Overview
The Oath-Brightroll integration ingests campaign performance data from Yahoo’s DSP platform into our data warehouse. It consists of two main scheduled jobs:
Data Import Job – Pulls delivery data (impressions, clicks, video views, conversions, etc.) at a daily granularity.
Meta Refresh Job – Retrieves up-to-date metadata for campaigns and creatives.
The imported data is processed to populate base metrics, composite performance calculations, and dimensional breakdowns. This enables reporting on spend efficiency, engagement rates, and video performance.
Connection Options
Key | Type | Required | Description | Hint | Size |
yahoo_advertiser_ids | text | Yes | Oath-Brightroll Advertiser ID | This is a numeric value next to your username in the dropdown | 30 |
yahoo_client_id | text | Yes | Yahoo DSP API Client ID | Yahoo Client ID generated in the UI for API integrations | 30 |
yahoo_client_secret | text | Yes | Yahoo DSP API Client Secret | Yahoo Client Secret generated in the UI for API integrations | 30 |
For more information on how to access these credentials please follow this link.
It should give you detailed guide on how to find the advertiser IDs and generate a Client ID and Secret.
Jobs
1. Oath-Brightroll Data Import
Feed:
oath_brightroll
Type: Data
Target Table:
oath_data_delivery
Description: Oath Data Import
Update Mode: Append
Date Column:
day
Lookback: 5 days
Run Hour: 6
Poll Frequency: 24 hours
2. Oath-Brightroll Meta Refresh
Feed:
oath_brightroll
Type: Lookup
Targets:
oath_meta_campaign
– Campaign Meta (Priority 1)oath_meta_creative
– Creative Meta (Priority 2)
Update Mode: Refresh
Lookback: 1 day
Run Hour: 6
Poll Frequency: 24 hours
Dimensions
Name | Source Field |
Advertiser [Yahoo] |
|
Order [Yahoo] |
|
Publisher [Yahoo] |
|
Campaign [Yahoo] |
|
Creative [Yahoo] |
|
Base Metrics
Name | Formula | Format |
Spend [Yahoo] |
| £, 2dp |
Clicks [Yahoo] |
| int |
Impressions [Yahoo] |
| int |
Video Views Quartile - 25% [Yahoo] |
| int |
Video Views Quartile - 50% [Yahoo] |
| int |
Video Views Quartile - 75% [Yahoo] |
| int |
Video Completes [Yahoo] |
| int |
Video Views [Yahoo] |
| int |
Measurable Impressions [Yahoo] |
| int |
Non Measurable Impressions [Yahoo] |
| int |
Conversions [Yahoo] |
| int |
VT Conversions [Yahoo] |
| int |
CT Conversions [Yahoo] |
| int |
Composite Metrics
Name | Formula | Format |
CTR [Yahoo] |
| %, 2dp |
CPM [Yahoo] |
| £, 2dp |
CPC [Yahoo] |
| £, 2dp |
VCR [Yahoo] |
| %, 2dp |
VTR [Yahoo] |
| %, 2dp |
CPCV [Yahoo] |
| £, 2dp |
Data Joins
Left Table Field | Right Table Field |
|
|