광고 라이브러리 주간 차이 분석
각 경쟁업체의 현재 공개 광고 라이브러리에서 표시되는 광고를 가져와서 지난주 스냅샷과 비교한 후, 새로 추가된 광고, 중단된 광고, 그리고 새 광고의 내용을 간략히 보고하는 리포트를 작성합니다.
공개 광고 라이브러리가 알려주는 것과 알려주지 않는 것
모든 리포트에 이러한 제한 사항을 명시하십시오. 독자가 그 이상을 추론하지 않도록 하십시오.
- 공개 광고 라이브러리는 일반 상업 광고의 비용, 노출수 또는 전환율을 표시하지 않습니다. Google은 선거 광고에 대해서만 비용 및 노출수 범위를 게시하며, Meta는 일부 EU 전달 및 정치 광고에 대해서만 도달 범위 분석을 표시합니다. LinkedIn은 일부 광고에 대해 노출수 및 타겟팅을 표시합니다. 광고 수로 예산이나 성과를 추정하지 마십시오.
- '라이브러리에 없음'이 '광고를 하지 않는다'는 의미는 아닙니다. 라이브러리는 국가 범위로 설정되어 있으며 하루 이상 지연될 수 있습니다.
- TikTok의 광고 라이브러리는 EU/EEA, 영국 및 스위스에서 게재된 광고만 다룹니다. 해당 국가 외부에서는 "TikTok: 해당 사항 없음"이라고 말하고 광고가 0개라고 보고하지 마십시오.
- 광고의 첫/마지막 게재 날짜는 정확한 시간이 아닌 달력 날짜입니다.
먼저 수집할 입력 정보
- 경쟁업체: 브랜드 이름과, 알고 있다면 Meta 페이지 URL, Google 광고주 이름 및 LinkedIn 회사 이름.
- 국가(두 글자 코드). 기본값:
US. TikTok이 중요하다면GB또는DE와 같은 EU/영국 국가를 추가하십시오. - 스냅샷 파일 경로. 기본값: 작업 디렉터리의
ad-library-snapshot.json. - 새 광고에 대한 광고 세부 정보 및 사본을 가져올지 여부(더 많은 크레딧, 더 나은 리포트).
크레딧 예상 — 실행 전에 표시
경쟁업체당, 국가당:
| 단계 | 엔드포인트 | 크레딧 |
|---|---|---|
| Meta 페이지 찾기 | /v1/ad-library/facebook/search-companies | 2 |
| Meta 광고 | /v1/ad-library/facebook/company-ads | 2 |
| Google 광고주 찾기 | /v1/ad-library/google/advertiser-search | 1 |
| Google 광고 | /v1/ad-library/google/company-ads | 2 |
| LinkedIn 광고 | /v1/ad-library/linkedin/search-ads | 2 |
| TikTok 광고 (EU/EEA/영국/CH만 해당) | /v1/ad-library/tiktok/search | 2 (대체 경로에서는 최대 5) |
이는 경쟁업체당 국가당 약 11크레딧(TikTok이 적용되지 않는 경우 9크레딧)입니다. 조회 단계는 스냅샷에 페이지 ID와 광고주 ID를 저장하여 이후 실행에서 건너뛸 수 있습니다.
선택 사항으로, 새 광고에만 해당: 세부 정보(.../ad-details, 각 2개) 및 Meta 광고 사본(/v1/ad-library/facebook/ad-transcript, 각 2개). 예를 들어 경쟁업체당 새 광고 5개로 제한하고 예상치에 명시하십시오.
예상치(경쟁업체 × 국가 × 11, 그리고 세부 정보 제한 포함)를 출력하고 GET /v1/account/balance(무료)로 잔액을 확인하십시오. 지출하기 전에 사용자에게 확인을 요청하십시오.
Captapi 호출 방법
두 경로 모두 작동합니다. 환경에 있는 것을 사용하십시오.
- MCP: 엔드포인트 이름을 딴 도구(예:
facebook_ad_library_company_ads,google_ad_library_company_ads,linkedin_ad_library_search_ads,tiktok_ad_library_search). - REST:
GET https://api.captapi.com<경로>?<매개변수>헤더Authorization: Bearer $CAPTAPI_API_KEY와 함께 사용.
실패한 호출은 크레딧이 소모되지 않습니다. retryable: true 오류는 잠시 기다린 후 한 번 재시도할 수 있습니다. retryable: false는 최종 답변입니다. 기록하고 반복하지 마십시오.
단계
- 스냅샷 로드: 스냅샷이 있으면 로드합니다. 스냅샷은
경쟁업체 → 국가 → 라이브러리 → {ids: [...], meta: {...}}와 저장된 조회 ID로 매핑됩니다. - ID 확인: 스냅샷에 ID가 없는 경우에만 확인합니다.
- Meta:
facebook/search-companies?q=<브랜드>&country=<국가>→ 이름이 일치하는 페이지를 선택하고pageId를 유지합니다. 여러 개가 맞는 것 같으면 질문합니다. - Google:
google/advertiser-search?q=<브랜드>&country=<국가>→ 일치하는 결과의 광고주 ID를 유지합니다.
- Meta:
- 현재 광고 가져오기: 각 경쟁업체 및 국가에 대해:
facebook/company-ads?url=<pageId 또는 페이지 URL>&country=<국가>&status=activegoogle/company-ads?advertiser=<광고주 ID 또는 이름>&country=<국가>linkedin/search-ads?company=<이름>&country=<국가>tiktok/search?q=<브랜드>&country=<국가>— EU/EEA/영국/CH에만 해당.
- 광고 ID로 차이 분석: 스냅샷과 비교하여
new(지금은 있지만 이전에는 없음),stopped(이전에는 있었지만 지금은 없음),continuing. - 새 광고 보강: 합의된 제한까지:
.../ad-details(날짜 및 미디어),facebook/ad-transcript(Meta 헤드라인/본문/CTA/랜딩 URL). - 리포트 작성(아래 형식) 및 새 스냅샷 저장 — 리포트가 작성된 후에만 저장하므로 실패한 실행이 지난주를 덮어쓰지 않습니다.
리포트 형식
각 경쟁업체에 대해:
- 라이브러리당 한 줄:
새 N개 · 중단 N개 · 게재 중 N개또는 누락된 이유(이 국가에서는 해당 사항 없음,조회 실패,광고 0개 발견). - 새 광고: 헤드라인 또는 사본 첫 줄, 형식(이미지/비디오/캐러셀), 첫 게재 날짜, 랜딩 도메인, 출처 엔드포인트(예:
(출처: /v1/ad-library/facebook/company-ads)). - 테마: 새 광고가 공유하는 각도에 대한 2~4개의 글머리 기호(제안, 대상, 제품). 각각을
[인간 검토 필요]로 표시하십시오. 이는 해석입니다. - 중단된 광고: 수와 중단된 광고 중 가장 오래 실행된 광고.
위의 제한 사항 섹션, 실행에 대한 한 줄 크레딧 총계, 스냅샷 경로로 마무리하십시오.
인간이 검토해야 하는 부분
- 조회 결과가 여러 개 반환될 때 어떤 페이지 또는 광고주가 "그" 경쟁업체인지.
- 모든 테마 또는 전략 주장 — 라이브러리는 크리에이티브를 보여줄 뿐 의도를 보여주지 않습니다.
- 예산 또는 성능에 대한 모든 결론 — 이에 대한 데이터가 없습니다. 리포트는 추측하기보다 그렇게 명시해야 합니다.