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_VALUEwith the macro that corresponds with the parameter through which the {ob_click_id} was passed in the Partner Tracking Link.Replace
EVENT_BASED_CONVERSION_NAMEwith 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}¤cy={offer_currency}