Эта страница переведена с помощью 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 анализируется для отслеживания местоположения устройства через браузер.

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

Обновление в реальном времени