Правила синхронизации влияют на настройки предложения при переносе предложений из CPAPI в Affise. Правила располагаются на странице настройки новой кампании, а также на странице редактирования существующей кампании. Основная цель правил синхронизации - управление частотой синхронизации для определенных полей предложения в Affise.
Прежде чем начать
Обзор раздела "Правила синхронизации
Правила синхронизации используются для управления частотой синхронизации для определенных полей предложения на Affise. Частота определяется:
Первая синхронизация: соответствующее поле подтягивается к предложению Affise в первый раз, когда оно появляется в исходном ответе API.
Всегда: соответствующее поле подтягивается или обновляется в предложении Affise каждый раз, когда происходит синхронизация.
Отключено: соответствующее поле никогда не подтягивается и не обновляется в Affise offer при каждой синхронизации.
Категории правил синхронизации
Здесь представлено описание категорий правил синхронизации:
Категории: этот раздел можно использовать для группировки предложений по вертикали.
Описание: описание предложения(Предложения > определенное предложение > Общие > Описание).
Выплаты: синхронизируются поля Страна, Устройства, ОС, Тип платежа, Доход, Выплаты, Валюта (Предложения > определенное предложение > Выплаты).
Статус: статус, присвоенный предложению, который извлекается из CPAPI в Affise и устанавливается принудительно. Оставьте его В соответствии с источником, чтобы рекламодатель получал только точный статус предложения.
URL: основной URL для отслеживания (Offers > a certain offer > Tracking).
Caps: заглавные буквы, установленные в предложении(Offers > a certain offer > Caps).
Так как CPAPI использует Affise API для аффилиатов, есть валидация по капчам.
Категории смарт-ссылки: определяет категорию смарт-ссылки, которую предложение будет иметь на Affise.
⚠️ Категория смарт-ссылки должна быть сначала создана на Affise.
Таргетинг трафика: Правило синхронизации используется для управления частотой синхронизации для гео-ограничений. Подробнее о синхронизации таргетинга в CPAPI читайте здесь.
Лендинги: это правило синхронизации доступно только для интеграции Affise <-> Affise. Оно извлекает посадочные страницы, настроенные в разделе Предложения > определенное предложение > Посадочные страницы.
Страны: Ограничения ГЕО по странам для фильтрации всех предложений, одобренных на стороне источника, на основе таргетинга по странам.
Is CPI: имеет информационную цель и показывает модель оплаты для аффилиатов, которые используют ваш API(Offers > a certain offer > General > CPI).
Payments Goal: значение цели, которое будет возвращено в параметре goal постбэка при выполнении целевого действия. Значение по умолчанию равно 1. Отключение синхронизации цели выплат требует отключения правила Caps Sync(Offers > a certain offer > Payouts > Goal value/Goal title).
Название: название предложения(Предложения > определенное предложение > Общие > Название).
URL Preview: в некоторых случаях работает как trafficback. Если вы нажмете на эту ссылку в партнерской панели, вы сможете увидеть, что представляет собой данное предложение в целом(Offers > a certain offer > Tracking > Preview URL).
KPI: имеет информационное назначение(Offers > a certain offer > General > KPI).
⚠️ Affise поддерживает мультиязычное описание только для интеграции Affise <-> Affise.
Тип перенаправления: тип перенаправления предложения, который назначается предложению на Affise и устанавливается принудительно.
Уровень конфиденциальности: уровень конфиденциальности, присвоенный предложению, полученному из CPAPI в Affise (Публичный, Премодерация и Частный).
URL назначения показов: ссылка, которую рекламодатель предоставляет вам, чтобы вы могли отправить ему информацию о показах(Offers > a certain offer > Tracking > Impressions destination URL).
Разрешить впечатления: разрешает отслеживание показов на Affise(Offers > a certain offer > Tracking > Allow impressions).
Примечания: дополнительные примечания, которые рекламодатель может передать внутри своего предложения.
⚠️ Если вы зададите значения в каком-либо поле раздела " Значения по умолчанию ", но одноименное правило синхронизации будет установлено как "Отключено", значение не будет применено. Предложение будет извлечено со значением по умолчанию. Например, вы установили значение Meta-redirect в поле Redirect Type в разделе Default values , но правило синхронизации Redirect Type Sync установлено как Disabled. В этом случае предложение будет содержать HTTP 302 редирект, так как он используется по умолчанию.
Изменение частоты правил синхронизации
Когда вы меняете частоту правил синхронизации (например, с Always на First Sync), помните, что изменения применяются ко всем импортированным предложениям. Импортированные предложения - это предложения, которые CPAPI берет из ленты рекламодателя. Если кампания содержит 100 предложений, но рекламодатель предоставляет 90 предложений в своей ленте API, изменения будут применены только к 90 предложениям.
Если изменить правила синхронизации с First Sync или Disabled на Always, изменения для предложений будут доставляться в Affise только после того, как рекламодатель внесет изменения в источник.
Правило синхронизации Always: особенности
Посмотрите на следующий пример:
В кампании у вас все правила синхронизации имеют значение First Sync (или Disabled), кроме Title. Вы изменили Title в предложении вручную/посредством API на Affise. Эти изменения останутся до тех пор, пока рекламодатель не изменит что-либо еще (например, Caps) на своей стороне. CPAPI заметит такие изменения. Поскольку правило синхронизации для Caps - First Sync, Caps не будет обновляться, но новые Title на Affise будут стерты (возвращены к версии, которая есть у рекламодателя сейчас), поскольку правило синхронизации для Title - Always. Этот принцип применяется ко всем правилам синхронизации, которые есть в кампании.
Ниже приведены случаи, с которыми вы можете столкнуться при работе с CPAPI:
У вас есть правило синхронизации Title как Always, правило синхронизации Cap как First Sync, и вы изменили Title вручную/посредством API в Affise. CPAPI совершил API-вызов к рекламодателю и не обнаружил никаких изменений в Caps, все значения в Caps остались прежними. Ваш Title останется прежним, по крайней мере, до следующего вызова API, который сделает CPAPI.
У вас правило синхронизации Title установлено как Always, правило синхронизации Cap - как First Sync, и вы изменили Title вручную/посредством API на Affise. CPAPI выполнил вызов API к рекламодателю и обнаружил, что рекламодатель не передал Caps как целый параметр (в нем нет параметров и значения). Ваш Title останется прежним, по крайней мере, до следующего вызова API, который сделает CPAPI.
Вы установили правило синхронизации Title Sync как Always, правило синхронизации Cap Sync как First Sync, и вы изменили Title вручную/посредством API на Affise. CPAPI совершил вызов API к рекламодателю и обнаружил, что рекламодатель передал пустой параметр Caps без какого-либо значения. Ваш Title останется прежним, по крайней мере, до следующего вызова API, который сделает CPAPI.
Изменения ⚠️ учитываются, даже если рекламодатель передал "-" или "0". Любое значение имеет значение.
4. У вас правило Title Sync установлено как Always, правило Cap Sync - как First Sync, и вы изменили Title вручную/посредством API на Affise. CPAPI выполнил вызов API к рекламодателю и обнаружил изменения в Caps. Неважно, на какой частоте действует правило синхронизации для Caps, ваш Title будет удален (возвращен к версии, которая есть у рекламодателя).
Особые правила синхронизации
Уровень конфиденциальности: если это правило установлено как Отключено, все предложения попадают в Affise как Публичные.
URL & Impression Destination URL: поскольку вы можете настроить параметры и макросы для обеих ссылок на странице настройки источника спроса, вам необходимо знать следующее:
Если правило синхронизации установлено как Disable, система не будет обновлять обе ссылки с параметрами и макросами, которые вы установили.
Если правило синхронизации установлено как First Sync, система обновляет обе ссылки с параметрами и макросами только один раз. Если вы обновите параметры и макросы на странице настройки источника спроса после того, как они были извлечены в Affise, система не будет обновлять их еще раз.
Если правило настроено как Всегда, система обновляет обе ссылки с параметрами и макросами каждый раз, когда вы обновляете их на странице настройки источника спроса.
Тип перенаправления: если это правило установлено как Отключено, все предложения будут перенаправляться в Affise с типом перенаправления HTTP 302.
Цель выплат: если при создании кампании это правило изначально отключено, все предложения по умолчанию будут содержать "1" в качестве значения цели.
Payments Goal & Caps: оба эти правила имеют взаимную проверку:
Если для Caps выбрано значение First Sync, то для Payments Goal может быть установлено значение First Sync или Always.
Если Caps - Always, цель платежей должна быть установлена только как Always.
Если Caps имеет значение Disabled, цель платежей может быть установлена как First Sync, Always и Disable.
🔎 Посмотрите на этот пример: вы установили правило Caps как First Sync, Payments Goal как Always, а Caps настроены для определенной цели. В этом сценарии может возникнуть ошибка обновления предложения при изменении цели выплат в источнике рекламодателя. Это означает, что колпачки установлены для несуществующей цели. Такая же ошибка может возникнуть, если цель платежей установлена как Always, а вы изменили правило Caps Sync с Always на Disabled.
Caps: опция Overcap не зависит от правила синхронизации Caps.
🔎 Например:
Caps настроены как First sync или Disbaled, а Overcap включен на CPAPI и выключен на Affise. Как только происходит синхронизация, оверкап становится активным на Affise.
Caps отсутствуют в предложении на CPAPI, Caps настроены как First sync, а Overcap включен на Affise. После синхронизации Caps остаются в предложении, но Overcap становится неактивным на Affise.
Таргетирование трафика: подробнее об этом читайте здесь.
⚠️ Если вы используете CR Automation или Click Automation, лучше использовать правило синхронизации Traffic targeting Sync в качестве первой синхронизации. В противном случае система будет стирать заблокированные значения sub2 каждый раз, когда CPAPI выводит предложение на Affise.
Пожалуйста, свяжитесь с командой поддержки клиентов Affise по всем возникшим вопросам по электронной почте: [email protected].