Using the Partner Portal

The Singular partner portal is a dashboard designed for integrated ad networks to keep an eye on their campaigns with Singular-enabled advertisers. Here, an ad network can view campaign information, configured postbacks, Postback Reports, Templates, Attribution logs and access helpful integration tools to aid in troubleshooting potential issues.

Partner Portal Access

 

Once granted access to the partner portal, ad networks can access it at https://partners.apsalar.com/.

Partner Portal Features

Campaigns

In the Campaigns dashboard, you may view the campaigns your advertiser has configured within the Singular system, along with the attribution tracking URLs for these campaigns. Use the dropdown to switch between advertiser configurations. "Campaign", "Application", and "Ad Group" are as named by the advertiser and may or may not match your advertiser's values in your system.

Column Description
Campaign Name of the campaign in Singular
Application Name of the applications in Singular
Ad Group Group within campaign in Singular
Click Tag Tag associated to the campaign in Singular

Configured Postbacks

In the Configured Postbacks dashboard, you may view the postbacks your advertiser has currently configured for you.

Column Values Description
Event Type install The postback that is fired for an install
event The postback that is fired for any configured post-install event
revenue The postback that is fired for any revenue or event with currency transaction
Status Active Active and set to trigger
Paused Paused and not set to trigger
Attribution Rules Attributed Will only send for event attributed to your network
All Will send for any event regardless of attribution source - most commonly used for re-engagement campaigns

Postback Report

In the Postback Report dashboard, you may see the count of attributed and not attributed postbacks which you received to your network endpoint. Use the drop-down to switch between advertisers' apps.

Column Values Description
Date - Date of postback sent
Postback ID - The postback ID
Recipient - Recipient of postback
Attribution Rules Attributed Will only send for event attributed to your network
All Will send for any event regardless of attribution source - most commonly used for re-engagement campaigns
Event Type install The postback that is fired for an install
event The postback that is fired for any configured post-install event
revenue The postback that is fired for any revenue or event with currency transaction
Total Postback Count - Count of postbacks sent. This number will match the "Attributed Postback Count" for attributed postbacks
Attributed Postback Count - Count of attributed postbacks sent. This number will match the "Toal Postback Count" for attributed postbacks

Postback Templates

In the Postback Templates dashboard, you may see your postback templates for Install, Custom event and Revenue event per platform.

Column Values Description
Type install The postback that is fired for an install
custom event The postback that is fired for any configured post-install event
revenue event The postback that is fired for any revenue or event with currency transaction
Platform iOS\Android Platform
Network(s) - attributed network - this will match your network's name unless you receive postbacks for attributed installs\event of other networks
Status Active Active template and in use
Paused Paused template and not in use
Template URI - Your network's endpoint+parameters

Attribution Logs

The Logs dashboard allows the retrieval of recorded attributions (install/re-engagement) Singular has for your account. These attribution logs are Singular's attributions, and in most cases, will not match postback records due to click/install windows configured for attributed postbacks.

The attributions can be queried by:

  • selected advertiser
  • selected advertiser app
  • selected date range (advertiser's configured timezone)
  • campaign name
  • group name
  • publisher
  • passthrough values
  • device ID
  • attribution type

Queries are executed by literal string matching. Regex matching is not supported. ​For example, if you would like to retrieve attributions for a campaign name like "Test Android Campaign", enter in "Test Android Campaign" under the Campaign Name text field (omitting double quotation marks).

The attribution logs will be emailed to the email registered to the account. Please allow for a few minutes for the query, depending on the size of the query. Results are in a tab separated format with the following columns:

  • device ID
  • device key
  • IP address detected at time of attribution
  • publisher/source
  • campaign source
  • campaign name
  • campaign group
  • click time (client timezone)
  • install time (client timezone)
  • fingerprint flag - t/f
  • pass-through parameters
  • re-engagement flag - t/f

Note: Attribution logs are records of Singular's attributions.

Note: If your attribution log results are blank, please ensure your query terms are correct, or try querying for a smaller set of data. We recommend querying a day first to ensure your query terms will result in an expected hit, then expanding query date range to retrieve attributions.

Integration Tools

The Integration Tools dashboard contains any utilities that are available to networks to help troubleshoot integration issues.

Currently, the dashboard contains a feature to forget devices in the Singular system. This utility will reset a particular test devices attribution status for an Singular advertiser. To use:

  1. Select the advertiser
  2. Select the test device's keyspace (usually device ID, or device's advertiser ID)​
  3. Provide the device's keyspace value and click "Reset Device"
Was this article helpful?
1 out of 1 found this helpful