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 методом POST на /v1/google-ad-library/advertiser-search и сохраните 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 candidatesСценарии использования Google Ad Library Advertiser Search API
- Поиск ID рекламодателей по бренду: Составляйте список вариантов по названию или сайту, прежде чем выбрать ID рекламодателя для отдельного запроса на сбор публичных объявлений.
- Разделение региональных и юридических лиц: Сравнивайте названия, регионы, сайты и публичные страницы рекламодателей, если несколько похожих записей могут относиться к дочерним компаниям, реселлерам или несвязанным организациям.
- Создание очереди на проверку: Сохраняйте данные вариантов и метки времени сбора для ручной проверки, не делая выводов о принадлежности только по сходству названий.
Практические советы по Google Ad Library Advertiser Search API
- Используйте конкретное юридическое название, бренд или похожий на домен запрос: широкие формулировки дают неоднозначные варианты, а правила сопоставления не гарантируются.
- Считайте region контекстом поиска, а не доказательством того, что вся реклама рекламодателя показывалась в этом регионе.
- Проверяйте варианты по ID, названию, сайту, региону и публичной странице рекламодателя, прежде чем объединять записи или собирать креативы.
- Не передавайте results_limit: эта операция сохраняет массив пригодных рекламодателей из одного ответа источника и не выполняет пагинацию источника.
Связанные API
Помимо Google Ad Library Advertiser Search API, используйте эти API, когда нужен другой тип публичных данных Google Ad Library.
- Google Ad Library Ad API — Получайте один известный публичный креатив из Transparency Center по URL: рекламодатель, текст, медиа, показ, регион, формат, целевая страница и показы.
- Google Ad Library Company Ads API — Собирайте публичные креативы из Transparency Center по домену компании или ID рекламодателя с фильтрами по теме, региону, датам, площадке, формату и лимитом результатов.