Обзор
В этой статье объясняется, как можно полностью автоматизировать процесс проверки, используя так называемые запросы CAD (преобразование дополнительных данных). Через запрос CAD вы связываетесь со своим хранилищем данных на платформе, был ли заказ отменен или подтвержден, и были ли внесены какие-либо изменения в значение заказа.
Существует два варианта автоматизации проверки с помощью запросов САПР. Какой вариант вы используете, зависит от того, можете ли вы создавать уникальные идентификаторы на страницах подтверждения на веб-сайте вашего рекламодателя.
Два автоматических варианта проверки
Первым параметром автоматической проверки является соответствующий идентификатор на странице подтверждения на веб-сайте рекламодателя. В этом случае вы автоматически экспортируете транзакции или позиции корзины с платформы. Как вы это делаете, описано в этой статье. Данные, которые вы экспортируете, нужно сравнивать с информацией в вашем хранилище данных.
Впоследствии вы настраиваете статус транзакций и позиции корзины на платформе с помощью запросов CAD. В случае частичной отмены вы также отрегулируете значение заказа или, когда будете работать с позициями корзины, значение идентификатора position.
Второй вариант актуален Когда вы и ваш рекламодатель способны генерировать уникальные идентификаторы на странице подтверждения сайта рекламодателя. В этом случае вы просто отправляете запрос CAD, когда у вас есть соответствующая информация о транзакциях или позициях корзины, доступных в вашем хранилище данных. Позиция транзакции и позиция корзины будут идентифицированы с использованием уникального идентификатора, переданного при их первоначальном отслеживании.
Создание запросов CAD
Начиная
Домен
Запрос САПР имеет следующую базовую структуру:
Как вы, наверное, заметили. Вместо этого вам необходимо использовать домен отслеживания.
Если вы используете несколько доменов отслеживания на своей платформе, убедитесь, что вы используете домен отслеживания рекламодателя, на который вы проверяете транзакции или позиции корзины.
Безопасность
Обратите внимание, что, хотя разрешены оба как защищенные, так и необеспеченные протоколы, рекомендуется использовать защищенный протокол (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 для транзакций будут выглядеть примерно так:
Параметры данных для позиций корзины
| Имя параметра | Описание | Обязательное поле | Соответствие в файле экспорта | Пример |
| 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 для позиций корзины будет выглядеть примерно так:
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
Обратите внимание, что этот пример содержит только одну позицию корзины. Во многих случаях вы обнаружите, что транзакция содержит несколько позиций корзины, представляющих все разные товары, заказанные клиентом. Для получения дополнительной информации, пожалуйста, прочитайте эту статью.
Добавить комментарий