Skip to main content

GAM Integration

Configure Google Ad Manager targeting for converted users.

Concept

When a user disables their ad blocker via Ad Sentinelle, you can:

  1. Identify these users in GAM via a key-value
  2. Create specific line items with higher CPM
  3. Optimize monetization for this premium segment

Automatic Configuration

By default, Ad Sentinelle automatically injects targeting after conversion:

// Automatically injected
googletag.pubads().setTargeting('adwall_status', 'converted');

Configure in GAM

Step 1: Create Key-Value

  1. In GAM, go to InventoryKey-values
  2. Click "New Key-Value"
  3. Configure:
    • Name: adwall_status
    • Type: Predefined
    • Values: converted, not_converted

Step 2: Create Targeted Line Item

  1. Go to DeliveryLine Items
  2. Create new line item
  3. In Targeting section:
    • Add CustomizationKey-values
    • Select adwall_status = converted
  4. Set higher CPM (these users are valuable)
Line item: "Ad Sentinelle Converted - Premium"
├── Targeting: adwall_status = converted
├── CPM: $5.00 (vs $2.00 standard)
└── Priority: 12

Step 3: Test Targeting

  1. Convert on your test site
  2. Open GAM console
  3. Verify targeting is sent
googletag.pubads().getTargeting('adwall_status');
// Should return ['converted']

Advanced Configuration

Custom Targeting

window.addEventListener('adwall:converted', function(e) {
// Standard targeting
googletag.pubads().setTargeting('adwall_status', 'converted');

// Additional targeting
googletag.pubads().setTargeting('adwall_variant', e.detail.variant);
googletag.pubads().setTargeting('adwall_date', new Date().toISOString().split('T')[0]);
});

Refresh Ads After Conversion

window.addEventListener('adwall:converted', function() {
googletag.pubads().setTargeting('adwall_status', 'converted');
googletag.pubads().refresh();
});

Prebid.js Integration

window.addEventListener('adwall:converted', function() {
pbjs.setConfig({
ortb2: {
user: {
data: [{
name: 'adwall',
segment: [{ id: 'converted' }]
}]
}
}
});

pbjs.requestBids({
timeout: 1000,
bidsBackHandler: function() {
pbjs.setTargetingForGPTAsync();
googletag.pubads().refresh();
}
});
});

Monetization Strategies

Option 1: Higher CPM

Create line items with higher CPM for converted users:

SegmentStandard CPMConverted CPM
Display$1.50$3.00
Video$8.00$15.00
Native$2.00$4.00

Option 2: Premium Partners

Reserve converted users for premium partners:

Line item: "Partner Premium - Converted Only"
├── Targeting: adwall_status = converted
├── Deal ID: 12345
└── Priority: 10

Line item: "Open Auction - All Users"
├── Targeting: (none)
└── Priority: 12

Option 3: Exclusive Formats

Offer higher-paying formats only to converted users.

GAM Reporting

Create Performance Report

  1. Go to ReportsNew Report
  2. Dimensions: Key-values (adwall_status)
  3. Metrics: Impressions, Revenue, eCPM
  4. Filter by period

Metrics to Follow

MetricCalculationGoal
Converted ImpressionsImpr. where adwall_status=convertedVolume
Additional RevenueConverted Revenue - (Standard × Rate)ROI
eCPM UplifteCPM converted / eCPM standardPerformance

Troubleshooting

Targeting Not Sent

  1. Verify googletag loads before Ad Sentinelle
  2. Check console for errors
  3. Test manually:
googletag.pubads().setTargeting('adwall_status', 'converted');
console.log(googletag.pubads().getTargeting('adwall_status'));

Ads Don't Refresh

Call refresh() after setting targeting:

window.addEventListener('adwall:converted', function() {
googletag.cmd.push(function() {
googletag.pubads().setTargeting('adwall_status', 'converted');
googletag.pubads().refresh();
});
});
Tip

Create an "Ad Sentinelle Converted" segment in your DMP for cross-platform data use.