You have just created a tracking link through the Manage Links page. Before you start using it in a campaign, you can test the link and see what information it sends to Singular.
You will be basically simulating an ad click and looking at Singular's attribution logs to check how the click was handled.
Guide for | UA Managers |
Prerequisites | 1. Singular's attribution service has been set up for your organization. 2. The Singular SDK has been integrated into your app. 3. You have generated a new Singular Link using the Manage Links page. |
Tools | A mobile device for testing |
1 |
Delete the Old Advertising IDIf your mobile device has been used to test Singular attribution before, you have to clear the data. First, uninstall your app from the device. Then, reset your mobile device's advertising identifier:
|
2 |
Get the New Advertising IDFor Apple devices, you need the IDFA identifier. To find out the IDFA of your test device, you can download the Singular Device Assist app from the App Store. For Android devices, you need the GAID (or AIFA). To find out the GAID of your test device, you can download Singular Device Assist from Google Play. |
3 |
Copy the Singular LinkCopy the tracking link you generated to somewhere you can edit it. It should look like the following. Note that the link includes a list of parameters, such as "aifa", "idfa", "cl", and "pcid". The values in {curly braces} are macros - placeholders meant to be replaced with actual values by the advertising network when it serves the ad. The macros' names and appearance may vary from link to link.
|
4 |
Insert Advertising ID into LinkIn order to test the link, you need to replace the relevant placeholder with the device's advertising ID.
Delete all the other placeholders. Here is an example of what the result should look like (for an Android device):
Note: All the parameters in the link have to be given a valid value (in this case, the aifa parameter) or left blank. If you click on a link that still has placeholders in curly braces {}, it may not result in successful attribution. To learn more, see Tracking Link Parameters.
|
5 |
Trigger the LinkSend the tracking link to your testing device and click on it from the device. You are redirected to the Apple App Store or Google Play Store. |
6 |
Install and Open the AppDownload the app, install it, and open it (Singular can only attribute the install after the app is opened). |
7 |
Verify AttributionTo verify that the install has been attributed properly by Singular, you can use either the Singular Device Assist App or the Attribution Details API endpoint. See instructions: |
8 |
Alternate Method: Verify Attribution Using the Attribution LogsTo check through the attribution logs:
If your test install was attributed correctly, you will find a conversion event in the log with the Device ID of your device. The Partner should be the partner you created the tracking link for. |
Other Ways to Test a Link
Testing Fingerprint-Based Attribution
To test what happens when the tracking link is clicked from devices that don't supply the IDFA or AIFA, do the following:
- Reset your device's attribution (see Resetting a Device and Clearing the Install Attribution).
-
Copy the tracking link again, but this time erase all the macro values, including the device ID. All the macros should be blank, as in the following example:
https://singularassist.sng.link/D59c0/tpa9&aifa= &idfa=&cl=&pcid=&pcn=&pshid=&psn=&psid=&pcrid=&pcrn=
- Send the link to your testing device and click it from the device. Then follow the same steps as in the previous test.
Testing Deep Linking
If you've generated a tracking link with deep linking functionality, you can test it using the following steps:
- Install the app on your test device.
- Copy the link from the Manage Links page and send it to your test device.
- From the device, click the link. The app should open and display the intended screen or content.