Written by Support. Updated 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 System1 account in order to have both traffic source and System1 revenue data aggregated in one place.
Follow the steps below to connect your System1 Publisher account to TheOptimizer Native.
Step 1: When on the Account Wizard page, select a traffic source account and then click Next.
Step 2: In the second step of the Account Wizard, click on Add New to start connecting your System1 account.
Step 3: On the pop-up integration screen, click on the Select Tracking Platform drop-down list and select System1.
Step 4: Fill in the required information as noted in the screenshot below 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 System1 account.
– API Key: API Key value as provided by System1 account (detailed below).
Step 5: In the third and final step, you simply need to specify the traffic source tracking token and System1 subid mapping.
Enable Custom Tracking
Because System1 has only 2 subids available (sub_id and sub_id2), while a traffic source might have more than 2 tokens to map, it is not possible to map each traffic source token on a different System1 subid. For this reason, for System1, a custom tracking setup is being used. Using the Custom Tracking it is possible to pass all traffic source tokens, concatenated with “|”, in a single System1 subid.
Important Note OUTBRAIN ONLY! – Because System1 has a limit of max 100 characters that can be passed on a single subid, and because a single Outbrain token has a length of 35 characters, it is only possible to map max 2 Outbrain tokens on each subid. For this reason, for Outbrain it is recommended to use both sub_id and sub_id2 and map 2 Outbrain tokens on each, in order to avoid the character limit issue.
If for some reason you can not use both subids, then the data that you are going to see on TheOptimizer from System1 will only be limited to the 2 Outbrain tokens that you decided to use. For example, if you are only using sub_id={{campaign_id}}|{{publisher_id}} then you will only have System1 data on campaign and publisher level, but not on section or ad level.
Important Note! – It is important that the same concatenation order that you have used during the setup in Account Wizard, is also used on the campaigns’ tracking code or in content URLs on your traffic source. For example, if during the setup for Taboola you have decided to pass all the tokens to sub_id2 in this order, sub_id2={campaign_id}|{site}|{campaign_item_id}, then the same order needs to be used in the Taboola campaigns
Below you can find some custom tracking setup examples for the top used traffic sources:
Concatenated Taboola Tracking String: sub_id={campaign_id}|{site}|{campaign_item_id} or sub_id2={campaign_id}|{site}|{campaign_item_id}
Concatenated RevContent Tracking String: sub_id={boost_id}|{content_id}|{adv_targets}|{widget_id} or sub_id2={boost_id}|{content_id}|{adv_targets}|{widget_id}
Concatenated Outbrain* Tracking String: sub_id={{campaign_id}}|{{publisher_id}}&sub_id2={{section_id}}|{{ad_id}}
Traffic Source Specific Example URLs:
Outbrain – https://www.example.com/?sub_id={{campaign_id}}|{{publisher_id}}&sub_id2={{section_id}}|{{ad_id}}
Taboola- https://www.example.com/?sub_id2={campaign_id}|{site}|{campaign_item_id}
RevContent- https://wwww.example.com/?sub_id2={boost_id}|{content_id}|{adv_targets}|{widget_id}
Where do I find System1 API Information?
Please contact your System1 account manager to get your account API key.
Once you have obtained your account API key, paste it in the API Key field in TheOptimizer integration screen.