Правила синхронизации влияют на настройки оффера при переносе офферов из 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].