Home
Integrations Library
Media Buying Integrations
Outbrain Integration
Outbrain Integration

SERIES:

Outbrain Integration

Learn how to set up the S2S integration between Everflow and Outbrain.

Overview

This guide explains how to set up the server-to-server integration between Everflow and Outbrain.

Outbrain Setup

Before setting up in Everflow, you must set up the Conversion Event Name in Outbrain:

  • Navigate to the Conversions tab:
Outbrain dashboard Conversions tab
  • Click Add conversion button:
Outbrain Add conversion button
  • Choose Event-Based Conversion type:
Outbrain Event-Based Conversion type selection
  • Fill in the info and enter the name of your conversion in the Name field and save the changes.

Outbrain conversion setup with the Name field for the conversion

Everflow Setup

Step #1

  • Add Outbrain as a Partner in Everflow.

Step #2

  • Add your Outbrain Offers in Everflow.

Step #3

  • Decide on a parameter that will be used for passing the OutbrainClickId to Everflow in the Partner Tracking Link. Outbrain's macro for this value is: {{ob_click_id}}

We recommend using the following parameters to pass the following Outbrain macros:

Everflow Parameter Outbrain Macro/Token Name/Description source_id {{ob_click_id}} OutbrainClickId (**REQUIRED**) sub1 {{ad_title}} Ad Title sub2 {{ad_id}} Ad ID sub3 {{publisher_name}} Publisher Name sub4 {{publisher_id}} Publisher ID sub5 {{campaign_id}} External Campaign ID sub6 {{section_id}} Section ID

Based on the recommendation to send OutbrainClickId using the source_id parameter, the Partner Tracking Link would look something like this:

https://sampledomain.com/21KL6/D42TR/?source_id={{ob_click_id}}&sub1={{ad_title}}&sub2={{ad_id}}&sub3={{publisher_name}}&sub4={{publisher_id}}&sub5={{campaign_id}}&sub6={{section_id}

Step #4

Add a Partner Postback for Outbrain. Navigate to Partners - Postbacks, then click Add Postback.
Everflow Partners Postbacks page with the Add Postback button
  • Under Delivery Method, be sure to select Postback.
  • Under Postback Level, select Global to fire all Conversions back to Outbrain.
  • Enter the following Postback URL:

https://tr.outbrain.com/unifiedPixel?ob_click_id=UNIQUE_CLICK_ID_VALUE&name=EVENT_BASED_CONVERSION_NAME

Everflow partner postback setup showing Delivery Method, Postback Level, and Postback URL fields

You will need to:

  • Replace UNIQUE_CLICK_ID_VALUE with the macro that corresponds with the parameter through which the {ob_click_id} was passed in the Partner Tracking Link.
  • Replace EVENT_BASED_CONVERSION_NAME with the name you entered earlier in Outbrain. Please note that this is case-sensitive.

The following optional parameters can be used to pass the following optional macros:

Outbrain Parameter Everflow Macro/Token Name/Description orderId {order_id} Order ID received from Advertiser; automatically passed with shopping cart integrations orderValue {sale_amount} Sale amount associated with the order currency {offer_currency} Currency of an Offer (i.e. USD, GBP, EUR)

So, if source_id was used in the Partner Tracking Link, then the Postback URL would look like this:

https://tr.outbrain.com/unifiedPixel?ob_click_id={source_id}&name=conversion&orderId={order_id}&orderValue={sale_amount}&currency={offer_currency}