Application activities are events from your app.
You can use a user access token or app access token to log events to this endpoint.
activities
edge from the following paths: Parameter | Description |
---|---|
advertiser_id string | |
advertiser_tracking_enabled boolean | Specifies whether a person has enabled advertising tracking on their device. Set to 0 for disabled or 1 for enabled. You should fetch this data and return it to Meta will use the event data (from partners about user activities off Meta) pursuant to its Data Policy, including for ad reporting, fraud detection and to build and improve our products (including our ads delivery products), but will restrict use of data about that individual to personalize that user’s ads. For devices running earlier versions than iOS 6, this parameter should default to 1. |
anon_id string | The ID of a person who has installed the app anonymously |
app_user_id string | Specifies user id of an app user. Used internally by the iOS and Android SDKs for |
application_tracking_enabled boolean | A person can choose to enable ad tracking on an app level. Your SDK should allow an app developer to put an opt-out setting into their app. Use this field to specify the person's choice. Use 0 for disabled, 1 for enabled |
attribution string | mobile_cookie from the person's device. Use this only on Android or iOS devices before iOS 6. The format for this should look something like |
auto_publish boolean | This field is not longer being used. Used to be used internally by Facebook's SDK |
bundle_id string | Used internally by Facebook's SDK |
bundle_short_version string | Used internally by Facebook's SDK |
bundle_version string | Used internally by Facebook's SDK |
campaign_ids string | Parameter passed via the deep link for Mobile App Engagement campaigns. |
click_id string | click_id |
consider_views boolean | Specifies that view through data should be considered when determining the ad to attribute this install to. Clicks will always be considered first before views and views will only be returned if there was not a click on an ad for the app |
custom_events list<CustomEvent> | Custom events reported, required with |
custom_events_file file | Custom file, encoded as JSON that describes the event. Please encode as UTF-8 and attach with the mime type |
device_token string | A token used to identify the device on push networks |
event enum {MOBILE_APP_INSTALL, CUSTOM_APP_EVENTS, DEFERRED_APP_LINK} | Event type, one of Required |
extinfo Object | Extended device and source information array, used by Facebook's SDKs, MMPs and Bots for Messenger. This parameter is an array and must be in a specific format. Please see our App Events API for more information |
include_dwell_data boolean | Specifies that view dwell ms should be returned as part of view through data |
include_video_data boolean | Specifies that video view completion percentages should be returned as part of view through data |
install_referrer string | 3rd party install referrer, currently available for Android only, see https://developers.google.com/analytics/devguides/collection/android/v4/campaigns |
installer_package string | Used internally by the Android SDKs |
migration_bundle string | Used internally by the iOS and Android SDKs |
page_id int64 | Specifies the Page ID associated with the messenger bot that logs the event |
page_scoped_user_id int64 | Specifies the page scoped User ID associated with the messenger bot that logs the event |
receipt_data string | The receipts of in-app purchase |
sdk_version string | sdk_version |
ud JSON object | Optional user data parameters for advanced matchingProvide hashed fields as key/value pairs similar to the Pixel |
url_schemes array<string> | Used internally by the iOS and Android SDKs |
user_id string | user_id |
user_id_type enum {INSTANT_GAMES_PLAYER_ID} | user_id_type |
vendor_id string | vendor_id |
windows_attribution_id string | Attribution token used for Windows 10 |
success
: bool, applink_class
: string, applink_url
: string, applink_args
: string, is_fb
: bool, is_paid
: bool, account_id
: ad account id, ad_id
: numeric string, ad_objective_name
: string, adgroup_id
: numeric string, adgroup_name
: string, campaign_id
: numeric string, campaign_name
: string, campaign_group_id
: numeric string, campaign_group_name
: string, click_time
: timestamp, is_mobile_data_terms_signed
: bool, is_external
: bool, is_instagram
: bool, is_view_through
: bool, is_modeled
: bool, is_same_ip
: bool, device_model
: string, os_version
: string, view_time
: timestamp, is_playable_ad
: bool, is_aaa_campaign
: bool, creative_id
: numeric string, engagement_type
: enum, success
: bool, drop_reason
: string, Error | Description |
---|---|
200 | Permissions error |
190 | Invalid OAuth 2.0 Access Token |