Outbrain

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.

Prerequisites

  • An active Outbrain account.

Configuring Outbrain as a Source

Perform the following steps to configure Outbrain as a Source in Hevo:

1. Obtain login credentials

  1. Register for the Outbrain Amplify API.
  2. Find the credentials for accessing Outbrain API’s in the confirmation e-mail received from Outbrain.

2. Set up Outbrain in Hevo

  1. Click PIPELINES in the Asset Palette.

  2. Click + CREATE in the Pipeline List View page.

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

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

    Configure Outbrain Source

    1. Pipeline Name: A unique name for the Pipeline.
    2. Username: The username in the access credentials received from Outbrain.
    3. Password: The password associated with the username, received from Outbrain.
    4. Historical Sync Duration: The duration for which the past data must be ingested.
  5. Click TEST & CONTINUE.

Data Replication

  • Historical Data: Hevo ingests the historical data for all objects on the basis of the historical sync duration specified during Pipeline creation.

  • Incremental Data: Once the historical data ingestion is complete, every subsequent run of the Pipeline fetches new and changed data since the previous run.

  • 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:

Outbrain ERD

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.

Last updated on 10 Nov 2020