Outbrain

Last updated on Nov 28, 2023
On This Page

Outbrain is a third-party, content discovery platform that offers native advertising. It is dedicated exclusively to drawing data-driven connections between users’ interests and actions to help you target that very behavior and promote your post on other pieces of content in order to attract readers from other websites.

You can replicate your marketer and ad campaign data from Outbrain to a Destination database or data warehouse using Hevo Pipelines.

For creating Pipelines using this Source, Hevo provides you a fully managed BigQuery data warehouse as a possible Destination. This option remains available till the time you set up your first BigQuery Destination irrespective of any other Destinations that you may have. With the managed warehouse, you are only charged the cost that Hevo incurs for your project in Google BigQuery. The invoice is generated at the end of each month and payment is recovered as per the payment instrument you have set up. You can now create your Pipeline and directly start analyzing your Source data. Read Hevo Managed Google BigQuery.

Prerequisites

Obtaining Login Credentials

  1. Register for the Outbrain Amplify API.

  2. Find the credentials for accessing Outbrain APIs in the confirmation e-mail received from Outbrain.

You can use these credentials while configuring your Hevo Pipeline.

Configuring Outbrain as a Source

Perform the following steps to configure Outbrain as the Source in your Pipeline:

  1. Click PIPELINES in the Navigation Bar.

  2. Click + CREATE in the Pipelines List View.

  3. In the Select Source Type page, select Outbrain.

  4. In the Configure your Outbrain Source page, specify the following:

    Configure Outbrain Source

    • Pipeline Name: A unique name for the Pipeline, not exceeding 255 characters.

    • Username: The username in the access credentials obtained from Outbrain.

    • Password: The password in the access credentials obtained from Outbrain.

    • Historical Sync Duration: The duration for which you want to ingest the existing data from the Source. Default duration: 1 Year.

      Note: If you select All Available Data, Hevo ingests all the data available in your Outbrain account since May 01, 2015.

  5. Click TEST & CONTINUE.

  6. Proceed to configuring the data ingestion and setting up the Destination.

Data Replication

Default Pipeline Frequency Minimum Pipeline Frequency Maximum Pipeline Frequency Custom Frequency Range (Hrs)
6 Hrs 3 Hrs 24 Hrs 3-24

Note: The custom frequency must be set in hours, as an integer value. For example, 1, 2, 3 but not 1.5 or 1.75.

  • Historical Data: The first run of the Pipeline ingests historical data for the selected objects on the basis of the historical sync duration specified at the time of creating the Pipeline and loads it to the Destination. Default duration: 1 Year.

  • Incremental Data: Once the historical data ingestion is complete, every subsequent run of the Pipeline fetches new and updated data as per the ingestion frequency.

  • Data Refresh: Data for the last 30 days is refreshed on a rolling basis for all report objects.

Schema and Primary Keys

Hevo uses the following schema to upload the records in the Destination database:

Data Model

The following is the list of tables (objects) that are created at the Destination when you run the Pipeline:

Object Description
Budget Details and activity statuses for all budgets associated with a marketer.
Budget objects represent the amount of money to be spent via the Amplify platform. Usually a budget belongs to a single campaign unless it is a shared budget.
Marketer Data for all marketers associated with the current user.
Marketers are representatives of Outbrain customers. A single Marketer object may control campaigns for more than one end-buyer.
Conversion All Conversion Events associated with a marketer.
Multiple conversions give the ability to track any action a user takes after clicking through to your content (Requires multiple custom pixels by end user).
Campaign Campaigns contain many promoted links and define budget, targeting, and cpc. Campaign settings apply to the promoted links contained in a specific campaign.
Derived tables:
- Targeting Location
- Targeting Location Parent
- Bids by Section
Section Specific content category within the publisher’s site such as sports or business. This object fetches the full list of sections’ metadata, classified by sections’ IDs.
Segments Segments give the ability to segment customers based on their actions, and retarget them with new or existing campaigns.
Derived tables:
- Campaign Segment
Targeting Interest Information that provides a mapping of interests to each campaign.
Campaign Report Daily campaign-level report covering all the performance metrics, such as, views, clicks, and conversions.
Section Report Daily section-level report covering all performance metrics such as views, clicks, and conversions.

Limitations

  • None.

Revision History

Refer to the following table for the list of key updates made to this page:

Date Release Description of Change
Feb-20-2023 NA Updated section, Configuring Outbrain as a Source to update the information about historical sync duration.
Dec-07-2022 NA Updated section, Data Replication to reorganize the content for better understanding and coherence.
Jul-26-2021 NA Added a note in the Overview section about Hevo providing a fully-managed Google BigQuery Destination for Pipelines created with this Source.
Was this page helpful?

Tell us what went wrong