Getting Started with Custom S2S Tracking

About Custom S2S

Custom tracking is available for advanced users who need to integrate their own tracking solution, not pre-integrated with CPIDroid. Tracking Link and Postback URL both are the important things for Custom S2S Tracking to work properly.  

 

Overview:

• Generating the Tracking Link
• Preparing the Postback URL
• Sending the Conversion Postback

Generating the Tracking Link

Tracking link help you to track the user who interacts (clicks) with the ads and takes the user to the advertised app in the App Store or Play Store.

• You will have to setup your own tracking link (via your own tracking solution) and it must carry the macro/placeholder {click_id}, which is dynamically replaced with a generated click id we supply.
• You need to check with your tracking provider to generate a tracking link from your custom tracking software provider's dashboard.
• Your tracking link should must have a url data parameter to carry our {click_id} macro. Usually, this parameter is called as Click ID or External ID by various tracking software providers.
  Note: Some tracking system may not have a dedicated click id data parameter, but they should have alternative parameters to carry custom data which can be used instead such as "data", "var", "custom" and "sub" ..etc.
• For example, if your click id data parameter is "clickid" then tracking link should look like:-
  
  - https://example.com/tracking.php?campaign_id=abc123&clickid={click_id}
  
  Note: Our system will generate & pass unique values on parameter "clickid" by replacing {click_id} placeholder dynamically every time the tracking url is clicked by any user.
  
• Your tracking system should catch the value of our {click_id} and save it in their database, because if that click results into conversion later, it will have to send postback with same value.
• Our system can pass several data to your tracking url by making use of macros/placeholders we have available, kindly refer this guide : List of Macros / Placeholders available apart from {click_id} 

Please note that you will have to enter your tracking link in the "Tracking Link" field given under "Select Tracking Method" box while creating the campaign.

 

Preparing the Postback URL

You will get the default postback url while creating campaign but you may have to prepare them by adjusting the macro/placeholder as per your tracking system.

How to get your default Postback URL?

1. Please go to https://app.cpidroid.com/campaign/add (login required)
2. Choose your platform (Android or iOS) and your desired campaign type (CPI or CPA).
3. Find "Select Tracking Method" box and select "Custom S2S Postback" as your Tracking Provider
4. A description will appear containing your Install Postback URL or Event Postback URL.
5. Copy your default Postback URL and paste/save it within your own tracking system.

Prepare your Install Postback URL:

• If your tracking system's click id data macro/placeholder is {CLICKID} then Install Postback URL should look like:-
  
  - https://cpidroid.com/tracking/s2s/callback.php?user_id=abc123&click_id={CLICKID}

Prepare your Event Postback URL:

• If your tracking system's click id data macro/placeholder is {CLICKID} then Event Postback URL should look like:-
  
  - https://cpidroid.com/tracking/s2s/event.php?user_id=abc123&click_id={CLICKID}&event_name=EVENT_NAME
  
  Note: In case of CPA campaign, unique even name is required, you may hardcode it into the postback url on parameter "event_name"

 

Sending the Conversion Postback

Postback URL help us to get notified about the user who completed the desired actions (conversions) after interacting with the ads.

• We will provide you with a postback URL. You will have to send conversion postbacks to our server on our postback URL after a successful conversion.
• We have two separate postback urls, Install Postback URL (for CPI campaigns) and Event Postback URL (for CPA campaigns) => Make sure to set correct postback url accordingly.
• You will have to prepare/configure our postback urls for your tracking system and enable your tracking system to send conversion postbacks to our postback url.
• Make sure to pass the unique value (same as we passed into your tracking link) of our click id on "click_id" parameter into the postback url.

*Make sure you contact us first to test and enable Custom S2S tracking for your account.

 

Disclaimer for Ad Network (please ignore this, if you are just a direct advertiser)
If you are an Ad Network and going to setup custom s2s with us then you can try S2S but Please be aware of a few things:

• We are connected to quite a lot of networks already. This is specifically true for incent campaigns. In case we get the same offer from multiple sources we send traffic only to the source with the highest bid. This means there is a chance that campaigns of yours are not getting approved, if the bid is too low.
• We are monitoring conversion rate for these campaigns. In case CR is too low or any other issues arise, the campaign will get suspended.
• We don't assume liability for any KPIs that are reached for any campaign. We are able to optimize campaigns though.
• For non-incent campaigns specifically, we'll need to make sure that
• redirect links are always directing to the store and not to other pages
• Campaigns get paused in case the daily cap is reached
• The bid is reasonable for the targeted countries