Google Ad Library Ad
Креативы Google Ads Transparency Center — это публичные рекламные записи с данными рекламодателя, видимым текстом и медиафайлами, целевыми ссылками, форматами, датами показа, регионами и доступными данными о показах. Эти сведения помогают проверять креативы, обогащать выбранные объявления, исследовать контекст показов и сравнивать архивные снимки на определенный момент.
Возможности Google Ad Library Ad API
- Точное разрешение креативаПреобразует один URL на adstransparency.google.com, содержащий /creative/, не более чем в одну нормализованную публичную запись объявления, не расширяя запрос до поиска.
- Поля рекламодателя и креативаВозвращает идентификатор креатива, публичный исходный URL, доступный текст, ссылку на рекламодателя, целевую ссылку и формат в стабильной схеме объявления.
- Контекст показаСохраняет доступные даты начала и окончания, страны, площадки и скалярное значение показов, только если исходные данные можно безопасно нормализовать.
- Нормализованные медиаресурсыОтдает доступные ссылки на изображения или видео с миниатюрами, размерами и длительностью, пропуская отсутствующие необязательные значения.
Параметры Google Ad Library Ad API
| Параметры | Обязательный | Описание |
|---|---|---|
url | Обязательный | Обязательный URL публичного креатива в Google Ads Transparency Center. Протокол должен быть http или https, хост должен оканчиваться на adstransparency.google.com, а путь должен содержать /creative/. |
Как использовать Google Ad Library Ad API
Отправьте один точный URL публичного креатива, отслеживайте асинхронную задачу и читайте нормализованную запись объявления из стандартной обертки результатов.
- Подготовьте один URL с протоколом http или https на adstransparency.google.com, путь которого содержит /creative/.
- Отправьте url методом POST на /v1/google-ad-library/ad и сохраните возвращенный task_id.
- Опрашивайте /v1/tasks/{task_id}, пока задача не завершится успешно или с ошибкой.
- Читайте data.results.items; операция получения деталей возвращает не более одного элемента, поэтому has_more обычно равно false, а next_cursor обычно равен null.
curl -X POST "https://api.socq.ai/v1/google-ad-library/ad" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"url":"https://adstransparency.google.com/advertiser/AR01614014350098432001/creative/CR10449491775734153217"}'
# Poll GET /v1/tasks/{task_id}
# Read data.results.items; this detail operation returns at most one itemСценарии использования Google Ad Library Ad API
- Обогащение выбранного креатива: Используйте ID креатива, ссылку на рекламодателя, текст, целевую ссылку, формат, медиафайлы и исходный URL, чтобы дополнить найденную ранее запись объявления.
- Проверка публичных данных о показах: Сравнивайте доступные даты, страны, площадки и показы, чтобы документировать, где и когда известный креатив был публично замечен.
- Архивирование снимков креативов: Храните нормализованные поля текста, медиафайлов, рекламодателя, показов, целевой ссылки и collected_at для последующего сравнения на определенный момент.
Практические советы по Google Ad Library Ad API
- Отправляйте полный URL креатива, а не просто идентификатор CR или URL рекламодателя, чтобы хост и путь /creative/ прошли проверку.
- Отличайте успешную задачу без элементов от сбоя провайдера: удаленный, ограниченный или недоступный креатив может не дать пригодной записи.
- Сохраняйте поля показов, текста, целевой ссылки, рекламодателя, числа показов и медиафайлов, которые могут быть null, а не превращайте отсутствующие публичные значения в ноль или пустые утверждения.
- Для поиска и инвентаризации используйте advertiser search и company ads; эта операция получения деталей намеренно обрабатывает только переданный креатив.
Связанные API
Помимо Google Ad Library Ad API, используйте эти API, когда нужен другой тип публичных данных Google Ad Library.
- Google Ad Library Advertiser Search API — Находите публичных рекламодателей в Transparency Center по запросу и необязательному региону: данные рекламодателя, сайт, логотип, регион и доступное число объявлений.
- Google Ad Library Company Ads API — Собирайте публичные креативы из Transparency Center по домену компании или ID рекламодателя с фильтрами по теме, региону, датам, площадке, формату и лимитом результатов.