Setting up your Singular x UA Integration

1. Configure Universal Ads as a Partner in Singular

Before creating tracking links, you must first configure Universal Ads as a partner inside Singular

1. Log in to your Singular account
2. Go to “Attribution” then “Partner Configuration” 
3. Search for and select Universal Ads in the “Search Partners” text box 
4. Select the app you would like to connect
5. Enable the partner configuration for both iOS and Android, if applicable 
6. Save your configuration 

Tip: For detailed instructions on configuring partner settings, enabling postbacks, and managing attribution permissions within Singular, refer to Singular’s official documentation

2. Generate Singular Tracking Links

Next, create the tracking links that Universal Ads will use for attribution 

1. In Singular, navigate to “Attribution” then “Manage Links”
2. Choose the app that you want to use
3. Select “Create Link”
4. Under “Link Type” select “Partner”
5. Under “Source Name” select Universal Ads 
6. Select Cross-Platform Attribution as the link type
7. Configure your tracking link settings: 
   • Link Name
   • Campaign Name
   • Source Device: Connected TV (CTV)
   • Destination App: Your mobile app
   • Attribution window settings 
     • Note: Make sure “Enable Connected TV Measurement” is toggled ON
     • 
8. Generate the tracking link
9. Copy the impression tracking URL

Tip: For detailed instructions on building and customizing Singular tracking links, refer to Singular’s official documentation

3. Configure Postbacks and Attribution Settings 

Before mapping events, configure Singular to send install and conversion data back to Universal Ads.

1. In Singular, navigate to Attribution > Partner Configuration.
2. Select Universal Ads from your configured partners.
3. Select the app you are configuring.
4. Under App-Specific Configuration, configure the following settings:
   • Enable Send View-Through Postbacks
   • Enable Send all install postbacks to Universal Ads regardless of attribution partner
   • Enable Send event postbacks to Universal Ads on all installs
5. Under Install & Re-engagement Postbacks:
   • Enable Install Postbacks
   • Enable Re-engagement Postbacks (if applicable)
6. Review your attribution windows and measurement settings.
7. Save your configuration.

Once enabled, Singular will be able to send install and conversion data to Universal Ads for attribution and optimization.

Tip: Universal Ads App Promotion campaigns rely on view-through attribution signals for CTV measurement. Ensure Send View-Through Postbacks is enabled to support accurate attribution and optimization.

Tip: For additional guidance on configuring partner settings and postbacks within Singular, refer to Singular’s official documentation

 
4. Configure Event Mapping and Data Sharing 

Event mapping is required for campaign optimization. Mapping conversion events allows Universal Ads to optimize delivery based on your most valuable user actions.

1. Within the Universal Ads Partner Configuration, navigate to Event Mapping.
2. Under Map Your Events, select the Singular events you want to share with Universal Ads.
3. Map each event to the corresponding Universal Ads optimization event.
4. Recommended events may include:
   • Registration
   • Purchase
   • Subscription
   • Add to Cart
   • Tutorial Complete
5. Confirm all desired events are mapped correctly.
6. Save your event mappings.

Tip: Review your event mappings before launch to ensure the events used for optimization align with your campaign goals.

Once enabled, Singular will share attributed install and post-install event data with Universal Ads to support campaign optimization and measurement.

Tip: For additional guidance on event mapping and data sharing within Singular, review Singular’s official documentation

5. Add Your CTV Tracking Link in Universal Ads 

With your Singular CTV Tracking link ready, you can now create your App Tracker in Universal Ads.

1. Create a Performance+ Campaign
2. In the “Objective” section select App Promotion

1. At the Ad Set level under the “Tracking” section toggle the App Tracker ON
2. Select Create App Tracker 

1. Select Singular as your MMP Partner

1. Name your tracker and select which platform you’d like to run on, iOS and Android are pre-selected
2. Copy & paste your iOS App Store ID and Android Package Name in the respective boxes
3. Copy & Paste your impression tracking URL(s) in the respective boxes for each platform type

⚠️  Example of CTV Attribution Link

https://i.sng.link/D4nw9/iin5?ad_account_name={{ADVERTISER_NAME}}&device_type={{DEVICE_TYPE}}&ua={{USER_AGENT_ESC}}&pcid={{CAMPAIGN_ID_ALT}}&pcrid={{CREATIVE_ID_ALT}}&pcn={{CAMPAIGN_NAME}}&impression_id={{AUCTION_ADGROUP_ID}}&pscid={{LINE_ITEM_ID_ALT}}&ip={{IP_ADDRESS_ESC}}&ad_account_id={{ADVERTISER_ID_ALT}}&pcrn={{CREATIVE_NAME}}&pscn={{LINE_ITEM_NAME}}&p=ctv 

1. Click Finish
   • Universal Ads will automatically validate your URLs and App IDs before saving.
   • The impression tracking URL will automatically be appended to all creatives under the ad set it’s appended to.