Google Ad Manager (GAM)

9min
Introduction
This guide simplifies the integration of MomentScience with Google Ad Manager (GAM). Follow these steps for a quick and effective setup to enhance your website's advertising capabilities.

Requirements
Your JS SDK snippet (obtainable through the Dashboard).
Access to your Google Tag Manager account.
Information on the page link/URL structure where you'll display the MomentScience unit (e.g., order confirmation page)



Steps Overview
Navigate to Google Ad Manager and select Delivery > Creatives.
Under Display Creatives, click "New Creative."
Choose your advertiser and select "Third party."
Enter a name for your creative (e.g., MomentScience – banner – 1x1 - 1).
Set the Target ad unit size size to 1x1 for universal compatibility.
Select "Standard" for the Code type and paste the JS SDK snippet.
Save your settings.
For additional guidance on setting up third-party creatives, refer to this Google Ad Manager support article.
﻿
Passing Payload Values (Optional)
To pass payload values with a GAM-driven implementation of MomentScience, you have two options:
Declare the payload object before loading MomentScience via GAM
Set payload values and refresh the MomentScience unit afterward

Option 1: Declare Payload Object Before Loading MomentScience via GAM

Determine the payload values you want to pass.
Use the following code snippet to pass your payload, Just replace the customAttribute with the desired attribute(s) and value(s).
Passing Payload Values
// Set a new payload attribute "customAttribute" with value 'someValue'

window.AdpxUser = Object.assign(window.AdpxUser || {}, { "customAttribute": 'someValue' });
// Set a new payload attribute "customAttribute" with value 'someValue'

window.AdpxUser = Object.assign(window.AdpxUser || {}, { "customAttribute": 'someValue' });
﻿

To set multiple payload attributes at once, use:
Passing Multiple Payload Attributes Once
window.AdpxUser = Object.assign(window.AdpxUser || {}, {
  "attributeOne": 1,
  "attributeTwo": 3.41,
  "customAttribute": 'newValue'
});
window.AdpxUser = Object.assign(window.AdpxUser || {}, {
  "attributeOne": 1,
  "attributeTwo": 3.41,
  "customAttribute": 'newValue'
});
﻿
When a payload attribute is set, it overwrites any existing value for that attribute. For example, if both snippets are used, the final value for the payload attribute "customAttribute" would be set to "newValue".
Option 2: Set Payload Values After MomentScience Initialization via GAM
To set payload values after MomentScience is initialized via GAM, follow these steps:
Modify the Moments JS SDK Snippet to prevent MomentScience from loading on initialization by setting autoLoad: false.
This allows payload values to be added on page load.
To launch the unit and refresh/display it with the updated payload values, call window.Adpx.refresh().
The MomentScience JS SDK Snippet provided displays MomentScience at run-time by default. To delay its display and add payload values on page load, set autoLoad: false. Afterwards, you can launch the unit with the updated payload values by calling window.Adpx.refresh().
﻿
📢 If you're running into any issues while going through the integration process, feel free to contact us at [email protected] 
Updated 21 Sep 2024
Did this page help you?
Google Tag Manager (GTM)
Mobile