Перейти до основного вмісту
GET
Отримуйте ефективність Google Ads у реальному часі, по одному рядку за день, для кампаній, груп оголошень або оголошень, створених через Ayrshare.
  • Дані зчитуються з Google в момент вашого запиту, а не з нічної копії.
  • Усі грошові значення подаються у валюті рекламного облікового запису, яка повертається в currency у кожному рядку.
  • Google пропускає дні без активності, тому діапазон може повернути менше рядків, ніж у ньому днів.
  • Google коригує вартість і конверсії за день ще кілька днів після його завершення, тому дані за останні дні можуть змінюватися між запитами.
  • Для кампанії Performance Max використовуйте level=campaign з ID кампанії. Кампанія Performance Max не має власних оголошень, тому level=ad не повертає рядків.

Параметри заголовка

Параметри запиту

string
обов'язково
Про що звітує кожен рядок: campaign (campaignId, отриманий під час створення), adSet (adGroupId, отриманий під час створення) або ad (adId, отриманий під час створення).
string
обов'язково
ID кампаній, груп оголошень або оголошень через кому, до 50. Усі вони мають належати до одного рекламного облікового запису.
string
10-значний ID клієнта Google Ads, із дефісами або без них (123-456-7890).Звіти за оголошеннями та групами оголошень зчитують рекламний обліковий запис, указаний тут. Без нього звіт за оголошеннями шукає в усіх рекламних облікових записах, до яких має доступ ваше під’єднання Google Ads, але не більше ніж у 25, а звіт за групами оголошень працює лише тоді, коли ваше під’єднання має доступ до одного рекламного облікового запису. Укажіть обліковий запис, коли ваше під’єднання має доступ до понад 25 рекламних облікових записів або до понад одного для звіту за групами оголошень. Інакше запит повертає code: 101.
string
Метрики для повернення через кому. Не передавайте цей параметр, щоб отримати всі. Див. Метрики.
string
за замовчуванням:"30 днів тому"
Перший день у форматі YYYY-MM-DD. Google зберігає щоденні показники протягом 37 місяців; ранніша startDate повертає code: 101.
string
за замовчуванням:"сьогодні"
Останній день у форматі YYYY-MM-DD.

Метрики

actions і conversionValue дорівнюють 0, доки у вашому обліковому записі Google Ads не налаштовано відстеження конверсій. reach недоступний, бо Google не повідомляє унікальне охоплення для Search, а breakdowns недоступні в Google. Запит будь-якого з них повертає code: 101.

Пагінація

Усі рядки повертаються в одній відповіді, тому nextCursor завжди має значення null.

Помилки