Google Ad Library Advertiser Search
Google Ads Transparency Center에서는 브랜드, 조직, 웹사이트 검색어 하나에 대해 지역별 법인이나 이름이 비슷한 주체를 포함한 여러 광고주 레코드가 나타날 수 있습니다. 각 레코드의 ID, 이름, 웹사이트, 로고, 지역, 확인 가능한 광고 수를 살펴보면 광고 소재를 수집하기 전에 알맞은 공개 광고주 레코드를 고르는 데 도움이 됩니다.
Google Ad Library Advertiser Search API 주요 기능
- 이름 기반 광고주 탐색비어 있지 않은 브랜드, 조직, 광고주 또는 웹사이트 검색어 하나로 검색하면 광고 소재가 아니라 정규화된 광고주 후보를 받습니다.
- 선택 지역 정보US 같은 지역을 전달해 상위 검색에 지역 맥락을 더할 수 있으며, 이 지역은 광고 게재 지역과는 별개로 다룹니다.
- 후보 식별 필드공개 광고주 ID, 이름, URL, 웹사이트, 로고, 지역, 원본에서 제공하는 광고 수를 추정 정보 없이 그대로 비교합니다.
- 단일 응답 전체 저장한 번의 상위 검색 응답에서 반환된 사용 가능한 광고주를 모두 저장하며, 호출자가 지정하는 결과 개수 제한이나 제공처 페이지네이션 반복은 적용되지 않습니다.
Google Ad Library Advertiser Search API 매개변수
| 매개변수 | 필수 | 설명 |
|---|---|---|
query | 필수 | 비어 있지 않아야 하는 광고주, 브랜드, 조직 또는 웹사이트 검색어로, 필수 값입니다. 일치 방식은 원본에 따라 다르며 완전 일치, 접두사 일치, 유사 일치 중 무엇이 적용될지 보장되지 않습니다. |
region | 선택 | US처럼 비어 있지 않은 지역 문자열로, 선택 값입니다. 지리적 검색 맥락으로 전달되며, 광고주의 광고가 해당 지역에 게재되었음을 증명하지는 않습니다. |
Google Ad Library Advertiser Search API 사용 방법
검색어를 제출하고 비동기 작업을 따라간 뒤, 정규화된 광고주 후보를 하나씩 검토한 다음 이후 조사에 해당 식별 정보를 사용합니다.
- 구체적인 광고주, 브랜드, 조직 또는 웹사이트 검색어를 정하고, 필요하면 US 같은 지역을 추가합니다.
- query와 선택 항목인 region을 /v1/google-ad-library/advertiser-search로 POST하고, task_id를 저장합니다.
- 작업이 성공하거나 실패할 때까지 /v1/tasks/{task_id}를 폴링합니다.
- data.results.items를 읽고, 광고주 ID를 선택하기 전에 이름의 유사성만이 아니라 여러 정보를 함께 보고 후보의 신원을 확인합니다.
curl -X POST "https://api.socq.ai/v1/google-ad-library/advertiser-search" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"query":"Nike","region":"US"}'
# Poll GET /v1/tasks/{task_id}
# Review data.results.items as advertiser candidatesGoogle Ad Library Advertiser Search API 추천 활용 사례
- 브랜드를 광고주 ID로 확인: 이름이나 웹사이트 검색어로 후보 목록을 만든 뒤, 별도의 공개 광고 목록 요청에 사용할 광고주 ID를 고릅니다.
- 지역·법인별 주체 구분: 비슷한 레코드 여러 개가 자회사, 리셀러, 무관한 조직 중 무엇인지 알기 어려울 때 이름, 지역, 웹사이트, 공개 광고주 페이지를 비교합니다.
- 검토 대기열 생성: 이름이 비슷하다는 이유만으로 소유 관계를 단정하지 않고, 후보 식별 정보와 수집 시각을 저장해 수동으로 확인합니다.
Google Ad Library Advertiser Search API 활용 팁
- 정확한 법인명, 브랜드 또는 도메인에 가까운 검색어를 사용하세요. 너무 넓은 표현은 모호한 후보를 만들 수 있고 일치 규칙도 보장되지 않습니다.
- region은 검색 맥락일 뿐이며, 해당 광고주의 모든 광고가 그 지역에서 게재되었다는 근거가 아닙니다.
- 레코드를 병합하거나 광고 소재를 수집하기 전에 ID, 이름, 웹사이트, 지역, 공개 광고주 페이지로 후보를 확인하세요.
- results_limit은 보내지 마세요. 이 작업은 한 번의 상위 응답에서 반환된 사용 가능한 광고주 배열을 저장하며 원본을 페이지네이션하지 않습니다.
관련 API
Google Ad Library Advertiser Search API 외에 Google Ad Library의 다른 유형의 공개 데이터가 필요할 때 이 API를 사용하세요.
- Google Ad Library Ad API — URL로 알고 있는 공개 Transparency Center 크리에이티브 하나를 가져오며, 광고주, 문구, 미디어, 게재, 지역, 형식, 랜딩, 노출 필드를 포함합니다.
- Google Ad Library Company Ads API — 회사 도메인 또는 광고주 ID로 공개 Transparency Center 크리에이티브를 수집하며, 주제, 지역, 날짜, 게재면, 형식, 결과 수 제한을 지정할 수 있습니다.