Django приложение для управления рекламных блоков от РСЯ

Вступление

1. Различные типы рекламных блоков: Поддержка баннеров, полноэкранной рекламы, рекламы в нижней части экрана, рекламы в верхней части экрана, каруселей и рекламы в изображениях
2. Таргетинг на платформу: показ рекламы на определенных платформах (настольных компьютерах, мобильных устройствах или кроссплатформенных).
3. Гибкая настройка: управление местоположением, частотой показа и правилами размещения рекламы.
4. Интеграция с промежуточным ПО: автоматическая вставка рекламы в шаблоны на основе правил представления и шаблонов.
5. Настраиваемые шаблоны: расширяемая система шаблонов для различных форматов рекламы.
6. Контекстная зависимость: интеллектуальное размещение рекламы с интеграцией контекстных данных.
7. Поддержка пагинации: автоматическая вставка рекламы между страницами с контентом.

Обзор моделей

YandexAdBlock

1. Типы рекламных блоков:
2. banner — адаптируется под размер обрамляющего контейнера. Один и тот же блок можно размещать одновременно на разных версиях сайта, и он будет показан на всех устройствах.
3. fullscreen — отображается на весь экран. Для каждой версии сайта нужно создать отдельный блок.
4. floorAd — фиксируется в нижней части экрана поверх содержимого сайта. Для каждой версии сайта нужно создать отдельный блок.
5. topAd — фиксируется в верхней части экрана поверх содержимого сайта только на мобильных устройствах.
6. feed — отображается в виде ленты объявлений. Один и тот же блок можно размещать одновременно на разных версиях сайта, и он будет показан на всех устройствах.
7. inImage — отображается поверх изображений на сайте. Один и тот же блок можно размещать одновременно на разных версиях сайта, и он будет показан на всех устройствах.
8. Триггеры запросов на отрисовку(То есть момент, когда нужно отрисовать рекламу)
9. on-load значит при загрузке страницы
10. on-intersection значит при первом вхождении на экран
11. Platform Targeting:
12. Desktop — только для десктопа
13. Mobile — только для мобильных устройств
14. Cross-platform — на обоих

YandexAdLocation

{% if isYandexAdManagerMiddlewareConnected %} {% for adlocation in adlocations %} {% if adlocation.adlocation_name == "HOME_FIRST_VISIBLE" %} {% include 'YandexAdManager/admanager_element.html' with adblock=adlocation.adblock%} {% endif %} {% endfor %} {% endif %}

YandexAdBlockConfiguration

YandexCurrentAdBlockConfiguration

Installation

pip install django-yandex-ad-manager

INSTALLED_APPS = [ # ... 'django_yandex_ad_manager.apps.YandexadmanagerConfig', # ... ] MIDDLEWARE = [ # ... 'django_yandex_ad_manager.middleware.AdManagerMiddleware', # ... ]

YANDEX_AD_MANAGER__ALLOWED_VIEWS = ('home', 'article', 'tool', 'tool_main') YANDEX_AD_MANAGER__ALLOWED_TEMPLATES = ('PagiScroll/base_post_list.html', 'Post/basic--post_preview-article.html', 'Post/basic--post_preview-note.html', 'Post/basic--post_preview-tool.html' )

python manage.py migrate python manage.py collectstatic

Настройка шаблонов

{% if isYandexAdManagerMiddlewareConnected %} {% include 'YandexAdManager/admanager_header.html' %} {% endif %}

{% block styles %} {% if isYandexAdManagerMiddlewareConnected %} {% include 'YandexAdManager/admanager_styles.html' %} {% endif %} {% endblock %} {% block scripts %} {% if isYandexAdManagerMiddlewareConnected %} {% include 'YandexAdManager/admanager_scripts.html' %} {% endif %} {% endblock %}

block scripts и block styles — это функции моего сайта, просто не забудьте включить необходимые шаблоны, где они будут доступны промежуточному программному обеспечению. То есть там, где вы хотите показывать рекламу.

Настройка мест размещения рекламы

Блоки ниже следует использовать в тех случаях, когда вы хотите, чтобы ваша реклама отображалась. Это не относится к рекламным блокам без контейнеров (topAd, floorAd, fullscreen, inImage).

Одно рекламное место

{% if isYandexAdManagerMiddlewareConnected %} {% for adlocation in adlocations %} {% if adlocation.adlocation_name == "AD_LOCATION_NAME" %} {% include 'YandexAdManager/admanager_element.html' with adblock=adlocation.adblock%} {% endif %} {% endfor %} {% endif %}

Несколько мест размещения рекламы

{% if isYandexAdManagerMiddlewareConnected %} {% for adlocation in adlocations %} {% if adlocation.adlocation_name == "AD_LOCATION_ONE" %} {% include 'YandexAdManager/admanager_element.html' with adblock=adlocation.adblock unificator="home_first_visible" %} {% endif %} {% if adlocation.adlocation_name == "AD_LOCATION_TWO" %} {% include 'YandexAdManager/admanager_element.html' with adblock=adlocation.adblock unificator="home_second_visible" %} {% endif %} {% endfor %} {% endif %}

{% if isYandexAdManagerMiddlewareConnected %} {% for adlocation in adlocations %} {% if adlocation.adlocation_name == "AD_LOCATION_ONE" %} {% include 'YandexAdManager/admanager_element.html' with adblock=adlocation.adblock unificator="home_first_visible" %} {% endif %} {% endfor %} {% endif %} {% if isYandexAdManagerMiddlewareConnected %} {% for adlocation in adlocations %} {% if adlocation.adlocation_name == "AD_LOCATION_TWO" %} {% include 'YandexAdManager/admanager_element.html' with adblock=adlocation.adblock unificator="home_first_visible" %} {% endif %} {% endfor %} {% endif %}

Расположение рекламы на страницах пагинации

{% if isYandexAdManagerMiddlewareConnected %} {# Ads between articles in pagination #} {% for adlocation in adlocations %} {% if adlocation.adlocation_name == "ON_PAGISCROLL_ARTICLES_BETWEEN_PAGES" %} {% include 'YandexAdManager/admanager_element_in_pagination.html' with page=page adblock=adlocation.adblock %} {% endif %} {% endfor %} {% endif %}

Рекомендации

1. Используйте описательные унификаторы для отслеживания эффективности рекламы в разных местах.
2. Тестируйте на нескольких устройствах при использовании таргетинга на платформу.
3. Отслеживайте плотность рекламы, чтобы избежать перегрузки пользователей.
4. Используйте загрузку на основе пересечений для повышения эффективности.
5. Настройте подходящие типы объявлений для разных контекстов контента.

Если реклама не показывается

1. Проверьте правильность настройки промежуточного ПО.
2. Убедитесь, что параметр isYandexAdManagerMiddlewareConnected имеет значение True в шаблонах.
3. Убедитесь, что места размещения рекламы правильно настроены в панели администратора.
4. Проверьте консоль браузера на наличие ошибок JavaScript.