Автоматизированная проверка транзакций и позиций корзины

Вы тут:
Приблизительное время чтения: 1 мин

Обзор

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

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

Два автоматических варианта проверки

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


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

Создание запросов CAD

Начиная

Домен

Запрос САПР имеет следующую базовую структуру:

https://[tracking_domain]/ts/[external_advertiser_ID]/tsa?typ=d

Как вы, наверное, заметили. Вместо этого вам необходимо использовать домен отслеживания.

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

Безопасность

Обратите внимание, что, хотя разрешены оба как защищенные, так и необеспеченные протоколы, рекомендуется использовать защищенный протокол (https). Кроме того, убедитесь, что запросы CAD отправляются через сервер, а не через браузер.

Формат

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

Параметры данных для транзакций

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

 Имя параметра Объяснение Обязательное Соответствующее поле в файле экспорта  Пример
Tst Временная метка UNIX вашего запроса будет автоматически заполнена. Да n/a 1429018671
Trc Категория продукта транзакции.  Да conversion_product

_category_label

корзина
Ctg Конверсионная цель транзакции. конверсией. Да conversion_target

_label

продажа
 Cid Идентификатор заказа транзакции. Да conversion_id  1234567asd
 Cfs  Состояние преобразования. Возможные значения: cnf (подтверждено), rjt (отклонено) и opn (открыто).  Да conversion_status cnf
Cfd  Время и дата, на которые была проверена конверсия. Обратите внимание, что формат файла экспорта (yyyy-mm-dd hh: mm: ss) должен быть закодирован в URL.  Нет   2015-04-14 15:37:51  2015-04-14% 2015% 3A37% 3A51
Ovn Новое значение заказа транзакции. Используйте этот параметр только в том случае, если вы хотите настроить значение порядка.  Нет  conversion_order

_value

 25.45
 Ctp  Тип комиссии, который должен быть отнесен к рекламному пространству, согласно модели комиссии примененной к транзакции. Возможные значения: fix или percent. Используйте этот параметр только в том случае, если вы хотите настроить комиссию. Нет  conversion_commis

sion_type

 percent
 Crt Новая комиссия за транзакцию. Используйте этот параметр только в том случае, если вы хотите настроить комиссию. Нет conversion_commis

sion_rate

 2.5
Unqid Уникальный идентификатор, идентифицирующий транзакцию, используемую для целей безопасности. Да conversion_uniqid 14e31669-6940-2204-8004-8340696916e3
 Сre Вы можете использовать этот параметр, чтобы объяснить причину почему транзакция была отменена.  Нет conversion_reason

_canceled

 Order%20was

%20canceled.

Mkey Магический ключ идентифицирует процесс пользователя автоматической проверки, делая процесс прозрачным и безопасным.  Да  n / a 0b539c09-e0de-42c6-9b9c-f4a42d92d389

Для получения дополнительной информации о волшебном ключе, пожалуйста, прочитайте эту статью.

Пример запроса CAD для транзакций

Если вы реализуете параметры данных (включая необязательные), запросы CAD для транзакций будут выглядеть примерно так:

https://marketing.net.yourdomain.com/ts/i1234567/tsa?typ=d&tst=1429018671&trc=basket&ctg=sale&cid=1234567asd&cfs=cnf&cfd=2015-04-14%2015%3A37%3A51&ovn=20.00&ctp=percent&crt=5.00&unqid=4e31885-6940-2204-8784-8340696916e3&cre=Order%20was%20canceled&mkey=0b539c09-e0de-42c6-9b9c-f4a42d92d389

Параметры данных для позиций корзины

 Имя параметра Описание Обязательное поле  Соответствие в файле экспорта Пример
Tst Временная метка UNIX вашего запроса. Обратите внимание, что значение будет заполнено автоматически.  Да  n/a
 Trc Категория отслеживания транзакции, к которой принадлежит позиция корзины. Обратите внимание, что категория отслеживания всегда должна быть корзиной.  Да conversion_product

_category_label

корзина
 Ctg Цель конвертации транзакции, к которой принадлежит позиция корзины. Да  conversion_target

_label

newSale
 Cid Идентификатор заказа транзакции, к которой принадлежит позиция корзины. Да  conversion_id 1234567asd
Unqid Уникальный идентификатор, идентифицирующий транзакцию, используемый для целей безопасности. Да conversion_uniqid  14e31669-6940-2204-8004-8340696916e3
 Mkey Магический ключ идентифицирует пользователя, обрабатывающего автоматическую проверку, делая процесс прозрачным и безопасным. Да n/a 0b539c09-e0de-42c6-9b9c-f4a42d92d389
 Bsknew Этот параметр содержит все данные о позиции корзины в формате JSON (кодирование URL), включая статус корзины, который необходимо скорректировать для процесса проверки.  Да n/a

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

Пример запроса САПР для позиций корзины

Если вы реализуете все параметры, упомянутые выше, ваш запрос CAD для позиций корзины будет выглядеть примерно так:

https://marketing.net.yourdomain.com/ts/i1234567/tsa?typ=d&tst=1429018671&trc=basket&ctg=sale&cid=1234567asd&unqid=
4e31669-6940-8905-8004-8340696916e3&bsknew=%5B%7B%22price%22%3A%22182%22%2C%22
quantity%22%3A%220%22%2C%22commissionFix%22%3A%220%22%2C%22commission
Percent%22%3A%2211%22%2C%22categoryId%22%3A%223682%22%2C%22productId
%22%3A%22MA339HL84SEDLMX893765%22%2C%22productNumber%22%3A%22Green
%20Hoover%20vacuum%20cleaner%22%2C%22positionId%22%3A%221%22%2C%22
status%22%3A%221%22%7D%5D%0A%0A&mkey=0b539c09-e0de-42c6
-9b9c-f4a42d92d389

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

Метки:
Эта статья была полезна?
Бесполезно 0
Читали: 229

Добавить комментарий

Ваш e-mail не будет опубликован.