Поиск, YouTube и DisplayНайдите рекламодателя и соберите его открытую рекламу в Google. Сравните форматы, время появления креативов и сообщения для разных рынков.
Попробуйте эти сценарии для маркетинга, роста и изучения конкурентов.
Перед запуском SaaS изучите три домена конкурентов. Посмотрите форматы и сообщения в поиске, Display и видео. Используйте примеры для планирования тестов каналов.
Создайте каталог креативов конкурентов с заметками о каналах, которые хотите изучить.
При исследовании розничного запуска следите за рекламодателем в двух целевых странах. Используйте даты первого и последнего показа, чтобы сравнить появление креативов и различия текстов.
Подготовьте сравнение стран со ссылками на открытые рекламные записи.
Для небольшой группы рекламодателей включите дополнительные данные и сохраните URL вариантов. Получите доступные публичные ID YouTube и изучите материалы перед началом производства.
Разложите материалы по форматам, чтобы команда могла находить примеры для кампаний.
ОТ ПЕРВОГО ЗАПУСКА К РЕГУЛЯРНОЙ РАБОТЕ
{
"domains": ["nike.com"],
"regions": ["GB"],
"platform": "all",
"maxAds": 50,
"fetchAdDetails": false,
"resolveMedia": false,
"proxyConfiguration": {
"useApifyProxy": true
}
}Вставьте это в редактор JSON Actor. Перед запуском замените примеры своими целями.
Посмотреть актуальные параметры на ApifyРекламодателя можно указать названием, доменом, ID или ссылкой из Transparency Center. Используйте ID, если у бренда несколько юридических лиц или поиск по названию выбирает другое.
| Способ поиска | Когда использовать | Что меняется |
|---|---|---|
| Домены сайтов | Когда использоватьУ вас есть список конкурентов для наблюдения. | Что меняетсяПроверенные домены вроде nike.com точнее названия бренда. При отсутствии совпадения возможен поиск по названию; проверьте выбранного рекламодателя. |
| Название рекламодателя или бренда | Когда использоватьВы хотите найти подходящие результаты, прежде чем выбрать конкретные цели. | Что меняетсяИщите по названиям брендов или компаний. Actor также проверяет домен и выбирает рекламодателя. Проверьте найденную организацию; для точного выбора используйте AR ID. |
| ID рекламодателей | Когда использоватьВы точно знаете, по какому объекту хотите собрать данные. | Что меняетсяAR ID из ссылок Центра прозрачности. Они исключают неоднозначность названий и позволяют отслеживать одну юридическую организацию во времени. |
| Ссылки из библиотеки рекламы | Когда использоватьВы уже настроили поиск на исходном сайте. | Что меняетсяВставляйте ссылки рекламодателей из Центра прозрачности. Каждая сохраняет регион и платформу; общие параметры заполняют отсутствующие фильтры. |
Оставляет объявления, последний показ которых был в эту дату или позже. Фильтрация выполняется после сбора: у Google нет фильтра дат на сервере, поэтому запросов может не стать меньше.
Сравнить с похожим скрейперомИспользуйте точные имена полей ниже в JSON. В форме Apify вводите элементы списков отдельно и соблюдайте числовые и логические типы.
Значение по умолчанию и предзаполнение различаются. Первое действует при пропуске настройки; второе является примером в форме Apify. Проверяйте цели и лимиты перед каждым запуском. У некоторых настроек нет значения по умолчанию в схеме. Всё равно нужно указать хотя бы одну поддерживаемую цель.
searchTermsИщите по названиям брендов или компаний. Actor также проверяет домен и выбирает рекламодателя. Проверьте найденную организацию; для точного выбора используйте AR ID.
domainsПроверенные домены вроде nike.com точнее названия бренда. При отсутствии совпадения возможен поиск по названию; проверьте выбранного рекламодателя.
domainОдин домен вместо списка domains. Используйте основной домен: путь на сайте не ограничивает объявления рекламодателя.
advertiserIdsAR ID из ссылок Центра прозрачности. Они исключают неоднозначность названий и позволяют отслеживать одну юридическую организацию во времени.
advertiserIdВариант advertiserIds для одного рекламодателя. Копируйте AR из его ссылки, а не ID креатива.
transparencyUrlsВставляйте ссылки рекламодателей из Центра прозрачности. Каждая сохраняет регион и платформу; общие параметры заполняют отсутствующие фильтры.
transparencyUrlОдна ссылка рекламодателя с приоритетом как у transparencyUrls. Регион в ссылке важнее другого общего региона.
regionsНесколько стран создают отдельные задачи по рекламодателю и региону. Дубликаты удаляются по creative_id. Пустое поле охватывает доступные регионы; неподдерживаемые страны пропускаются.
regionОдна страна, используемая только при пустом regions. Для сравнения рынков выбирайте regions.
platformОграничивает рекламную площадку Google. Выбирайте search, youtube, display, shopping, maps, play или all. Итоги по площадкам могут пересекаться.
all search youtube display shopping maps playminDateОставляет объявления, последний показ которых был в эту дату или позже. Фильтрация выполняется после сбора: у Google нет фильтра дат на сервере, поэтому запросов может не стать меньше.
maxDateОставляет объявления, впервые показанные не позднее этой даты. Вместе с minDate выбирает показы, пересекающиеся с периодом. Используйте YYYY-MM-DD.
proxyConfigurationРекомендуется Apify Proxy; обычно хватает datacenter. Residential не обязателен. При отклонении настроек возможен переход к стандартному прокси аккаунта.
maxConcurrencyОт 1 до 10 параллельных задач по рекламодателю и региону. Помогает при нескольких целях; один рекламодатель в одном регионе обходится последовательно.
maxAdsЖёсткий лимит уникальных объявлений на весь запуск, включая все цели и рынки. Начните с 50. Без этого лимита широкий поиск может стать значительно больше.
maxPagesЛимит страниц для каждой пары рекламодатель-регион. На странице до pageSize объявлений, максимум 100. Это тестовое ограничение, не общий лимит результатов.
fetchAdDetailsДобавляет регионы, даты показов по регионам и варианты креативов. Нужен дополнительный запрос на объявление; включайте только при необходимости.
resolveMediaДополнительными запросами получает ID публичных видео YouTube из превью. Не создаёт публичную ссылку для display-видео, у которых её нет.
pageSizeОт 1 до 100 объявлений на запрос. Большие значения ограничиваются 100, поскольку Google их отклоняет. Обычно оставляйте 100.
delayMsПауза между запросами страниц в миллисекундах. Увеличивайте при ограничениях источника; уменьшение не устраняет задержки сети и лимиты запросов.
rawВозвращает исходную структуру вместо нормализованного представления. Оставляйте false для стабильных столбцов анализа; true используйте для диагностики или собственных преобразований.
proxyRotationsПовторяет отклонённые запросы с новой прокси-сессией. Дополнительные попытки помогают при временных блокировках, но увеличивают время и трафик. Меняйте стандартное значение только при необходимости по журналу.
resumeСохраняет прогресс примерно каждые 30 секунд для продолжения после перезапуска или миграции Apify. Обычно оставляйте включённым.
continueFromLastRunПродолжает незавершённую работу предыдущего запуска с теми же входными данными. Старые результаты остаются в его dataset. Для нового или регулярного сбора оставляйте false.
impersonateИдентификатор браузера для запросов. Сохраняйте стандарт Actor, кроме диагностики мгновенных блокировок. Он меняет отпечаток запроса, а не запрашиваемые данные.
proxySessionIdФиксирует прокси-сессию для диагностики. При обычном сборе оставляйте пустым. Параллельным задачам нужны отдельные сессии, поэтому фиксированная может игнорироваться.
Справочник соответствует параметрам Actor. Перед изменением рабочего процесса проверьте актуальную форму. Посмотреть актуальные параметры на Apify.
Каждый пример рассчитан на отдельный запуск. Начните с малого, проверьте результаты и затем расширяйте охват. Измените цели, страны и даты под свою задачу.
Два домена и два региона создают четыре задания «рекламодатель-регион». Лимит 150 относится к общему набору без дублей. Он не гарантирует одинаковую выборку для каждого бренда или страны.
{
"domains": ["nike.com", "adidas.com"],
"regions": ["GB", "FR"],
"maxAds": 150,
"fetchAdDetails": false,
"proxyConfiguration": {
"useApifyProxy": true
}
}Выберите YouTube и включите resolveMedia для попытки получить ID и ссылки видео. Проверьте медиаполя перед передачей ссылок Claude: у некоторых креативов всё равно нет доступного напрямую видео.
{
"domains": ["nike.com"],
"regions": ["GB"],
"platform": "youtube",
"maxAds": 50,
"resolveMedia": true,
"proxyConfiguration": {
"useApifyProxy": true
}
}Добавьте подробности и период показа для Германии. Даты проверяются после получения объявлений, поэтому узкий период не гарантирует низкую стоимость. Измените даты и начните с небольшого лимита.
{
"domains": ["nike.com"],
"regions": ["DE"],
"minDate": "2026-09-01",
"maxDate": "2026-09-30",
"maxAds": 50,
"fetchAdDetails": true,
"proxyConfiguration": {
"useApifyProxy": true
}
}Сохраняйте ID рекламодателей и креативов с регионом, платформой и датой. Опции подробностей и медиа расширяют те же записи, а не создают набор данных об эффективности. Используйте Sheets для обзора креативов или BigQuery и dbt для истории без дублей. Расходы, ROAS и конверсии источник не предоставляет.
resume защищает текущий запуск при перезапуске Apify. continueFromLastRun продолжает предыдущий запуск с той же конфигурацией; старые записи остаются в старом dataset. Объедините оба набора и увеличьте достигнутый лимит. Для наблюдения сегодняшних изменений начните новый сбор.
Сохраните одну из конфигураций выше в input.json. Задайте в терминале APIFY_TOKEN своим токеном Apify и отправьте файл как тело запроса.
curl --fail-with-body --request POST \
--url "https://api.apify.com/v2/actors/jmlp~google-ads-transparency-center-scraper/runs" \
--header "Authorization: Bearer $APIFY_TOKEN" \
--header "Content-Type: application/json" \
--data-binary @input.jsonОтвет содержит ID запуска и defaultDatasetId, а не готовые результаты. Дождитесь успешного завершения, задайте DATASET_ID идентификатором набора и получите записи. Для больших наборов используйте limit и offset для постраничной выгрузки.
curl --fail-with-body \
--url "https://api.apify.com/v2/datasets/$DATASET_ID/items?format=json" \
--header "Authorization: Bearer $APIFY_TOKEN"Документация API Apify для запуска и экспорта
Параметры экспорта набора данных
Меняйте по одному параметру, сохраняйте небольшой лимит и проверяйте сводку перед расширением сбора.
AR ID из ссылок Центра прозрачности. Они исключают неоднозначность названий и позволяют отслеживать одну юридическую организацию во времени.
Дополнительными запросами получает ID публичных видео YouTube из превью. Не создаёт публичную ссылку для display-видео, у которых её нет.
От 1 до 10 параллельных задач по рекламодателю и региону. Помогает при нескольких целях; один рекламодатель в одном регионе обходится последовательно.
Успешный статус означает завершение работы Actor, а не наличие данных у источника. Проверьте SUMMARY.inputProblem, SUMMARY.problem и журнал: возможны отсутствующие цели, неподдерживаемые фильтры или отклонённые запросы. Попробуйте известную цель с меньшим числом фильтров.
Проверьте общие лимиты, лимиты поиска и страниц, охват и дедупликацию. Несколько запросов могут найти одну запись. Счётчик источника может включать недоступные публично данные. Проверьте незавершённые задачи, прежде чем считать набор полным.
Соберите creative_id, advertiser_name, format, first_shown, last_shown и preview_url в одной таблице. Добавьте колонку темы кампании для заметок команды.
Читать инструкциюПопросите Claude сравнить форматы и даты показа для небольшой группы рекламодателей. Требуйте ссылки и отделяйте интерпретации от того, что видно в записях.
Читать инструкциюСравните форматы по рекламодателю и покажите появление новых ID креативов. Если собираете регионы, разверните массив перед отчётами по рынкам.
Читать инструкциюУдаляйте дубликаты по creative_id, сохраняя каждое наблюдение с датой. Храните регионы и варианты в дочерних таблицах, чтобы объединения не завышали число креативов.
Читать инструкцию
Проверь схему jmlp/google-ads-transparency-center-scraper и собери не более 50 записей для nike.com в GB. Обобщи доступные форматы и даты показа, укажи transparency_url и вопросы для маркетингового исследования. Не оценивай расходы или ROAS.Сохраняйте время сбора и исходные ID: они нужны для проверки источника результата и сравнения с последующими запусками.
Данные прозрачности Google не включают конверсии и ROAS конкурентов. Даты фильтруются после сбора, поэтому узкий период не обязательно сокращает обход. Дополнительные данные и получение видео добавляют запросы: включайте их по необходимости.
Он может собирать записи из поиска, YouTube, Display, Shopping и Maps в зависимости от выбранной платформы и доступных открытых данных.
Не обязательно. У исходного API нет фильтра дат: скрапер собирает страницы, а затем фильтрует записи. Ограничивайте запуск через maxAds и настройки дополнительных данных.
Источник и актуальные сведения: Actor Google Ads Transparency от JMLP на Apify.
Facebook & Instagram01Узнайте, что рекламируют конкуренты.
Соберите рекламу конкурентов в одном месте. Сравните тексты, предложения и сроки перед следующей кампанией.
Библиотека коммерческого контента02Найдите идеи для видео, которые стоит проверить.
Собирайте рекламу TikTok с 32 рынков ЕС/ЕЭЗ, Великобритании и Швейцарии. Сохраняйте ссылки видео и даты показов, затем изучайте интересующие креативы.
Расскажите, что нужно собрать или понять. Я помогу со скрапером на заказ, конвейером или анализом.
Обсудить проект