{"id":185,"date":"2023-04-26T14:47:37","date_gmt":"2023-04-26T14:47:37","guid":{"rendered":"https:\/\/theoptimizer.io\/help\/?post_type=ht_kb&p=185"},"modified":"2024-10-10T00:43:42","modified_gmt":"2024-10-10T00:43:42","slug":"tonic-integration-guide","status":"publish","type":"ht_kb","link":"https:\/\/theoptimizer.io\/help\/knowledge-base\/tonic-integration-guide\/","title":{"rendered":"Tonic Integration Guide"},"content":{"rendered":"\r\n

\"\"<\/sub> Written by\u00a0Support.\u00a0Updated over a week ago<\/p>\r\n\r\n\r\n\r\n

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.<\/p>\r\n\r\n\r\n\r\n

Follow the steps below to connect your Tonic Publisher account to TheOptimizer Native.<\/p>\r\n\r\n\r\n\r\n


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

\"\"<\/p>\r\n\r\n\r\n\r\n

Required input information details:

– Nickname:<\/strong> Add a friendly, easy to recognize name for your Tonic Publisher account.
– API Key: <\/strong>API Key value as provided in your Tonic Publisher account (detailed below).
– API Secret: <\/strong>API Key value as provided in your Tonic Publisher account (detailed below).<\/p>\r\n\r\n\r\n\r\n

Step 5:<\/strong> specify which Tonic subids you are using to pass traffic source macros back to Tonic.
One possible configuration is shown in the screenshot below:<\/p>\r\n\r\n\r\n\r\n

\"\"<\/p>\r\n\r\n\r\n\r\n

Step 6<\/strong>: Campaign tracking code:
According to the configuration in the previous step, TheOptimizer assumes that you are also using the same setup on the traffic source campaigns’ tracking code (in this case Taboola but it applies to all traffic sources).

The tracking code you need to make sure it is present in your campaigns in this case is:<\/p>\r\n\r\n\r\n\r\n

subid1={campaign_id}&subid2={site}&subid3={campaign_item_id}<\/pre>\r\n\r\n\r\n\r\n

IMPORTANT!<\/em> – <\/strong>Make sure all the traffic source macros are used in your configuration. In case one of the required traffic source macros is missing in your Tonic mapping configuration, or in your campaign tracking code, the data from Tonic for that macro will be missing in TheOptimizer. For example, if you are not using {site} macro, there will not be Tonic data for Taboola sites in TheOptimizer<\/p>\r\n\r\n\r\n\r\n
Custom Tracking – When to use it?<\/strong><\/h1>\r\n\r\n\r\n\r\n
If for some reason you do not have all the Tonic subids available (because you are already using some of them for other purposes), but you have only a couple of them, you can enable and use our custom tracking option.

Using the Custom Tracking option, you are able to pass more than one traffic source macro on a single Tonic subid, using a special format.
For example, in the case of Taboola, you can pass all Taboola macros on sub1, as shown in the screenshot below:<\/p>\r\n\r\n\r\n\r\n
\"\"<\/p>\r\n\r\n\r\n\r\n
In this case the tracking code that you need to add in your campaigns needs to be exactly in the same format:<\/p>\r\n\r\n\r\n\r\n
subid1={campaign_id}|{site}|{campaign_item_id}<\/pre>\r\n\r\n\r\n\r\n
Here are some examples of top-used traffic source custom tracking concatenated templates:<\/p>\r\n\r\n\r\n\r\n

Concatenated Taboola <\/strong>Tracking String: {campaign_id}|{site}|{campaign_item_id}<\/strong>
Concatenated RevContent <\/strong>Tracking String: {boost_id}|{content_id}|{adv_targets}|{widget_id}<\/strong>
Concatenated Outbrain* <\/strong>Tracking String: {{campaign_id}}|{{publisher_id}}|{{section_id}}|{{ad_id}}<\/strong><\/p>\r\n\r\n\r\n\r\n
Outbrain special case<\/strong><\/h2>\r\n\r\n\r\n\r\n
Because Outbrain macro values (ID values) have an average length of 35 characters. So Putting all required tokens on a single concatenated string like in the example above, may result in trimmed values on Tonic’s side. This is due to the Tonic limit of max 100 characters that can be passed on a single subid.<\/p>\r\n\r\n\r\n\r\n
So to overcome this limitation, for Outbrain we recommend using a combination of Custom Tracking and normal tracking.
For example, one possible configuration can be as in the screenshot below, where campaign id and publisher id are being concatenated and passed under sub3 while section id is being passed on sub2 and ad id on sub1:<\/p>\r\n\r\n\r\n\r\n
\"\"<\/p>\r\n\r\n\r\n\r\n
In this case the tracking code that needs to be added to Outbrain campaigns is:<\/p>\r\n\r\n\r\n\r\n
subid1={{ad_id}}&subid2={{section_id}}&subid3={{campaign_id}}|{{publisher_id}}<\/pre>\r\n\r\n\r\n\r\n
Where do I find Tonic API Information?<\/strong><\/h2>\r\n\r\n\r\n\r\n
Please follow the steps below to find Tonic API information.<\/p>\r\n\r\n\r\n\r\n
Login <\/strong>to your Tonic Publisher account then go to Account > Settings<\/strong><\/p>\r\n\r\n\r\n\r\n
\"\"<\/p>\r\n\r\n\r\n\r\n
Copy the values visible on the API Access section of your account settings, then paste it on the API Username to API Key and API Password to API Secret field in TheOptimizer integration screen.<\/p>\r\n","protected":false},"excerpt":{"rendered":"
Written by\u00a0Support.\u00a0Updated over a week ago 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…<\/p>\n","protected":false},"author":1,"comment_status":"open","ping_status":"closed","template":"","format":"standard","meta":{"footnotes":""},"ht-kb-category":[13],"ht-kb-tag":[],"class_list":["post-185","ht_kb","type-ht_kb","status-publish","format-standard","hentry","ht_kb_category-tracking-platform-setup"],"aioseo_notices":[],"_links":{"self":[{"href":"https:\/\/theoptimizer.io\/help\/wp-json\/wp\/v2\/ht-kb\/185","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/theoptimizer.io\/help\/wp-json\/wp\/v2\/ht-kb"}],"about":[{"href":"https:\/\/theoptimizer.io\/help\/wp-json\/wp\/v2\/types\/ht_kb"}],"author":[{"embeddable":true,"href":"https:\/\/theoptimizer.io\/help\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/theoptimizer.io\/help\/wp-json\/wp\/v2\/comments?post=185"}],"version-history":[{"count":5,"href":"https:\/\/theoptimizer.io\/help\/wp-json\/wp\/v2\/ht-kb\/185\/revisions"}],"predecessor-version":[{"id":2307,"href":"https:\/\/theoptimizer.io\/help\/wp-json\/wp\/v2\/ht-kb\/185\/revisions\/2307"}],"wp:attachment":[{"href":"https:\/\/theoptimizer.io\/help\/wp-json\/wp\/v2\/media?parent=185"}],"wp:term":[{"taxonomy":"ht_kb_category","embeddable":true,"href":"https:\/\/theoptimizer.io\/help\/wp-json\/wp\/v2\/ht-kb-category?post=185"},{"taxonomy":"ht_kb_tag","embeddable":true,"href":"https:\/\/theoptimizer.io\/help\/wp-json\/wp\/v2\/ht-kb-tag?post=185"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}