Importing Key-Values from GAM
Import your GAM key-values for use in targeting and reporting.
What are key-values?
Key-values are custom targeting parameters in Google Ad Manager:
| Key | Example values | Use case |
|---|---|---|
content_type | article, video, gallery | Target by content |
section | sports, news, entertainment | Target by section |
pos | top, sidebar, footer | Target by position |
How key-values are imported
Connecting GAM (see Connecting GAM) grants Anima access to your network — it doesn't pull key-values automatically. You import them on demand:
- Switch to Ad Manager (main) mode
- Go to Inventory → GAM
- Click Import to pull all reportable keys, or use the dropdown for Filter by Name / Exact Name
To refresh a single key after a change in GAM, use its per-row Sync from GAM action. Anima doesn't run a background job that re-pulls key-values on a schedule — they update only when you import or sync.
Viewing imported key-values
- Switch to Ad Manager (main) mode
- Go to Inventory → GAM
- Key-values surfaced from your GAM network are listed there
| Column | Description |
|---|---|
| Key | The key name |
| Values | Allowed values (if predefined) |
| Type | Predefined or freeform |
| Status | Active/Inactive |
Using key-values
In layout targeting
Use key-values to target layouts:
- Edit a layout
- In Targeting, add key-value conditions
- Example:
section = sportstargets sports pages
In reporting
Key-values appear as dimensions in reports:
- Go to Dashboard → Monetization
- Add key-value as a dimension
- Segment data by key-value
Key-value types
Predefined values
Fixed list of allowed values:
content_type: article, video, gallery- Only these values are accepted
Freeform (dynamic)
Any value accepted:
author: john-smith, jane-doe, etc.- Values created as they're used
Passing key-values from your site
For key-values to work, your site must send them with ad requests:
// Example: Setting key-values on your page
window.googletag = window.googletag || { cmd: [] };
googletag.cmd.push(function() {
googletag.pubads().setTargeting('section', 'sports');
googletag.pubads().setTargeting('content_type', 'article');
});
Your development team will implement this based on your site's technology.
Troubleshooting
Key-values not appearing
| Cause | Solution |
|---|---|
| Not imported yet | Run Import from Inventory → GAM |
| Key-value not in GAM | Create it in GAM first |
| Recent GAM change | Use the per-row Sync from GAM, or re-import |
Values not matching
If targeting isn't working:
- Verify the key name matches exactly (case-sensitive)
- Check value spelling
- Confirm your site is passing the values correctly