google-ad-library/
ad

Получайте один публичный креатив из Google Ads Transparency Center по его точному URL: данные рекламодателя, текст, медиафайлы, даты показа, регионы, формат, целевая ссылка и доступные показы в нормализованной записи.

Google Ad Library Ad API

Точный URL креатива
Рекламодатель и медиафайлы
Публичные данные о показах
0,5 кредита за результат
Готово
Готово

Введите параметры и отправьте запрос. Здесь появятся статус задачи и нормализованные результаты.

README

Автор: SocQ · Обновлено

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 публичного креатива, отслеживайте асинхронную задачу и читайте нормализованную запись объявления из стандартной обертки результатов.

  1. Подготовьте один URL с протоколом http или https на adstransparency.google.com, путь которого содержит /creative/.
  2. Отправьте url методом POST на /v1/google-ad-library/ad и сохраните возвращенный task_id.
  3. Опрашивайте /v1/tasks/{task_id}, пока задача не завершится успешно или с ошибкой.
  4. Читайте 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; эта операция получения деталей намеренно обрабатывает только переданный креатив.

Помимо 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 рекламодателя с фильтрами по теме, региону, датам, площадке, формату и лимитом результатов.

Другие платформы

Объединяйте данные Google Ad Library с публичными данными других поддерживаемых соцсетей.

Google Ad Library Ad API — FAQ

Google Ad Library Ad API — это программный интерфейс для получения одного публичного креатива из Google Ads Transparency Center по его точному URL. Он возвращает нормализованные поля рекламодателя, текста, медиафайлов, показа, региона, формата, целевой ссылки и доступных показов.

Отправьте один URL с протоколом http или https, хост которого оканчивается на adstransparency.google.com, а путь содержит /creative/. Отдельные ID креативов, URL рекламодателей, домены, поисковые запросы и списки URL не принимаются.

Нормализованная запись описывает идентификаторы, исходный URL, текст, рекламодателя, даты показа, страны, платформы, формат, целевую ссылку, показы, медиафайлы, время публикации и время сбора. Поля, зависящие от источника, могут быть null, а media может быть пустым.

Корректный URL креатива может указывать на удаленную, ограниченную, некорректную или временно недоступную публичную запись. Эндпоинт не подставляет другой креатив и не превращает запрос в поиск.

Каждая возвращенная запись стоит 0,5 кредита SocQ. Если запись не возвращена, настроенная политика пустых результатов взимает только базовую плату в ноль кредитов.