System1 RSOC Integration Guide

A step-by-step guide on how to integrate System1 RSOC to ClickFlare
E
Written by Ervis
Updated 3 weeks ago

Thanks to ClickFlare's API integration with System1 RSOC, you'll be able to have conversions and revenue accurately pulled automatically into ClickFlare. 

Note: The frequency conversions and revenue are pulled varies depending on your subscription plan.

In this article, we'll go over the step-by-step process of setting up the API Integration with System1.

What you'll need for the integration:

  • An active System1 Account.
  • An active ClickFlare Account.
  • Your System1 Auth. Key

Adding the System1 integration to ClickFlare.

To add System1 integration to your ClickFlare account, begin by accessing the Integrations Menu, found under the Settings Menu (gear icon).

  • Under RSOC Integrations, click Add Integration.

  • Choose the System1 template
  • Give your new integration a Name.

Note: Have your integrations' connection info ready before proceeding to connect it with ClickFlare.

  • Under Accounts, click on + Connect Account.
  • Enter the account name, auth key and click on Save.
  • Move on to choosing the custom conversion, you want to attribute the conversion event to.

    To learn how to add a custom conversion in ClickFlare, follow our article here.

Note: In order for the integration to work, you have to send the {cf_click_id} to the "nonrevsubid" parameter (check offer URL example below). 
  • Lastly, click on Save.

You’ll see the new integration appear under the Revenue Stream Integrations section

Offer URL template for System1:

https://your_domain/?segment=REPLACE_SEGMENT&subid={campaign_id}&headline=REPLACE&optkey=REPLACE&forceKeyA=REPLACE&forceKeyB=REPLACE&network=facebook&nonrevsubid={cf_click_id}&impression_track_url=https%3A%2F%2Fyour_tracking_domain%2Fcf%2Fcv%3Fclick_id%3D%7Bcf_click_id%7D%26ct%3Dimpression&search_track_url=https%3A%2F%2Fyour_tracking_domain%2Fcf%2Fcv%3Fclick_id%3D%7Bcf_click_id%7D%26ct%3Dsearch&click_track_url%3Dhttps%3A%2F%2Fyour_tracking_domain%2Fcf%2Fcv%3Fclick_id%3D%7Bcf_click_id%7D%26ct%3Dclick

*Important Note:
It's crucial to append the following parameter to your offer URLs:

• The ClickFlare click ID: "&nonrevsubid={cf_click_id}"

• The ClickFlare campaign ID: "subid={campaign_id}"

If you fail to append the {cf_click_id}, your postbacks will not fire and ClickFlare will not pull any revenue from System1.

If you fail to send the  {campaign_id} in the subid parameter, you'll not have same day revenue. The revenue will be reflected starting from the next day

*Note:
Make sure that the postback are encoded correctly. For instance, only the postback after the equal sign should be encoded.

If your postbacks are:

&search_track_url=https://your_tracking_domain.com/cf/cv?click_id={cf_click_id}&ct=search&click_track_url=https://your_tracking_domain.com/cf/cv?click_id={cf_click_id}&param10=SEGMENT_NAME&ct=click

The enocded postback should look like this:

&search_track_url=https%3A%2F%2Fyour_tracking_domain.com%2Fcf%2Fcv%3Fclick_id%3D%7Bcf_click_id%7D%26ct%3Dsearch&click_track_url=https%3A%2F%2Fyour_tracking_domain.com%2Fcf%2Fcv%3Fclick_id%3D%7Bcf_click_id%7D%26param10%3DSEGMENT_NAME%26ct%3Dclick

Failing to encode the postbacks correctly, will cause them to break and not report conversions correctly.

Postback template for System1

The postbacks go directly in the offer URL (check offer URL oabove)

These are the postbacks:

impression_track_url=https://your_tracking_domain/cf/cv?click_id={cf_click_id}&ct=impression

search_track_url=https://your_tracking_domain/cf/cv?click_id={cf_click_id}&ct=search

click_track_url=https://your_tracking_domain/cf/cv?click_id={cf_click_id}&param10=SEGMENT_NAME&ct=click

Note: Always make sure to encode the postbacks, before appending them to your offer URL.
Note: Sytem1 revenue reporting operates on PST time. Please ensure to set your ClickFlare settings to PST when checking reporting for System1.

Glossary:

optkey - Like referring ad creative, optkey is another content-based hint for term optimization. Note, “headline” has a stronger hierarchy in terms of influence on the terms, so the preference should be on providing optimal “headline” values.

forceKey - The forceKey URL parameter is one way to specify the terms you’d like the user to see in the RSoC widget. If you choose this strategy, you’ll set forceKeyA as the first term, forceKeyB as the second term, and so on, as shown in this example:

Please note: 

  • You can only pass one keyword per forceKey.

  • You should provide at least six unique forceKey terms (A - F) to ensure there are enough terms for all RSoC widgets on the page. 

  • If you’d like your page to feature more than one RSoC block, please notify your account manager first. You must then provide enough keywords to populate both blocks, and all keywords must be unique across both blocks.

segment - It's a bucket of traffic; typically a buyside account. If no segment is passed, System1 uses the “default” segment, and this will not affect the rest of the URL params sent.

subid - More granular performance tracking at a campaign, adgroup, etc. level. You have a finite number of subids per day. Once you reach that limit, new subids will stop being tracked. Your account manager will be notified when you get close to the limit.

nonrevsubid - The most granular performance tracking but does not include revenue. There is no limit on the cardinality of this parameter.

! Important Note: The revenue we calculate on a click ID level, it's not accurate but just an estimation, based on the revenue dimensions (segment, subid, geo, device) provided by System1

Related Resources:

 

Did this answer your question?