Эта страница переведена с помощью Cloud Translation API.

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

Обзор

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

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

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

Разобрать и сохранить `rwg_token`

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

Разобрать токен

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

В следующем примере показано, как 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 дней после первоначального реферала .

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

if (typeof rwg_token !== 'undefined') {
  document.cookie =
  "_rwg_token=" + rwg_token + ";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 .

if (typeof rwg_token !== 'undefined') {
  document.cookie =
  "_rwg_token=" + rwg_token + ";_merchant_id=" + 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 см. в разделе Возврат значения изменения продавца .

Тело 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
    })
  });
}

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

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

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

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

Протестируйте и проверьте отслеживание конверсий

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

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

Тестовый пример	Описание теста	Пользовательский поток	Ожидаемый результат
1	Пользователь оформляет бронирование, инициированное не Google.	Пользователь переходит непосредственно на страницу бронирования без ссылки со стороны Google или без существующего направления. Это не должно приводить к каким-либо событиям конверсии.	Нет события-конверсии , поскольку пользователь ранее не посещал страницу бронирования или не был перенаправлен Google.
2	Пользователь завершает бронирование, созданное в Google.	Пользователь находит вашего продавца через Google, попадает на вашу страницу бронирования и завершает бронирование.	Событие конверсии будет отправлено с токеном A и измененным значением продавца 2 , поскольку Google перенаправил пользователя на страницу бронирования.
3	Пользователь (из Google) начинает процесс бронирования, но прекращает сеанс до завершения бронирования. Примечание. Оставьте этот сеанс открытым для тестов 4 и 5.	Пользователь перенаправляется на вашу страницу бронирования, но сеанс завершается, и он не завершает бронирование.	Конверсии нет , поскольку пользователь не завершил бронирование, но токен B должен храниться в течение 30 дней.
4	Пользователь возвращается на страницу бронирования, не входя в Google, и завершает бронирование. Примечание. URL-адрес потока бронирования не должен содержать rwg_token.	Пользователь возвращается на страницу бронирования после теста №4 . Токен B следует хранить в течение 30 дней, и любая конверсия в течение этих 30 дней должна возвращать событие конверсии.	Событие конверсии будет отправлено с токеном B и измененным значением продавца 2 , поскольку пользователь возвращается на страницу бронирования после предыдущего перехода от Google.
5	Пользователь оформляет новое бронирование от Google после теста №4 .	Если пользователь возвращается на вашу страницу бронирования, используя реферал Google после предыдущего реферала Google, его 30-дневное окно хранения сбрасывается, и новый токен C заменяет старый токен B. Все будущие конверсии будут привязаны к токену C.	Событие конверсии будет отправлено с токеном C и измененным продавцом значением 2, поскольку пользователь завершил бронирование, а новый токен заменил ранее сохраненный токен.

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

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

Тестовый пример	Описание теста	Пользовательский поток	Ожидаемый результат
6	Google направляет пользователя на вашу страницу бронирования и оформляет бронирование у другого продавца.	Google направляет пользователя на вашу страницу бронирования, используется токен A , но перед завершением бронирования он переходит на другую страницу и завершает бронирование у продавца, который отличается от исходного реферала.	Событие конверсии будет отправлено, потому что пользователь завершил бронирование, инициированное рефералом от Google с токеном A и измененным продавцом значением 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

Токен С:

rwg_token=AJKvS9VwInjZ_hGZPvBz0COVWJ5oFDzocFt9hGi7TMurlo2l71uiXP48PspPUMmRnqCUDE1mF_A5H_dMV78cBTF8jIfSQK6lEA%3D%3D

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

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

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

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

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

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

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

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

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

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