Гроші

Google Ads: підключення та конверсії

Усі налаштування Google розташовані в Джерела → Рекламний кабінет → Google: власний OAuth-застосунок, вибір акаунта, дії конверсій, браузерні мітки, витрати та журнал надсилань. У потоці вибирається лише це джерело. Окремого Google-підключення й окремих номерів дій потік не має.

У цій інструкції: власники ресурсів · варіанти підключення · передумови · Google Cloud та OAuth · підключення джерела · вибір акаунта · номери дій вручну · ідентифікатори й мітки · окремі потоки · відправка постбеків · браузерні теги · витрати · перевірка · усунення помилок · обслуговування · поширені запитання.

1. Кому належать акаунти й дозволи?

Ця інтеграція Ads не використовує спільний OAuth-застосунок, Cloud-проєкт, developer token чи MCC ArtisanClo. Облікові дані іншого клієнта не підставляються. Серверні запити все одно виконуються на інфраструктурі ArtisanClo: власний застосунок не означає, що запити надходять із вашого комп’ютера.

Client Secret і токени доступу та оновлення зберігаються зашифрованими. Збережені секрети не повертаються у форму налаштувань. Якщо залишити поле збереженого секрету порожнім, попереднє значення збережеться. Відвідувачі отримують лише публічні ідентифікатори й мітки тегів. Відокремлення ресурсів не гарантує відсутності обмежень Google: його правила поширюються на акаунти, застосунки й використання сервісу.

2. Виберіть потрібні можливості

Серверну й браузерну відправку можна ввімкнути одночасно. Вони фіксують різні моменти й автоматично не об’єднуються в одну конверсію. Перегляньте дублікати й цілі конверсій.

3. Підготуйте трекінг і джерело

1. Ваш тариф має включати відправку конверсій у рекламні кабінети. Імпорт витрат — окрема функція тарифу. Якщо можливість недоступна, налаштування показують тарифні обмеження.
2. Використовуйте потік з увімкненим трекером. Потоки лише з клоакінгом не відправляють конверсії джерела. Виберіть джерело в налаштуваннях трекінгу потоку.
3. Налаштуйте вхідні конверсії зі свого сайту, партнерської мережі або зовнішнього трекера. Передайте ідентифікатор кліку ArtisanClo на офер і поверніть його в постбеку.
4. Перевірте, що рекламні переходи зберігають справжній gclid, gbraid або wbraid. Внутрішній click_id ArtisanClo пов’язує постбек із відвідуванням; ідентифікатор Google пов’язує відвідування з рекламою. Потрібні обидва зв’язки.
5. Використовуйте користувача Google з достатніми правами в цільовому акаунті Ads або доступному MCC. Самі лише дозволи Cloud не надають доступу до акаунта Google Ads.

Не вигадуйте ідентифікатор кліку Google для звичайної відправки. gad_source, значення UTM, електронна адреса та ідентифікатори транзакцій не можуть його замінити. Пізніше підключення Google не відновить ідентифікатор, відсутній у початковому відвідуванні.

4. Налаштуйте власний застосунок Google Cloud

1. Відкрийте Google Cloud Console та виберіть або створіть проєкт, яким ви керуєте.
2. У бібліотеці API увімкніть Data Manager API для серверної відправки конверсій.
3. Для списку акаунтів, автоматичного створення дій або витрат також увімкніть Google Ads API. Перевірте рівень доступу проєкту в Google Ads API Overview і виконайте вимоги Google для потрібних акаунтів. Доступу лише до тестових акаунтів недостатньо для робочих рекламних акаунтів. Рівні доступу проєкту.
4. У Google Auth Platform налаштуйте назву й дані застосунку, контактну адресу та аудиторію. Внутрішня аудиторія організації обмежує вхід її користувачами. У режимі Testing додайте адресу Google, якою користуватиметеся, до тестових користувачів.
5. Створіть OAuth Client ID типу Web application. В ArtisanClo відкрийте джерело → Рекламний кабінет → Google → серверні конверсії → власний OAuth-застосунок Google Cloud. Скопіюйте показаний Authorized redirect URI у налаштування цього OAuth-клієнта.
6. Скопіюйте Client ID і Client Secret у джерело. Client ID зазвичай закінчується на .apps.googleusercontent.com. Не вставляйте в ці поля API-ключ, номер акаунта Ads або цілий JSON-файл.

Копіюйте адресу повернення точно, включно зі схемою, доменом і шляхом. Не замінюйте /en/ мовою свого кабінету: шлях повернення фіксований. Локальна й робоча інсталяції можуть показувати різні адреси. Вимоги Google до вебавторизації OAuth.

Серверне підключення запитує openid, email і https://www.googleapis.com/auth/datamanager. Увімкнення перемикача Google Ads API додає https://www.googleapis.com/auth/adwords. Надайте дозволи для вибраних можливостей. Дозвіл Data Manager обов’язковий для завершення цього серверного підключення.

Назви екранів Google можуть змінюватися. Вказуйте дані власного застосунку й лише домени, якими керуєте. Якщо Google вимагає перевірки домену або застосунку, виконайте вимоги для своєї конфігурації; підключення ArtisanClo не замінює цю процедуру.

5. Підключіть джерело

1. Відкрийте «Джерела» та створіть або відредагуйте джерело Google. Назвіть його так, щоб було зрозуміло, до якого бізнесу чи акаунта воно належить.
2. Розгорніть блок конверсій і витрат рекламного кабінету, виберіть Google та ввімкніть серверну відправку лідів і продажів.
3. Введіть Client ID і Client Secret. Увімкніть «Список акаунтів, створення конверсій і витрати (Google Ads API)», якщо Cloud-проєкт підготовлено для цих можливостей.
4. Натисніть «Зберегти й підключити мій Google». Джерело зберігається до відкриття Google. Виберіть потрібного користувача Google та авторизуйте власний застосунок.
5. Після повернення перевірте підключену електронну адресу та налаштуйте рекламний акаунт і дії-конверсії. «Підключено» підтверджує збережену авторизацію, а не доставку певної конверсії.

Вхід у кабінет ArtisanClo через Google та авторизація рекламного джерела — окремі операції. Підключення Ads використовує Client ID, збережений у цьому джерелі.

Завершіть авторизацію в тій самій сесії браузера протягом десяти хвилин. Початок іншого підключення замінює попередній незавершений запит. Якщо ви повернулися до старої вкладки або строк запиту минув, почніть знову з джерела.

Якщо вхід не вдався, кабінет називає причину:

6. Виберіть акаунт і автоматично налаштуйте дії

1. Після авторизації Google Ads API натисніть «Показати мої акаунти». Список містить доступні рекламні акаунти, зокрема клієнтів MCC. Якщо список порожній, перевірте користувача Google, дозволи Ads і доступ Cloud-проєкту.
2. Звірте десятизначний номер акаунта й натисніть «Вибрати й налаштувати». Ця кнопка може створити справжні дії-конверсії в акаунті.
3. Перевірте заповнені номер акаунта, номер керуючого акаунта за потреби та номери дій для ліда й продажу.

Увімкнені сумісні дії з цими точними назвами використовуються повторно. Несумісний тип або статус зупиняє налаштування з помилкою; наявні дії не переписуються непомітно. Створення двох дій — окремі операції: якщо друга не вдалася, перша вже може існувати й буде використана після виправлення помилки та повторної спроби.

Якщо відстеження конверсій належить іншому акаунту в конфігурації MCC, автоматичне налаштування повертає google_shared_conversion_account. Спочатку перевірте власника конверсій у Google Ads; зміна номера керуючого акаунта не переносить дії.

Автоматичне налаштування заповнює номери серверних дій. Воно не створює й не отримує браузерні Conversion ID/label. Налаштуйте браузерні події окремо та перевірте цілі конверсій і ставки кампаній у Google Ads.

7. Введіть номери вручну без Google Ads API

Data Manager API разом із вашою авторизацією OAuth може відправляти постбеки, навіть якщо список акаунтів і створення дій вимкнені.

1. Підготуйте в Google Ads дії-конверсії для імпорту за кліками. Якщо потрібні обидва статуси, створіть окремі дії для ліда й продажу.
2. У поле Google Ads Account ID введіть номер рекламного акаунта, наприклад 123-456-7890. Для запитів API дефіси видаляються.
3. Введіть номер MCC, якщо доступ здійснюється через нього. Для прямого доступу залиште поле порожнім.
4. Відкрийте кожну дію-конверсію в Google Ads і скопіюйте її числовий номер — параметр ctId в адресі сторінки — у відповідне поле ліда чи продажу.
5. Збережіть джерело й запустіть перевірку кожного ввімкненого статусу.

Порожнє поле дії вимикає відповідний статус. Щоб відправляти лише продажі, заповніть продаж і залиште лід порожнім. Не вставляйте AW-… або Conversion label у поле номера серверної дії.

8. Розрізняйте номери акаунтів, дій і мітки тегів

Це приклади значень, а не придатні для підключення облікові дані.

9. Виберіть джерело в потоці

Усі налаштування Google розташовані в Джерела → Рекламний кабінет → Google: власний OAuth-застосунок, вибір акаунта, дії конверсій, браузерні мітки, витрати та журнал надсилань. У потоці вибирається лише це джерело. Окремого Google-підключення й окремих номерів дій потік не має.

Для іншого Google-акаунта або інших дій конверсій створіть ще одне джерело й виберіть його в потрібному потоці. Зміни джерела діють для всіх потоків, що його вибрали. Браузерний тег і серверні постбеки використовують вибране джерело. Якщо воно змінилося до надсилання конверсії з черги, попереднє надсилання зупиняється з google_connection_changed.

10. Простежте шлях серверної конверсії

1. Рекламне відвідування зберігається зі справжнім ідентифікатором кліку Google та внутрішнім ідентифікатором кліку ArtisanClo.
2. Ваш сайт або мережа повідомляє про лід/продаж через налаштований приймач конверсій, повертаючи ідентифікатор кліку ArtisanClo.
3. Усі налаштування Google розташовані в Джерела → Рекламний кабінет → Google: власний OAuth-застосунок, вибір акаунта, дії конверсій, браузерні мітки, витрати та журнал надсилань. У потоці вибирається лише це джерело. Окремого Google-підключення й окремих номерів дій потік не має.
4. Сервер використовує чинний OAuth-токен вашого застосунку для виклику Data Manager API з вашим акаунтом і дією.
5. Результат записується в історію відправок. Google окремо обробляє подію та визначає її атрибуцію.

Запит містить ідентифікатор кліку Google, час події, цінність конверсії в USD та ідентифікатор події для захисту від дублікатів. Цінність береться з виплати конверсії, записаної в ArtisanClo, а не з рекламних витрат. Серверна відправка не чекає ранкового імпорту витрат.

Пара «конверсія/статус» відправляється один раз. Перехід із ліда в продаж може відправити дві окремі дії. Статуси hold, rejected і trash через це зіставлення не надсилаються. Відхилення раніше відправленого ліда не відкликає автоматично його конверсію Google. Повторна передача зміненої суми в тому самому статусі не є коригуванням цінності в Google Ads.

11. Браузерні події з ID і мітками Google

За ввімкненого Google Ads API та вибраного акаунта натисніть «Налаштувати мітки з Google» у браузерному блоці джерела. Кнопка створює або використовує дії сайту AC — Offer visit та AC — Form lead і отримує їхні ID/мітки. Нові дії — додаткові цілі. Установіть JavaScript-тег ArtisanClo на сторінку: кнопка його не встановлює. Без API використовуйте ручні поля нижче.

Браузерна відправка незалежна від OAuth. Вона фіксує перехід на офер і відправку форми, поки відвідувач перебуває на сторінці; пізній постбек після його виходу вона відправити не може.

1. Встановіть JavaScript-тег ArtisanClo на сторінці та ввімкніть трекінг потоку.
2. Відкрийте потрібну конверсію сайту в Google Ads → налаштування тегу → «Use Google Tag Manager». Скопіюйте Conversion ID і Conversion label. Ця вкладка показує потрібні значення; саме використання ArtisanClo не вимагає встановлення GTM.
3. Увімкніть браузерні конверсії в джерелі. Для переходу на офер заповніть GTAG ID і GTAG Click Label, а для форми — GTAG Conversion ID і GTAG Conversion Label (Lead).
4. Або розгорніть «Вставити фрагмент події» та вставте фрагмент для одного призначення. ArtisanClo витягне ID і мітку; вставлений JavaScript не виконується.
5. Перевірте показаний AW-ID/label і збережіть. Поки функцію ввімкнено, потрібна щонайменше одна повністю заповнена подія. Щоб вимкнути всі події, вимкніть браузерний перемикач.

Наприклад, gtag('event', 'conversion', {'send_to': 'AW-12345678901/ExampleLeadLabel'}); перетворюється на збережене призначення AW-12345678901/ExampleLeadLabel. Не змішуйте два різні призначення в одному полі. ID без мітки недостатньо.

Код автоматично завантажує тег Google і повторно використовує наявну функцію gtag. На прелендингу подія офера спрацьовує при переході за посиланням на офер, а не при простому відкритті прелендингу. Перед переходом код чекає на зворотний виклик події не довше 800 мс, після чого продовжує перехід, навіть якщо Google заблокований.

Подія звичайної форми спрацьовує після вбудованої перевірки полів браузером, якщо submit не було скасовано. Це не доводить, що сервер прийняв форму. Для AJAX-форм викличте таку подію після успішної відповіді обробника форми:

document.dispatchEvent(new Event('artisanclo:lead'));

Не викликайте її лише при натисканні кнопки, невдалій перевірці або до відповіді сервера. Вона сповіщає тег Google і сама не створює конверсію в ArtisanClo. Приймання вхідних конверсій налаштуйте окремо.

Батьківський тег не може спостерігати форму в сторонньому iframe або подальші дії на зовнішньому сайті без вашого тегу. Блокувальники реклами, CSP і налаштування згоди можуть впливати на відправку. Інтеграція не перевизначає конфігурацію згоди вашого сайту.

12. Уникайте дублікатів і виберіть цілі конверсій

Не відправляйте одну браузерну дію одночасно через GTM і ArtisanClo з тим самим ID/міткою. ArtisanClo обмежує повторні події одного типу для кліку й передає Google ідентифікатор транзакції.

Серверні й браузерні події мають окремі механізми та не гарантують спільної автоматичної дедуплікації. Відправка форми в браузері й підтверджений постбек можуть відповідати різним цілям. Перевірте, які дії є основними й використовуються для оптимізації кампаній у Google Ads. Відхилення постбека не скасовує вже надіслану браузерну подію.

13. Імпортуйте витрати

1. Авторизуйте власний OAuth-застосунок для Google Ads API та перевірте доступ Cloud-проєкту до робочих акаунтів.
2. У блоці витрат рекламного кабінету джерела виберіть Google.
3. Задайте рекламний акаунт, з якого отримуватимуться витрати. Перевірте запропонований номер після автоматичного налаштування акаунта; раніше заповнений акаунт витрат автоматично не перезаписується.
4. Збережіть джерело. Витрати імпортуються за розкладом, якщо ваш тариф включає цю функцію.

Щоранку імпорт повторно читає три попередні завершені дні, щоб врахувати коригування. Це не лічильник сьогоднішніх витрат у реальному часі. Значення читаються у валюті рекламного акаунта й перераховуються в USD за доступним курсом.

Коли кілька потоків використовують одне джерело, зберігайте ідентифікатори кампаній у кліках, зазвичай через utm_campaign={campaignid} у шаблоні Google Ads. Витрати кампанії, спільної для кількох потоків, розподіляються за часткою відповідних кліків, які дійшли до оферів; якщо таких немає, враховуються всі відповідні кліки. Кампанії без відповідних кліків не розподіляються довільно: їхні номери з’являються в помилці імпорту.

Якщо джерело має лише один потік із трекінгом, цей потік отримує всі імпортовані витрати акаунта. Не сприймайте це налаштування як фільтр однієї кампанії у великому акаунті. Імпортовані значення не перезаписують витрати, введені вручну. Перевіряйте час останньої синхронізації й помилку в налаштуваннях витрат.

14. Окремо перевірте налаштування, відправку й атрибуцію

Усі налаштування Google розташовані в Джерела → Рекламний кабінет → Google: власний OAuth-застосунок, вибір акаунта, дії конверсій, браузерні мітки, витрати та журнал надсилань. У потоці вибирається лише це джерело. Окремого Google-підключення й окремих номерів дій потік не має.

Перевірка без запису. Біля заповненого серверного статусу натисніть «Зберегти й відправити перевірочну». Кнопка зберігає форму та викликає Google із validateOnly = true, перевіряючи запит без виконання конверсії. Справжня конверсія в ArtisanClo не створюється; історія відправок позначає перевірочну спробу. Довідка Google щодо validateOnly.

Усі налаштування Google розташовані в Джерела → Рекламний кабінет → Google: власний OAuth-застосунок, вибір акаунта, дії конверсій, браузерні мітки, витрати та журнал надсилань. У потоці вибирається лише це джерело. Окремого Google-підключення й окремих номерів дій потік не має.

Перевірка всього ланцюжка. У дозволеному тестовому сценарії зафіксуйте рекламний клік, перевірте його ідентифікатор Google, використайте внутрішній ідентифікатор кліку в новій конверсії, знайдіть її в ArtisanClo та перегляньте звичайну відправку в Google. Звірте призначення й результат, а згодом перевірте Google Ads. Це справжня відправка, яка може вплинути на звіти.

Перевірка браузера. Використайте Google Tag Assistant, виконайте дію та перевірте подію conversion і призначення send_to. Невдала форма не повинна викликати вашу подію успіху. Браузерні події не мають ані серверного журналу відповідей Google, ані кнопки validateOnly.

15. Читайте історію відправок

Джерело показує останні десять відправок, а не повний експорт історії. Зв’язок звичайної відправки з конверсією також доступний в історії конверсій/кліків. Для підтримки вкажіть джерело, потік, час, статус, HTTP-код, текст помилки та requestId за наявності. Не надсилайте Client Secret, токени доступу або оновлення.

16. Усунення помилок

17. Повторне підключення, відключення й перехід із JSON

Додавання Google Ads API. Увімкніть його у проєкті й джерелі, потім підключіться повторно. Збереження перемикача не розширює вже надані дозволи.

Зміна Client ID або Secret. Збереження змінених облікових даних застосунку очищає наявну авторизацію OAuth. Підключіться знову й перед зміною врахуйте всі потоки, які використовують джерело.

Зупинка лише відправки постбеків. Вимкніть серверну відправку й збережіть. Браузерні події, файли за розкладом і витрати мають окремі налаштування. Щоб припинити всю взаємодію джерела з Google, вимкніть кожну використану функцію.

Відключення доступу. Видаляє збережену OAuth-авторизацію цього джерела. Не видаляє застосунок або дії в Google Ads. Не викликає глобального відкликання в Google, яке могло б вплинути на інші джерела з тим самим застосунком клієнта. Якщо ви самі відкликаєте дозвіл у Google, перевірте всі такі джерела.

Наявний JSON-ключ сервісного акаунта клієнта. Раніше підключені джерела залишаються підтримуваними. Для переходу налаштуйте й авторизуйте власний OAuth-застосунок у джерелі. Введення OAuth Client ID вибирає шлях OAuth; не очікуйте автоматичного повернення до старого JSON-ключа, поки вхід не завершений. Успішна авторизація очищає попередній ключ серверних конверсій. Також перевірте витрати, дозвіл Ads API й кожну дію.

Файл Google Ads за розкладом. Цей незалежний варіант містить до 90 днів відповідних подій із gclid і використовує назви конверсій із налаштувань фіду. Ці назви — не ctId і не браузерні мітки. Для однакових подій виберіть один основний шлях відправки, щоб уникнути небажаного дублювання імпорту.

18. Поширені запитання

Чи можна обійтися без Google Cloud?

Так, для браузерної відправки за ID/міткою або файлу за розкладом. Автоматична серверна відправка через OAuth потребує власного Cloud-проєкту.

Чи можна обійтися без JSON?

Так. Нове підключення використовує Client ID, Client Secret і авторизацію Google, а не завантажений ключ сервісного акаунта.

Чи все автоматизовано?

За ввімкненого Google Ads API та вибраного акаунта натисніть «Налаштувати мітки з Google» у браузерному блоці джерела. Кнопка створює або використовує дії сайту AC — Offer visit та AC — Form lead і отримує їхні ID/мітки. Нові дії — додаткові цілі. Установіть JavaScript-тег ArtisanClo на сторінку: кнопка його не встановлює. Без API використовуйте ручні поля нижче.

Чи потрібен MCC ArtisanClo?

Ні. За прямого доступу власний MCC також не потрібен. Вказуйте номер керуючого акаунта лише тоді, коли цього вимагає шлях доступу.

Чи може один потік використовувати інший акаунт?

Для іншого Google-акаунта або інших дій конверсій створіть ще одне джерело й виберіть його в потрібному потоці. Зміни джерела діють для всіх потоків, що його вибрали. Браузерний тег і серверні постбеки використовують вибране джерело. Якщо воно змінилося до надсилання конверсії з черги, попереднє надсилання зупиняється з google_connection_changed.

Чи відправиться лід після виходу відвідувача?

Так, якщо надійде зіставлений постбек і виконані умови серверної відправки. Лише браузерна конфігурація цього не може.

Чому браузерної події немає в конверсіях ArtisanClo?

Тег Google не замінює приймач конверсій. Налаштуйте постбек/обробник сайту та внутрішній ідентифікатор кліку.

Чи доводить успішна перевірка атрибуцію?

Ні. Перевірте весь ланцюжок із дозволеним справжнім рекламним кліком і кінцевий результат у Google Ads.

Пов’язані розділи: джерела, трекінг потоку, вхідні конверсії, історія конверсій, звіти й витрати. Вимоги зовнішніх API звірено з документацією Google 19 жовтня 2026 року; налаштування проєкту й назви екранів уточнюйте в актуальному інтерфейсі Google.