--- title: "Singular" slug: "singular" updated: 2026-04-01T16:44:12Z published: 2026-04-01T16:44:12Z canonical: "help.awin.com/singular" --- > ## Documentation Index > Fetch the complete documentation index at: https://help.awin.com/llms.txt > Use this file to discover all available pages before exploring further. # Singular > [!NOTE] > Note > > For information from Singular, please see [here](https://support.singular.net/hc/en-us/articles/21934945208219-Awin-Attribution-Integration). ## Features and Limitations - Awin's postbacks on Singular are GLOBAL (non-customizable). So the values being passed can be adjusted by the advertiser in conjunction with Singular support. - We have INSTALL and IN-APP postbacks in place for iOS and Android. - Deep-linking is supported ## Integrating Awin Tracking ### Integrating Singular The integration steps must be completed for both Android and iOS apps on the Singular dashboard. 1. Advertiser to implement the SDK. 2. Set up Awin as a partner in Singular. 3. In your Singular account, go to **Attribution** > **Partner Configuration** > Click on **Add a partner**. Select "**Awin**" from the drop-down list. 4. In the **Configuration** window, select the application and application site for which you want to configure Awin. 5. In the Awin Advertiser ID box, enter your advertiser ID. ### Define the Attribution Window & Postbacks Ensure both **Install** and **Re-Engagement** boxes are selected. Set the **Click Through Window** to 30 days for both. Once finished click ‘**Next**’ in the bottom right corner. ### In-App Events Postback **Revenue Events Postbacks**: 1. In the drop down menu select ‘**Manually select individual revenue events**’. 2. Select the desired ‘**Purchase**’ event from the drop down menu SDK Event Name. 3. Enter the desired **Commission Group Code**. Please note this must also be setup on Commission Manager via the Awin platform. For more information, please see our [Commission Groups](/developers/docs/commission-groups) article. 4. Select ‘**TouchPoint**’ from the **Postback Window Starting Point** dropdown menu. 5. Ensure the **Postback Window** is set at 30 days. 6. Ensure the ‘**Include Revenue**’ checkbox is enabled for any event containing revenue data. 7. Upon completion the event configuration should look similar to: **Adding More Revenue Events** Select events in the application to send to the partner. - In event postbacks, click on "+" to add a new event. - Select one of the events reported by the Singular SDK in your application. - If the event involves revenue, select the "Send Revenue" checkbox. - Repeat for all your events. **Adding More Event Postbacks** - Click ‘Add a new event’ - Repeat the steps listed above (excluding the revenue) ## How to create a Singular Tracking Link In your Singular account, go to **Attribution > Manage Link**s and **Create Link**. Select ‘**Partner**’ from the **Link Type.** Under source name, select "**Awin**". Provide a **Tracking Link Name** so you can easily identify it in analytics reports. This will appear in your Singular reports as ‘**Tracker Name**’. ### Link Settings and Redirects Configure which app site(s) this link is for, and what happens when users click on it. Select the Link Sub-Domain and activate for both IOS and Android. **Probabilistic Attribution** Check to define the link as “**owned mobile web-to-app media**”. This enables probabilistic attribution in IOS without requiring the user’s ATT consent. More information can be found at: [https://support.singular.net/hc/en-us/articles/4403415921805-How-to-Get-Started-with-SKAdNetwork](https://support.singular.net/hc/en-us/articles/4403415921805-How-to-Get-Started-with-SKAdNetwork) **IOS** Configure the below redirect options for when: - The app is not installed - If the app is installed - When the user first opens the app **Android** Complete the same steps for Android **Fallback URL** Add a Fallback URL for other devices using the link ### Attribution Settings Configure settings such as attribution methods and windows for the generated link. Ensure ‘**Enable re-engagement tracking**’ is switched on. **Default Attribution Window** is defined within the **Partner Configuration Page**. If you want to override those values for this link please toggle the button and adjust the time periods below. Once completed click ‘**Generate**’ to create the Tracker. Click ‘**Link Summary**’ to view the Click-through tracking link. Example Tracking Link: ```plaintext https://posthaus.sng.link/Adch7/t46t?_dl=posthaus%3A%2F%2Fposthaus.com.br%2F&_smtype=3&pcid=!!!id!!!&cl=!!!awc!!!&psn=!!!companyname!!!&psid=!!!affid!!!&pcrid=!!!linkid!!! ``` **Data Mapping** **Dimensions** | Field in Singular UI | Field in Singular API | Field in Awin | | --- | --- | --- | | App | app_name | app_name | | Campaign Name | unified_campaign_name | advertiserName | | Campaign ID | country_field | advertiserId | | Country | adn_campaign_id | region | | Publisher ID | publisher_id | publisherId | | Publisher Site Name | publisher_site_name | publisherName | | Currency | currency | currency | | Creative ID | adn_creative_id | creativeId | | Creative Name | creative_name | creativeName | **Metrics** | Field in Singular UI | Field in Singular API | Field in Awin | | --- | --- | --- | | Network Clicks | adn_clicks | clicks | | Network Impressions | adn_impressions | impressions | | Original Cost | adn_original_cost | totalComm | | Original Currency | original_currency | currency | ### Deeplinking Singular allows the creation a unique deep link that directs the user to the correct page within the app even if it originates from any possible OS, channel and platform. This tracking link is to be configured as a mobile prefix within the Awin platform **Fallback URL** If the app is not installed, redirect the user to this page (typically this will be the App Store to encourage users to install the app) **Deep Linking** If the app is already installed, open the app after the click and/or serve the user personalized content (such as redirecting the user to a specific page within the app). **Deferred Deep Linking** After the app has been installed , redirect the user to a specific page within the app, (typically the same URL as the deep link but can be different if needed) If a user who clicks on an Awin URL already has your app installed, they will be directed to the app's main homepage screen unless you have deeplink handling implemented in your app that can read the web URL and translate it to the same destination in your app. Web destination URLs different from app destination URIs. Your app developer needs to implement the transformation and redirection of the web destination URL into the same destination in your app. More information on the configuration of Deep Links can be found at: [https://support.singular.net/hc/en-us/articles/360050910891-How-to-Create-Deep-Links](https://support.singular.net/hc/en-us/articles/360050910891-How-to-Create-Deep-Links) #### Commission Groups The commission group can be populated in breakdowns, for example: *commissionGroup1:amount1|commissionGroup2:amount2|commissionGroup3:amount3*. However, it must be configured within the "Awin_CG" variable that will be sent by the SDK. More information is available on our [Commission Groups](/developers/docs/commission-groups) guide. ### Example postbacks **Install postback - iOS and Android** ```plaintext /sread.php?tt=ns&tv=2&type=ai&merchant={Merchant_ID}&amount=1&ref={TIMESTAMP}3&parts={DEVICE_INSTALL}:1&cks={coalesce,(awc),(cks)}&ch=aw&p=singular&re-engagement=1 ``` **Install postback - iOS and Android (Awin Live Example)** ```plaintext /sread.php?tt=ns&tv=2&type=ai&merchant=17634&amount=1&ref=fdb7f765dde1ac0ae23023f9389053e45cc178d0&parts=iOS_INSTALL:1&cks=17634_1712341671_caa46a9dd8fcc9c30e25b82809a3689d&p30=singular&ch=aw&re-engagement=0 ``` **In-app postback** ```plaintext /sread.php?tt=ns&tv=2&type=ap&merchant={Merchant_ID}&amount={Transaction_Total}&ref={Order_Ref}&parts=INAPP-SALE:{Transaction_Total}&cks={coalesce,(awc),(cks)}&p1={TIMESTAMP}&ch=aw&cr={Currency}&p30=singular ``` **In-app postback (Awin Live Example)** ```plaintext /sread.php?tt=ns&tv=2&type=ap&merchant=17634&amount=89.89&ref=54489364&parts=INAPP-SALE:89.89&cks=17634_1715712831_47e7a6cb689241c2660d93199bf22d3a&p1=3040f5a806d7948e657c8d8561c90a22&ch=aw&cr=BRL&p30=singular ``` --- ## Testing your App Tracking Once you’ve completed the installation of your app tracking, please get in touch with your assigned Awin technical point of contact for more information on how to test your tracking. For a more general overview of the testing process, please review our [Testing your Integration](/developers/docs/testing-your-integration) article.