Перейти до основного вмісту
POST
Створіть пошукову кампанію Google Ads одним запитом. Ayrshare створює разом бюджет, кампанію, одну групу оголошень, ваші ключові слова, одне адаптивне пошукове оголошення й таргетинг за місцеположенням. Якщо Google відхиляє будь-яку частину, нічого не створюється. Запит використовує спільну структуру Рекламних кампаній. На цій сторінці описано те, що стосується саме Google.
  • Оголошення Google вмикаються для кожного облікового запису окремо. Зв’яжіться з нами, щоб їх увімкнути.
  • Спершу під’єднайте Google Ads на сторінці “Social Accounts”. accountId — це 10-значний ID клієнта Google Ads, із дефісами або без них (123-456-7890).
  • Користувач Google, якого ви під’єднуєте, повинен мати прямий доступ до рекламного облікового запису. Облікові записи, до яких ви маєте доступ лише через обліковий запис менеджера, не відображаються в списку й поки що не можуть використовуватися: додайте цього користувача безпосередньо до рекламного облікового запису. Облікові записи менеджера також не відображаються: вони не можуть містити кампаній.
  • Нові кампанії створюються зі статусом paused, якщо ви не надішлете status: "active".
  • Бюджет задається на день у валюті рекламного облікового запису. Не надсилайте budget.currency: це повертає code: 101.
  • Витрати в іншій валюті конвертуються в USD для розрахунків за курсом Open Exchange Rates на відповідний день. Обліковий запис у валюті, яку неможливо конвертувати, повертає code: 101 ще до того, як щось буде створено.
  • Оголошення показуються лише в Google Search, а не в пошукових партнерів чи в контекстно-медійній мережі (Display Network).
Відстеження конверсій. maximizeConversions працює лише тоді, коли у вашому обліковому записі Google Ads налаштовано відстеження конверсій. Ayrshare не налаштовує його за вас. Без нього використовуйте maximizeClicks або manualCpc.

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

string
обов'язково
Нове унікальне значення, наприклад UUID, для кожної нової кампанії. Повторення запиту з тим самим ключем повертає першу відповідь і нічого нового не створює. Якщо створення не вдається до того, як Ayrshare надішле кампанію в Google, ключ звільняється, тож ви можете виправити запит і повторити його з тим самим ключем. Це стосується значення, яке Ayrshare відхиляє (наприклад, непідтримуваної стратегії ставок), облікового запису у валюті, яку неможливо конвертувати в USD, і будь-якої невдачі перевірки облікового запису, яку Ayrshare виконує спочатку, зокрема коли її відхиляє Google. Створення, яке не вдалося вже після надсилання кампанії в Google, зберігає свою відповідь: повторіть його з новим ключем.

Параметри тіла

Спільні поля працюють так, як описано на сторінці Рекламні кампанії. У Google:
string
обов'язково
search.
string
обов'язково
maximizeClicks, manualCpc або maximizeConversions. Будь-яке інше значення повертає code: 101.
boolean
обов'язково
Google вимагає цю декларацію для кожної кампанії. Доки будь-яка кампанія в обліковому записі не має декларації, Google відхиляє всі зміни кампаній цього облікового запису.
object
Google планує цілі дні в часовому поясі рекламного облікового запису. start починається о 00:00:00 свого дня, а end зупиняється о 23:59:59 свого дня; надісланий вами час лише визначає день. start може бути сьогоднішнім днем, але не раніше. Для одноденної кампанії надішліть ту саму дату в start і end. end на день раніше за start повертає code: 101.
object
Google зіставляє пошукові оголошення з людьми за мовою тексту вашого оголошення, тому налаштування мови немає. Надсилання targeting.languages повертає code: 101.
object
обов'язково

Помилки