Third-party Data Billing

In this article

Setting up billing for third-party providers

This document explains how we charge for the 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.

  1. Give read access to the bucket, by inviting the account to the Google group you created when setting up the bucket.
  2. Give our service account, 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:

  • ptime
  • puid

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.



Data activation

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 third-party segments are flighted by some other means (eg. Rubicon - Fastlane), you will need to self-report and send to 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

Was this article helpful?
0 out of 0 found this helpful
Have more questions? Submit a request