Як налаштувати надсилання даних лід-форм Google Ads до Telegram або на пошту

Лід-форми в Google Ads

Лід-форма (або форма для потенційних клієнтів) – це розширення в Google Ads, за допомогою якого можна збирати контактні дані користувачів, зазначені в полях форми. На даний момент форми можна додати до кампанії пошукової мережі, відеокампанії, а також кампанії Discovery.

Як отримати дані форм Google Ads

Отримати дані клієнта з форм можна двома способами:

• Скачування даних форм у вигляді CSV-файлу (завантажувати інформацію потрібно часто, оскільки вона зберігається лише 30 днів).
• Налаштування інтеграції вебхука, яка дозволить відправити дані користувачів з форм у CRM-систему в режимі реального часу.

Налаштувати інтеграцію форм Google Ads і CRM можна самостійно (із залученням програміста) або ж скористатися готовими конекторами, наприклад, Zapier.

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

Принцип роботи скрипту

У момент заповнення форми Google Ads дані можуть бути надіслані за допомогою вебхука.

Вебхук – це механізм отримання оповіщень про події, що відбуваються за допомогою функцій зворотних викликів. Коли відбувається подія в системі, сервер відправляє HTTP-запит на URL-адресу, надану користувачем для прийому веб-хуків. На базі Google Apps Scripts можна створити програму, публічний URL якої буде використовуватися для налаштування вебхука.

У Google Apps Scripts є зарезервований метод doPost(), який відповідає за отримання значень, що надсилаються за допомогою запитів POST. Цей метод приймає об’єкт e, за допомогою якого можна отримати доступ до даних у форматі JSON.

Структура цих даних містить колекцію значень user_column_data, що включає дані полів, які були заповнені. У скрипті ця інформація наводиться до зручного вигляду для наступного виведення таблиці та відправки в Telegram чи на пошту. Також для зручності я фіксую дату відправки заявки та ID форми у Google Ads.

Інформація про заповнену форму відправляється:

• на пошту за допомогою класу MailApp,
• у Telegram за допомогою бота через api-метод sendMessage().

Повний перелік доступних для передачі полів можна знайти тут.

Як налаштувати надсилання даних форм для потенційних клієнтів з Google Ads до Google Spreadsheets

1. Створення таблиці
На Google Drive потрібно створити нову таблицю. Аркуш у таблиці назвати Leads.
Приклад таблиці

2. Створення проєкту у Google Apps Script
Перейдіть на сторінку https://script.google.com/home та додайте новий проєкт.

У вікні редактора коду вставте код скрипта.

Дайте проєкту назву.

3. Адаптація коду під себе

3.1 Замінити значення tableId та googleKey.

tableId – це ідентифікатор таблиці. Його можна взяти з URL-адреси.
Наприклад, для таблиці
https://docs.google.com/spreadsheets/d/1r2zV45HuRXoYz2Y7PpnhT01NnE3mXyvEgF0UAJJmS7I/edit#gid=0
значення буде:
tableId = "1r2zV45HuRXoYz2Y7PpnhT01NnE3mXyvEgF0UAJJmS7I"

googleKey – ключ, який ви вигадуєте самостійно (як пароль).
Наприклад: googleKey = "kjhegf79aS"

3.2 Додати свою email-адресу.
Це потрібно для надсилання даних з форми безпосередньо на пошту.

3.3 Створити бота Telegram для надсилання даних у Telegram

Для створення бота потрібно написати користувачеві @BotFather і виконати кілька дій відповідно до його інструкцій.
Бот видасть токен для авторизації:

Це значення підставте в змінну telegramToken.

Для налаштування надсилання повідомлень нам також потрібно вказати свій ID в Telegram.
Щоб дізнатися свій ID, напишіть боту @my_id_bot.
Отриманий ідентифікатор додайте до змінної telegramId.

4. Збереження та розгортання скрипту

Далі зберігаємо зміни у коді:

Натискаємо Deploy → New deployment:

Вибираємо спосіб розгортання скрипту як веб-додатку:

У полі Description потрібно вказати назву версії програми.
У полі Who has access вибираємо Anyone.
Потім натискаємо Deploy.

При першому запуску знадобиться авторизація за допомогою облікового запису Gmail:

Після авторизації з’явиться вікно, що містить згенеровану URL-адресу:

Отримана URL-адреса буде URL-адресою, вказаною для вебхука.

⚠️ Після будь-якої зміни вже розгорнутого скрипту необхідно присвоїти змінам нову версію та опублікувати її (повторити крок 4).

Як протестувати роботу скрипту

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

Тут потрібно вказати:

• URL вебхука (отриманий на попередньому кроці):
  https://script.google.com/macros/s/AKfycbwVJW4OOd7XsavBIY7SMENi286CJxWGhRELuUcAjgyewHlKBhVvLC4m/exec
• значення ключа (googleKey).

Після вказівки вебхука та ключа з’явиться можливість надсилати тестові дані:

Після відправки з’явиться повідомлення, при натисканні на яке можна подивитися, які саме дані були надіслані:

У таблиці з’явиться запис про новий лід:

На пошту буде надіслано лист:

І прийде повідомлення від бота Telegram:

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

Відеоінструкція: