Third-party Data Billing

In this article

A guide to the different methods you can use to report your third-party data usage. 

If you have activated Permutive cohorts that use third-party data into other platforms, please choose one of the below methods to report this usage to Permutive:

  • Google Ad Manager Log Files
  • Google Ad Manager self-reporting
  • Automated Google Ad Manager self-reporting
  • Self-reporting for other platforms

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 cohort is evaluated, an activation is recorded in the following examples:

  • 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
GAM Log Files GAM Self-Reporting Automated GAM Self-Reporting

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 cohorts the user was in at the time when the impression was served and which of those cohort (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 programmatically 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

To add these key values please follow the steps below:

1. Head to the 'Inventory' tab

2. Select the 'Key-values' tab

3. Click 'New key-value'

4. Choose the settings 'Dynamic and 'Do not include values in reporting'


Note: Once you've completed all the steps above, please contact customer support by emailing so we can complete the final steps on our end.

Self-Reporting for Other Platforms

If you have any Permutive cohorts using third-party data activated on a different platform, for example, Facebook, you will need to self-report. Please send a list of Permutive cohorts that have been activated on another platform to for processing. 

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