Facebook App Events Destination Documentation

Facebook App Events Destination Documentation Facebook Events​ collects required info from one among Segment’s cellular SDKs (iOS or Android) and sends it from Segment’s servers to Facebook App Events servers. This server-to-server connection is not going to work with our server-aspect libraries. The Facebook App Events Destination is open-source. You possibly can browse the code on GitHub for iOS. This doc was final up to date on October 04, 2018. In the event you discover any gaps, outdated data or just need to leave some feedback to assist us enhance our documentation, please let us know!

Use Cases Improve mobile app retention with Facebook Ads Getting Started The first step is to make sure Facebook App Events helps the supply type and connection mode you’ve chosen to implement. You can learn extra about what dictates the connection modes we help here.

From your Segment UI’s Destinations page click on “Add Destination”.

Seek for “Facebook App Events” within the Destinations Catalog and affirm the Source you’d prefer to connect to.

Drop in your Facebook App ID which might be retrieved out of your Facebook Apps dashboard.

Once you activate the Facebook App Events integration in your app’s Segment venture, we’ll begin sending monitor knowledge to Facebook’s App Events endpoints.

Screen When you haven’t had an opportunity to review our spec, please have a look to grasp what the Screen method does. An instance name would appear like: Our integration additionally supports using Segment display screen occasions as monitor events. For instance, for those who had a display event named Confirmation you could possibly map the invocation of this to a Facebook app event as you'll with Segment monitor events.

To use this functionality you could choose into it via the integration setting named Use Screen Events as Track Events. Once enabled, you should start seeing display occasions populate in Facebook App Events. The display identify you provide might be bookended with the words

Viewed and Screen. So, when you've got a screen event with the identify property set to Welcome, it'll present up in Facebook as an occasion called Viewed Welcome Screen.

Please be aware, the mixing is not going to mechanically translate display occasions to spec’d Facebook occasions as our track technique does. In case you want to map these events to specific Facebook events you can do that via the Map your events to straightforward FB App Events setting. Please make sure to specify the occasion as Viewed name Screen the place title is the title property of the screen occasion.

Track In case you haven’t had an opportunity to review our spec, please have a look to understand what the Track methodology does. An instance name would appear like: When you call observe we’ll mechanically ship that occasion and it’s properties to Facebook.

Within the Facebook analytics interface you’ll be able to make use of the occasion properties to section your knowledge.

Facebook App Events doesn’t like events with periods within the identify so should you ship us an event with periods in the identify, we’ll convert all intervals to underscores. So in case your event is good friend.added, we’ll ship that to Facebook as buddy_added. We also truncate occasions which might be longer than forty characters long on account of Facebook’s API constraints.

Facebook Parameters We automatically translate our spec’d properties income and forex to the suitable Facebook parameters (valueToSum and FBSDKAppEventParameterNameCurrency), and likewise send events with income to Facebook’s buy logging method (logPurchase).

When you don’t provide a currency explicitly, we send USD. If any properties don’t match the beneath, we’ll go them on as they had been despatched to us.

Facebook Events We’ll automatically translate any of your occasions that match considered one of our spec’d events that map to Facebook’s spec’d events. The below desk shows the out of the box mappings in our integration: If you ship a track event that doesn’t match one of the above events, we’ll ship it alongside to Facebook with the identify you provide Segment.

Facebook Recommended Events The most important occasions that can assist advertisers enhance campaign ROI are the conversion occasions or occasions closest to the conversion. Those events are marked with an “*” inside Segment’s Facebook App Events settings page.

In addition, there are particular requirements for dynamic ads. These events are marked with “m” for dynamic ads for mobile, and “t” for dynamic advertisements for travel inside Segment’s Facebook App Events settings web page.

Other Features Facebook Login and Facebook Dialogs The integration does not mechanically support Facebook Login and Facebook Dialogs out of the box (you’d want to jot down code here regardless!). To make use of these options you’ll need to arrange Facebook’s app delegate hooks by accessing the Facebook SDK directly.