This package allows you to easily integrate advertising blocks from the Yandex Advertising Network onto any website built using the Django framework.
Project description
Django Yandex Ad Manager
A comprehensive Django application for managing and displaying Yandex advertising blocks with advanced configuration options. See the comprehensive guide on https://timthewebmaster.com/en/tools/django-yandex-ad-manager/
Features
- Multiple Ad Types: Support for banners, full-screen ads, floor ads, top ads, carousels, and in-image ads
- Platform Targeting: Display ads on specific platforms (desktop, mobile, or cross-platform)
- Flexible Configuration: Manage ad locations, display frequency, and placement rules
- Middleware Integration: Automatic ad injection into templates based on view and template rules
- Customizable Templates: Extensible template system for different ad formats
- Context-Aware: Smart ad placement with context data integration
- Pagination Support: Automatic ad insertion between content pages
Installation
pip install django-yandex-ad-manager
Requirements
- Django 3.2+
- Python 3.7+
Configuration
1. Add to INSTALLED_APPS
INSTALLED_APPS = [
# ...
'django_yandex_ad_manager.apps.YandexadmanagerConfig',
# ...
]
2. Add Middleware
MIDDLEWARE = [
# ...
'django_yandex_ad_manager.middleware.AdManagerMiddleware',
# ...
]
4. Set up allowed views and templates, to render into
# Yandex ad manager
# For example, you should paste your view's names and templates
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' )
3. Run Migrations
python manage.py migrate
4. Configure Static Files
Make sure to collect static files after installation:
python manage.py collectstatic
Models Overview
YandexAdBlock
Defines individual ad blocks with properties:
- Ad Types:
banner,fullscreen,floorAd,topAd,feed,inImage - Push Triggers:
on-load,on-intersectionThis means when your website should make a request to Yandex, to retrieve an Ad.- on-load means as soon as possible
- on-intersection means when users viewport intersects with an Ad element.
- Platform Targeting:
desktop,mobile,crossplatform
YandexAdLocation
Maps ad blocks to specific locations on your site. You should specify them by yourself
YandexAdBlockConfiguration
Groups ad locations and defines display frequency.
YandexCurrentAdBlockConfiguration
Singleton model to manage the currently active ad configuration.
Template Integration Examples
1. Required Headers in Base Template
Include these in your base template's head section (<head> tag):
{% if isYandexAdManagerMiddlewareConnected %}
{% include 'YandexAdManager/admanager_header.html' %}
{% endif %}
2. Styles and Scripts
Include in your base template's styles and scripts blocks:
{% block styles %}
{% if isYandexAdManagerMiddlewareConnected %}
{% include 'YandexAdManager/admanager_styles.html' %}
{% endif %}
{% endblock %}
{% block scripts %}
{% if isYandexAdManagerMiddlewareConnected %}
{% include 'YandexAdManager/admanager_scripts.html' %}
{% endif %}
{% endblock %}
Ad Placement Examples
The blocks below should be used whenever you want your ad to be displayed. This is not applied to those Ad blocks without containers (topAd, floorAd, fullscreen, inImage)
Single element Integration
{% 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 %}
Multiple elements Integration
unificator should be used only if you use one YandexAdBlock for different location on the same page
{% if isYandexAdManagerMiddlewareConnected %}
{% for adlocation in adlocations %}
{% if adlocation.adlocation_name == "HOME_FIRST_VISIBLE" %}
{% include 'YandexAdManager/admanager_element.html' with adblock=adlocation.adblock unificator="home_first_visible" %}
{% endif %}
{% if adlocation.adlocation_name == "HOME_SECOND_VISIBLE" %}
{% include 'YandexAdManager/admanager_element.html' with adblock=adlocation.adblock unificator="home_second_visible" %}
{% endif %}
{% endfor %}
{% endif %}
Paginated Lists Integration
{% 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 %}
Advanced Configuration
Display Frequency Control
Control how often ads appear in paginated lists:
# In YandexAdBlockConfiguration model
adnetwork_step_by = 3 # Show ad every 3 items
Platform Targeting
# Available options
PlatformToDisplay.CROSSPLATFORM # All devices
PlatformToDisplay.DESKTOP # Desktop only
PlatformToDisplay.MOBILE # Mobile only
Push Triggers
PushOn.ON_LOAD # Load immediately
PushOn.ON_INTERSECTION # Load when visible in viewport
Middleware Configuration
The AdManagerMiddleware automatically injects context data and handles ad placement:
class AdManagerMiddleware:
allowed_views = ('home', 'article', 'tool', 'tool_main')
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'
)
Best Practices
- Use descriptive unificators to track ad performance in different locations
- Test on multiple devices when using platform targeting
- Monitor ad density to avoid overwhelming users
- Use intersection-based loading for better performance
- Configure appropriate ad types for different content contexts
Troubleshooting
Ads Not Showing
- Check if middleware is properly configured
- Verify
isYandexAdManagerMiddlewareConnectedis True in templates - Ensure ad locations are properly configured in admin
- Check browser console for JavaScript errors
Performance Issues
- Use
ON_INTERSECTIONfor non-critical ads - Minimize use of full-screen ads
- Implement lazy loading where appropriate
Contributing
- Fork the repository
- Create a feature branch
- Make your changes
- Add tests
- Submit a pull request
License
ISC License - see package.json for details.
Support
For issues and questions, please open an issue on the GitHub repository.
Compatibility
- Django 3.2, 4.0, 4.1, 4.2
- Python 3.7, 3.8, 3.9, 3.10, 3.11
Note: This package is not officially affiliated with Yandex. It's a community-maintained Django integration for Yandex Advertising Network.
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file django_yandex_ad_manager-0.0.3.tar.gz.
File metadata
- Download URL: django_yandex_ad_manager-0.0.3.tar.gz
- Upload date:
- Size: 31.3 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/6.2.0 CPython/3.12.4
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
058a9eb49b442b87239e4aa14a5738dd677434ed162a34f883d848b418b653da
|
|
| MD5 |
be13c4a7dc274358375a18d85338f395
|
|
| BLAKE2b-256 |
1701c0a7ad3f6d32d72996d54e7875bc3a79909f41b8731ff11c5b1240d97959
|
File details
Details for the file django_yandex_ad_manager-0.0.3-py3-none-any.whl.
File metadata
- Download URL: django_yandex_ad_manager-0.0.3-py3-none-any.whl
- Upload date:
- Size: 43.5 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/6.2.0 CPython/3.12.4
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
c1c9ae3ce02afef1cd100eb641bd1f7367560129f5dbc466888dbd378ce21306
|
|
| MD5 |
1219976fad473ec952b9a7ef6b5057a6
|
|
| BLAKE2b-256 |
b74b4adf92eb62e5927dd9b7fc2cffbe54edd6093d97357cd7662a9e958cac1f
|
