Обзор
В этой статье мы обсудим, как вы можете создать автоматический экспорт транзакций на основе файла экспорта. Обратите внимание, что есть три разных типа файлов, которые вы можете экспортировать:
- Полный файл экспорта, содержащий все данные, относящиеся к транзакциям.
- Ограниченный файл экспорта, содержащий только данные транзакции, относящиеся к процессу проверки. Если вы не применяете отслеживание корзины, этот файл следует использовать для проверки.
- Файл экспорта, содержащий все позиции корзины, связанные с транзакциями. Когда вы применяете отслеживание корзины, этот файл следует использовать для целей проверки.
Чтобы автоматизировать процесс проверки, вам нужно будет сравнить файл экспорта с хранилищем данных вашего рекламодателя и затем снова импортировать транзакции или позиции корзины. Чтобы узнать, как сделать этот последний шаг, прочитайте эту статью.
Создание URL-адресов экспорта
Экспорт URL для транзакций
Имя URL-адреса экспорта для транзакций — «adm-control». Следуйте инструкциям по созданию URL-адреса экспорта в статье об автоматическом экспорте. Если вы это сделаете, и вы добавите некоторые фильтры, ваш URL-адрес экспорта для транзакций будет выглядеть примерно так:
https://export.net.yourdomain.com/f0d58125-5489-4ac3-84b2-0417a3a85f65/adm-controlling_123.
csv?filter[a:advertiser_program_id]=456&filter[from_date]=01.06.2014&filter[to_date]
=27.08.2014
csv?filter[a:advertiser_program_id]=456&filter[from_date]=01.06.2014&filter[to_date]
=27.08.2014
Экспорт URL для транзакций (данные проверки)
Имя URL-адреса экспорта для транзакций — «adm-controlv». Следуйте инструкциям по созданию URL-адреса экспорта в статье об автоматическом экспорте. Если вы это сделаете, и вы добавите некоторые фильтры, ваш URL-адрес экспорта для транзакций будет выглядеть примерно так:
https://export.net.yourdomain.com/f0d58125-5489-4ac3-84b2-0417a3a85f65/adm-controllingv_123.
csv?filter[a:advertiser_program_id]=456&filter[from_date]=01.06.2014&filter[to_date]
=27.08.2014
csv?filter[a:advertiser_program_id]=456&filter[from_date]=01.06.2014&filter[to_date]
=27.08.2014
URL экспорта для позиций корзины
Имя URL-адреса экспорта для позиций корзины — это «adm-basketexport». Следуйте инструкциям по созданию URL-адреса экспорта в статье об автоматическом экспорте. Если вы это сделаете и вы добавите некоторые фильтры, ваш URL-адрес экспорта для позиций корзины будет выглядеть примерно так:
https://export.net.yourdomain.com/f0d188789-5420-4523-84b2-0417a3a85f58/adm-basketexport_123.
csvfilter[advertiser_program_id]=456&filter[timerange_type]=absolute&filter[from_date]
=01.06.2014&filter[to_date]=27.08.2014
csvfilter[advertiser_program_id]=456&filter[timerange_type]=absolute&filter[from_date]
=01.06.2014&filter[to_date]=27.08.2014
Применение фильтров
Для URL-адреса транзакции и URL-адреса позиции корзины могут применяться следующие фильтры:
| Описание фильтра | Имя фильтра | Формат значения | Приложения |
| Этот фильтр определяет, относится ли выбранный вами временной интервал к моменту, когда транзакции были обновлены или отслеживались. | timetype | Если фильтр не используется, временной интервал будет относиться к моменту отслеживания транзакций. | Используйте либо «отслеживание», либо «обновление». |
| Этот фильтр позволяет определить, является ли временной интервал, для которого требуется отчет о ваших транзакциях или позициях корзины, абсолютным (точные даты) или динамическим (например: последние десять дней, последний месяц и т. д.). | timerange_type | Этот фильтр является обязательным | Либо используйте «absolute», либо используйте «dynamic». |
| Если вы используете динамический временной диапазон, вам нужно указать его здесь. | timerange | Этот фильтр является обязательным, если вы используете динамический временной интервал. | Пожалуйста, прочитайте эту статью для полного обзора. |
| Если вы используете абсолютный временной диапазон, вам нужно определить дату начала диапазона. | from_date | Этот фильтр является обязательным, если вы используете абсолютный временной интервал. | дд.мм.гггг |
| Чтобы ограничить вывод на транзакции или позиции корзины с определенным статусом, используйте этот фильтр. | A: status | Этот фильтр следует применять, когда вы создаете отчет, используемый для целей проверки. | 0 для открытых, 1 для одобренных, 2 для отклоненных и 3 для подтвержденных. Вы можете использовать несколько значений. |
| Этот фильтр позволяет ограничить транзакции или позиции корзины, которые вы экспортируете в определенную валюту. | Код валюты | Используйте коды кодов ISO 4217. Обратите внимание, что вы не можете использовать только один код валюты одновременно. | |
| Этот фильтр позволяет ограничить транзакции или позиции корзины, которые вы экспортируете определенной программой рекламодателя. | а: advertiser_program_id | Этот фильтр позволяет создавать файлы экспорта на рекламодателя, что настоятельно рекомендуется. | Используйте MID, который вы найдете на странице обзора всех рекламодателей на своей платформе. |
| Этот фильтр позволяет ограничить транзакции или позиции корзины, которые вы экспортируете конкретным партнером. | A: affiliate. | Используйте UID, который вы найдете на странице обзора партнеров на вашем бланке. | |
| Этот фильтр позволяет включать бренд и категории покупок, которые рекламодатель применял в экспорте корзины. | FullBasket | Этот фильтр доступен только для экспорта корзины. | Используйте «true» для добавления дополнительных данных. |
| Этот фильтр позволяет включать в ваш файл экспорта любые идентификаторы, связанные с транзакцией. | Allsmcs | Этот фильтр доступен только для отчета о всеобъемлющей транзакции. | Используйте «true», если вы хотите экспортировать sub-идентификаторы. |
| Этот фильтр позволяет включать все дополнительные параметры (возраст и пол клиента, новый custumer, пользовательские значения и т. Д.), Связанные с транзакцией в вашем файле экспорта. | TrackingParams | Этот фильтр доступен только для отчета о всеобъемлющей транзакции. | Используйте «true», если вы хотите экспортировать дополнительные параметры. |
Вывод
Полный файл экспорта транзакций
| Название заголовка | Объяснение | Формат | Измерения | Пример |
| Partner_id | Идентификатор партнера, который сгенерировал транзакцию. | Числовой | n/a | 1234 |
| partner_firstname | Первое имя партнера, сгенерировавшего транзакцию. | Алфавитный | n/a | Mary |
| partner_lastname | Фамилия партнера, сгенерировавшего транзакцию. | Алфавитный | n/a | Поппинс |
| partner_company | Название компании партнера, сгенерировавшего транзакцию. | Алфавитный | n/a | Walt Disney Productions |
|
conversion_target _type |
Тип цели конверсии транзакции. | Алфавитный | n/a | Продажа |
| conversion_target
_label |
Метка цели конверсии транзакции. | Алфавитный | n/a | Спортивные продажи |
| conversion_hidden
_status |
Видимость цели конверсии транзакции для партнеров. Возможные значения: ложные (видимые) и истинные (скрытые). | Алфавитный | n/a | Fales |
| external_advertiser_id | Внутренний идентификатор рекламодателя, используемый для отслеживания. | Буквенно-числовой | n/a | i12345678 |
| internal_conversion_id | Внутренний идентификатор рекламодателя, используемый для целей оценки. | Числовой | n/a | 123456789 |
| conversion_product_
category_id |
Идентификатор категории отслеживания применяется к транзакции. | Числовой | n/a | 5678 |
| adspace_id | Идентификатор (PID) рекламного пространства, через которое была сгенерирована транзакция. | Числовой | n/a | 142536 |
| conversion_status | Состояние конверсии. Возможные значения: 0 (открыто), 1 (одобрено), 2 (отклонено) и 4 (подтверждено). | Числовой | n/a | 0 |
| conversion_id | Идентификатор транзакции. Обычно этот идентификатор будет соответствовать идентификатору заказа, сгенерированному рекламодателем, но в некоторых случаях он заменяется внутренним идентификатором. Если это так, идентификатор будет содержать слово «авто». | Буквенно-числовой | n/a | 1608010800207180980
_авто |
| conversion_commi
ssion_model |
Название модели оценки применяется к транзакции. | Буквенно-цифровая | n/a | комиссия премиум-класса |
| conversion_tracking
_time |
Время и дата начала транзакции. | гггг-мм-дд Hh: mm: ss |
Hyphen and colon | 2016-08-20 15:00:00 |
| click_id | Идентификатор клика, через который была сгенерирована транзакция. | Числовой | n/a | 987654321 |
| click_time | Время и дата отслеживания клика, по которому была сгенерирована транзакция. | Yyyy-mm-dd hh: mm: ss | Hyphen and colon | 2016-08-20 15:00:00 |
| click_referrer | Ссылка, т. е. URL-адрес веб-сайта, на котором был создан клик. | URL | n/a | fashionblog.com |
| click_subid | Первый дополнительный идентификатор клика, через который была сгенерирована транзакция. Обратите внимание, что вы найдете здесь только значение, когда к URL-адресу клика был добавлен дополнительный идентификатор. | Буквенно-цифровая | n/a | mp1234 |
| conversion_commis
sion_rate_id |
Внутренний идентификатор, используемый для определения способа оценки транзакции. | Числовой | n/a | 74859 |
| conversion_commis
sion_rate |
Комиссионная ставка применяется к сделке. | Числовой | Период | 2.5 |
| conversion_commis
sion_type |
Тип комиссии, применяемой к транзакции. Возможные значения: fix и percent. | Алфавитный | n/a | процент |
| conversion_order
_value |
Величина заказа транзакции. Обратите внимание, что эта сумма не включает стоимость доставки и НДС. | Числовое: #. # | Период | 142.45 |
| conversion_order
_value_rejected |
Отклоненная сумма стоимости заказа. Обратите внимание, что при частичном аннулировании вы увидите только значение. | Числовое: #. # | Период | 35.75 |
| conversion_commis
sion_total |
Общая стоимость комиссии, применяемая к транзакции. | Числовое: #. # | Период | 3.56 |
Ограниченный файл экспорта транзакций (данные проверки)
| Название заголовка | Объяснение | Формат | Измерения | Пример |
| Partner_ID | Идентификатор пользователя партнера, который сгенерировал транзакцию. | Числовой | n/a | 1234 |
| Conversion_target
_label |
Метка цели конверсии транзакции. | Буквенно-числовой | n/a | Продажа |
| Adspace_ID | Идентификатор рекламного пространства, которому были связаны транзакции. | Числовой | n/a | 1234 |
| Conversion_status | Состояние транзакции: 0 означает, что транзакция открыта, 1 означает, что транзакция одобрена, 2 означает, что транзакция была отклонена, 3 означает, что транзакция подтверждена. Для получения дополнительной информации, пожалуйста, прочитайте эту статью. | Числовой | n/a | 0 |
| External_adver
tiser_ID |
Идентификатор отслеживания рекламодателя, для которого была создана транзакция. Пожалуйста, не путайте этот идентификатор с идентификатором внутреннего рекламодателя (MID) ниже. | Буквенно-числовой | n/a | i123456 |
| Conversion_id | Идентификатор заказа транзакции. | Буквенно-числовой | n/a | ORD1234 |
| Conversion_commis
sion_rate |
Сумма комиссии, которая должна быть отнесена к рекламному пространству, согласно модели комиссии, примененной к транзакции. Значение в этом поле будет представлять собой процент или фиксированную сумму. | Числовое: #. # | Период | 5.00 |
| Conversion_commis
sion_type |
Тип комиссии, которая должна быть отнесена к рекламному пространству, в соответствии с моделью комиссии, применяемой к транзакции. | n/a | fix, percent | |
| Conversion_order
_value |
Значение заказа транзакции. | Числовое: #. # | Период | 123.45 |
| Conversion_last
_modified_time |
Время и дата последней модерации транзакции. | Yyyy-mm-dd hh: mm: ss | Hyphen and colon | 2001-08-20 15:00:00 |
| Conversion_curre
ncy_code |
Код валюты ISO 4217, в котором были определены значения транзакции. | ### | n/a | EUR |
| Conversion_reason
_canceled |
Если транзакция отменена, это поле может содержать сообщение партнеру, объясняющее причину отмены. Обратите внимание, что это поле не обязательно, поэтому оно может быть пустым, даже если преобразование было отменено. Максимальная длина — 1000 символов. | Алфавитно-цифровые и печатные специальные символы | n/a | Отменено из-за спама в cookie. |
| Conversion_uniqid | Уникальный идентификатор используется для идентификации транзакции во время процесса проверки. | алфавитно-цифровой | Дефис | 14e68d1d-c740-3e37-8037-ee40c71x6de6 |
| Maturity_date | Время и дата, когда транзакция будет одобрена автоматически. Если дата погашения не была реализована, поля будут пустыми. | Yyyy-mm-dd hh: mm: ss | Hyphen and colon | 2001-08-20 15:00:00 |
| Conversion_product
_category_label |
Название категории продукта для транзакции. Если применяется отслеживание корзины, значение будет корзиной. | Алфавитно-цифровые | n/a | по умолчанию, корзина, мода |
| Advertiser_id | Внутренний идентификатор рекламодателя, для которого была создана транзакция, соответствующая MID в пользовательском интерфейсе. | Числовой | n/a | 1234 |
| Advertiser_label | Имя рекламодателя, для которого была сгенерирована транзакция. | Буквенно-числовой | n/a | Shopping.com |
| Partner_adpace
_label |
Ярлык рекламного пространства, которому была связана транзакция. | Буквенно-числовой | n/a | Maxtargeter |
| Internal_conversion
_ID |
Внутренний идентификатор транзакции. | Числовой | n/a | 12345 |
| Conversion_check
sum |
Внутренний код проверки. | Буквенно-цифровые и печатные специальные символы | n/a | 4384315; 3f9b69c6bdca
920193e817 f26815e4e9 |
Файл экспорта позиции корзины
| Название заголовка | Объяснение | Формат | Измерения | Пример |
| Partner_id | Идентификатор партнера, который сгенерировал транзакцию. | Числовой | n/a | 1234 |
| partner_firstname | Первое имя партнера, сгенерировавшего транзакцию. | Алфавитный | n/a | Mary |
| partner_lastname | Фамилия партнера, сгенерировавшего транзакцию. | Алфавитный | n/a | Поппинс |
| partner_company | Название компании партнера, сгенерировавшего транзакцию. | Алфавитный | n/a | Walt Disney Productions |
|
conversion_target _type |
Тип цели конверсии транзакции. | Алфавитный | n/a | Продажа |
| conversion_target
_label |
Метка цели конверсии транзакции. | Алфавитный | n/a | Спортивные продажи |
| conversion_hidden
_status |
Видимость цели конверсии транзакции для партнеров. Возможные значения: ложные (видимые) и истинные (скрытые). | Алфавитный | n/a | Fales |
| external_advertiser_id | Внутренний идентификатор рекламодателя, используемый для отслеживания. | Буквенно-числовой | n/a | i12345678 |
| internal_conversion_id | Внутренний идентификатор рекламодателя, используемый для целей оценки. | Числовой | n/a | 123456789 |
| conversion_product_
category_id |
Идентификатор категории отслеживания применяется к транзакции. | Числовой | n/a | 5678 |
| adspace_id | Идентификатор (PID) рекламного пространства, через которое была сгенерирована транзакция. | Числовой | n/a | 142536 |
| conversion_status | Состояние конверсии. Возможные значения: 0 (открыто), 1 (одобрено), 2 (отклонено) и 4 (подтверждено). | Числовой | n/a | 0 |
| conversion_id | Идентификатор транзакции. Обычно этот идентификатор будет соответствовать идентификатору заказа, сгенерированному рекламодателем, но в некоторых случаях он заменяется внутренним идентификатором. Если это так, идентификатор будет содержать слово «авто». | Буквенно-числовой | n/a | 1608010800207180980
_авто |
| conversion_commi
ssion_model |
Название модели оценки применяется к транзакции. | Буквенно-цифровая | n/a | комиссия премиум-класса |
| conversion_tracking
_time |
Время и дата начала транзакции. | гггг-мм-дд Hh: mm: ss |
Hyphen and colon | 2016-08-20 15:00:00 |
| click_id | Идентификатор клика, через который была сгенерирована транзакция. | Числовой | n/a | 987654321 |
| click_time | Время и дата отслеживания клика, по которому была сгенерирована транзакция. | Yyyy-mm-dd hh: mm: ss | Hyphen and colon | 2016-08-20 15:00:00 |
| click_referrer | Ссылка, т. е. URL-адрес веб-сайта, на котором был создан клик. | URL | n/a | fashionblog.com |
| click_subid | Первый дополнительный идентификатор клика, через который была сгенерирована транзакция. Обратите внимание, что вы найдете здесь только значение, когда к URL-адресу клика был добавлен дополнительный идентификатор. | Буквенно-цифровая | n/a | mp1234 |
| conversion_commis
sion_rate_id |
Внутренний идентификатор, используемый для определения способа оценки транзакции. | Числовой | n/a | 74859 |
| conversion_commis
sion_rate |
Комиссионная ставка применяется к сделке. | Числовой | Период | 2.5 |
| conversion_commis
sion_type |
Тип комиссии, применяемой к транзакции. Возможные значения: fix и percent. | Алфавитный | n/a | процент |
| conversion_order
_value |
Величина заказа транзакции. Обратите внимание, что эта сумма не включает стоимость доставки и НДС. | Числовое: #. # | Период | 142.45 |
| conversion_order
_value_rejected |
Отклоненная сумма стоимости заказа. Обратите внимание, что при частичном аннулировании вы увидите только значение. | Числовое: #. # | Период | 35.75 |
| conversion_commis
sion_total |
Общая стоимость комиссии, применяемая к транзакции. | Числовое: #. # | Период | 3.56 |
Ограниченный файл экспорта транзакций (данные проверки)
| Название заголовка | Объяснение | Формат | Измерения | Пример |
| Internal_conversion
_ID |
Определяет транзакцию, к которой принадлежит позиция корзины. | Числовой | n / a | 4376671 |
| Order_ID | Идентификатор заказа, которому принадлежит позиция корзины. | Числовой | n / a | ORD123456 |
| Conversion_target_ID | ИД цели конверсии транзакции, к которой принадлежит позиция корзины. | Числовой | n / a | 174 |
| Conversion
_target_name |
Название цели транзакции, относящейся к позиции корзины. | Буквенно-числовой | n / a | Покупка |
| Product_basket
_index |
Ранг позиции корзины в корзине. | Числовой | n / a | 1 |
| Product_number | Название продукта, которое оно было передано из торговой системы рекламодателя. | Буквенно-цифровые | n / a | Носки, пуловер, мобильный телефон |
| Product_ID | Идентификатор продукта, поступающего из торговой системы рекламодателя. | Числовой | n / a | 6543 |
| Product_currency
_code |
Код валюты ISO 4217, в котором были определены значения транзакции. | ### | n / a | EUR |
| Product_category
_ID |
Идентификатор категории продукта позиции корзины. | Числовой | n / a | 386 |
| Product_category
_name |
Название категории продукта позиции корзины. | Буквенно-числовой | n / a | по умолчанию |
| Product_price | Цена продукта в позиции корзины. | Числовое: #. # | Период | 30.00 |
| Product_quantity | Общее количество товаров, заказанных для позиции корзины. | Числовой | n / a | 5 |
| Product_total
_price |
Цена продукта умножается на количество товаров, заказанных для позиции корзины. | Числовой | Период | 150,00 |
| Product_commis
sion_fix |
Исправленное значение, используемое для расчета комиссии. | Числовое: #. # | Период | 3.00 |
| Product_commis
sion_percent |
Процентное значение, используемое для расчета комиссии. | Числовое: #. # | Период | 5.00 |
| Product_commis
sion_total |
Общая сумма комиссии, относящаяся к позиции корзины. | Числовое: #. # | Период | 22.50 |
| Product_fee_fix | Если рекламодатель выставлен счету владельцем сети, это поле будет содержать фиксированное значение, используемое для расчета платы. | Числовое: #. # | Период | .00 |
| Product_fee
_percent |
Если рекламодатель выставлен счету владельцем сети, это поле будет содержать процентное значение, используемое для расчета платы. | Числовое: #. # | Период | 3.00 |
| Product_fee_total | Если рекламодатель выставлен счету владельцем сети, это поле будет содержать плату, которую рекламодателю придется заплатить за эту транзакцию. | Числовое: #. # | Период | 3.00 |
| Product_uniqid | Уникальный идентификатор транзакции, к которой относится позиция корзины. Этот идентификатор используется во время процесса проверки. | Буквенно-цифровые и печатные специальные символы | n / a | 14x66c23-084f-3784-8084-c74f08536ce6 |
| Product: _checksum | Внутренний код проверки. | Буквенно-цифровые и печатные специальные символы | n / a | 097df04754f352493
0b1f62e8296c845 |
| Position_status | Состояние позиции корзины: 0 означает, что позиция открыта, 1 означает, что позиция подтверждена, 2 означает, что позиция была отклонена. Для получения дополнительной информации, пожалуйста, прочитайте эту статью. | Числовой | n / a | 2 |
| Advertiser_id | Идентификатор рекламодателя, для которого была создана позиция корзины. | Числовой | n / a | 123 |
| Advertiser_title | Название рекламодателя, для которого была создана позиция корзины. | Буквенно-цифровые и печатные специальные символы | n / a | Fashion Shop |
| Conversion_tracking
_time |
Время и дата отслеживания позиции корзины. | Yyyy-mm-dd hh: mm: ss | Hyphen and colon | 2016-04-28 22:00:08 |
Добавить комментарий