In this article
Setting up billing for third-party providers
This document explains how we charge for usage of third-party data.
Google Ad Manager Log Files
To begin, you will need to share access to your GAM log files. GAM log files are a feature of GAM Premium (also known as data transfer reports). These log files contain data about every impression that gets served, including what segments the user was in at the time when the impression was served and which of those segments (if any) were used in the decision to serve the impression.
The specific files we need for billing are NetworkImpressions and NetworkBackfillImpressions.
- Give email@example.com read access to the bucket, by inviting the account to the Google group you created when setting up the bucket.
- Give our service account, firstname.lastname@example.org read access to the bucket. This enables us to programatically access the files. Since this is a service account, click 'direct add members' to add this email address, instead of 'invite'.
Note: If you do not have access to these GAM log files, you must track usage of data for billing purposes and properly report to Permutive.
In addition to log files, two new key values need to be added to your GAM instance:
You can add them by going to the Inventory (1) > Key-values (2) tab, adding a new key value (3) and choosing the settings "Dynamic" and "Do not include values in reporting" (4), as seen in the screenshot.
A third-party segment is activated when a user's presence in it causes targeting information to be set. When a user's presence in a Permutive segment is evaluated, an activation is recorded whenever
- A user's presence in a negatively-targeted third-party data segment is evaluated
- A user's presence in a positively-targeted third-party data segment is evaluated and the user exists in it
If you have given us access to your GAM log files, usage can then be tracked in Permutive Analytics to provide information on your most popular third party segments and the cost associated with these.
If third party segments are flighted by some other means (eg. Rubicon - Fastlane), you will need to self report and send to email@example.com on a monthly basis for billing purposes.
If you have any questions about the billing process, or would like to enable third party data on your project please contact us at firstname.lastname@example.org