Onboarding Guide for Agency Partners

 

Singular’s Agency Portal is currently in a closed BETA program with select agencies. This guide is for agencies who have access to it. If you would like to be considered for BETA access please email support@singular.net.

 

Prerequisites

  • You provide mutual advertisers transparency on the media sources you advertise

 

Limitations

  • In order to have your email alias associated with an Agency Portal with Singular, that email alias can not already be permissioned access to another Singular account (Advertiser account or Partner Portal).
  • The Agency Portal only shows attributed install and in-app events for advertisers using Singular as their MMP.
  • Agency partners cannot set up a Data Connector from within the Agency Portal to report advertising costs from their campaigns. In order for advertising cost to be reported in the Advertiser's account for the agency-managed campaigns, agencies need to request the advertiser gives Restricted User Access to their Advertiser account. The agency partner can then setup a Data Connector for each media source to pull in the advertising costs for their campaigns. Alternatively, the agency can email support@singular.net and request to directly integrate with Singular to send advertising cost data using a file-based integration that the agency will maintain. 

 

Setup Instructions on Singular's Platform

Receiving access to advertisers' apps:

  1. Have the advertiser go to Settings → Team Management → Agencies
  2. Select Add Agency to choose your agency from the dropdown list. If your agency does not appear in the list, please email support@singular.net to see if you’re eligible for an Agency Account or if you are working with an advertiser who does not have the ability to invite agencies in their Team Management page.

Configuring a campaign:

Once your Agency has been granted access to the advertiser’s Apps then the Agency can log into their Agency account and select:

  1. Select Account → [Advertiser Account Name]
  2. Go to Partner Configuration to setup postbacks
  3. Thereafter, click Manage Links to setup the tracking links for the media sources. You will be able to adjust any attribution windows for the partner campaign here, assign deeplinks to the campaign, and determine if the campaign should utilize probabilistic attribution or not. 

Test the tracking links:

Use our testing instructions prior to launching a campaign with partners to ensure measurement is working as you expect it. 

If you need to troubleshoot a test prior to launching a campaign, please look at some of our FAQ guides to double-check your setup:

      1. Partner Configuration FAQ & Troubleshooting
      2. Tracking Link FAQ

Campaign Reporting:

You will have access to reporting of attribution data within the Agency Portal. You will not have access to reporting of advertising cost from each media source. This currently exists only within the advertiser’s Singular account.

Overview of all menu options with the Agency Portal:

  • Analytics (Reporting is based on deterministic and probabilistic attribution. No SKAN reporting is available. If you require some data that is not contained within the Agency Portal reporting, please ask the advertiser to create a Shared Report for you to bookmark limited to the sources you manage for them.)
  • Attribution
  • Settings
    • Data Destinations (send your attributed data to your internal BI)
    • Events (see what events the advertiser has chosen to share with you from their Singular SDK / S2S implementation. You are not able to edit anything on this page.)
    • Account Select (change which advertiser data you want to review)
    • Apps (see the applications configurations that the advertiser has configured and the inactivity window that is set, along with deeplinks available to use within a campaign)
    • Team Management (see which team members have access to view the advertiser’s data)
  • Developer Tools
    • Testing Console (see calls being made to Singular from the advertiser’s SDK implementation. You can test that your install is registered. Note: this does not mean your install was attributed to a campaign.)

FAQ

Learn about tracking links, postback and about adding “passthrough parameters” to your Singular tracking links:

  • What is Singular’s tracking link structure?
    • Tracking links built by agencies will contain an agency ID to differentiate tracking links built by an agency versus the advertiser.
  • Tracking link parameters are reserved for specific information that Singular reports on within advertisers' reports that are related to their campaigns. If you have additional information you want passed on the tracking link and receive on the postback that does not match a description for any of the listed parameters, please use a unique parameter to pass the information on. An example could be an internal advertiser ID represented on a tracking link, such as: aid=115873
  • Postback Macros are available for information that Singular collects from the advertiser's apps, campaigns, and device- and event-related information.
  • Passthrough Parameters are a way to add information to the tracking links that you wish to receive in postbacks to your own server.
  • Can advertisers see the media partners, tracking links and postbacks I’ve set up on their behalf?
    • Yes, Singular gives full transparency to the advertiser to see this. Below is an example of how advertisers can choose to view tracking links and postbacks created by your agency from within their Singular advertiser portal:

Tracking links visibility:

Postbacks setup visibility: