This integration was created by Fishtown Analytics for Singer, an open-source, composable ETL platform. Check out & contribute to the repo on GitHub.
Outbrain is currently in Open Beta. The info in this article is subject to change.
Release Status | Open Beta | Availability | Free |
Status Page | Outbrain Status Page | Default Historical Sync | 1 year |
Whitelist Tables/Columns | Unsupported/Unsupported | Default Replication Frequency | 30 minutes |
Full Table Endpoints | 0 | Incremental Endpoints | 3 |
Destination Incompatibilities | None |
Connecting Outbrain
Connecting Stitch to Outbrain is a three-step process:
Add Outbrain as a Stitch Data Source
- On the Stitch Dashboard page, click the Add an Integration button.
-
Click the Outbrain icon.
-
Enter a name for the integration. This is the name that will display on the for the integration; it’ll also be used to create the schema in your data warehouse.
For example, the name “Stitch Outbrain” would create a schema called
stitch_outbrain
in the data warehouse. This schema is where all the tables for this integration will be stored. -
In the Account ID field, enter your Outbrain Account (or Marketer) ID.
You can find this by looking at the URL when you’re logged into your Outbrain account. The Account ID looks something like this:
0f4b02153ee75f3c9dc4fc128ab041962
and is located betweenmarketers
andcampaigns
, if you’re looking at the Overview dashboard:https://my.outbrain.com/amplify/site/marketers/[account-id-will-be-here]/campaigns/overview
- In the Username field, enter your Outbrain username.
- In the Password field, enter your Outbrain password.
Defining the Historical Sync
The Sync Historical Data setting will define the starting date for your Outbrain integration. This means that data equal to or newer than this date will be replicated to your data warehouse.
Change this setting if you want to sync data beyond Outbrain’s default setting of 1 year. For a detailed look at historical syncs, check out the Syncing Historical SaaS Data article.
Define the Replication Frequency
The Replication Frequency controls how often Stitch will attempt to replicate data from your Outbrain integration. By default the frequency is set to 30 minutes, but you can change it to better suit your needs.
Before setting the Replication Frequency, note that:
- The more often Outbrain is set to replicate, the higher the number of replicated rows.
-
The number of rows in the source may not equal the number of rows replicated by Stitch. Tables that use Full Table Replication will result in a higher number of replicated rows.
- If you’re using a data warehouses that doesn’t natively support nested structures, you’ll see a higher number of replicated rows due to the de-nesting Stitch performs.
To help prevent overages, we recommend setting the Replication Frequency to something less frequent - like 6 hours instead of 30 minutes. For tips on reducing your row count, check out the Reducing Your Row Count section of our Billing Guide.
After selecting a Replication Frequency, click Save Integration.
Outbrain’s Intial Sync
After you finish setting up Outbrain, you might see its Sync Status show as Pending on either the Stitch Dashboard or in the Integration Details page.
For a new integration, a Pending status indicates that Stitch is in the process of scheduling the initial sync for the integration. This may take some time to complete.
Outbrain Schema
- Campaign pagination is not implemented – this integration pulls incomplete data if more than 100 campaigns exist. (Is a workaround necessary for this? If so, is there one?)
Included Tables
Stitch's Outbrain integration includes these tables:
campaigns
Replication Method: Incremental
Primary Key: id
Contains Nested Structures?:
No
campaigns
table contains info about your Outbrain campaigns.campaigns Attributes
While we try to include everything Outbrain has here, this may not be a full list of attributes.
Campaign ID (
id
)name
campaignonair
onairreason
enabled
budget__id
budget__name
budget__shared
budget__amount
budget__currency
budget__amountremaining
budget__amountspent
budget__creationtime
budget__lastmodified
budget__startdate
budget__enddate
budget__runforever
budget__type
budget__pacing
budget__dailytarget
budget__maximumamount
cpc
campaign_performance
Replication Method: Incremental
Primary Key: campaignid : fromdate
Contains Nested Structures?:
No
campaign_performance
table contains performance metrics for your Outbrain campaigns.campaign_performance Attributes
While we try to include everything Outbrain has here, this may not be a full list of attributes.
campaignid
fromdate
impressions
clicks
ctr
spend
ecpc
conversions
conversionrate
cpa
link_performance
Replication Method: Incremental
Primary Key: campaignid : linkid : fromdate
Contains Nested Structures?:
No
link_performance
table contains performance metrics for links in your Outbrain campaigns.link_performance Attributes
While we try to include everything Outbrain has here, this may not be a full list of attributes.
campaignid - This is the campaign ID plus the start date (day) for the record.
linkid
fromdate
impressions
clicks
ctr
spend
ecpc
conversions
conversionrate
cpa
Related | Troubleshooting |
Questions? Feedback?
Did this article help? If you have questions or feedback, please reach out to us.