Google Ads

В Google Ads метки передаются через ValueTrack, а клик идентифицируется параметром gclid. Telegfy сохраняет gclid в клике и умеет отправлять офлайн-конверсии в Google Ads, но только если у клика есть gclid.

Сверьте с документацией Google

Макросы ValueTrack взяты из справки Google Ads. Ограничения по типам кампаний тоже из справки. Перед запуском проверьте их в документации Google Ads, особенно для Performance Max и Demand Gen.

Макросы ValueTrack

Макрос	Что подставляется	Ограничения
{campaignid}	ID кампании	Поддерживается везде
{adgroupid}	ID группы объявлений	Не работает в Performance Max
{creative}	ID объявления	Не работает в Performance Max
{keyword}	Ключевое слово	Пусто для кампаний без ключевых слов
{matchtype}	Тип соответствия: e, p, b, a
{network}	Сеть: g (Поиск), s, d, ytv и др.	Не работает в Demand Gen
{device}	Устройство: m, t, c
{placement}	Сайт клика (Display)	Не работает в Demand Gen
{gclid}	ID клика Google	Добавляется при автопометке

Полный список макросов и их условий — в справке Google. Ограничения по Performance Max и Demand Gen заметно сужают набор.

Ссылка в Telegfy

Ссылка создаётся в «Мои ссылки» → «Создать ссылку». Выберите источник трафика Google Ads в поле «Источник трафика», если он заведён.

1. Целевой URL: адрес оффера или лендинга.
2. Источник трафика.

Шаги

1. Включите автопометку.

   В настройках аккаунта Google Ads включите «Автоматическую пометку» (auto-tagging). Тогда Google добавляет gclid к адресу каждого клика. Без неё gclid не придёт, и офлайн-конверсии не отправятся.

2. Задайте финальный URL.

   В объявлении в поле «Финальный URL» укажите короткую ссылку Telegfy, а метки добавьте как параметры:

   https://<домен>/<код>?sub_id_1={campaignid}&sub_id_2={adgroupid}&sub_id_3={creative}&sub_id_4={keyword}&sub_id_5={matchtype}&sub_id_6={network}&sub_id_7={device}

   Для Performance Max уберите {adgroupid}, {creative} и {keyword}. Эти макросы там не поддерживаются.

3. Проверьте клик.

   Откройте ссылку по объявлению (или через предпросмотр) и убедитесь, что клик появился в Telegfy. В журнале кликов (Pro) sub_id_1 содержит ID кампании.

4. Настройте офлайн-конверсии (по желанию).

   В Google Ads создайте действие конверсии типа «Импорт». В Telegfy откройте «CAPI-интеграции» → Google Ads и укажите Customer ID, Conversion Action ID, Developer Token, OAuth Client ID, Client Secret и Refresh Token. Login Customer ID нужен, если аккаунт управляется через MCC.

   Затем укажите статусы, которые нужно отправлять. Статус без сопоставления не отправляется.

Что отправляется в Google Ads

• Конверсия уходит только для клика с gclid. Если gclid нет, конверсия пропускается, а не отправляется с нашим внутренним ID.
• Access token Telegfy получает сам по refresh token. Вручную обновлять его не нужно.
• Интеграция не проверялась на боевом API. Перед запуском проверьте, что офлайн-конверсия появилась в Google Ads.

Частые ошибки

• Нет gclid в клике. Автопометка выключена или финальный URL потерял параметр. Проверьте оба.
• Метки пустые в Performance Max. Часть макросов там не поддерживается, см. таблицу.
• Google отклоняет конверсию. Действие конверсии не типа «Импорт», либо refresh token устарел или выдан для другого OAuth-приложения.
• Конверсия не отправилась. Проверьте маппинг статусов и то, что у клика есть gclid.

Что читать дальше

• Conversion API — подробнее о провайдерах и полях.
• Кампании и ссылки — как устроены sub_id.
• Facebook Ads и TikTok Ads — та же схема для других площадок.