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

Примечание. Отслеживание конверсий было обновлено 2 февраля 2024 г. Если у вас есть вопросы относительно изменений, обратитесь к представителю Google.

Рисунок 1. Обзор отслеживания конверсий

Краткое содержание

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

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

1. Соберите и сохраните rwg_token .
2. Соберите и сохраните торговца.
3. Верните значения rwg_token и merchant_change .
4. Тестируйте и проверяйте отслеживание конверсий.

Соберите и сохраните rwg_token .

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

Коллекция токенов

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

var query = location.search.substring(1);
var params = query.split('&');
var rwgToken = undefined;
for (var i = 0; i < params.length; ++i) {
  var pair = params[i].split('=');
  if (pair[0] == 'rwg_token') {
    rwgToken = decodeURIComponent(pair[1]);
    break;
  }
}

Параметр запроса, добавленный к вашему URL-адресу, будет зашифрованным токеном, см. следующий пример rwg_token . Используйте этот образец токена, чтобы убедиться в правильности его анализа, включая любые специальные символы, такие как «=". Ниже приведен пример того, как будет выглядеть типичный токен.

AJKvS9WeONmWKEwjG0--HdpzMq0yAVNL8KMxbb44QtbcxMhSx_NUud5b8PLUBFehAIxOBO-iYRIJOknEFkIJmdsofdVJ6uOweQ==

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

При хранении rwg_token существует два разных уровня, на которых вы можете реализовать отслеживание конверсий: уровень устройства и уровень пользователя. Где вы решите хранить токен, это ваше решение, но вы должны хранить токен в течение 30 дней с момента первоначального направления .

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

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

if (typeof rwg_token !== 'undefined') {
  document.cookie =
  "_rwg_token=" + rwg_token + ";max-age=2592000;domain=rootdomain.com;path=/";
}

Принимая решение о том, где хранить rwg_token , учтите следующее.

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

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

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

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

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

Соберите и сохраните торговца.

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

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

if (typeof rwg_token !== 'undefined') {
  document.cookie =
  "_rwg_token=" + rwg_token + ";_merchant_id=" + merchantid + ";max-age=2592000;domain=rootdomain.com;path=/";
}

Верните значения rwg_token и merchant_change .

Когда использование завершает бронирование, начатое по рефералу Action Link, вы должны отправить HTTP-запрос POST в конечную точку конверсии. Существует две конечные точки: одна для производственной среды и одна для изолированной среды.

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

При отправке события конверсии вы должны включить сохраненный rwg_token и значение merchant_change 1 или 2 Более подробную информацию о 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`;

const rwgTokenCookie = document.cookie
  .split('; ')
  .find(row => row.startsWith('_rwg_token='));

if (typeof rwgTokenCookie !== 'undefined') {
  const rwgTokenVal = rwgTokenCookie.split('=')[1];
  fetch(endpoint, {
    method: "POST",
    body: JSON.stringify({
      conversion_partner_id: partnerId,
      rwg_token: rwgTokenVal,
      merchant_changed: merchantChanged
    })
  });
}

Внимание: единственным допустимым типом контента MIME является text/plain . Не указывайте Content-Type в заголовке. Если вы это сделаете, вы получите ошибку CORS.

Предупреждение. Убедитесь, что в составе данных о конверсиях в Google не отправляется личная идентификационная информация пользователя (PII).

Примечание. В рабочей среде не следует отправлять события-конверсии, не связанные с этой интеграцией. Перед отправкой события рекомендуется проверить действительное и неистекшее значение rwg_token .

Возврат значения изменения продавца

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

При принятии решения о том, какое значение назначить merchant_change , вам нужно будет взять исходного продавца, сохраненного в разделе «Собрать и сохранить продавца» , и проверить, не изменился ли продавец, а затем обратиться к следующей таблице при назначении значения.

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

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

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

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

1. Завершите бронирование, просто используя ссылку действия.
   • Прямые бронирования без рефералов или ранее сохраненных токенов не должны приводить к отправке каких-либо запросов в Google.
2. Завершите бронирование, используя ссылку с добавленным rwg_token .
   • Убедитесь, что запрос успешен и отправлен со значением rwg_token и merchant_change равным 2
   • Убедитесь, что вы храните rwg_token в течение 30 дней.
3. Завершите новое бронирование у того же продавца, используя новый rwg_token .
   • Убедитесь, что запрос успешен и отправлен с новым rwg_token и значением merchant_change равным 2
   • Убедитесь, что окно хранения атрибуции токена обновляется в течение 30 дней.
4. Перейдите непосредственно на страницу бронирования продавца, которого вы тестировали, и сделайте новое бронирование без добавленного rwg_token .
   • Убедитесь, что запрос отправлен с ранее сохраненным rwg_token , а значение merchant_change равно 2

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

1. Перейдите на страницу бронирования продавца, используя ссылку с добавленным rwg_token , затем перейдите к другому продавцу и сделайте заказ.
   • Убедитесь, что запрос отправлен со значением rwg_token и merchant_change равным 1

При тестировании отправьте запрос 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

Используйте следующий токен для тестов, требующих дополнительных токенов.

rwg_token=AJKvS9U2QfiQanHFQrlJxBjD0AyFany3qpaJVEWOcY4nHqY_UkLYFFDj6RIa-EXS1iEmV8gtFPG6v1cU1jnusJK66ijXXnaqkQ%3D%3D

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

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

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

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

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

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

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

Если токен хранится на уровне пользователя (см. раздел «Сохранение токена»), ожидается, что вы обеспечите атрибуцию между устройствами. То есть пользователь, который переходит по ссылке действия с рабочего стола, а затем завершает транзакцию на мобильном устройстве (используя ту же учетную запись пользователя), должен инициировать событие конверсии.

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

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