Home
Integrations Library
Media Buying Integrations
Rokt Integration
Rokt Integration

SERIES:

Rokt Integration

Learn how to send Everflow conversions to Rokt's Events API: add your Rokt credentials, create a Rokt postback, map the click ID and email, and test it.

Beta

The Rokt integration is being rolled out network by network. If you do not see Rokt as a Delivery Method on your postbacks, ask your account manager to turn it on for your network.

Overview

Rokt is an ad platform that partners with e-commerce sites to show ads on their post-checkout pages. With the Rokt integration, Everflow sends each conversion straight to Rokt's Events API from our servers. The advertiser does not need to place a Rokt pixel, and Everflow hashes the customer's personal details before they leave.

You set it up in two parts. First you add your Rokt API key and secret once, as an integration. Then you create a postback with Rokt as the Delivery Method and choose which fields to send.

How It Works

Here is what happens between a click on a Rokt ad and a conversion reaching Rokt:

Rokt adds its click ID to your tracking link. Everflow saves it on the click in a sub parameter you choose.
The customer converts. The conversion reaches Everflow the usual way, by pixel, SDK or server postback.
Everflow fires the Rokt postback within seconds. It sends the Rokt click ID, the customer's email and any other fields you mapped, with personal details hashed.
Rokt matches the conversion back to the ad and uses it for reporting and optimization.

The more customer fields you send, the better Rokt can match. Rokt asks for an email at minimum, and recommends name, mobile number and postal code when you have them.

Before You Start

Make sure you have the following:

A Rokt API key and API secret. Your Rokt account manager can provide both.
A partner in Everflow for your Rokt traffic, and an offer that partner runs.
Rokt enabled on your network. If Rokt is missing from the Delivery Method list, ask your account manager.
A way to get the Rokt click ID and the customer's email onto the conversion. The next two sections explain how.

Add the Rokt Click ID to Your Tracking Link

Rokt fills in its click ID through the {rokt.rclid|} macro. Add it to the Everflow tracking link you give Rokt, in a sub parameter you are not already using. Use & before it if the link already has a ?, otherwise use ?. This example uses sub2:

Tracking Link for Rokt
https://www.YOUR-TRACKING-DOMAIN.com/ABC123/DEF456/?sub2={rokt.rclid|}

Later, in the postback, you map the same sub parameter (here {sub2}) to the Rokt Click Id field. Any free sub parameter works, as long as the tracking link and the postback use the same one.

Rokt's own docs show the click ID as rtid={rokt.rclid|}. That parameter name is for Rokt's pixel. With Everflow, use a sub parameter instead so the click ID is saved on the click.

Pass the Customer's Email

The email works the same way as in other server-side integrations: it has to arrive with the conversion. When the advertiser sends the customer's email on the conversion, you map {email} to the User Email field in Step 2, and Everflow hashes it before it leaves.

If the advertiser sends the email in an advertiser parameter instead, such as adv1, map that parameter ({adv1}) to User Email. Advertiser parameters are hidden from partners by default, so turn on Macro Parameters Visibility for the Rokt partner first. See Managing Offer Visibility and Partner Access for how.

Partner details page with the Macro Parameters Visibility panel highlighted

Step-by-Step Setup

Step 1: Add the Rokt Integration

The integration belongs to a partner, so you add it in the Partner Platform. You need a Rokt partner with at least one user first. As a network user, create the partner, add a user, then log in as that user by impersonating them. Media buyers running their own Rokt traffic follow the same steps.

1
Open the Rokt Integration
In the Partner Platform, go to Company Settings → Integrations

Partner Platform Company Settings menu with Integrations highlighted

Under Not connected, find Rokt and select Connect Integration.

Manage Integrations page with the Connect Integration button for Rokt highlighted

2
Enter Your Rokt Credentials
Name: a label you will recognize later, such as Rokt - Main Account. You pick the integration by this name in Step 2.
Api Key: your Rokt API key.
Api Secret: your Rokt API secret.
Click Add.

Rokt integration form with Name, Api Key and Api Secret filled in

Rokt now shows under Connected, and its button changes to View. Add one integration per Rokt account for each partner. A postback can only use an integration that belongs to its own partner.

Manage Integrations page with Rokt under Connected and the View button highlighted

Manage Your Rokt Integrations

Select View on the Rokt card to open Manage Rokt Integration. From there:

Manage Rokt Integration page with the + Rokt Integration button highlighted
Add another Rokt account: select + Rokt Integration.
Change the key or secret: open the row menu, select Edit, switch Api Credentials to Yes, enter the new values and click Save. Saved credentials are never shown again.
Remove an integration: open the row menu and select Delete.

With Api Credentials set to Yes, the key and secret fields open again for new values:

Edit Rokt integration with Api Credentials switched to Yes

Network users can also see every partner's Rokt integration in the Core Platform under Integrations → Media Buying → Rokt. The Manage page lists each partner, its Rokt integration and the event types it sends.

Core Platform Rokt Manage page listing each partner, its Rokt integration and event types

Step 2: Create the Rokt Postback

Next, create the postback in the Core Platform. Partners can also create it themselves in the Partner Platform, under Postbacks with + Postback.

1
Start a New Postback
Go to Partners → Postbacks and select Add. You can also open the Rokt partner, go to its Postbacks tab and select + Add next to Conversion or Event.
Status: Active.
Postback Type: Conversion or Event.
Postback Level: Global covers all offers for one partner. Specific covers one offer for one partner.
Partner: the partner that owns the Rokt integration. For Specific, also pick the Offer, and for an Event postback the Event (or All Additional Events).

Add Postback form with Conversion, Global and the Rokt partner selected

2
Choose Rokt and Map the Fields
Delivery Method: Rokt.
Rokt: the integration you added in Step 1.
User Email (required): use Add Macro to pick {email}, or the advertiser parameter that carries the email. The HASHED badge means Everflow hashes it for you.
Conversion Type (required): the action you are reporting, such as purchase, lead or booking. This is plain text.
Rokt Click Id: use Add Macro to pick the sub parameter that holds the Rokt click ID, such as {sub2}.
Customer Id (optional): your own ID for the customer, such as {transaction_id}.
Click Add to save the postback.

Rokt postback fields with the Automatic Hashing notice highlighted

Use a different Conversion Type for each postback, such as lead for the conversion and booking for an event. Rokt receives every postback as the same kind of event, so Conversion Type is the only thing that tells them apart.

Here is a finished Rokt postback with the email, click ID and customer ID mapped:

A completed Rokt postback with User Email, Conversion Type, Rokt Click Id and Customer Id mapped

Heads Up

The postback needs at least one identity with a value: User Email, Customer Id or Rokt Click Id. If all three are empty on a conversion, the postback fails with a configuration error instead of firing.

If the email is empty on a single conversion, Everflow leaves it out of that event and still sends the rest. Rokt is not available at the Global (Offer) level, so choose Global or Specific.

Step 3: Send Extra Data (Optional)

Select the + next to Rokt User Data or Rokt Custom Data to add more fields. Every field is optional and accepts macros. Pick the field in Data Field, then enter its Value. A blank field is left out of the event.

Rokt User Data

Fields with a HASHED badge are hashed by Everflow before they are sent.

Rokt User Data field list with HASHED badges on First Name, Last Name and Mobile

Here is how Everflow sends each one:

FieldHow Everflow sends it
First Name, Last NameHashed with SHA-256, after trimming spaces and setting to lowercase.
MobileReduced to the national number, then hashed. Send it in E.164 format, such as +14155550123.
Age, Date Of Birth, GenderSent as entered.
City, State, ZIP/Postal CodeSent as entered.
Title, LanguageSent as entered.
ValueSent as entered. Rokt can use it in its audience and bidding models.

Rokt Custom Data

These describe the conversion itself.

FieldWhat to enter
AmountThe conversion value as a number, such as {sale_amount}.
Confirmation RefAn order or transaction ID, such as {transaction_id}. Rokt uses it with Conversion Type to remove duplicates.
CurrencyA three-letter currency code, such as USD.
Screen NameThe page or screen where the conversion happened.
URLThe URL of the conversion page.

Rokt's own documentation lists Confirmation Ref as a required attribute, even though the Everflow form treats it as optional. Based on that recommendation, we suggest adding it to every Rokt postback.

Pro Tip

Rokt uses Confirmation Ref, together with Conversion Type, to avoid counting the same conversion twice. {transaction_id} is a simple choice. If you also send conversions through Rokt's Web SDK, use the same Conversion Type and Confirmation Ref in both so Rokt can match them up. This follows Rokt's guidance, so check Rokt's Events API documentation or your Rokt account manager for the latest requirements.

An Event postback set to Specific needs an offer with at least one public event. If the offer has none, the form shows a warning and you cannot pick an event.

Add Postback warning that the offer has no public events

Step 4: Test the Postback

Before you go live, ask your Rokt account manager to set up testing on their side. Then fire a test and check both ends.

1
Fire a Test From Everflow
Open the Rokt partner and go to its Postbacks tab.
Open the row menu on your Rokt postback and select Test.

Postback row menu with Test highlighted

The Postback Test Tool shows It's working! when the postback fired, with the exact payload sent to Rokt and Rokt's reply, such as Success (202).

Postback Test Tool showing It's working and the payload sent to Rokt

2
Check Real Conversions
Go to Reporting → Partner Postback and filter by the Rokt partner.
Open a row's menu and select View Debug Info to see the payload Everflow sent and Rokt's response.

Partner Postback report row menu with View Debug Info highlighted

Send a few test conversions with test email addresses, and share those addresses with your Rokt account manager so they can confirm the events arrived under the Conversion Type you set.

A Success status means Everflow delivered the event to Rokt. It does not mean Rokt matched the customer, which only Rokt can confirm.

How Everflow Handles Personal Data

Everflow hashes the email, first name, last name and mobile number with SHA-256 before they leave. A hash is a scrambled version of a value that Rokt can match but nobody can read. Everything else is sent as you entered it.

Two mistakes stop Rokt from matching the customer without causing any error. The postback still shows Success, because Everflow did deliver it.

Pre-Hashed Email Must Be SHA-256

If the email is already hashed, Everflow only leaves it alone when it is a 64-character SHA-256 hash. Any other hash, such as MD5 or SHA-1, is hashed a second time and will never match. If you are not sure how it was hashed, send the plain email and let Everflow hash it.

The second one is about phone numbers.

Send Mobile Numbers in E.164 Format

Everflow reads the number, reduces it to the national number, then hashes it. If it cannot read the number, it hashes the raw text and Rokt will not match it. Use a plus sign, the country code and the number with no spaces or dashes, such as +14155550123.

What Everflow Sends Automatically

You do not need to map these:

ValueWhere it comes from
IP address and user agentThe conversion.
TimestampAdded automatically to every event.
Rokt Click IdSent twice, as an identity and as Rokt's passback conversion tracking ID, so Rokt can match on either.

For customers in the UK and EU, the IP address is hashed for privacy. Rokt does not need the IP address to match a conversion.

Conversions That Happen Offline

Conversions that happen off the web, such as a booking made by phone, can still reach Rokt. The advertiser sends Everflow the original transaction ID in a server postback when the booking happens, and Everflow fires the Rokt postback for the matching click. See Email Address Attribution if the advertiser only has the customer's email.

Quick Reference

The whole setup at a glance:

TopicDetail
CredentialsRokt Api Key and Api Secret
Where to add themPartner Platform: Company Settings → Integrations → Rokt → Connect Integration
ScopeOne integration per Rokt account, per partner
Delivery MethodRokt
Postback levelsGlobal or Specific (not Global (Offer))
Required fieldsRokt, User Email, Conversion Type
Click matching{rokt.rclid|} on the tracking link, mapped to Rokt Click Id
Email{email}, or an advertiser parameter such as {adv1}
Hashed automaticallyEmail, first name, last name, mobile (SHA-256)
Recommended by RoktConfirmation Ref, such as {transaction_id}

Troubleshooting

Select a problem to see what to check.

?
Rokt is not in the Delivery Method list
▼

Rokt is being enabled network by network. Ask your account manager to turn it on for your network.

?
The postback fails with a configuration error every time
▼

The API key or secret is wrong, the integration was deleted, or User Email, Customer Id and Rokt Click Id were all empty. Check that the parameter carrying the email has a value on the conversion.

?
User Email is always empty
▼

Check that the advertiser sends the email with the conversion. If you mapped an advertiser parameter such as {adv1}, make sure it has a value and that Macro Parameters Visibility is turned on for the partner.

?
Postbacks succeed, but Rokt sees nothing
▼

The Rokt click ID is probably missing. Check that {rokt.rclid|} is on the tracking link and that the same sub parameter is mapped to Rokt Click Id.

?
Rokt receives the conversion but cannot match the customer
▼

Check for the two silent mistakes: an email pre-hashed with something other than SHA-256, or a mobile number not in E.164 format.

?
The same conversion is counted twice
▼

Add a Confirmation Ref, such as {transaction_id}, so Rokt can recognize a repeat.

?
Postbacks keep retrying
▼

Rokt may be rate limiting, returning an error, or the connection failed. Everflow retries automatically, so you only need to act if it keeps happening.

?
Rokt rejects the conversion
▼

A value is malformed. The usual causes are a currency that is not a three-letter code, or an amount that is not a number.

Limitations

Rokt works with Conversion and Event postbacks at the Global and Specific levels. It is not available for CPC postbacks, where the Delivery Method is always Postback, or at the Global (Offer) level. Everflow can confirm that it delivered an event to Rokt, but only Rokt can confirm that it matched the customer.

Keep reading:

Explore Related Content
More on postbacks and server-side integrations:

→ Introduction to Partner and Advertiser Postbacks: how postbacks work.

→ Your Guide to Parameters and Macros: the macros you can use in postback fields.

→ How to Test Partner Postbacks: more ways to check a postback fired.

→ Whop Ads Integration: another server-side integration.

→ Meta (Facebook / Instagram) Integration: a similar Conversions API setup.

→ Microsoft Advertising (Bing) CAPI Integration: a similar Conversions API setup.

→ Rokt Events API Integration Guide: Rokt's own documentation for the API Everflow sends to.

Next in This Series