This article describes how to set up the Facebook App Events connector in your Universal Data Hub account.

Table of Contents Placeholder

Connector Actions

Action Name AudienceStream EventStream
Send Event

How it Works

Report app installs and in-app conversions through this API and send data back to Facebook Analytics. Use this on mobile devices without the Facebook SDK. For more detailed information, see the Facebook App Events API documentation.

Configure Settings

Go to the Connector Marketplace and add a new connector. Read the Connector Overview article for general instructions on how to add a connector.

After adding the connector, configure the following settings:

Action Settings - Parameters and Options

Click Next or go to the Actions tab. This is where you configure connector actions.

This section describes how to set up parameters and options for each action.

Action - Send Event

Parameters

Parameter Description
Advertiser ID
  • Required.
  • Apple IDFA or Google Advertising ID.
Advertiser Tracking Enabled
  • Required.
  • Options are 0 for disabled; 1 for enabled.
App Tracking Enabled
  • Required.
  • Options are 0 for disabled; 1 for enabled.
Attribution
  • Required.
  • Mobile cookie from a device.
  • Applies to Android and pre-iOS 6 devices. For other devices, use advertiser_id.
Client IP Address
  • Required.
  • Device's IP address in IPv4 or IPv6 format.
Event
  • Required.
  • Type of event being sent via the App Events API.
App User ID
  • Optional.
  • A unique combination of letters and numbers no more than 100 characters long stored on the device of the user.
Bundle ID
  • Optional.
  • A unique string that identifies your application to the system.
Bundle Short Version
  • Optional.
  • The publicly visible version of your app.
Bundle Version
  • Optional.
  • The internal version number of your app.
App Package Name
  • Required.
  • String for the app package name.
Available Storage Size
  • Required.
  • Integer value for the available external storage space, in GB.
Carrier Name
  • Required.
  • String for the carrier name.
  • If the carrier name is not available, use "NoCarrier".
CPU Cores
  • Required.
  • Integer for the number of CPU cores.
Device Locale
  • Required.
  • String for two letters for the locale language in lowercase, concatenated with '_' and two letters for the country code, in uppercase.
Device Model Name
  • Required.
  • String for the device model name.
Device Timezone
  • Required.
  • String for the device timezone.
Device Timezone Abbreviation
  • Required.
  • String for the device timezone abbreviation.
External Storage Size
  • Required.
  • Integer for the total external storage size, in GB.
OS Version
  • Required.
  • String for the operating system version.
Package Info Version Code
  • Required.
  • Integer for the PackageInfo version code.
Package Info Version Name
  • Required.
  • String for the PackageInfo version name.
Screen Density
  • Required.
  •  Float for the screen density in the "%.2f" format.
  • The decimal separator must be a dot.
Screen Height
  • Required.
  • Integer for the screen height, in pixels.
Screen Width
  • Required.
  • Integer for the screen width, in pixels.
Extended Info Format
  • Optional.
  • Extended info format version and source indicator.
  • Default value is "a2".
Event Name
  • Select event from drop-down list or create new event.
_logTime
  • Optional.
  • Recommended parameter to specify the time of event, specified in Unix time.
_valueToSum
  • Optional.
  • Numeric value of individual event to be summed in reporting.
  • See above for recommended events to attach to.
fb_content_id
  • Optional.
  • International Article Number (EAN), when applicable, or other product or content identifiers.
fb_content_type
  • Optional.
  • For example, a music, video, or product description.
fb_currency
  • Optional.
  • ISO 4217 code.
  • Examples: "EUR", "USD", "JPY".
  • Required when passing "_valueToSum" as a price or a purchase amount.
 fb_description
  • Optional.
  • A string description.
fb_level
  • Optional.
  • Level of a game.
fb_max_rating_value
  • Optional.
  • Upper bounds of a rating scale,
  • Example: 5 on a 5-star scale.
fb_num_items
  • Optional.
  • Number of items.
fb_payment_info_available
  • Optional.
  • Values are 1 for yes, 0 for no.
fb_registration_method
  • Optional.
  • Facebook, Email, Twitter, etc.
fb_search_string
  • Optional.
  • The text string that was searched for.
fb_success
  • Optional.
  • Values are 1 for yes, 0 for no.
User Data is Already SHA256 Hashed
  • Optional.
  • Check box if user data is already SHA256 hashed.
IDs
  • Optional.
  • Product IDs.
  • Array values of same length only, they will be paired in order when sent to Facebook.
Quantities
  • Optional.
  • Product Quantities.
  • Array values of same length only, they will be paired in order when sent to Facebook.
Custom Value
  • Optional.
  • Specify key of additional fields.
  • Array values of same length only, they will be paired in order when sent to Facebook.
  • Single value attributes can be used and will apply to each custom event.
Email
  • Optional.
  • Email address.
First Name
  • Optional.
  • First Name.
Last Name
  • Optional.
  • Last Name.
Phone
  • Optional.
  • Phone Number.
External ID
  • Optional.
  • Any unique ID from the advertiser, such as loyalty membership ID, user ID, and external cookie ID.
Gender
  • Optional.
  • Options are f for female, m for male.
  • If unknown, leave blank
Birthdate
  • Optional.
  • Birth year, month, then date.
City
  • Optional.
  • City Name.
State or Province
  • Optional.
  • Two-letter state or province code.
Zip or Postal Code
  • Optional.
  • Numeric zip or postal code.
Country
  • Optional.
  • Lowercase two-letter country code.
Version history
Revision #:
5 of 5
Last update:
‎04-29-2020 06:16 PM
Updated by: