Файл экспорта транзакций

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

Обзор

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

  1. Полный файл экспорта, содержащий все данные, относящиеся к транзакциям.
  2. Ограниченный файл экспорта, содержащий только данные транзакции, относящиеся к процессу проверки. Если вы не применяете отслеживание корзины, этот файл следует использовать для проверки.
  3. Файл экспорта, содержащий все позиции корзины, связанные с транзакциями. Когда вы применяете отслеживание корзины, этот файл следует использовать для целей проверки.

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

Создание 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

Экспорт 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

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

Применение фильтров

Для 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
Метки:
Эта статья была полезна?
Бесполезно 0
Читали: 141

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

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