Integration Guide for Singular

Instructions on how to create Tracker URLs and activate Event Postbacks

Ashish thakur avatar
Written by Ashish thakur
Updated over a week ago

Last Update: March, 2024

This guide provides step-by-step instructions for integrating Kayzen into your singular dashboard, including how to pass event postbacks from Singular to Kayzen. Additionally, we'll explore the process of creating tracker URLs specifically tailored for Kayzen campaigns.

Steps to Integrate with Kayzen and to configure Event Postbacks

  1. To initiate the integration process login into Singular dashboard and navigate to Attribution > Partner Configuration. Click on Add a Partner and Select Kayzen.

2. Click on Kayzen to navigate to the configuration window. You need to select an App and App Site (platform version) for which you want to configure settings.

3. In the app-specific configuration, ensure all three checkboxes are selected.

  • Send View-Through Postbacks: Enabling this option allows Kayzen to receive postbacks for conversions originating from view-through attribution.

  • Send all install postbacks to Kayzen regardless of attribution partner: This setting ensures that Kayzen receives all app installs for this app, including organic, Kayzen-attributed, and unattributed installs.

  • Send event postbacks to Kayzen for all installs: By checking this box, Kayzen will receive in-app events for every install.

  • Check the box "Send Fraud Postbacks" if it is available in your dashboard.

Please input the Kayzen API Key corresponding to the app you're integrating. Follow the steps outlined in this article to locate your app-specific API key.


4. You have the option to configure the click-through attribution lookback window; however, it is recommended to keep the default value to 7 days.

5. The next step is to configure your install and re-engagement postbacks.

  • Please ensure that "Send View-Through Postbacks" and "Send postbacks to Kayzen on all installs" are enabled for both install, re-engagement, and individual in-app events. You can access this configuration by clicking on the settings option, as shown in the screenshot.

  • Additionally, configure in-app event postbacks. These events may encompass any actions defined and implemented within the Singular SDK. For further guidance please refer the following document.

  • Remember to include revenue values where applicable.

 6. Once configured, scroll to the bottom click on done to save the settings.


If you encounter any challenges with the available options, kindly contact Kayzen support for assistance.


Steps to Generate Tracking Links:

  • Navigate to the Attribution >>Manage links after login into the Singular Dashboard, where you can generate the Kayzen attribution link for your campaign.

  • Choose the desired app and then click on "Create Link". This action will prompt a new window to appear.

    • Ensure that you have already established a subdomain for your links. If you haven't done so yet, click on "Manage Link Domains" and proceed to create a subdomain before creating a link.

  • Choose the link type as Partner, select Kayzen as source name from the Source Name dropdown, and provide a descriptive title under Tracking Link Name. The Tracking Link Name will appear in your reports as "Tracker Name."

  • Scroll down and expand the Link Settings and Redirects section.

    • From the drop down choose the sub-domain

    • Choose 'Enable iOS Tracking' or 'Enable Android Tracking' depending on whether we are creating links for iOS or Android platforms.

    • For iOS, Enable Probabilistic attribution- This enables probabilistic attribution in iOS without requiring the user’s ATT consent.

    • For Android, Enable Probabilistic attribution by setting the view-through and click-through windows in Attribution Settings as shown below.

    • The Site field will be automatically populated with the bundle ID.

    • 'If the app is not installed go to:' - This is your Play Store or App Store URL.

    • Complete any remaining fields as needed.

  • Scroll down and expand the Attribution Settings section.

    • Toggle Enable re-engagement tracking on if you want to track and optimize re-engagement.

    • Override attribution windows - Default attribution windows are set from the Partner Configuration page. Toggle to override values for this link only.

      • Set the click through Deterministic and probabilistic attributions install window.

      • Set the view-through Deterministic and probabilistic attributions install window.

  • Click "Save" to generate the tracking link in the Link Summary section, which includes both the click-through and view-through links.

    • These tracking links are equipped with Kayzen macros, enabling the transmission of campaign information to Singular for attribution automatically.

Singular's integration instruction for Generating Tracking links: https://support.singular.net/hc/en-us/articles/13000445013531-How-to-Build-Tracking-Links


Advanced Setup

Did this answer your question?