Facebook Graph App Events API (query string)

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”. Source It can be accessed through the Facebook SDKs for Android Source and iOS Source .

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. Source

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.
  1. Parse the request body as a query string. Store that in the result for the request body.
  2. Parse the result for the request body at extinfo as 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.
PropertyContextPathExamples of observed values
App IDbodyextinfo.1 Tracker documentation on this propertydrzio.dailyyoga.at.home.yogaforbeginner.howtodoyoga
drzio.heightincrease.exercise.yoga.workout.growtaller
fr.vinted
com.antoinehabert.truthordaregame
com.apalon.flight.tracker
bodyapplication_package_namedrzio.dailyyoga.at.home.yogaforbeginner.howtodoyoga
drzio.heightincrease.exercise.yoga.workout.growtaller
fr.vinted
com.antoinehabert.truthordaregame
com.apalon.flight.tracker
App versionbodyextinfo.2 Tracker documentation on this property18
43
202410
9.000027e+06
55
bodyextinfo.3 Tracker documentation on this property2.0.8
4.3
20.24.1.0
1.0.7
1.25.0
Carrierbodyextinfo.8 Tracker documentation on this propertyAndroid
NoCarrier
T-Mobile
Free disk spacebodyextinfo.14 Tracker documentation on this property5
-1
15
Total disk spacebodyextinfo.13 Tracker documentation on this property6
-1
16
Device advertising ID (GAID/IDFA)bodyadvertiser_id Tracker documentation on this property827d8162-0e1c-48cd-892e-4abd3df95ba8
ea70edc1-ac05-481c-8d2a-66b1be496a7e
830ec0b3-e94e-43e5-8722-a3a428af37bb
49b61a9c-cece-4300-b52e-26840e4c258e
fffe8a97-a504-4d14-89ab-c2025fbaf065
Languagebodyextinfo.6 Tracker documentation on this propertyen_US
en_
en_GB
Modelbodyextinfo.5 Tracker documentation on this propertysdk_gphone_x86_64_arm64
sdk_gphone_x86_64
OS namebodysdkandroid
OS versionbodyextinfo.4 Tracker documentation on this property11
13
Other unique identifiers for the user, device, session, or installationbodyanon_id More details on how we identified this propertyXZ962c852a-1c55-4392-a9e6-95eec196cb29
XZb559fc35-f543-4718-92d5-ffe030d96306
XZ11c88d7a-939c-44a2-94ec-20e6ea5a5f53
XZcd26718f-fdf8-47b7-bc63-74b996b7ae2a
XZ07cbe349-39b1-41eb-be20-449f13575898
bodyapp_user_id Tracker documentation on this property
bodydevice_token Tracker documentation on this property
Screen heightbodyextinfo.10 Tracker documentation on this property2392
1440
2148
2214
1794
Screen widthbodyextinfo.9 Tracker documentation on this property1440
2392
1080
Time zonebodyextinfo.7 Tracker documentation on this propertyGMT+01:00
GMT+02:00
CEST
bodyextinfo.15 Tracker documentation on this propertyEurope/Berlin
References