Tracking Facebook Campaigns - Deferred Deep Links

Tracking Android campaigns using referrer

Meta passes campaign metadata through Android referrer on the first app open, which can be used for attribution. More details are available in Meta's official documentation. In order to use referrer tracking, please follow the steps below.

Ensure you are using the latest Tenjin SDK and implement the Android referrer. If Android referrer is implemented properly, you can see the green received mark in the app page. (NOTE - Please ensure to also update the manifest file in the SDK as mentioned here)

Next, go to the Meta developer page, navigate to the App Settings -> Basic, and scroll down to the Android section. Copy the Install Referrer Decryption Key.

Go to the Apps page on the Tenjin dashboard and click edit. Paste the decryption key you copied in Step 2 under the Facebook referrer decryption key field.

Go to CONFIGURE -> Apps tab and select your app.

Click + New Callback.

Create Meta Install callback from templates.

Enter app_id for your app, and hit SAVE CALLBACK for Meta Install callback.

Need for Meta Install Referrer

The Meta install referrer includes data for: view through installs (VT), click through installs (CT) and multiple session click though installs. You can read more about it here

Tracking < iOS 14 campaigns using deferred deep links

Tenjin and Meta SKAdnetwork Campaign setup

For iOS 14+ SKAdnetwork campaign setup with Tenjin, please see this page.

Meta deferred deeplinking is not available for Meta iOS 14+ campaigns.

For Android, please use the tracking using Android referrer. The Deeplink setup is NOT needed for Android tracking.

Make sure you have already added Protocol in the App setting.

Go to CONFIGURE -> Apps tab and select your app.

Click + New Callback.

Create BOTH Meta Install and Meta Deferred Deep link callbacks from the templates.

Enter the app_id for your app and hit SAVE CALLBACK for both Meta Install and Meta Deferred Deep link callbacks.

After you create a campaign in Tenjin, you will automatically see the deep link URL.

Go to your Meta Ads Manager and create your ad set. Use the Tenjin campaign name as your Meta ad set name. For example, it would say "iOS-US-male-Wordsearch @hB1zqEeYDeKgDPF6qvkq7O". You can give any name for the Meta campaign.

Create an Ad for the Meta ad set, and in the "Deferred deep link" field insert the Tenjin Deeplink you generated in step 6. You can use the same deep link url for multiple ads under the same ad set.

To redirect users to a specific place in your app, you can append any parameter and value to the deeplink generated in step 6 above. For example:

Original Meta deferred deeplink:

fb1423740114570310://?campaign_id=hB1zqEeYDeKgDPF6qvkq7O

Meta deferred deeplink with a custom parameter/key:

fb1423740114570310://?campaign_id=hB1zqEeYDeKgDPF6qvkq7O&creative_name=TEST

When there's an app install from your campaign, the entire deeplink url with the custom parameter will. be passed to the Tenjin SDK. The customized deeplink data can be fetched directly from the Tenjin SDK to handle any type of redirects within your app by following these instructions: iOS, Android, and Unity.

How to set up App Event Optimization (AEO) campaigns in Meta

Run campaigns on standard events

Go to the Tenjin Dashboard, CONFIGURE -> APPS, and select your app to set up the standard event callback to Meta.
Select Meta standard custom event callback.
Select the event you want to pass to Meta. Please make sure you are already sending this event to Tenjin.
Enter the Meta App ID and event name to map with Meta. The following 8 standard events are supported by Meta.
Then hit Save Callback. When Tenjin receives the custom event, this event will be sent to Meta. You can then see the event in the event manager page as shown below.
If you are setting up a campaign for iOS 14.5+, please set up SKAdnetwork configuration, by referring to our instructions here.
Now you will be able to choose the standard events as shown below when you setup a bidding strategy for your campaign.

Run campaigns on custom events (event defined by yourself)

Go to the Tenjin Dashboard, CONFIGURE -> APPS, select your app to set up the manual custom event callback to Meta.
Select Meta manual custom event callback.
Select the event you want to pass to Meta. Please make sure you are already sending this event to Tenjin.
Input your Meta App ID, and event name to map with Meta. The name you input under Event Name will be displayed in Meta.
Then hit Save Callback.
When Tenjin receives the custom event, this event will be sent to Meta. You can then see the event in the event manager page as below (you may need to filter by the event type on the right side).
Now, when you set up a bidding strategy for your campaign, you will be able to choose the custom events as shown below. (Note: this is not applicable to iOS 14.5+ campaign. For iOS 14.5+ campaign, please refer to above section)

NOTE:

At least one standard event (non-install one) is required before you can run AEO campaigns based on custom events.

NOTE

In accordance with Meta's privacy requirement, starting May 9, 2024, campaign reporting will not be provided when the count of unique users is below 100, or the count of ad impressions is below 1,000

Meta

Tracking Android campaigns using referrer

Tracking < iOS 14 campaigns using deferred deep links

How to set up App Event Optimization (AEO) campaigns in Meta

Run campaigns on standard events

Run campaigns on custom events (event defined by yourself)

What's Next