Advertising Entity

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 and ad_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.
  The ad_entity_dfp module for example enables you to create
  types of Doubleclick for Publishers (DFP) advertisement.
  This module can be found in the modules 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.