Ad Server Requirements
Required Agreements
- TAG TrustNet Membership Agreement (signed with TAG)
- TAG TrustNet Licensing and Service Level Agreement (signed with Fiducia)
General Requirements
- Ad server providers are required to receive Verified by TAG status before applying for TAG TrustNet Membership.
- Ad server providers are required to support a log level data product available to its clients compliant with specifications set out below, specifically the ‘required’ fields.
Log Level Data Accessibility Requirements
- Log level data access should be provided to clients promptly upon request by the contract owner.
- Log level data files should be provided with comprehensive documentation with detailed descriptions of all data fields provided, required data dictionaries.
- Impression events should be reported in compliance industry guidelines, e.g. IAB begin to render:
Log Level Data Ingestion Automation (Optional)
- To simplify the activation of an Ad servers log level data in TAG TrustNet for clients, the Ad server provider may support the following mechanism:
-
Upon a client’s request for a log level data feed enablement for an owned client or account ID:
- Start continuous upload of client or account ID log files into TAG TrustNet Node Amazon S3 storage bucket provided by Fiducia, or
- Enable client or account ID log data in the data view shared with Fiducia Snowflake account using Snowflake Data Exchange;
-
Fiducia will configure a dedicated instance of TAG TrustNet Node for each Ad server, which will automatically share provided client or account log level data with TAG TrustNet Nodes of client.
-
Data will be protected from unauthorised access end-to-end using encryption in transit and at rest.
-
Compliance with Data Protection Laws
- Log level data provided for ingestion into TAG TrustNet shall not include any Personal Data (as defined below) and, as such, should fall outside of the scope of any data protection laws, including, without limitation, the GDPR and the CCPA. All Personal Data, and any data fields which represent pseudonymous data, shall be removed from the data before it is ingested into TAG TrustNet. “Personal Data” means any information defined as “personal data,” “personal information,” “personally identifiable information,” “nonpublic personal information,” or other similar term under any applicable data protection laws.
Log Level Data Technical Requirements
The tables below list the type of data files required, the frequency, and format.
Log Files Data Required |
Frequency | |
---|---|---|
Ad Server | Impressions, Data Dictionaries | New log file entries shall become available continuously to Fiducia within 24 hours |
Technical Requirements
-
Ad server providers should not change data record contents in internal systems in a way that they will become out of sync with log level data provided to a client. If data restatement is required, then the client or account owners and TAG TrustNet should be informed in a timely fashion so impression events can be reprocessed.
-
Impression log file records and database records provided to a client are deemed immutable in TAG TrustNet for the purpose of ad delivery audit.
-
Impression log file records should be included in the log files no later than 48 hours after the impression event. Any impression log file record delivered beyond this time limit will be ignored for the purpose of ad delivery audit in TAG TrustNet.
-
Timestamps for impression events should be determined server-side using an authoritative time source.
-
Timestamps should always be reported in UTC time zone.
-
If impression records are reported via database (e.g. Snowflake), they should contain both the impression timestamp and timestamp of data record insertion into the log database.
-
As part of the Ad servers log file delivery, data dictionaries allowing the mapping of impression record data fields to their meaning should be provided at least every 24 hours.
-
Ad server provider should make sure that ad server tags are installed in DSPs with passthrough of variables required to fill log level data fields described below, especially “DSP Impression ID Passthrough”.
Required and Recommended Data Fields
Ad server
The following table details the ‘required’ and ‘recommended’ fields for impression events, with references to the OpenRTB specs where appropriate.
Field | Status | Description |
---|---|---|
Event Type | Required | Detailed type of the reported event: impression begin to render, click, conversion, etc. This may be reported as different events for subsequent matching or may be flagged as fields in the single impression event. |
Timestamp | Required | The date and time of the impression event. Has to be reported in sync with authoritative time source in UTC time zone. |
Account ID | Required | Ad Server partner Account ID |
Seat ID | Recommended | Partner’s DSP seat ID. For oRTB 2.x: bidresponse.seatbid.seat. oRTB 3.x: response.seatbid.seat. |
Country | Recommended | The country where the ad was served. For oRTB 2.x: bidrequest.geo.country, oRTB 3.x: request.context.geo.country. |
Device Type | Recommended | The oRTB type of the device if available (oRTB 2.x: bidrequest.device.devicetype, oRTB 3.x: request.context.device.type). See device type in oRTB 2.5 table 5.21 or List: Device Types in oRTB 3.x. |
OS Type | Recommended | OS type. This may differ by data provider and require creation of mapping dictionary. |
Browser Type | Recommended | Browser type. This may differ by data provider and require creation of mapping dictionary. |
City | Recommended | City. |
AdServer Campaign ID | Required | The campaign ID. |
AdServer Creative ID | Required | The creative ID. |
Campaign ID | Recommended | The campaign ID passed from the DSP. |
Insertion Order Number | Recommended | The insertion order number passed from the DSP. |
Creative ID | Recommended | The creative ID passed from the DSP. |
Creative Type | Required | Type of creative (display, video, size etc). |
Page URL | Required | Publisher site URL determined by verification provider. |
Site Domain | Required | The publisher site domain (oRTB 2.x: bidrequest.site.domain, oRTB 3.0: request.context.site.domain). |
App Bundle | Required | The app bundle (oRTB 2.x: bidrequest.app.bundle, oRTB 3.0: request.context.app.bundle). |
App Store URL | Required | The app store URL (oRTB 2.x: bidrequest.app.storeurl, oRTB 3.0: request.context.app.storeurl). |
AdServer Impression ID | Required | Ad server unique impression ID. |
DSP Impression ID Passthrough | Required | Passthrough variable filled by a DSP for ad server tag with: The oRTB ID of the impression request and/or bid request using macro oRTB 2.x: bidrequest.imp.id and bidrequest.id, oRTB 3.x: bidrequest.item.id and bidrequest.id; Vendor-specific DSP unique impression ID, e.g. ${AUCTION_ID} for Google Display Video 360. |
Measurable | Recommended | Whether the impression is measurable for viewability. |
inView | Recommended | Whether the impression was viewable and which viewability specification was applied (IAB, GroupM, display/video etc). |
Download Requirements
Download a copy of the requirements here: TAG TrustNet - Adserver Requirements v2.0.