Outbrain Integration Guide

Setting up the S2S integration between Everflow and Outbrain.

Genny avatar
Written by Genny
Updated over a week ago

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:

  • Click Add conversion button:

  • Choose Event-Based Conversion type:

  • Fill in the info and enter the name of your conversion in the Name field and save the changes.


Everflow Setup

Step #1

  • Add Outbrain as a Partner in Everflow.

For more information on how to set up a Partner - [Click Here]

Step #2

  • Add your Outbrain Offers in Everflow.

For more information on how to set up an Offer - [Click Here]

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.

  • 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

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}


Did this answer your question?