Facebook iOS Install tracking with a third party measurement company

Last Updated: Apr 21, 2014 06:14PM PDT

Facebook iOS Install tracking with a third party measurement company

With Apsalar’s recently launched Event API, we provide a quick and easy way to measure campaigns using your existing 3rd party SDK integrations, including iOS campaigns on Facebook. While the best way to take advantage of Apsalar’s offerings is integrating our client side SDK, this article is aimed at migrating measurement of Facebook campaigns to Apsalar without 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,  please follow the steps below:
      • Navigate to the Add Server Postback page.
      • Check the Use Postback Template for an Integration option.
      • Select Apsalar as the Integration
      • Select iOS as the Platform
      • Choose your applicable application(s) under Mobile App
      • Choose the install (ios) Template with the title Apsalar iOS Attribution Analytics Postback.
      • Be sure to also select All under the Data option.
      • Edit the 'a' parameter in the URL text box to equal your Apsalar API Key
      The resulting URL should look like the following:

      http://api.apsalar.com/api/v1/launch?a=Your_Apsalar_API_Key&i={package_name}&idfa={ios_ifa}&p=iOS&ip={device_ip}&mac1={mac_address_sha1}&dnt={ios_ad_tracking_disabled}&clid={publisher_ref_id}

      MAT’s support article has more information on this process.
       
    • 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 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 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.
  1. 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 your Facebook Mobile App Installs for iOS campaigns without delay or a client side 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 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 Prefered 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.
support@apsalar.com
http://assets0.desk.com/
apsalarinc
Loading
seconds ago
a minute ago
minutes ago
an hour ago
hours ago
a day ago
days ago
about
Invalid characters found
/customer/en/portal/articles/autocomplete