Facebook Graph App Events API (JSON)

Facebook Graph App Events API (JSON) (facebook/graph-activities-json)

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 JSON. 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 = parseJson(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
Device advertising ID (GAID/IDFA)bodyadvertiser_id Tracker documentation on this propertyF04C6D92-D4FA-4CA4-AC62-DE94C8C2DAE7
App IDbodyextinfo.1 Tracker documentation on this propertyGravidkalender
com.quora.app.mobile
com.socialchain.blockchainvault
net.actionverite.avfranceinapp
com.woltapp.wolt
bodyapplication_package_name
App versionbodyextinfo.2 Tracker documentation on this property20220318231217
2946
87
1024
8499
bodyextinfo.3 Tracker documentation on this property7.2.9
8.4.8
1.32.0
4.5.3
3.13.0
Carrierbodyextinfo.8 Tracker documentation on this propertyo2-de
NoCarrier
Unique device IDbodyanon_id More details on how we identified this propertyXZ1B3C1888-9C94-4679-A9B2-3227AEA2A308
XZ9EF91195-33BC-44D6-8E31-638C0EEFA35D
XZ78E45CA6-C2BD-4506-BAC4-9A85354E2D3F
XZ8B67AF48-120B-4937-8DE6-01049481D410
XZ68974EA2-8136-4EEB-9A9E-273A4ABF4BD0
bodydevice_token Tracker documentation on this property22cbf18c3f93cfd8e682014d38c778c6ef930f7912875fa375f0df79320a8ee0
31b29d5217f8ab062ed17e142b23f8fc4dc2ed2845915a37003c15111f95d0b5
Free disk spacebodyextinfo.14 Tracker documentation on this property15
11
14
13
12
Total disk spacebodyextinfo.13 Tracker documentation on this property30
119
60
Languagebodyextinfo.6 Tracker documentation on this propertyen_DE
de_DE
Modelbodyextinfo.5 Tracker documentation on this propertyiPhone9,3
iPhone10,4
iPhone10,6
OS namebodysdkios
OS versionbodyextinfo.4 Tracker documentation on this property14.8
14.5.1
15.6.1
Screen heightbodyextinfo.10 Tracker documentation on this property667
812
Screen widthbodyextinfo.9 Tracker documentation on this property375
Time zonebodyextinfo.7 Tracker documentation on this propertyCEST
MESZ
bodyextinfo.15 Tracker documentation on this propertyEurope/Berlin
Unique user IDbodyapp_user_id Tracker documentation on this propertyios_746f759635fc4e07adb5404d1c82484a_sara
References