Singular is a unified marketing analytics platform that delivers attribution, cost aggregation, creative reporting, and workflow automation.

Singular allows you to import paid install attribution data to segment more intelligently within your lifecycle campaigns.


Step 1: Integration Requirements

  • This integration supports iOS and Android apps.
  • If you expect more than 100 attributed installs per hour, you will need a Braze Enterprise account. See API Restrictions for more information.
  • Your app will need Braze’s SDK and Singular’s SDK installed.
  • If you have an iOS app, you will need to enable IDFA collection in Braze’s SDK.
  • If you have an Android app, you will need to include the code snippet below, which passes a unique Braze user id to Singular. For most setups, 2 lines of code must be added in an app’s onCreate() method immediately after Singular’s init method or session start. Braze’s device_id must be available when the first “App Open” event is sent to Singular.
protected void onCreate(Bundle savedInstanceState)
    // Other code
    // Init Singular SDK
   Singular.init(context, config); // context is Application Context
   // Code For Braze
   String appboyDeviceId = Appboy.getInstance(context).getInstallTrackingId();
   Singular.event("App Open", "appboyUserID", appboyDeviceId);

Step 2: Getting the Braze API Key

In your Braze account, navigate to “Technology Partners” , then “Attribution” and find the API key and REST Endpoint in the Singular section. You will need to provide the API key and the REST Endpoint to your Singular Account Manager for the integration to be completed.

Step 3: Confirming the Integration

Once Braze receives attribution data from Singular, the status connection indicator on [“Technology Partners” , then “Attribution”][14] will change to green and a timestamp of the last successful request will be included. Note that this will not happen until we receive data about an attributed install. Organic installs, which should be excluded from the Singular postback, are ignored by our API and are not counted when determining if a successful connection was established.

Facebook and Twitter Attribution Data

Attribution data for Facebook and Twitter campaigns is not available through our partners. These media sources do not permit their partners to share attribution data with third-parties and, therefore, our partners cannot send that data to Braze.

New Stuff!