Singular

For information from Singular, please see here.

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 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 Links 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

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:

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

Metrics

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

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 guide.

Example postbacks

Install postback - iOS and Android

/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)

/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

/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)

/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 article.