Отслеживание конверсий

Обзор

Отслеживание конверсий отслеживает конверсии, инициированные Google через одну из наших интеграций Action Center . Это помогает поддерживать вашу интеграцию в рабочем состоянии, поскольку она может влиять на рейтинг на определенных страницах. Каждый раз, когда Google генерирует action_link , определенный URL-адрес изменяется, чтобы включить уникальный параметр запроса: rwg_token . Вы можете сохранить токен и вернуть соответствующие значения, когда пользователь завершает бронирование.

Для завершения интеграции выполните следующие действия:

1. Проанализируйте и сохраните rwg_token .
2. Анализ и сохранение информации о продавце.
3. Верните значения rwg_token и merchant_changed .
4. Протестируйте и проверьте отслеживание конверсий.

Анализ и сохранение rwg_token

Для завершения интеграции вам необходимо собрать и хранить rwg_token в течение 30 дней с момента первоначального реферала Google. Значение rwg_token представляет собой закодированную строку, содержащую метаданные о ссылке и информацию о торговце, который сгенерировал эту action_link .

Анализ токена

Когда пользователь направляется на вашу страницу бронирования, к предоставленному URL добавляется новый rwg_token . На вашей странице бронирования вам необходимо проанализировать значение токена.

В следующем примере показано, как rwg_token анализируется для отслеживания на уровне устройства через браузер.

const rwgToken = new URLSearchParams(location.search).get('rwg_token') || undefined;

Хранить токен

При сохранении rwg_token вы можете реализовать отслеживание конверсий на двух разных уровнях:

• Уровень устройства
• Уровень пользователя

Вы можете хранить токен на любом уровне, но вы обязаны хранить токен в течение 30 дней после первоначального реферала .

В следующем примере показано отслеживание конверсий на уровне устройства. Вы можете сохранить значения токенов в браузере с помощью cookie-файла первой стороны. В этом примере предполагается, что вы проанализировали значение токена в переменную. Обязательно обновите rootdomain.com своим доменом.

if (rwgToken !== undefined) {
  document.cookie =
  "_rwgToken=" + rwgToken + "; max-age=2592000; domain=rootdomain.com; path=/";
}

Каждый раз, когда Google генерирует action_link , который вы предоставили через каналы, URL-адрес изменяется, чтобы включить уникальный параметр запроса: rwg_token . Вы должны сохранить этот токен и передать его обратно как часть события конверсии.

Хранить на уровне устройства

Уровень устройства включает использование cookie-файлов браузера, локального хранилища, локального хранилища приложения или любого другого метода, который может сохранять токен в течение 30-дневного окна атрибуции. Токен хранится локально на устройстве пользователя. Таким образом, событие конверсии не может быть атрибутировано должным образом, если пользователь:

• Меняет используемое устройство.
• Очищает локальное хранилище или файлы cookie.
• Использует приватный или инкогнито-браузер.

При использовании отслеживания конверсий на уровне устройства вам необходимо повторно реализовать событие конверсии на каждом поддерживаемом устройстве, включая мобильные устройства.

Хранить на уровне пользователя

Уровень пользователя сохраняет токен в базе данных вашего приложения через серверную аналитическую систему или другие серверные системы. Токен хранится на стороне сервера. Таким образом, событие конверсии по-прежнему правильно атрибутируется после того, как пользователь снова войдет в систему.

При использовании отслеживания конверсий на уровне пользователя на основе архитектуры вашей системы вы можете реализовать событие конверсии один раз на стороне сервера и повторно использовать его на всех поддерживаемых устройствах.

Обновить токен

Когда Google направляет пользователя к тому же продавцу, существующий токен, который уже сохранен, заменяется новым токеном из последнего реферала. После замены токена 30-дневное окно атрибуции хранилища токенов сбрасывается, и любые новые конверсии для этого продавца атрибутируются к последнему токену.

Более подробную информацию см. в разделе «Требования к атрибуции конверсий» .

Анализ и сохранение информации о торговце

Когда пользователь направляется на вашу страницу бронирования, вам необходимо реализовать логику, которая может найти и захватить данные продавца. Обычно партнеры добавляют метаданные продавца или merchant_id в свои ссылки действий и используют их для идентификации и хранения информации о продавце.

Мы рекомендуем вам хранить merchant_id или выбранный идентификатор вместе с rwg_token . Когда пользователь подтверждает бронирование, вы можете обратиться к продавцу, прежде чем отправлять полный запрос на конвертацию. Подобно хранению токенов, вы должны сохранять данные продавца с токеном в течение 30 дней после первоначального направления.

Следующий пример изменяет ранее сохраненный rwg_token . Он предполагает, что вы проанализировали информацию о торговце из метаданных в предоставленном URL и либо сохранили ее как merchant_id , либо сопоставили ее с существующим merchant_id .

// Store the rwgToken and merchantId in your cookie and set the cookie
// expiration date to 30 days.
if (typeof rwgToken !== 'undefined') {
  document.cookie =
  "_rwgToken=" + rwgToken + "; _merchantId=" + merchantId + "; max-age=2592000;domain=rootdomain.com; path=/";
}

Верните значения rwg_token и merchant_changed

Когда пользователь завершает бронирование, которое начинается с реферала action_link , вам необходимо отправить HTTP POST-запрос в конечную точку конверсии. Есть две конечные точки:

• Производственная среда : https://www.google.com/maps/conversion/collect
• Песочница : https://www.google.com/maps/conversion/debug/collect

При отправке события конверсии необходимо включить сохраненный rwg_token и значение merchant_changed 1 или 2 Более подробную информацию о merchant_changed см. в разделе Возврат значения Merchant Change .

Тело POST-запроса должно представлять собой закодированный JSON-объект в формате:

{
  "conversion_partner_id": "<partnerId>",
  "rwg_token": "<rwg_token_val>",
  "merchant_changed": "1|2"
}

{
  "conversion_partner_id": "XXXXXXX",
  "rwg_token": "AJKvS9WeONmWKEwjG0--HdpzMq0yAVNL8KMxbb44QtbcxMhSx_NUud5b8PLUBFehAIxOBO-iYRIJOknEFkIJmdsofdVJ6uOweQ==",
  "merchant_changed": "2"
}

Следующий пример включает отслеживание конверсий на уровне устройства с помощью cookie-файла на устройстве пользователя, написанного на JavaScript:

const partnerId = XXXXXXXXXX;
const endpoint = `https://www.google.com/maps/conversion/collect`;

// Retrieve the value of the rwgToken stored in the browser's cookie
const match = document.cookie.match(new RegExp('(?:^| )_rwgToken=([^;]+)'));
const storedRwgToken = match ? match[1] : undefined;

// Send Conversion event with decoded token, verify any special characters
// are sent properly.
if (storedRwgToken !== undefined) {
  fetch(endpoint, {
    method: "POST",
    body: JSON.stringify({
      conversion_partner_id: partnerId,
      rwg_token: decodeURIComponent(storedRwgToken),
      merchant_changed: merchantChanged
    })
  });
}

Возврат стоимости изменения торговца

Значение merchant_changed используется для определения того, был ли изменен продавец с первоначального продавца перенаправления. Смена продавцов является обычным явлением, если ваша целевая страница находится на платформе, которая включает других продавцов. В этом случае, если пользователь перешел на вашу платформу с помощью Google и решил перейти к другому продавцу, чтобы завершить бронирование, вам необходимо знать, что конверсия произошла с отдельным продавцом. Вы можете использовать логическое значение для определения смены продавца, но не деталей продавца.

Когда вы решаете, какое значение присвоить merchant_changed , вам нужно взять исходного продавца, сохраненного в Parse and Store the Merchant Information . Проверьте, изменился ли продавец, и присвойте значение в соответствии с вашими требованиями.

• Требование : когда пользователь покидает сайт исходного продавца и совершает покупку через вашу платформу у другого продавца.
  • Изменение стоимости продавца : 1
• Требование : когда пользователь завершает транзакцию через первоначального продавца.
  • Изменение стоимости продавца : 2

Тестирование и проверка отслеживания конверсий

В следующих тестовых случаях используются тестовые токены, предоставленные в разделе Тестовые токены , и они призваны помочь вам пройти через все различные сценарии, которые могут привести к событию конверсии. Это гарантирует, что токен хранится надлежащим образом, значение merchant_changed установлено правильно, а событие конверсии отправляется, когда это необходимо.

Используйте ссылку действия или URL-адреса страницы бронирования, предоставленные в ваших фидах, и запускайте каждый тестовый случай, добавляя тестовые токены в конец URL-адреса. Обязательно используйте приватное или инкогнито-окно браузера — это очистит все существующие токены, связанные с текущим пользователем, и даст вам чистый лист для работы.

Если у вас есть платформа, на которой пользователи могут оформлять заказы у разных продавцов, протестируйте следующее.

Во время тестирования отправьте запрос HTTP POST в конечную точку преобразования. Есть две конечные точки:

• Производственная среда: https://www.google.com/maps/conversion/collect
• Песочница: https://www.google.com/maps/conversion/debug/collect

Тестовые токены

Чтобы протестировать отслеживание конверсий, добавьте один из следующих тестовых токенов в конец ссылок действий или URL-адресов страниц бронирования, которые вы указываете в своих фидах.

Токен А:

rwg_token=AJKvS9WeONmWKEwjG0--HdpzMq0yAVNL8KMxbb44QtbcxMhSx_NUud5b8PLUBFehAIxOBO-iYRIJOknEFkIJmdsofdVJ6uOweQ%3D%3D

Токен B:

rwg_token=AJKvS9U2QfiQanHFQrlJxBjD0AyFany3qpaJVEWOcY4nHqY_UkLYFFDj6RIa-EXS1iEmV8gtFPG6v1cU1jnusJK66ijXXnaqkQ%3D%3D

Токен C:

rwg_token=AJKvS9VwInjZ_hGZPvBz0COVWJ5oFDzocFt9hGi7TMurlo2l71uiXP48PspPUMmRnqCUDE1mF_A5H_dMV78cBTF8jIfSQK6lEA%3D%3D

При отправке успешных событий конверсии вы можете увидеть их обобщенные данные в Центре действий на панели отслеживания конверсий.

Требования к атрибуции конверсий

Требуемый стандарт Google для атрибуции конверсий — 30-дневное окно атрибуции для любого взаимодействия со ссылкой на действие места в любом магазине.

Это окно атрибуции означает, что Google может ожидать отправки события конверсии в любом из следующих сценариев:

• Пользователь переходит по ссылке действия места и размещает заказ у того же продавца в том же сеансе. Значение изменения продавца = 2.
• Пользователь переходит по ссылке действия места, а затем возвращается с другого канала в течение 30-дневного окна атрибуции, чтобы разместить заказ у того же продавца. Значение изменения продавца = 2.
• Пользователь переходит по ссылке действия места, а затем размещает заказ в другом магазине, либо в том же сеансе, либо в другом сеансе в течение 30-дневного окна атрибуции. Значение изменения продавца = 1.

Кроме того, Google ожидает отправлять события конверсии с любого устройства, к которому пользователь может получить доступ через ссылку действия места. Эти устройства включают:

• Настольные или мобильные веб-приложения.
• Мобильные приложения, доступные либо через глубокую ссылку на приложение, либо через зарегистрированное намерение приложения для вашего домена.

Если токен хранится на уровне пользователя, ожидается, что вы предоставите кросс-девайсную атрибуцию. Для получения дополнительной информации см. раздел Хранение на уровне пользователя . В этом случае пользователь, который следует по ссылке действия с рабочего стола, а затем завершает транзакцию на мобильном устройстве с той же учетной записью пользователя, должен инициировать событие конверсии.

Если токен хранится исключительно на уровне устройства, например, в файлах cookie браузера, не ожидается, что вы предоставите кросс-девайсную атрибуцию. В этом случае каждое устройство может иметь отдельный сохраненный токен, если пользователь переходит по ссылке действия на этом устройстве, и каждое устройство может следовать правилам атрибуции отдельно.