Вкратце об openid connect

Viewing Advertiser Parameters in Reports

Advertiser sub ID and unique values are visible in the conversion report. In the Data section, select one or more of  the Advertiser Sub ID and Advertiser Unique parameters to see them when you run the report:


By default, advertiser sub ID values are invisible to your publishers. This is to protect advertisers who may want to share sensitive information with networks but not publishers. However, you can change this setting if necessary.

To allow publishers to see an advertiser’s sub ID and advertiser unique values in the publisher interface, first go to Advertisers > Manage Advertisers and select the advertiser’s name. Then in the Account Information panel, you can change the Display Advertiser Sub IDs to Partner setting:

How Advertiser Parameters Work

Advertiser parameters are typically used to help you and your advertiser cross-reference conversion data. They can be used to keep track of various information that is meaningful to various advertiser verticals.

  • e-commerce: order numbers (cart ids), product SKU numbers, Product category, store location code
  • Subscriptions: subscription type, estimated LTV, cancelation reason
  • Gaming: game level, score, gaming group id, tutorial id
  • Session IDs from an third party system (external to TUNE), to cross-reference and validate data across systems

Remember: use adv_unique values (as opposed to adv_sub) any time your values are uncommon or unique:

You can receive advertiser parameters via the following parameters in the conversion link:

  • adv_sub, adv_sub2,  adv_sub3, adv_sub4, adv_sub5
  • adv_unique1, adv_unique2,  adv_unique3, adv_unique4, adv_unique5

On conversion, values for these advertiserparameters are stored in the session and appear in conversion reports. Once a value is stored, you can provide it to your publisher using the corresponding advertiser sub ID and advertiser unique macro in a partner conversion link.

Only advertiser sub IDs are shown as Dimensions in aggregate reports such as the Stats report, where the user can group by their values. By contrast, adv unique values are only shown in event reports such as Conversion and Event Tracer. Due the potentially high number of distinct / unique values it would not be useful to group by these fields.

Important: Each advertiser sub ID must be a URL-encoded value up to 500 characters in length. Your conversion link may not work if you use longer or non-encoded sub ID values.

Отправка постбека на JS

Вставьте этот код на вашей странице:

<script type="text/javascript">
var postbackUrl = 'POSTBACK_URL';
function sendPostback(params, cb) {
    var pattern = new RegExp('subid=(+)');
    var params = params || {};
    params.subid = ((v=window.location.search.match(pattern))==null?'':v);
    params.return = 'img';
    var img = document.createElement('img');
    img.src = postbackUrl + '?' + paramsToString(params);
    img.height=0;
    img.width=0;
    img.onload = cb;
    document.getElementsByTagName("body").append(img);
};
function paramsToString (params) {
    var str = [];
    for (var p in params) {
        if (params.hasOwnProperty(p)) {
            str.push(encodeURIComponent(p) + "=" + encodeURIComponent(params));
        }
    }
    return str.join("&");
};
<script>

Замените в нем на ваш. Взять Postback URL можно на странице партнерские сети, добавив новую сеть.

Теперь можно отправлять постбек вызвав функцию:

Пример:

<script type="javascript/text">
sendPostback({status 'sale', revenue 100, currency 'rub', sub_id_10 'item 828'})
</script>

Пример с коллбеком:

<script type="javascript/text">
sendPostback({status 'sale'}, function(){
  $('form').submit();
})
</script>

Если вы включили предзагрузку лендинга, параметр subid нужно дописать вручную. Замените строку

params.subid = ((v=window.location.search.match(pattern))==null?''v1);

на

params.subid = '{subid}';

How Partner Sub IDs Work

Partner sub IDs are used to store non-unique values from the publisher’s tracking system, in some cases to forward to an advertiser. For example, TUNE doesn’t have a parameter or macro specific to sub partners or ad placements. To store that data, you use partner sub IDs.


On click, values for these parameters are stored in the session. Once a sub ID value is stored, you can provide it to your advertiser or publisher using the corresponding partner sub ID macro in an offer URL or partner conversion link.

Note: If you are storing unique values—like click IDs or user hashes—use the  instead. Storing unique values in partner sub IDs is a common cause of sluggish reporting.

Here’s what passing a value from the tracking link to the offer URL looks like from the server’s perspective:

Each partner sub ID must be a URL-encoded value up to 500 characters in length. Your tracking link may not work if you use longer or non-encoded sub ID values.

Перевод «Subid» на русский язык: «поднимитесь»

Subid.   Вы оба со мной. источник пожаловаться     Corpus name: OpenSubtitles2016. License: not specified. References: http://opus.lingfil.uu.se/OpenSubtitles2016.php, http://stp.lingfil.uu.se/~joerg/published/ranlp-V.pdf
¡Subid!   Пошли! источник пожаловаться     Corpus name: OpenSubtitles2016. License: not specified. References: http://opus.lingfil.uu.se/OpenSubtitles2016.php, http://stp.lingfil.uu.se/~joerg/published/ranlp-V.pdf
¡Signor, subid, subid!   Синьор! Поднимайтесь сюда! источник пожаловаться     Corpus name: OpenSubtitles2016. License: not specified. References: http://opus.lingfil.uu.se/OpenSubtitles2016.php, http://stp.lingfil.uu.se/~joerg/published/ranlp-V.pdf
¡Subid!   Поднимаемся и отчаливаем! источник пожаловаться     Corpus name: OpenSubtitles2016. License: not specified. References: http://opus.lingfil.uu.se/OpenSubtitles2016.php, http://stp.lingfil.uu.se/~joerg/published/ranlp-V.pdf
Subid.   Идите скорей! источник пожаловаться     Corpus name: OpenSubtitles2016. License: not specified. References: http://opus.lingfil.uu.se/OpenSubtitles2016.php, http://stp.lingfil.uu.se/~joerg/published/ranlp-V.pdf
¡Subid!   Залезайте! источник пожаловаться     Corpus name: OpenSubtitles2016. License: not specified. References: http://opus.lingfil.uu.se/OpenSubtitles2016.php, http://stp.lingfil.uu.se/~joerg/published/ranlp-V.pdf
¡Subid!   Идем! источник пожаловаться     Corpus name: OpenSubtitles2016. License: not specified. References: http://opus.lingfil.uu.se/OpenSubtitles2016.php, http://stp.lingfil.uu.se/~joerg/published/ranlp-V.pdf
¡Subid!   Готово! источник пожаловаться     Corpus name: OpenSubtitles2016. License: not specified. References: http://opus.lingfil.uu.se/OpenSubtitles2016.php, http://stp.lingfil.uu.se/~joerg/published/ranlp-V.pdf
¡Subid! Subid.   источник пожаловаться     Corpus name: OpenSubtitles2016. License: not specified. References: http://opus.lingfil.uu.se/OpenSubtitles2016.php, http://stp.lingfil.uu.se/~joerg/published/ranlp-V.pdf
¡Subid!   Живее! источник пожаловаться     Corpus name: OpenSubtitles2016. License: not specified. References: http://opus.lingfil.uu.se/OpenSubtitles2016.php, http://stp.lingfil.uu.se/~joerg/published/ranlp-V.pdf
¡Subid!   Поднимайся наверх. источник пожаловаться     Corpus name: OpenSubtitles2016. License: not specified. References: http://opus.lingfil.uu.se/OpenSubtitles2016.php, http://stp.lingfil.uu.se/~joerg/published/ranlp-V.pdf
Subid.   источник пожаловаться     Corpus name: OpenSubtitles2016. License: not specified. References: http://opus.lingfil.uu.se/OpenSubtitles2016.php, http://stp.lingfil.uu.se/~joerg/published/ranlp-V.pdf
¡Subid!   Садитесь! источник пожаловаться     Corpus name: OpenSubtitles2016. License: not specified. References: http://opus.lingfil.uu.se/OpenSubtitles2016.php, http://stp.lingfil.uu.se/~joerg/published/ranlp-V.pdf
¡Subid!   А теперь, вперед! источник пожаловаться     Corpus name: OpenSubtitles2016. License: not specified. References: http://opus.lingfil.uu.se/OpenSubtitles2016.php, http://stp.lingfil.uu.se/~joerg/published/ranlp-V.pdf
¡Subid!   Ползи! источник пожаловаться     Corpus name: OpenSubtitles2016. License: not specified. References: http://opus.lingfil.uu.se/OpenSubtitles2016.php, http://stp.lingfil.uu.se/~joerg/published/ranlp-V.pdf
¡Subid!   источник пожаловаться     Corpus name: OpenSubtitles2016. License: not specified. References: http://opus.lingfil.uu.se/OpenSubtitles2016.php, http://stp.lingfil.uu.se/~joerg/published/ranlp-V.pdf
¡Subid!   Поднимитесь туда! источник пожаловаться     Corpus name: OpenSubtitles2016. License: not specified. References: http://opus.lingfil.uu.se/OpenSubtitles2016.php, http://stp.lingfil.uu.se/~joerg/published/ranlp-V.pdf
¡Subid!   Давай! источник пожаловаться     Corpus name: OpenSubtitles2016. License: not specified. References: http://opus.lingfil.uu.se/OpenSubtitles2016.php, http://stp.lingfil.uu.se/~joerg/published/ranlp-V.pdf
Subid.   Быстро внутрь! источник пожаловаться     Corpus name: OpenSubtitles2016. License: not specified. References: http://opus.lingfil.uu.se/OpenSubtitles2016.php, http://stp.lingfil.uu.se/~joerg/published/ranlp-V.pdf
Subid.   источник пожаловаться     Corpus name: OpenSubtitles2016. License: not specified. References: http://opus.lingfil.uu.se/OpenSubtitles2016.php, http://stp.lingfil.uu.se/~joerg/published/ranlp-V.pdf

Настройка передачи значений нашей метки [CPA] в рекламируемой ссылке партнерской сети

1.1 Для рекламы любого оффера партнерская сеть выдает вам рекламируемую ссылку. Например: Эту ссылку обычно вы получаете при выборе оффера из списка в партнерской сети, в меню настроек потока на оффер или же после окончания настройки потока на оффер. Пример получения ссылки на оффер в ПП ad-x:

Если не знаете, где посмотреть рекламируемую ссылку на свой оффер, пожалуйста, обращайтесь в поддержку ПП.1.2 Обычно в рекламируемой ссылке можно указывать разные метки. Со списком меток, которые может передавать наша сеть в ПП, можно ознакомиться здесь.Обязательное условие корректного уведомления о целевых действиях — это наличие метки в рекламируемой ссылке. Метки в ссылках могут присваиваться с помощью get параметров партнерской сети или же указываться по другим правилам строения ссылки партнерской сети. Пример рекламируемой ссылки с метками нашей сети и параметрами: где sub1, sub2, sub3, sub4 — это параметры партнерской сети, в которых указаны метки нашей сети — ,,,, а каждый параметр в паре с меткой разделяются символом &. У каждой ПП свои названия параметров (могут быть любыми, например, sub, sub1, sub_id, sid и т.д.), также свое количество таких параметров (в одной партнерской сети параметров может быть 10, а в другой 2), а также в некоторых ПП метки могут вообще указываться без параметров по своим правилам строения рекламируемой ссылки. Метки обычно указываются в меню настроек оффера (потока на оффер) или же указываются вручную. Вот примеры того, где указываются метки в рекламируемой ссылке в разных партнерских сетях:

Например, в сетях advendor и dr.cash в меню настроек потока сразу есть поля, где можно указать метки, потом метки автоматически дописываются к рекламируемой ссылке:

— advendor

— dr.cash


Например, в сетях advertise и admitad необходимо получить основную рекламируемую ссылку, а уже вручную дописать к ней метку при создании рекламной кампании в нашей сети:

— advertise

К ссылке добавляется параметр — ?tid= Пример готовой ссылки выглядит так: — admitad

рис. 7

К ссылке добавляется параметр — ?subid= Пример готовой ссылки выглядит так: Если самостоятельно не находите, где указываются метки в ссылке или не знаете, какие параметры используются для указания меток, пожалуйста, обращайтесь в поддержку ПП.1.3 Полученная рекламируемая ссылка указывается в поле URL в рекламной кампании в кабинете Kadam. Пример для ссылки сети admitad:

рис. 8

1.4 В параметрах рекламной кампании нужно выбрать в поле «Модель оплаты» — Smart Ads, в поле «Уведомление о конверсии» — Postback URL, а в поле «Шаблон принятия» необходимо выбрать шаблон текущей нужной партнерской программы:

рис. 9

1.5 После клика по рекламному объявлению на площадке пользователь попадает на сайт рекламодателя, ссылка этого сайта будет уже со значением метки (уникальный clickID), которое будет присвоено параметру партнерской сети. Пример рекламируемой ссылки с произвольным значением метки:

где subid — это параметр партнерской сети, со значением метки 0000x4a7d1ed414474e4033ac29ccb8653d9b. Значение параметра генерируется автоматически нашей сетью при клике по объявлению и отличается для каждого уникального перехода.

Совместимость действий и редиректов с различными видами интеграции

Действие Ссылка Script Iframe/Frameset
HTTP-редирект Редирект Выполнение js-кода Редирект внутри фрейма
Js-редирект Редирект Не работает Редирект внутри фрейма
Meta-редирект Редирект Редирект Редирект
Двойной Meta-редирект Редирект Редирект Редирект
Ред. с пуст. реферером Редирект Редирект Редирект внутри фрейма
Открыть во фрейме Показ фрейма Не работает Фрейм внутри фрейма
CURL Показ страницы Выполнение js-кода Страница внутри фрейма
404 NotFound Ошибка 404 Ничего Пустой фрейм
Показать текст Показ текста Исполнение как js код Текст внутри фрейма
Показать HTML Показ страницы Показ рядом с тегом script Показ внутри фрейма
REMOTE Редирект Редирект Редирект
FormSubmit Редирект Не работает Редирект внутри фрейма
Редирект для iframe Не работает Не работает Редирект основной страницы
Редирект для script Не работает Редирект Не работает
SubId Показ subid Не работает Показ subid во фрейме

Как самостоятельно собрать Postback URL

При добавлении партнерской сети у вас будет в поле «Postback URL» базовый адрес. Теперь вам необходимо найти документацию на сайте партнерки о настройке постбека. В частности, необходимо:

  1. Список токенов
  2. Инструкция по передаче subid/clickid

Список токенов поможет составить цепочку параметров. Например, в рекламной сети есть токены , , . Значит параметры к адресу добавляем такие: . С полным списком доступных параметров Keitaro можете ознакомиться разделом ниже.

Теперь вам нужно определить через какой параметр нам можно передать наш subid. Допустим, его передают через sid1. Значит, пишем «&sid1={subid}» в поле «Параметры офферов»

Если в логе конверсий не начинают появляться записи, посмотрите страницу «Обслуживание > Логи > Полученные постбеки».

Связка по UserID: если у вас есть собственные идентификаторы клиентов

Этап 1. Учим Метрику узнавать клиентов

Чтобы начать передавать в Метрику идентификаторы авторизованных посетителей (UserID), нужно добавить на сайт код, который будет подставлять эти идентификаторы в метод setUserID:

yaCounterXXXXXX.setUserID( UserID)


Идентификаторы UserID не будут показываться в отчетах: они сохранятся в базе данных Метрики в качестве ключей, которые позволят сопоставить посетителей в Метрике и клиентов в вашей CRM.

Для зарегистрированных посетителей эти связки будут созданы после того, как посетитель хотя бы раз зайдет на сайт под своим логином. Каждый раз, когда авторизованный посетитель будет заходить на сайт, Метрика будет получать команду «запомнить» его под указанным UserID.

UserID можно передавать не только для авторизованных посетителей. Уникальный идентификатор также можно забирать из «меченой» ссылки, которую вы отправляли вашим клиентам по почте, или из реферера соцсетей. Также в качестве UserID подойдёт номер дисконтной карты или промо-код, который посетители вводят на сайте.

Этап 2. Загружаем данные

После того, как UserID переданы в Метрику, нужно подготовить файл с атрибутами клиентов, которые нужно добавить в отчеты. Это таблица в формате csv с тремя столбцами:

  • в первом — UserID, который послужит ключом для связки данных в файле и в Метрике,
  • во втором — название параметра,
  • в третьем — его значение.

Вот как может выглядеть этот файл:

Чтобы отправить его в Метрику, зайдите во вкладку «Загрузка данных» в настройках счетчика. Не забудьте выбрать тип файла — «User_id»:

Когда файл будет обработан, в интерфейсе вы увидите уведомление:

Статус «Выполнено (80% привязки)» означает, что переданные UserID нашлись в Метрике для 80% клиентов из файла. Чаще всего данные привязываются не полностью из-за того, что не все клиенты успели побывать на сайте — а значит, их UserID еще не переданы, и Метрика не знает, каким посетителям записывать атрибуты из таблицы. Поэтому параметры будут добавлены только для 80% «привязанных» посетителей — об этом полезно помнить, интерпретируя данные в отчётах.

Статусы конверсии

Конверсия в Keitaro имеет 4 состояния:

  • Лид (lead) — был получен лид, но выплата еще не перечислена. В товарных партнерках это состояние называется «Холд».
  • Продажа (sale) — лид подтвержден, выплата произведена.
  • Отклонено (rejected) — лид отклонен партнерской сетью. Если ранее у конверсии стоял статус «Продажа», выплата отменяется.
  • Ребилл (rebill) — конверсия в этом статусе говорит о том, что приведенный клиент совершил еще одну покупку или продление услуги. Вы видите эту конверсию в отчете Конверсии, но показатели лидов и продаж при этом не увеличиваются. Если партнерская сеть поддерживает допродажи (ребиллы), необходимо включить опцию «Допродажи» в настройках оффера.

Возможные переходы состояний:

  • Продажа
  • Отклонение
  • Продажа → Ребилл (если у оффера включена опция «Допродажи»)
  • Лид → Продажа
  • Лид → Продажа → Ребилл
  • Лид → Отклонение (если у оффера включена опция «Допродажи»)

Допускается также смена состояний «Лид → Лид», что позволяет организовать многоэтапное ведение лида. Например, «Корзина → Заказ → Оплата → Звонок».

Названия статусов могут быть произвольные, но у них обязательно должна быть связь с одним из системных статусов. Связь можно указать через параметры постбека. Например, у нас 3 статуса: accept, confirm, reject. Тогда в постбеке передается следующее:

&lead_status=accept&sale_status=confirm&rejected_status=reject

В отчете конверсии, вы можете добавить колонку «Оригинальный статус», чтобы видеть полученные статусы.

Returning Sub IDs on Conversion

Your publisher may want you to return their partner sub ID values via the partner conversion link. To set this up, first go to Partners > Conversion Pixels / URLs. You can add a new link (by clicking Add Conversion Pixel / URL) or edit an existing link (by clicking Edit). Then insert the {aff_sub} macro in the appropriate partner conversion link parameter.

For example, your publisher may want to accept the {aff_sub} macro in their “session” parameter. The partner conversion link after inserting the macro would look something like this:

http://track.publisherstuff.com/conversion?session={aff_sub}

С этим читают