Adopting Apsalar Attribution Tracking via API

02/13/14

The recent changes in Facebook Mobile Measurement Partners (MMPs) has left many marketers without an attribution solution for install campaigns running on Facebook.  With Apsalar’s recently launched simple Event API, we provide a quick and easy way to measure all campaigns, including iOS campaigns on Facebook, using existing SDK integrations.  While the best way to take advantage of Apsalar’s offerings is integrating our client side SDK, this article is aimed at quickly getting your measurement of Facebook campaigns running again without a client side update.

Note: Android campaigns on Facebook require a client-side update.

Follow these 3 easy steps to get your Facebook campaign measurement back on track with Apsalar:

1. Sign up for an Apsalar account

You’ll be able to start using your account right away, but a salesperson may contact you to ensure all your needs are being addressed by our platform.

2. Begin passing all installs to Apsalar

To accurately attribute installs to Facebook, and other select ad networks, all installs need to be passed to Apsalar.  Each install is checked against Facebook’s attribution API for matching clicks within the last 28 days.

Here are a few common solutions for sending Apsalar all installs from other 3rd party SDKs:

  • MobileAppTracking (MAT) by HasOffers : To pass all installs to Apsalar from MAT, you’ll need to configure an “Attribution Analytics” server postback with “Apsalar” selected as the publisher and data set to “all”.  MAT’s support article explains this process more thoroughly.

  • Kontagent : Please reference Kontagent’s support documentation or contact their support team for information about sending all installs to Apsalar.

  • Other Tracking Systems: For systems that allow adding a postback, endpoint, or URL for reporting all installs, you’ll want to configure an endpoint like the following iOS example:

http://api.apsalar.com/api/v1/launch?a=Apsalar_API_Key&p=iOS&i=com.yourApps.bundleID&idfa=raw_iOS_AdvertiserIdentifier_upper-case_with_dashes

Apsalar’s support document for our simple Event API provides more examples and other optional parameters. Please contact Apsalar’s Support Team if you have any questions.

Once the first install is passed to Apsalar, the application will appear in your Apsalar account. The first install must be received before you can complete the next step.  Please note: All traffic will show as organic until the following step is taken.

3. Add your Facebook App ID to the your Apsalar account

To measure installs from Facebook, you’ll need to add the Facebook App ID for your application in the Apsalar dashboard.

To obtain your Facebook App ID, visit the Facebook’s App Developer Dashboard

Next, you’ll need to enter your Facebook App ID in the Apsalar dashboard following these instructions.

Once you’ve completed these steps, you can begin tracking all of your Facebook Mobile App Install on iOS campaigns without delay or a client side SDK change.

Optimizing Facebook Campaigns

For most marketers, simply measuring installs is not enough and optimizing to downstream events is fundamental to their buying strategy. Similar to installs, custom events can be sent to Apsalar’s simple Event API to provide more campaign insights and reporting.

Here are a few common solutions for sending Apsalar events from other 3rd party SDKs:

  • MobileAppTracking (MAT) by HasOffers : To pass all events to Apsalar from MAT, you’ll need to configure a server postback for the applicable events with “Apsalar” selected as the publisher and data set to “all”.  MAT’s support article explains this process more thoroughly.

  • Kontagent : Please reference Kontagent’s support documentation or contact their support team for information about sending all installs to Apsalar.

  • Other Tracking Systems: For systems that allow adding a postback, endpoint, or URL for reporting events, you’ll want to configure an endpoint like the following iOS example:

http://api.apsalar.com/api/v1/evt?a=Apsalar_API_Key&p=iOS&i=com.yourApps.bundleID&idfa=raw_iOS_AdvertiserIdentifier_upper-case_with_dashes&n=yourEventName

Apsalar’s support document for our simple Event API provides more examples and other optional parameters. Please contact Apsalar’s Support Team if you have any questions.

Working with Facebook PMDs

Many marketers work with Facebook Preferred Marketing Developers (PMDs), allowing them to buy ads on Facebook.  Apsalar, as a measurement partner of Facebook, is able to work with all PMDs to pass conversion and event data on an aggregated, anonymized basis for optimization.  Two steps are required to allow Apsalar to work with your desired PMD:

  1. Due Facebook’s requirements, advertisers must agree to Facebook’s Advance Mobile Measurement agreement. Click here to ensure you’ve enacted this agreement.

  2. Email Apsalar Support and confirm your permission to pass conversion information to your desired PMD. Apsalar will never share your application’s data with a 3rd party without your explicit permission.

Share Button