Ad Placeholder

The Ads-Placeholder component allows author to insert 3rd-Party Ads

Examples

Authoring

Properties

Ad Placeholder via Adobe Experience Launch

Integrating 3rd-party ads through Adobe Experience Launch.

Examples

• Author link on Stage
• Published link on Stage

Setup the Launch connection to the site (if not already configured)

1. Request access to Launch if you don’t already have it.
2. Request new web property (if one doesn’t already exist) in Launch from Chris Hogg/Alex Krikun.
3. Chris/Alex should provide a Report Suite ID and Launch embedded URL, these go into the site’s language page properties under the analytics tab as shown in Illustration 1 below.
4. Publish the language page.
5. Verify that the launch embedded code is coming through on the site. You can view sources in your browser tools and you should see ‘assets.adobedtm.com’ with the launch file underneath it being included as shown in Illustration 2.

Illustration 1. Analytics tab under the language page properties

Illustration 2. Launch embed code verification using browser tools

Create the Ad Code rule in Launch

1. Access Adobe Experience Launch (TA – URL should be https://experience.adobe.com/#/@informaglobalexhibitions/launch)
2. Find the web property for the site (e.g. “Informa_dev_EventTest_Sample” is being used here
3. Under ‘Authoring’ in the left sidebar menu, select ‘Rules’
4. Click ‘Add Rule’
5. You’ll need to add an ‘Event’, ‘Condition’, and ‘Action’
6. Set the ‘Event’ to “Library Loaded (Page Top)”. This tells the code we’ll add where and when to load on the page
7. Set the ‘Condition’ to ‘Condition Type: Domain’ and you should see the available domains already associated with that web property on the right. Check the domain for the site.
8. Add an ‘Action’. Select ‘Action Type: Custom Code’. Select ‘HTML’ and click ‘Open Editor’
9. Add the Ad Code provided by Ad Operations into this component. Make sure to remove any DIV tags from the HTML (e.g.
   ) otherwise those will be output with the code and display the ads in unwanted locations (I saw them show up beneath the footer).
10. Return to the main Rule page and click ‘Save to Library’. If it asks which Library to save to, select ‘initial Config’ as that seemed to be the only library setup at the time for the web property.
11. Click ‘Build’ on the library to rebuild and include your new rule/ad code into the Launch code that will be output on the site. You can also check the status of the library and publish it from the ‘Publishing Flow’ option in the left menu.

Add the Ad Placeholder Components to the V2 Site to verify they’re working (Note that once everything is working, marketers/MEMs should be able to add/move Ad positions easily).

1. Drag the ‘Ad Placeholder’ component onto an AEM page where you want an Ad to display
2. In the Ad Placeholder config, add the Div ID from the associated ad unit. For example, the main leaderboard is “gpt-728_1”. You can find the Div IDs in the original Ad Code provided by Ad Operations.
3. Publish the page and view to see if the Ad is coming through. Note: If the domain set in the ‘Condition’ of the Launch rule does not include the author domain, you won’t see these appear on Author/View as Published. You’ll only see the Launch code come through on the domain selected in the Rule.

Troubleshooting

You can use the googletag console to view if the ads are setup correctly or not. On the page the ads should be appearing, type “googletag.openConsole()” into your browser console.

If you receive an error back that says googletag is undefined, that means the Ad Code isn’t included properly on the page

You should see a new console appear with info on the Ad Units

• These will tell you what Ads are configured to display on that page and whether they’re being displayed currently or not. An example of when this is useful is if there are currently no Ads scheduled to run for that particular Ad Unit, this will verify that your code is working correctly but will say ‘Not Displayed’ to indicate there is nothing scheduled currently.
• The ‘Page Request’ tab will tell you if there are any errors with the Ad Code itself. If there are Errors, you can try to correct or otherwise send this back to Ad Operations to request what the code should be.