Facebook Graph App Events API (query string) (facebook/graph-activities-qs)
operated by: Facebook
(get company information on datarequests.org)The Graph API is provided by Facebook to “get data into and out of the Facebook platform”. 
It can be accessed through the Facebook SDKs for Android
and iOS
.
The App Events endpoint allows developers to “track actions that occur in [a] mobile app or web page such as app installs and purchase events” in order to “measure ad performance and build audiences for ad targeting”. The Facebook SDK automatically logs app installs, app sessions, and in-app purchases using this endpoint. Additionally, developers can manually log their own events.
Endpoint URLs
These are URLs or regexes of endpoints the tracker sends data to. We use these to determine which adapter to apply to a request. Some trackers use the same endpoint for several formats. In this case we use additional logic to match the adapter to the request, refer to the code for more information./^https:\/\/graph\.facebook\.com\/v\d{1,2}.\d\/\d+\/activities$/
Decoding steps
Every tracking library has its own way of transmitting tracking data, often even several. They are regularly pretty convoluted, nested encoding schemes. Because of that, the adapter needs to decode the request information into a consistent format. We try to keep keys and paths intact, but the structure results from our decoding. All steps used in the decoding for this adapter are documented here.- Parse the request body as a query string. Store that in the result for the request body.
- Parse the result for the request body at
extinfoas JSON. Replace the existing value.
1res.body = parseQueryString(body)
2res.body.extinfo = parseJson(res.body.extinfo)
Observed data transmissions
This is data that we observed being transmitted by this tracker. Not every request contains all of this data. The context of the data describes where we found the data in the request, the path describes the location of the data in the decoded request. The examples are a selection of observed values.| Property | Context | Path | Examples of observed values |
|---|---|---|---|
| Device advertising ID (GAID/IDFA) | body | advertiser_id
| 827d8162-0e1c-48cd-892e-4abd3df95ba8ea70edc1-ac05-481c-8d2a-66b1be496a7e830ec0b3-e94e-43e5-8722-a3a428af37bb49b61a9c-cece-4300-b52e-26840e4c258efffe8a97-a504-4d14-89ab-c2025fbaf065 |
| App ID | body | extinfo.1
| drzio.dailyyoga.at.home.yogaforbeginner.howtodoyogadrzio.heightincrease.exercise.yoga.workout.growtallerfr.vintedcom.antoinehabert.truthordaregamecom.apalon.flight.tracker |
| body | application_package_name | drzio.dailyyoga.at.home.yogaforbeginner.howtodoyogadrzio.heightincrease.exercise.yoga.workout.growtallerfr.vintedcom.antoinehabert.truthordaregamecom.apalon.flight.tracker | |
| App version | body | extinfo.2
| 18432024109.000027e+0655 |
| body | extinfo.3
| 2.0.84.320.24.1.01.0.71.25.0 | |
| Carrier | body | extinfo.8
| AndroidNoCarrierT-Mobile |
| Unique device ID | body | anon_id
 | XZ962c852a-1c55-4392-a9e6-95eec196cb29XZb559fc35-f543-4718-92d5-ffe030d96306XZ11c88d7a-939c-44a2-94ec-20e6ea5a5f53XZcd26718f-fdf8-47b7-bc63-74b996b7ae2aXZ07cbe349-39b1-41eb-be20-449f13575898 |
| body | device_token
| ||
| Free disk space | body | extinfo.14
| 5-115 |
| Total disk space | body | extinfo.13
| 6-116 |
| Language | body | extinfo.6
| en_USen_en_GB |
| Model | body | extinfo.5
| sdk_gphone_x86_64_arm64sdk_gphone_x86_64 |
| OS name | body | sdk | android |
| OS version | body | extinfo.4
| 1113 |
| Screen height | body | extinfo.10
| 23921440214822141794 |
| Screen width | body | extinfo.9
| 144023921080 |
| Time zone | body | extinfo.7
| GMT+01:00GMT+02:00CEST |
| body | extinfo.15
| Europe/Berlin | |
| Unique user ID | body | app_user_id
|
References
- Documentation for
advertiser_id: https://developers.facebook.com/docs/graph-api/reference/v17.0/application/activities
- Documentation for
extinfo.1: https://developers.facebook.com/docs/graph-api/reference/v17.0/application/activities - Documentation for
extinfo.2: https://developers.facebook.com/docs/graph-api/reference/v17.0/application/activities - Documentation for
extinfo.3: https://developers.facebook.com/docs/graph-api/reference/v17.0/application/activities - Documentation for
extinfo.8: https://developers.facebook.com/docs/graph-api/reference/v17.0/application/activities - Documentation for
device_token: https://developers.facebook.com/docs/graph-api/reference/v17.0/application/activities - Documentation for
extinfo.14: https://developers.facebook.com/docs/graph-api/reference/v17.0/application/activities - Documentation for
extinfo.13: https://developers.facebook.com/docs/graph-api/reference/v17.0/application/activities - Documentation for
extinfo.6: https://developers.facebook.com/docs/graph-api/reference/v17.0/application/activities - Documentation for
extinfo.5: https://developers.facebook.com/docs/graph-api/reference/v17.0/application/activities - Documentation for
extinfo.4: https://developers.facebook.com/docs/graph-api/reference/v17.0/application/activities - Documentation for
extinfo.10: https://developers.facebook.com/docs/graph-api/reference/v17.0/application/activities - Documentation for
extinfo.9: https://developers.facebook.com/docs/graph-api/reference/v17.0/application/activities - Documentation for
extinfo.7: https://developers.facebook.com/docs/graph-api/reference/v17.0/application/activities - Documentation for
extinfo.15: https://developers.facebook.com/docs/graph-api/reference/v17.0/application/activities - Documentation for
app_user_id: https://developers.facebook.com/docs/graph-api/reference/v17.0/application/activities