Accessing & Editing S2S Postback URLs

Learn how to access and configure server-to-server postback URLs, pass conversion information, and track detailed metrics across your marketing campaigns using Everflow's flexible S2S postback system.

How To Access S2S Postbacks URLs

At The Offer Level

In order to access the S2S Postback that the Advertiser needs to configure on their end, head to a specific Offer:

In the left sidebar, head to Offers → Manage

Click on a specific Offer name

In the Offer Details view, navigate to the Tracking card → Conversion Tab

If the Offer is set up to use S2S Postbacks as the Conversion Tracking Method, you’ll find the Postback URL here.

Using The Global Postback

The interesting thing about S2S Postbacks is that they’re the same format for any Offer. It’s always the NID and the Transaction ID that at a minimum need to be sent to Everflow via the S2S Postback.

The NID is a constant value that is prefilled, which only leaves the Transaction ID to be populated by the Advertiser when triggering the Postback.

For this reason, you don’t need to go into the Offer Details card to fetch the Postback URL, you can use the Global Postback. To access the Global Postback URL:

In the left sidebar, head to Control Center → Platform Configurations

In the General Tab, find the Global Postback card

Here you’ll find the Global Postback URL.

Passing Additional Conversion Information Via S2S Postbacks

The following information, related to Conversions can be passed to Everflow via macros in an Advertiser Postback:

Macro Name

Macro Format

Usage

Amount

amount

Please use the "amount" parameter to send the sale amount to the Everflow platform. Please note that the amount will be formatted based on the offer currency. For example, "&amount=12,34" will be treated as $12.34.

Advertiser Sub IDs

adv1, adv2, adv3, adv4, adv5

A Postback can accept up to 5 Advertiser sub ids, which are adv1, adv2, adv3, adv4 and adv5. For instance, use "&adv1=xxxx" to pass any metadata that you'd like to report on in Everflow.

Timestamp

timestamp

Conversion time registered in the Advertiser system formatted as UNIX timestamp. The timestamp can be passed back using the timestamp parameter (i.e &timestamp=1515004406)

Currency

currency

You can include the 3 letter ISO acronym as the currency parameter in the postback. Please see here for details on ISO codes. (i.e &currency=USD)

User's email address to pass in Advertiser Postback (required for Email Address Attribution

Order Data

order

Specific to e-commerce integration, JSON payload associated to the order (i.e., &order={...}).

User IP Address

user_ip

The IP of the user to be passed in to the Conversion IP field in Everflow. In the absence of this value being passed, the conversion IP will be the IP of the server which fired the conversion (i.e., &user_ip=XXX.XXX.XXX.XXX).

Order ID

order_id

The order ID specifically for e-commerce (i.e., &order_id=YOUR_ORDER_ID).

Offer ID (Clickless)

oid

Used to generate a clickless conversion, this is the offer ID (i.e., &oid=123).

Advertiser ID

advid

Advertiser ID (i.e., &advid=456).

Advertiser ID (Alternative)

aid

Advertiser ID (i.e., &aid=789).

Affiliate ID (Clickless)

affid

Used to generate a clickless conversion, this is the affiliate ID (i.e., &affid=101).

Coupon Code (Clickless)

coupon_code

Coupon code or discount code used. This can be used to generate a clickless conversion, please see this documentation (i.e., &coupon_code=SUMMER20).

Source ID (Clickless)

source_id

(clickless) When generating a clickless conversion with the coupon code or offer ID/Affiliate ID combo this can be used to pass the source ID to register that to reporting (i.e., &source_id=FACEBOOK).

Sub ID 1 (Clickless)

sub1

(clickless) When generating a clickless conversion with the coupon code or offer ID/Affiliate ID combo this can be used to pass the sub1 to register that to reporting (i.e., &sub1=VALUE1).

Sub ID 2 (Clickless)

sub2

(clickless) When generating a clickless conversion with the coupon code or offer ID/Affiliate ID combo this can be used to pass the sub2 to register that to reporting (i.e., &sub2=VALUE2).

Sub ID 3 (Clickless)

sub3

(clickless) When generating a clickless conversion with the coupon code or offer ID/Affiliate ID combo this can be used to pass the sub3 to register that to reporting (i.e., &sub3=VALUE3).

Sub ID 4 (Clickless)

sub4

(clickless) When generating a clickless conversion with the coupon code or offer ID/Affiliate ID combo this can be used to pass the sub4 to register that to reporting (i.e., &sub4=VALUE4).

Sub ID 5 (Clickless)

sub5

(clickless) When generating a clickless conversion with the coupon code or offer ID/Affiliate ID combo this can be used to pass the sub5 to register that to reporting (i.e., &sub5=VALUE5).

IDFA SHA1 (Clickless)

idfa_sha1

(clickless) When generating a clickless conversion with the coupon code or offer ID/Affiliate ID combo this can be used to pass the idfa_sha1 to register that to reporting (i.e., &idfa_sha1=...).

Google AID MD5 (Clickless)

google_aid_md5

(clickless) When generating a clickless conversion with the coupon code or offer ID/Affiliate ID combo this can be used to pass the google_aid_md5 to register that to reporting (i.e., &google_aid_md5=...).

Google AID SHA1 (Clickless)

google_aid_sha1

(clickless) When generating a clickless conversion with the coupon code or offer ID/Affiliate ID combo this can be used to pass the google_aid_sha1 to register that to reporting (i.e., &google_aid_sha1=...).

Android ID (Clickless)

android_id

(clickless) When generating a clickless conversion with the coupon code or offer ID/Affiliate ID combo this can be used to pass the android_id to register that to reporting (i.e., &android_id=...).

Android ID MD5 (Clickless)

android_id_md5

(clickless) When generating a clickless conversion with the coupon code or offer ID/Affiliate ID combo this can be used to pass the android_id_md5 to register that to reporting (i.e., &android_id_md5=...).

Android ID SHA1 (Clickless)

android_id_sha1

(clickless) When generating a clickless conversion with the coupon code or offer ID/Affiliate ID combo this can be used to pass the android_id_sha1 to register that to reporting (i.e., &android_id_sha1=...).

Examples Of Postback Macros

Sending A Total Sale Amount Associated With The Conversion Event

In the following postback, a total sale amount of $100.24 is associated with the conversion. This will help pass on the information to the Partner if you want, associate Revenue with the conversion, and even base the Payout as a percentage of the Revenue.

https://trk-domain-88.com/?nid=10&transaction_id=abc123&amount=100,24

Sending A Currency & Some Categorical Metadata

In the following postback, the currency associated with this conversion will be CAD and the Advertiser is sending a custom value of “blackfriday” via adv1. This would help filter reporting conversion associated with specific adv1 values, and it seems the Advertiser is using it to filter around special sale events in the example.

https://trk-domain-88.com/?nid=10&transaction_id=abc900&currency=CAD&adv1=blackfriday

Did This Help You Today?

Yes

Next in This Series

Lorem Ipsum Dolor Sit