This module provides a unified way to display ads on your Drupal website.
Why you might want this module to have a consolidated ad management:
- Be able to attach targeting information in one way accross multiple ad providers based on your content via Advertising context fields. You can also turn off ads on specific content pages through that field type.
- Always be able to replace your existing ads by others of any type with just a few clicks, without losing any targeting context.
- All your ads respect your theme's breakpoints in the same way by using the Theme Breakpoints JS module.
- Configure consent-aware personalization: This module offers a unified way to configure GDPR compliant ads.
Available provider integrations
- Google Ad Manager / Doubleclick for Publishers (DFP) , included in this module.
- AdTech Factory, included in this module. Please use the included ad_entity_adtech_v2 module for new projects, the ad_entity_adtech module is not supported anymore.
- Video Intelligence
- Smart AdServer
- For advanced use cases, the already included ad_entity_generic submodule provides a skeleton to manage ads of custom and arbitrary types.
Have a further integration based on ad_entity
and want to list it here? Please tell us!
Requirements
- The Entity API module.
- If you want to setup ads, which respect your theme breakpoints, then you need the Theme Breakpoint JS module.
Quick start
- Install this module.
- Set permissions to view ads. As there are two separate entity types (
ad_entity
andad_display
) involved, make sure your roles do have granted view access to both types by setting: "View Advertising entities" and "View Display configs for Advertisement". - You need at least one further module which defines an Advertising type.
Thead_entity_dfp
module for example enables you to create
types of Doubleclick for Publishers (DFP) advertisement.
This module can be found in themodules
subfolder. - Configure global settings for Advertising entities
at admin/structure/ad_entity/global-settings. - Create and manage your Advertising entities at admin/structure/ad_entity.
When your theme has multiple breakpoints, you can create one entity for each. - Create and manage Display configurations for your Advertisement at
admin/structure/ad_entity/display. Once you've created a Display config,
you'll be able to place it as a block at admin/structure/block.
About view handlers
For each advertising type, there are usually different view handlers to choose:
- A default HTML view, which is the way for viewing the ads on a regular page.
- An iframe, which could be used for feeds or publishing on external sources.
- Facebook Instant Articles (FIA), which is basically an iframe as well.
- Accelerated Mobile Pages (AMP), currently only provided by the DFP submodule.
About Advertising contexts
A given Advertising context is able to extend or manipulate the information and
defined behavior for Advertising entities being displayed on a page.
Advertising context can be defined by content such as nodes and taxonomy terms.
To enable users defining contexts, the Advertising context
field must be
attached to an entity type. Choose unlimited cardinality to let users add multiple contexts.
The field provides different formatters for the Advertising context.
In the Manage display
section of your entity type, place the context field
into the content region to deliver the user-defined context on the page.
Project information
- Seeking new maintainer
The current maintainers are looking for new people to take ownership. - Module categories: E-commerce
- 94 sites report using this module
- Created by mxh on , updated
- Drupal 10 is here!
This module works with D10.
- Stable releases for this project are covered by the security advisory policy.
Look for the shield icon below.
Releases
Development version: 8.x-1.x-dev updated 16 Apr 2024 at 06:54 UTC