Partner Configuration and Postbacks: FAQ and Troubleshooting

Learn how to use the Partner Configuration page, the different options for setting up partner postbacks, and how to solve common issues.

If you're just getting started, see How to Configure Partner Settings and Postbacks.

Note: This guide is for Singular customers. If you are a Singular partner or want to become one, see Information for Partners instead.

 

Troubleshooting

Why is my network partner not receiving postbacks?

If a partner network says they are not receiving postbacks for installs/conversions or in-app events:

  1. Go to Attribution > Export Logs and download the postbacks logs for the partner. For help downloading logs, see the Export Logs and User-Level Data FAQ.
    • Make sure to filter the postbacks with Response HTTP Code = 200. If the Response HTTP Code is "200", it means that the partner confirmed that they received the postback. 
    • Also select the field Response HTTP Body as it may help pinpoint a tech issue at the partner's end. 
  2. Share the log with the partner to validate the data internally. If there are many postbacks with other response codes, inform them that there might be a technical issue with them receiving postbacks from Singular.
Why is there a mismatch between the number of events received by the partner as postbacks and the events in Singular reporting?

Some possible reasons are:

  • Lookback windows: One or more events may have a different lookback window configured for postbacks. Check the settings in the Partner Configuration page.
  • Technical issues: The partner may not have received one or more postbacks due to technical issues on the partner's end. To check, see Why is my network partner not receiving postbacks?
  • Duplicate events: The Singular SDK in your app auto-generates an event called __REVENUE__, which is triggered on any in-app purchase. In addition, you can also create your own SDK revenue events for different types of in-app purchases. When you configure event postbacks, make sure to send postbacks either for __REVENUE__ or for your custom-named revenue event(s) - but not both. Otherwise, Singular will send two postbacks for each in-app purchase.
Why are postbacks being sent to a partner without event attributes?

If a network partner says they are receiving postbacks without event attributes:

  1. Go to Attribution > Export Logs and download the postbacks logs for the partner. Check the postback HTTP Body or Target URL fields to see if they include event attributes. For help downloading logs, see the Export Logs and User-Level Data FAQ.
  2. If the logs show that postbacks are indeed being sent without event attributes, double-check the postback settings in the Partner Configuration page. If you have not configured added attributes to be sent along with events, change the settings now.
  3. If the settings are correct and postbacks are still being sent with missing attributes, contact Singular support.
How do I double-check what postbacks were sent to a network partner, e.g., for billing and invoicing purposes?

If your billing with a network is based on the number of install/event postbacks that Singular has sent to them during the period, you can double-check what postbacks were sent to a partner by downloading raw postback logs at Attribution > Export Logs.

For general help with the Export Logs page, see the Export Logs and User-Level Data FAQ.

For postback validation, we recommend downloading a log with the following settings:

postback_log1.png

postback_log2.png

Be sure to filter for the value "200" in Response HTTP Code to see the postbacks successfully received by the Postback Recipient.

Don't get confused between the Partner and Postback Recipient fields:

  • Partner is the network to which the event was attributed.
  • Postback Recipient is the partner that received the postback for the event. The event is not necessarily attributed to that partner (remember, some partners ask to receive postbacks on all of your events, whether they are attributed to that partner or another network, and you can enable that option in the Partner Configuration page).

An additional field, Is Attributed, further clarifies whether the postback recipient is the network to which the event was attributed ("Y" means it's the same network, "N" means the event was attributed to another partner which you can see in the Partner field).

Note: The Partners filter will filter the postbacks by the name of the partner who received the postbacks - whether it was a partner network, your internal BI, third-party analytics tools, etc.

For other log types, the Partners filter means the partner to whom a conversion or an event was attributed (ad networks).

FAQ

Partner Configuration FAQ

Which postbacks are required and which are optional?

Singular sends every partner network a postback when an app install is attributed to that network. You cannot disable these postbacks.

Other types of postbacks are optional and depend on the preferences of the partner network:

  • Re-engagement postbacks
  • In-app event postbacks
  • Postbacks about conversions (installs/re-engagements) and events that are not attributed to the partner
Which IPs are Singular postbacks sent from?
When and how often does Singular retry sending a postback? How long does the system wait between retries?
  • Singular retries sending a postback if we receive an HTTPS response code between 500 and 559.
  • The mechanism has a maximum of 5 retries.
  • Retries are in intervals of 1, 5, 15, 30, and 60 minutes from the original attempt.

Partner Types and Terminology

What are partners?

The partners in the Partner Configuration page are all the networks and services you configure to work with Singular's attribution service.

Note: This is not where you tell Singular which sources to pull campaign data from to present the data in Singular reports. For that, you need to set up ad networks and other media sources separately in the Data Connectors page (see the Data Connectors FAQ).

What sort of settings can I configure for a partner?

The Partner Configuration page lets you configure the following things per partner and site:

  • The lookback window for click-through attribution
  • Which postbacks to send to the partner
  • This is also where you enter your login credentials to the partner's platform, if Singular needs them to connect to the partner. This varies from partner to partner.

For more details, see Configuring Settings and Postbacks below.

What types of partners are there?
  • Some partners are ad networks, ad agencies, etc. You configure attribution settings for these partners, and then you create tracking links that incorporate the partners' custom macros. You can also have Singular send these partners information about attributed installs, fraud decisions, etc. in the form of automated postbacks.

  • Other partners are third-party BI systems, fraud analyzing services, etc. If you work with such services, you can set them up in the Partner Configuration page so they can receive postbacks.
What are "Internal" partners (internal BI)?

"Internal BI" is a special type of partner that you can configure if you want your own internal platform to receive postbacks about attribution decisions, fraud decisions, etc. See Configuring Internal BI Postbacks for more information.

What are sites?

A site (or an app site) is a version of your app developed for a specific platform. You configure partner settings for each app site separately.

For example, if you have an app that runs on Android and on iOS, you have two app sites, and you can configure the partner settings for each one.

See also: App Configuration FAQ.

How does Singular know what data to send each partner?

As part of the process of developing integrations with an attribution partner, Singular creates a postback template that contains all the fields supported by the partner. When you save a new partner configuration, Singular starts creating postbacks based on that template.

How do I export partner settings? How can I get a full list of the postbacks configured for my partners?

To export postback settings for all partners, click Export All on the top right corner of the Partner Configuration page.

To export postback settings for selected partners, first select one or more partners by clicking the checkbox to the left of the partner, and then click Export Selected.

This downloads a CSV file with information about each postback that has been configured:

Column Description
Partner The name of the partner
App The display name of the app
Long Name The long name or bundle ID of the app
OS The OS of the app (iOS or Android)
Created  
Click-through attribution lookback window The lookback window configured for this partner and app site.
Postback Type Install or Event.
Events The name of the event that triggers the postback.
Attributed Only Whether the postback is sent for all events of this type or only if the install has been attributed to the specific partner.
Postback URL The full URL of the postback, including Singular macros.

Settings and Postbacks

How do I double-check what postbacks were sent to a network partner, e.g., for billing and invoicing purposes?
Why do I need to pick the app and app site when setting up a partner?

Partner settings are configured for each app site separately.

What is the security key/token/password that I'm asked to enter?

Singular usually requires certain credentials to send postbacks to the partner. Ask the partner for the appropriate credentials.

What are re-engagement postbacks?

These are postbacks that notify the partner about a successful re-engagement. The option to enable these postbacks is only available for partners that support re-engagement campaigns (retargeting campaigns).

What are view-through attributions?

View-through attributions are attributions determined based on an ad view rather than an ad click. If you run any view-through campaigns, select Include View-Through Attributions to have Singular send postbacks to the partner about these attributions as well (otherwise, Singular will only send postbacks about click-through attributions).

What are fraud postbacks?

Fraud postbacks include information about decisions made by Singular's fraud detection system. To learn more, see Fraud Postbacks. Also, see Singular Fraud Prevention for an introduction to Singular's advanced fraud detection methods.

What is the attribution lookback window?
What are in-app events?

In-app events are any user events that happen in your app post-conversion. For example, a user who installs your app may then log in or register to your platform, watch the tutorial, or level up if it's a gaming app. Some partners want to receive postbacks about these events from Singular's attribution service.

How do I configure in-app event postbacks?

image4.png

First, choose which postbacks you want to send:

Option Meaning
All Send this partner postbacks about all in-app events
Only if the install was attributed to X Only send this partner postbacks about in-app events if the app install was attributed to this partner.
Off Never send this partner postbacks about in-app events.

Next, add your in-app events as follows:

Field Meaning
In-app (SDK) event name The name of the event as sent from your app through the Singular SDK integration.
Event Name The event name or ID as recognized by the partner (the partner would usually have a list of events that it can recognize).
Send Revenue For revenue events, include the revenue information in the postback (if you do not check this checkbox, Singular will only send a count of the events).
What's the difference between the __iap__ event and the __REVENUE__ event? Which one should I configure postbacks for?
  • __IAP__ is any in-app purchase event that wasn't given a custom name.
  • __REVENUE__ includes:

    1. All in-app purchase events (__IAP__ + events with custom names, if any).
    2. Ad revenue events reported by the SDK (if you have set up ad revenue attribution using the method of sending SDK events).

If you don't have any ad revenue events set up, and you just want a revenue event that encompasses all your in-app purchase events, use __REVENUE__.

Note that selecting to send __REVENUE__ postbacks may cause problems if you have ad revenue events and the network is not set up to receive this type of postback. Before sending ad revenue events, check with the network that it is able to receive ad revenue postbacks.

How do I update partner integrations and postback configuration?

Singular's integration team is in constant contact with partners to ensure we have the best integration possible. Occasionally a partner may ask you to update the integration, for example, due to changes to how the partner wants to receive postbacks from Singular.

In most cases, you can update the integration by logging into Singular, going to the Partner Configuration page, opening the integration, and re-saving it.

In some rare cases, an update may require more steps, such as providing a new field or setting that didn't exist before. In such cases, the parter or Singular will contact you to provide instructions.

Was this article helpful?