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 support@permutive.com '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, 326199512840-compute@developer.gserviceaccount.com '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 support@permutive.com so we can complete the final steps on our end.

Google Ad Manager Self-Reporting

If you do not have GAM log files, you need to self-report. 

If you would like Permutive to pull the following monthly report on your behalf, please contact tpdreporting@permutive.com to give us the authorisation to do so.

In the Google Ad Manager platform, navigate to Reporting > Reports > New report:

Tip: You can give this report a name and save it to make to easier to run each month

Set the Report Type, General Settings, and Dimensions to the following options:

1. Report type: 'Historical'

2. Date range: The date range you wish to run the report over. We've used the month of September in this example

Tip: If you choose 'Fixed' instead of 'Dynamic' you can choose the exact date range you're interested in

3. Add a filter for 'Key-values contains "permutive"'

4. Dimensions: 'Key-values'

Next, you need to select the Metrics you'd like to report on. As we're looking for impressions delivered with Permutive audiences, you will need to select 'Total targeted impressions':

The results will look something like the following:

The key-value is shown first, alongside the impressions related to that value. 

To see the full results you should export your report as a CSV.

This raw CSV should then be emailed to tpdreporting@permutive.com for processing by the 5th of each month for the previous month's usage. 

Example: To report your third-party usage for July, you would need to send the CSV file to the Finance Team by the 5th of August.

Once our Finance team receives your activation report, they will process the data through a calculator which returns usage costs.

This calculator allows Permutive to understand what percentage of a Permutive cohort’s audience entered via a third-party segment and which specific third-party segment they entered by.

This optimization makes sure that customers are only paying for the third-party data that was actually used to target an impression.

If you have given Permutive authorization to run this report on your behalf, you do not need to do anything and the Finance team will send you your monthly bill.