Tonic Integration Guide

After you have finished connecting one or more of the supported traffic source accounts in the first step of the Account Wizard process, you can continue connecting your Tonic Publisher account in order to have both traffic source and Tonic revenue data aggregated in one place.

Follow the below steps to connect your Tonic. Publisher account to TheOptimizer Native.

Step 1: When on the Account Wizard page select a traffic source account then click Next.
Step 2: In the second step of the Account Wizard, click on Add New to start connecting your Tonic account.
Step 3:
On the pop-up integration screen click on the Select Tracking Platform drop-down list and select Tonic.
Step 4: Fill in the required information as noted in the below screenshot then click Save and Next to move to the next step.


Required input information details:

- Nickname: Add a friendly, easy to recognize name for your Tonic Publisher account.
- API Key: API Key value as provided in your Tonic Publisher account (detailed below).
- API Secret: API Key value as provided in your Tonic Publisher account (detailed below).

Step 5: In the third and final step, you simply need to specify the traffic source tracking token and Tonic subid mapping.

Make sure to properly map your tracking traffic source tracking tokens to Tonic subids.

Important Note!

Make sure all provided tracking tokens are properly mapped. In case one of the required traffic source tracking tokens is missing in your Tonic mapping configuration campaigns statistics (Tonic side) may be inaccurate.


Enable Custom Tracking

To provide additional support to Tonic publishers, we have added the ability to use concatenated token value custom tracking that can be used to map multiple tracking tokens in a single subid along with the the token-subid standard mapping structure.

Top used traffic source custom tracking concatenated templates:

Concatenated Taboola Tracking String:  {campaign_id}|{site}|{campaign_item_id}
Concatenated RevContent Tracking String:  {boost_id}|{content_id}|{adv_targets}|{widget_id}

Concatenated Outbrain* Tracking String: {{campaign_id}}|{{publisher_id}}|{{section_id}}|{{ad_id}}

*Please note that Outbrain token unique ID alphanumerical strings have an average length of 35 characters. Putting all required tokens on a single concatenated string like in the example above, may result in trimmed values on Tonic side. This because the maximum number of characters that can be passed to a Tonic subid is that of 100 characters. We strongly recommend using a combination of concatenated tracking strings and token-subid mapping for Outbrain.

Where do I find Tonic API Information?

Please follow the below steps to find Tonic API information.

Login to your Tonic Publisher account then go to Account > Settings

Copy the values visible on the API Access section of your account setttings, then paste it on the API Username to API Key and API Password to API Secret field in TheOptimizer integration screen.