Для майданчика на адаптивному коді з перевіркою скролла можна використовувати функцію перезавантаження банера.
Public API
Public API відмінно підходить для односторінкових додатків, для яких важливий повний контроль над станом сторінки. Public API дозволяє запобігти витоку пам'яті і не допускає випадання помилок при знищенні банерів. При використанні повторної ініціалізації все callback функції. які були передані в параметри банера, будуть виконані заново.
Метод window.Ya.adfoxCode.clearSession (); - служить для зміни ідентифікатора сесії (pr) на сторінці для всіх подальших запитів.
Функція перезавантаження коду
Перезавантаження коду вставки дозволяє зробити повторні запити до системи ADFOX без перезавантаження всієї сторінки, наприклад, на сторінках сайту, де користувач перебуває тривалий кількість часу (гортає фотогалерею, проходить тестування).
Управління завантаженням банерів:
де containerId - ідентифікатор елемента, який є контейнером для банера.
Якщо потрібне перезавантаження всіх майданчиків, залиште containerId порожнім.
Приклад виклику перезавантаження майданчики з ідентифікатором контейнера "adfox-id"
Коди для розміщення сторінках AMP і Turbo
Створіть структуру сайту, розділів і майданчиків з використанням типів банерів з відповідною відміткою ( "Turbo" або "AMP").
При отриманні коду вставки інтерфейс автоматично запропонує відповідний для площадки Вид коду:
Асинхронний - для турбо-сторінок;
AMP - для AMP-сторінок. Обов'язково вкажіть значення для параметрів "Ширина" та "Висота"
Приклад отримання коду вставки виду "AMP"
Callback функції в коді вставки
У кодах вставок для безрозмірних типів банерів є можливість використання callback функції:
Викликається, коли отримано відповідь за запит і у відповіді присутній об'єкт window.loadAdFoxBundle. Викликається до onRender.
Аргументи callback onLoad:
Застарілі види кодів
Синхронний код (застарів)
Синхронний код вставки генерується для Стандартних типів банерів.
На даний момент синхронний код є застарілим видом і деякі можливості ADFOX на цьому виді коду не підтримуються.
Рекомендуємо перевести всі синхронні майданчика на асинхронні коди вставки. За подробицями звертайтеся в службу технічної підтримки.
Приклад синхронного коду вставки
Асинхронний код (застарів)
Асинхронний код вставки, що вимагає підключення додаткових бібліотек на сайт, є застарілою версією і рекомендується його замінити на асинхронний код без підключення окремих бібліотек.
Приклад асинхронного коду вставки (застаріла версія з підключенням бібліотеки)
Асинхронний код з перевіркою скролла (застарів)
Асинхронний код з перевіркою скролла, що вимагає підключення додаткової бібліотеки на сайт, є застарілою версією і рекомендується його замінити на асинхронний код з перевіркою скролла без підключення окремих бібліотек.
Приклад асинхронного коду вставки з перевіркою скролла (застаріла версія з підключенням бібліотеки)
Для майданчиків, створених з XML-типами банерів, в інтерфейсі ADFOX генеруються посилання для отримання XML.
Приклад посилання для отримання XML
прості посилання
Посилання працюють тільки в тому випадку, якщо банер і РК активні і проходять по таргетування і обмеженням.
Посилання працюють незалежно один від одного. Наприклад, можна отримати тільки Кликова посилання, тоді у банеру не буде статистики по показах, але будуть вважатися кліки.
Розширені можливості пошуку в коді вставки
Додавання параметрів в код вставки проводиться або в об'єкт params (для асинхронних кодів), або в рядок запиту до сервера ADFOX (для синхронних і XML кодів).
При підстановці значень до параметру pk кодування значень не потрібно.
Синтаксис додавання для асинхронних кодів:
Якщо value є текстом, то робимо висновок в одинарні лапки.
Якщо value є ім'ям змінної, то залишаємо без лапок.
Якщо новий параметр додається останнім, то кома в кінці не потрібна.
Приклади додавання параметрів:
Приклад 1 - додавання puid1 з одним значенням і puid2 з декількома значеннями через роздільник - двокрапка
Приклад 2 - додавання eid1 зі значенням firstEid
Приклад 3 - додавання pk з одним ключовим словом
Приклад 4 - додавання pk з кількома ключовими словами через роздільник - пробіл
Приклад 5 - додавання pk з ключовою фразою. Ключова фраза може бути передана тільки одна.
Синтаксис додавання для синхронних кодів, асинхронних кодів (застаріла версія) і XML:
Знайдіть рядок запиту до сервера ADFOX, наприклад:
додайте новий параметр, розділяючи назву і значення символом рівності (=).
Наприклад, додамо параметр eid1 зі значенням firstEid: