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

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

Обзор

Отслеживание конверсий позволяет контролировать конверсии, инициированные Google через одну из наших интеграций с Action Center . Это помогает поддерживать работоспособность вашей интеграции, поскольку может влиять на ранжирование определенных страниц. Каждый раз, когда 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 анализируется для отслеживания местоположения устройства через браузер.

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 , предоставленную вами через RSS-ленту, 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 см. в разделе «Возвращение значения изменения цены продавцом» .

Тело 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 и решает перейти к другому продавцу для завершения бронирования, вам необходимо знать, что конверсия произошла с другим продавцом. Вы можете использовать логическое значение (Boolean) для идентификации смены продавца, но не для получения подробной информации о продавце.

При определении значения для параметра merchant_changed необходимо взять исходные данные о продавце, сохраненные в Parse, и сохранить информацию о продавце . Проверьте, изменился ли продавец, и присвойте значение в соответствии с вашими требованиями.

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

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

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

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

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

Токен 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 браузера, то предоставление межустройственной атрибуции не требуется. В этом случае для каждого устройства может быть сохранен отдельный токен, если пользователь переходит по ссылке на этом устройстве, и для каждого устройства могут применяться правила атрибуции отдельно.