Перейти к содержимому


Интеграция С Cpa Рекламой (Оплата За Действие)


  • Авторизуйтесь для ответа в теме
Сообщений в теме: 7

#1 Bardin

Bardin

    Активный участник

  • Пользователи
  • PipPipPipPip
  • 700 сообщений
  • ГородМосква

Отправлено 13 Март 2013 - 00:19

CPA (Cost Per Action — цена за действие) — это реклама с оплатой за результат.
Рекламодатель оплачивает не показы и клики, а целевые действия посетителей на своем сайте (например оформление заказа).

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

Например партнерка ActionPay предлагает следующее решение: http://actionpay.ru/...age:instruction


Цитата

Инструкция по интеграции рекламодателей с партнёрской сетью ActionPay


Описанные ниже правила интеграции призваны обеспечить достижение следующих целей:
  • обеспечить учёт сетью ActionPay действий, производимых на стороне рекламодателя
  • обеспечить корректную работу кампании в Post-Click период, указанный в дополнительном соглашении к договору
  • максимизировать количество учитываемых действий, утеря которых вызвана техническими ограничениями
  • обеспечить рекламодателя данными, необходимыми для эффективной борьбы с некачественным трафиком
Достижение описанных выше целей приведёт к:
  • улучшению конверсии переходов в действия для вебмастеров, что повысит их интерес к рекламным кампаниям и, соответственно, увеличит объём привлекаемых действий
  • более оперативному и качественному выявлению накруток
ОБЩИЙ ПРИНЦИП РАБОТЫ

Описанная ниже схема работы состоит из трёх частей и подходит для большинства кампаний. Типовой пример – работа с интернет-магазином. Несмотря на это, кампании могут иметь индивидуальные особенности или технические ограничения.
В случае невозможности использования стандартной схемы, необходимо совместными усилиями технических специалистов с обеих сторон, обеспечить условия для максимального достижения целей, перечисленных  выше.
Интеграция состоит из трёх основных частей:
  • Обработка перехода из сети ActionPay на сайт рекламодателя

  • Извещение сети ActionPay о совершённом действии

  • Извещение сети ActionPay об изменении статуса по совершённому ранее действию
Ниже подробно описывается каждая часть.
ОБРАБОТКА ПЕРЕХОДА

Для определения того, что переход на сайт рекламодателя осуществляется через сеть ActionPay, а не через другой источник, применяются два альтернативных варианта идентификации: полная форма и компактная. На стороне рекламодателя необходимо принять решение о том,какая из двух форм будет использоваться, после чего необходимо сообщить о своём решении менеджеру по работе с клиентами для настройки системы.
Полная форма:
Сеть ActionPay добавляет к ссылке перехода три GET-параметра (параметры, передаваемые в адресной строке, реферальные параметры, utm-метки):


source=actionpay – признак источника трафика – сеть ActionPay
apclick=0000-0000-0000-0000-0000 – уникальный идентификатор перехода в сети ActionPay
apsource=0000000 – идентификатор источника сети ActionPay

Компактная форма:
Сеть ActionPay добавляет к ссылке перехода один GET-параметр с именем actionpay, в котором идентификаторы перехода и источника разделяются точкой:

actionpay=0000-0000-0000-0000-0000.0000000

Идентификаторы перехода и источника, в примере обозначенные нулями представляются буквенно-цифровыми последовательностями. Максимальная длина – 50 символов. Пример идентификатора перехода: 66393b6e-b5fe-0bdf-f62b-013890d2391f.
Приём и разбор передаваемых GET-параметров должен осуществляться на любой странице сайта рекламодателя (а не только на главной или ограниченном наборе), так как вебмастера могут добавлять в систему ActionPay ссылки на произвольные страницы (устанавливается настройками оффера по согласованию с рекламодателем).
После приёма пользователя с указанными параметрами на сайте рекламодателя, ему необходимо установить cookie c именем actionpay и значениями идентификаторов перехода и источника, разделённых точкой:

actionpay=0000-0000-0000-0000-0000.0000000

Время жизни установленной cookie должно соответствовать периоду Post-Click, указанному в дополнительном соглашении к договору (например, если Post-Click период равен 30 дням, то cookie должны действовать до времени, которое является суммой даты перехода плюс 30 дней).
Сеть ActionPay будет произоводить на постоянной основе автоматический контроль за правильностью установки cookie (верное имя, значение и срок действия).
Помимо cookie, сайт рекламодателя может сохранять полученные во время перехода от сети ActionPay параметры в своих внутренних системах (БД, профиле пользователя и прочее), однако установка cookie обязательна.
ИЗВЕЩЕНИЕ О ДЕЙСТВИИ

Для информирования сети ActionPay о действии, совершённом на сайте рекламодателя, применяется трекинг-пиксель (далее – пиксель). Простыми словами, в момент совершения действия, в код отображаемой пользователю страницы, подставляется код, загружающий с сервера ActionPay прозрачное изображение размером 1х1 пиксель.
Это изображение не показывается пользователю, а служит средством выполнения запроса к серверу ActionPay с передачей необходимых параметров.
Код пикселя с передачей параметров выглядит так:

<img src="http://n.actionpay.r...0-0000.0000000" width="1" height="1" />

, где 0000 – идентификатор цели в сети ActionPay (конкретный номер цели будет предоставлен менеджером по работе с клиентами, а 0000-0000-0000-0000-0000.0000000 – идентификаторы перехода и источника, разделённые точкой (их значения необходимо получать из установленной ранее cookie). Пиксель должен отображаться при любом выполнении действий, предусмотренных дополнительным соглашением к договору, пользователю с установленной cookie с именем actionpay в течение всего периода действия cookie (то есть в течение Post-Click периода).
Возможен расширенный вариант передачи параметров пикселю, с разделением идентификаторов перехода и источника на две переменные:

<img src="http://n.actionpay.ru/ok/0000.png?apclick=0000-0000-0000-0000-0000&apsource=0000000" width="1" height="1" />

В случае, если на стороне рекламодателя каждому совершаемому действию присваивается некий уникальный идентификатор, по которому можно однозначно найти дополнительную информацию по этому действию, то этот идентификатор должен передаваться в пиксель параметром с именем apid. Идентификатором может являться, например:
  • номер заказа
  • номер заявки
  • идентификатор пользователя
  • номер платежа
  • идентификатор созданного объекта в системе рекламодателя
и т. д.
Идентификатором может являться любая буквенно-цифровая последовательность символов, со знаками препинания, но без пробелов. Передача в пиксель параметра apid осуществляется следующим образом:

<img src="http://n.actionpay.r...0-0000.0000000apid=NNNN" width="1" height="1" />

В случае, если на стороне рекламодателя каждому совершаемому действию присваивается некая денежная сумма, то эта сумма должна передаваться в пиксель параметром с именем apprice. Суммой может являться, например:
  • сумма заказа/покупки
  • сумма платежа
  • сумма пополнения счёта
и т. д. При этом единицей изменения суммы может являться любая валюта, в том числе виртуальная (например, голоса Вконтакте).
Суммой должно являться число с дробной частью. Разделителем целой и дробной части должна являться точка, максимальное количество знаков после точки – 4. Передача в пиксель параметра apprice осуществляется следующим образом:

<img src="http://n.actionpay.r....0000&apid=NNNNapprice=000.0000"
width="1" height="1" />

Дополнительные возможности
JavaScript-пиксель


Если необходимо сделать динамическое отображение пикселя на странице (к примеру, страница отображается без перезагрузки), то возможно использование JavaScript-версии пикселя. Все необходимые значения должны быть предварительно присвоены соответствующим переменным. Пример кода (обратите внимание на наличие апострофов вокруг значений параметров):

<script language="JavaScript" type="text/javascript">
var id=0000;
var actionpay='0000-0000-0000-0000-0000.0000000';
var apid='NNNN';
var apprice=000.0000;

</script>
<script language="JavaScript" type="text/javascript" src="http://n.actionpay.r...k.js"></script>

, где var id=0000; – идентификатор цели в сети ActionPay (предоставляется менеджером).

Server-to-server запрос


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

Защищённое https-соединение


Если сервер рекламодателя организует защищённое соединение по протоколу https, то вызов пикселя возможно также осуществлять по протоколу https, например:

<img src="https://n.actionpay.ru/ok/0000.png?actionpay=0000-0000-0000-0000-0000.0000000" width="1" height="1" />


Вызов из Adobe Flash


Если сайт рекламодателя использует для отображения всего содержимого страниц технологию Adobe Flash, то вызов пикселя можно встроить в код Flash-приложения. При этом необходимо, чтобы вызов пикселя производится средствами браузера. Рекомендуемый код вызова пикселя из Flash:

var loader:Loader = new Loader();
loader.load(new URLRequest('http://n.actionpay.r...00-0000.0000000'));


Перечисленные выше дополнительные возможности должны использоваться только в том случае, если отображение обычного пикселя невозможно.
ИЗВЕЩЕНИЕ О СТАТУСЕ ДЕЙСТВИЯ

Для уведомления сети ActionPay о статусе действий, произведённых на сайте рекламодателя, а также для учёта действий, по которым по какой-то причине не было начального оповещения сети, применяется автоматический обмен данными между серверами ActionPay и сайтом рекламодателя. Обмен данными осуществляется с использованием формата XML.
От сети ActionPay может исходить два вида запросов: со списком идентификаторов и за дату. Периодичность запросов и их точное время определяются внутренними настройками. Для осуществления запросов рекламодатель должен предоставить адрес страницы (скрипта) на сайте, к которой будет производиться запрос с отправкой данных. Данные отправляются методом POST. Кодировка – UTF-8. Запрос содержит три параметра:


xml – содержимое запроса в формате XML
pass – md5-хеш от установленного пароля (необязательный параметр, пароль согласуется с менеджером)
date – дата (формат ДД.ММ.ГГГГ)

В зависимости от вида запроса отправляется либо параметр xml (запрос со списком идентификаторов), либо параметр date (запрос за дату).
Если обеспечение безопасности при передаче данных не критично, то пароль можно не использовать.
Запрос со списком идентификаторов:
XML-запрос содержит в своём составе идентификаторы, полученные при вызове пикселя в параметре apid. Количество идентификаторов в одном запросе не ограничено. Пример запроса:

<?xml version="1.0" encoding="UTF-8"?>
<items>
<item>10000001</item>
<item>10000002</item>
<item>10000003</item>
<item>10000005</item>
</items>

В ответ на такой запрос скрипт на стороне рекламодателя должен сформировать ответ, содержащий детальную информацию о запрашиваемых действиях. Формат ответа должен содержать следующие теги внутри контейнера item:


id – идентификатор действия (аналог параметра apid, полученного пикселем)
click – идентификатор перехода (аналог параметра apclick, полученного пикселем, либо часть параметра actionpay до точки)
source – идентификатор источника (аналог параметра apsource, полученного пикселем, либо часть параметра actionpay после точки)
price – сумма действия (необязательный параметр, аналог параметра apprice, полученного пикселем)
status – статус действия (необязательный параметр, 1, 2 или 3 – см. ниже)
date – дата (необязательный параметр, дата действия в формате ДД.ММ.ГГГГ ЧЧ:ММ:СС)
aim – идентификатор цели (необязательный параметр, аналог имени файла пикселя до «.png»

Если по офферу существует несколько целей, либо в случае, если одна и та же XML-выгрузка используется для передачи данных по нескольким офферам, то параметр aim обязателен.
На каждый переданный в запросе идентификатор в ответе должен присутствовать отдельный контейнер item. Пример ответа, содержащего ответ по одному идентификатору:

<?xml version="1.0" encoding="UTF-8"?>
<items>
<item>
<id>10000001</id>
<click>0000-0000-0000-0000-0000</click>
<source>0000000</source>
<price>10.0000</price>
<status>1</status>
<date>23.12.2012 23:55:01</date>
<aim>0000</aim>
</item>
</items>

Для поля status используются следующие числовые обозначения статусов:


1 – действие «принято» (будет оплачено впоследствии рекламодателем)
2 – действие «в обработке» (решение по нему ещё не принято, необходимо запросить статус позже)
3 – действие «отклонено» (действие не будет оплачено рекламодателем)
4 – запрошенное действие «не существует» (в запросе пришёл идентификатор, который не зафиксирован на сайте рекламодателя)

Статусы 1 и 3 являются терминальными статусами, то есть переход из этих статусов в какой либо другой впоследствии невозможен. Если сервер ActionPay получил по идентификатору статус 1 или 3, он не будет повторять попытки запроса этого идентификатора когда-либо позже. Этот статус будет зафиксирован в ActionPay окончательно, поэтому статусы 1 и 3 стоит отдавать только в том случае, если решение относительно действия принято окончательно.
Статусы 2 и 4 не являются терминальными. Сервер ActionPay может периодически повторять попытки запроса соотвествующих идентификаторов, пока не будет получен один из терминальных статусов (1 или 3), либо до тех пор, пока не истечёт период ожидания (не оговаривается и является внутренней настройкой в сети ActionPay).
Запрос за дату:
Содержимое ответа должно формироваться из всех действий, зарегистрированных на сайте рекламодателя за указанные сутки. Формат ответа идентичный ответу на запрос без даты. Запрос с указанием даты обычно формируется на следующие сутки, после указанных в запросе.
Реализация выгрузки на запрос за дату является обязательной для интернет-магазинов.
В случае любой непредвиденной ошибки в запросе (неверный пароль, некорректный формат XML и прочее) необходимо вернуть тег error, содержащий произвольное, но содержательное сообщение об ошибке. Например:

<?xml version="1.0" encoding="UTF-8"?> <error>Неверный пароль</error>

ЗАКЛЮЧЕНИЕ

Данные правила предназначены для изучения и реализации техническими специалистами со стороны всех рекламодателей.
В случае технической невозможности реализовать какую-либо часть данных правил необходимо совместно с менеджером ActionPay и техническими специалистами согласовать и реализовать альтернативное решение.


#2 Flor@@

Flor@@

    Активный участник

  • Пользователи
  • PipPipPipPip
  • 1 959 сообщений

Отправлено 05 Апрель 2013 - 03:07

ау?

#3 Bardin

Bardin

    Активный участник

  • Пользователи
  • PipPipPipPip
  • 700 сообщений
  • ГородМосква

Отправлено 05 Апрель 2013 - 10:46

Много букв...... по сути дела это пратнерская программа для ИМ. И было бы логично организовать поддержку хотя бы одного сервиса агрегатора.

#4 raven_knp

raven_knp

    Пользователь

  • Пользователи
  • PipPip
  • 40 сообщений

Отправлено 13 Ноябрь 2013 - 20:59

Здравствуйте, есть ли у вас инструкция как подключить cpa от yandex маркета нужно настроить api http://api.yandex.ru...ase-methods.xml
ida4ehol.ru

#5 Koderhan

Koderhan

    Активный участник

  • Модератоpы
  • 6 227 сообщений

Отправлено 14 Ноябрь 2013 - 11:37

http://storeland.ru/about/faq#50

#6 raven_knp

raven_knp

    Пользователь

  • Пользователи
  • PipPip
  • 40 сообщений

Отправлено 14 Ноябрь 2013 - 15:57

Просмотр сообщенияKoderhan (14 Ноябрь 2013 - 11:37) писал:

отлично но мен нужно
  • не указаны все необходимые настройки API покупки. Пожалуйста, внесите их на странице Настройки API покупки




URL API
Изображение не указан изменить
SHA1 fingerprint
Изображение не указан изменить
Авторизационный токен
Изображение не указан изменить
Тип авторизации
Изображение HEADER
URL
Формат данных
Изображение JSON
XML

#7 raven_knp

raven_knp

    Пользователь

  • Пользователи
  • PipPip
  • 40 сообщений

Отправлено 15 Ноябрь 2013 - 19:59

и всё-таки буду признателен если ответите

Прикрепленные изображения

  • Ashampoo_Snap_2013.11.15_20h57m58s_001_.jpg


#8 ApostolofD

ApostolofD

    Продвинутый пользователь

  • Пользователи
  • PipPipPip
  • 58 сообщений
  • ГородБелгород

Отправлено 03 Декабрь 2013 - 14:41

Здравствуйте, очень актуально. Кто подскажет ??




Количество пользователей, читающих эту тему: 0

0 пользователей, 0 гостей, 0 анонимных