Ad Server Integration for Yield Analytics

Ad Server Integration

Salesforce DMP's Yield Analytics reports allow you to understand and analyze audience segment delivery and yield across all ad impressions, irrespective of whether an ad was targeted to an audience segment or not. The "raw" ad impression delivery information is combined with the user audience segment map managed in the Salesforce DMP to produce these audience segment delivery and yield reports.

Salesforce DMP requires access to the "raw" ad impression information via ad impression log files. Please refer to your contract and coordinate with your Salesforce DMP Solutions team on how these log files will be accessed for your account.

The ad impression log file contains a record of every impression delivered, and each impression delivery record must contain the Krux User ID of the user who saw the ad. Note that it is not required for every delivery record to contain the Krux User ID; Salesforce DMP simply ignores the records that don't contain the Krux User ID, but the accuracy of the reports is directly proportional to the number of records that contain the Krux User ID.

The following sections describe the format of the Ad Server Log files that can be ingested by the Salesforce DMP to generate audience segment yield analytics reports for all direct-sold inventory that is managed by your first party ad server.

Ad Server Logs

DFP/DFA

DFP/DFA "Data Transfer File" Integration and API Access

Contact your DFP/DFA account manager and issue a request for Salesforce DMP to obtain access to the Data Transfer files described below. 

DFP/DFA makes this data available through Google Cloud Storage.  For a quick check via a browser, access through a URL like https://console.cloud.google.com/storage/browser/gdfp-####, with access managed by your Google Group.  See here for more information.

Data Transfer Files (NetworkImpressions and NetworkClick)

1.  Please configure the files to include the following fields:

  • Date
  • Time
  • UserID
  • AdvertiserID
  • OrderID
  • LineItemID
  • CreativeID
  • CreativeVersion
  • CreativeSize
  • AdUnitID
  • CustomTargeting
  • Domain
  • TimeUsec2
  • AudienceSegmentIds

See a full description of fields and types.

2. Salesforce DMP requires API access to pull the following information:

  1. Campaign and Ad metadata (mapping IDs to Names)
  2. O&O usage reports for Interchange billing (also a pre-requisite for #3)
  3. 3rd party billing reports (dependent on #2, need to know which campaigns/ads were targeted to Salesforce DMP segments)

Since the Data Transfer files only provide IDs, we require the API access to map those IDs to Names. Because DFP has an API that is well documented, we use that to pull the required information described.

To set up API access

  1. Log into DFP
  2. Create a new user for krux.dfpp@gmail.com
  3. Check "All Entities" Under "Teams". This user should be associated with both the API and the Google Cloud Storage access for the Data Transfer Files.
  4. Once Salesforce DMP has both access to the API and Data Transfer files, we can enable Yield Analytics, O&O reporting and 3rd party billing.

When complete, contact your Salesforce DMP representative to verify.

Setup Interchange snippet

The Krux user ID (kuid) must be present in the Data Transfer Files to analyze all the audiences the campaigns have reached.  This is accomplished by passing the kuid in each ad call on all web pages.  Refer to this guide.

 

 

 

 

Have more questions? Submit a request

0 Comments

Article is closed for comments.