Recommended Fields

While not strictly required, these fields significantly improve targeting accuracy, bid performance, and overall revenue. Publishers should include as many of these fields as possible.

Overview

Including recommended fields provides:

Better Targeting: More accurate ad matching
Higher CPMs: Better targeting = higher bids
Improved Fill Rate: More bidders can participate
Better User Experience: More relevant ads

High Priority Recommended Fields

These fields have the highest impact on performance and should be included whenever possible.

Site/App Identification

Field	Type	Impact	Description
`site.publisher.id`	string	Very High	Publisher account ID (assigned by Affinity AI)
`site.id`	string	High	Site ID for publisher tracking
`site.domain`	string	High	Publisher domain for brand safety
`site.keywords`	string	High	Keywords for contextual targeting
`app.id`	string	High	App ID for publisher tracking
`app.bundle`	string	High	App bundle ID for targeting
`app.keywords`	string	High	Keywords for contextual targeting

{
  "id": "req-001",
  "imp": [{...}],
  "site": {
    "id": "site-123",
    "domain": "publisher.com",
    "keywords": "family,travel,vacation,resorts",
    "publisher": {
      "id": "my-publisher-id"
    }
  }
}

Impact: Publishers providing publisher.id, domain, and keywords typically see 15-25% higher CPMs.

Device Information

Field	Type	Impact	Description
`device.ua`	string	High	User agent for device detection
`device.ip`	string	High	IP address for geo-targeting
`device.language`	string	Medium	Browser/device language
`device.ifa`	string	Medium	Advertising ID (IDFA/AAID)
`device.dpidsha1`	string	Low	SHA1 hashed platform device ID
`device.dpidmd5`	string	Low	MD5 hashed platform device ID
`device.geo`	object	High	Geographic location (country)

{
  "device": {
    "ua": "Mozilla/5.0 (iPhone; CPU iPhone OS 14_5 like Mac OS X) AppleWebKit/605.1.15",
    "ip": "192.0.2.1",
    "language": "en",
    "geo": {
      "country": "USA"
    },
    "ifa": "AEBE52E7-03EE-455A-B3C4-E57283966239",
    "dpidsha1": "AA000DFE74168477C70D291f574D344790E0BB11"
  }
}

Impact: Including ua, ip, and geo.country can increase fill rate by 20-30%.

Content Language

Field	Type	Impact	Description
`site.content.language`	string	Medium	Content language (ISO-639-1)
`app.content.language`	string	Medium	Content language (ISO-639-1)

{
  "site": {
    "id": "site-123",
    "domain": "publisher.com",
    "keywords": "golf,resorts,vacation,family,california",
    "content": {
      "language": "en"
    }
  }
}

Impact: Providing content language can improve targeting accuracy by 5-10%.

User Information (Privacy-Compliant)

Field	Type	Impact	Description
`user.id`	string	Low	User ID (if available)

{
  "user": {
    "id": "user-abc123"
  }
}

Important: Only include user data if you have proper consent and comply with privacy regulations.

Affinity AI-Specific Recommended Fields

These optional Affinity AI extensions significantly improve targeting for AI-native advertising.

Context Enhancement

Field	Type	Impact	Description
`ext.aura.intent`	object	Very High	User intent classification
`ext.aura.sentiment`	object	High	Sentiment analysis
`ext.aura.conversation`	object	Medium	Conversation metadata

{
  "ext": {
    "aura": {
      "intent": {
        "value": "information_seeking",
        "confidence": 0.92,
        "topics": ["family travel", "golf", "california resorts"]
      },
      "sentiment": {
        "value": "positive",
        "score": 0.75
      },
      "conversation": {
        "turn_count": 3,
        "session_id": "session-abc123",
        "funnel_stage": "consideration"
      }
    }
  }
}

Impact: Context enhancement can increase CPMs by 40-60% for AI-native formats.

View context enhancement documentation →

AdCP Format Support

Field	Type	Impact	Description
`imp.ext.aura.adcpFormats`	object[]	High	Supported AdCP formats

{
  "imp": [
    {
      "id": "imp-1",
      "native": {
        "request": "{\"native\":{\"ver\":\"1.2\",\"assets\":[{\"id\":1,\"required\":1,\"title\":{\"len\":80}}]}}"
      },
      "ext": {
        "aura": {
          "adcpFormats": [
            {
              "agent_url": "https://creative.adcontextprotocol.org",
              "id": "display_300x250"
            }
          ]
        }
      }
    }
  ]
}

Impact: AdCP support can increase fill rate by 15-25% and CPMs by 10-15%.

View AdCP format support →

Privacy & Compliance Fields

These fields are critical for privacy compliance and should be included when applicable.

Field	Type	Required When	Description
`regs.ext.gdpr`	integer	EU traffic	GDPR applies flag (0/1)
`user.ext.consent`	string	GDPR=1	Consent string

{
  "regs": {
    "ext": {
      "gdpr": 1
    }
  },
  "user": {
    "ext": {
      "consent": "CPXxRfAPXxRfAAfKABENB-CgAAAAAAAAAAYgAAAAAAAA"
    }
  }
}

CCPA Compliance

Field	Type	Required When	Description
`regs.ext.us_privacy`	string	US traffic	US Privacy string

{
  "regs": {
    "ext": {
      "us_privacy": "1YNN"
    }
  }
}

COPPA Compliance

Field	Type	Required When	Description
`regs.coppa`	integer	Child-directed	COPPA applies flag (0/1)

{
  "regs": {
    "coppa": 1
  }
}

Best Practices by Use Case

AI-Native Advertising

Must Include:

site.publisher.id — publisher account ID assigned by Affinity AI
site.id and site.domain OR app.id and app.bundle
site.keywords OR app.keywords
device.ua
device.ip
device.geo.country
ext.aura.intent

Should Include:

ext.aura.sentiment
ext.aura.conversation
imp.ext.aura.adcpFormats

Impact Summary

Field Category	Fill Rate Impact	CPM Impact	Implementation Effort
Site/App ID	+20-30%	+15-25%	Low
Device Info	+20-30%	+10-15%	Low
Keywords	+10-15%	+10-20%	Low
Context Enhancement	+15-25%	+40-60%	High
AdCP Support	+15-25%	+10-15%	Medium

Testing Recommendations

Baseline Test

Start with minimal required fields:

{
  "id": "baseline-001",
  "imp": [
    {
      "id": "imp-1",
      "native": {
        "request": "{\"native\":{\"ver\":\"1.2\",\"assets\":[{\"id\":1,\"required\":1,\"title\":{\"len\":80}}]}}"
      }
    }
  ]
}

Add High-Priority Fields

{
  "id": "improved-001",
  "imp": [
    {
      "id": "imp-1",
      "native": {
        "request": "{\"native\":{\"ver\":\"1.2\",\"assets\":[{\"id\":1,\"required\":1,\"title\":{\"len\":80}}]}}"
      }
    }
  ],
  "site": {
    "id": "site-123",
    "domain": "publisher.com",
    "keywords": "family,travel"
  },
  "device": {
    "ua": "Mozilla/5.0...",
    "ip": "192.0.2.1",
    "language": "en",
    "geo": {
      "country": "USA"
    }
  }
}

Measure Impact

Track these metrics:

Fill rate (% of requests with bids)
Average CPM
Revenue per 1000 requests (RPM)
Bid response time

Next Steps

Required Fields - Minimum field requirements
Validation Rules - Field validation specifications
Context Enhancement - Rich contextual signals
AdCP Format Support - Advanced creative formats

Support

For questions about recommended fields:

Review field impact data in this guide
Test incrementally to measure impact
Contact support for publisher-specific recommendations

Overview​

High Priority Recommended Fields​

Site/App Identification​

Device Information​

Content Language​

User Information (Privacy-Compliant)​

Affinity AI-Specific Recommended Fields​

Context Enhancement​

AdCP Format Support​

Privacy & Compliance Fields​

GDPR Compliance​

CCPA Compliance​

COPPA Compliance​

Best Practices by Use Case​

AI-Native Advertising​

Impact Summary​

Testing Recommendations​

Baseline Test​

Add High-Priority Fields​

Measure Impact​

Next Steps​

Support​