Meta (Facebook) SDK and app events
Meta's SDK logs installs and in-app events and can send hashed email or phone to match people.
In one line
Can send your app activity to Meta and match it to your account
Meta's SDK logs installs and in-app events and can send hashed email or phone to match people.
Ties activity to a Meta account for ads. Can send hashed email or phone (advanced matching). Logs events even for signed-out Facebook users.
What it can and can't do
What the user does: Nothing. It happens when the app opens or you do something in it
It can
- Send installs and in app actions, such as purchases, to Meta
- Match you using a scrambled email or phone number
- Record events for people signed out of Facebook
- Use Meta's install referrer to see which ad led to the install (Android)
It cannot
- Track you across apps on iPhone after you tap Ask App Not to Track, within Apple's rules
- Show the real email, only a scrambled version
- Stay out of ad matching if you never use Meta products; it can still send events
How it differs between platforms: Android uses the install referrer and ad ID. iPhone asks for tracking permission, with Meta's own tools as backup.
On Android and iPhone
| Android | iPhone | |
|---|---|---|
| Status | Supported | Supported |
| First version | Not available | Not available |
| Permission or entitlement | INTERNET; AD_ID; Install Referrer; optional Facebook Login | NSUserTrackingUsageDescription for advertiser ID; privacy manifest for the SDK |
| Protection level | normal | prompt |
| How access is granted | install | prompt |
| What the user sees | Not listed | Not listed |
| How long it lasts | Not listed | Not listed |
| How to take it back | Not listed | Not listed |
| Store policy | Data safety: advertising ID, app activity; Play SDK Index lists the SDK | Privacy manifest; ATT; 5.1.2 |
| API | Facebook SDK for Android, FacebookSdk.setAutoLogAppEventsEnabled | FBSDKCoreKit, AEM (Aggregated Event Measurement), Limited Login |
| Notes | Meta Install Referrer (encrypted referrer) lets Meta see install attribution. | After iOS 14.5 Meta used AEM on top of SKAN and Limited Login without ATT. |
Data you get
What comes back: App events, advertiser ID, hashed identifiers
Shape: object
How often: continuous
| Field | Type | Unit | Range | Precision |
|---|---|---|---|---|
advertiser_id | string | None | GAID or IDFA | Not listed |
hashed email/phone | hash | SHA-256 | Not listed | Not listed |
Technical limits
- Needs consent for ads use under GDPR
- Events can be disabled
- Privacy manifest and signature required
The story
What it is
Meta's code library that reports installs and in app actions so Facebook can match them to ads.
For you
You never see it. If you used Facebook or clicked a Meta ad, the app might tell Meta you opened it, bought something or reached a level.
For makers
Meta uses the events to match purchases to ads and to build audiences. Advanced matching can send hashed email or phone, and the SDK can log events even for people signed out of Facebook.
Where you see it
| Type | Example | Apps |
|---|---|---|
| games | A game reports 'level 10 reached' so Meta can find more players like your best ones. | Candy Crush, Words With Friends |
| shopping | A store app reports a purchase so the advertiser sees which Instagram ad drove the sale. | Shein, Temu |
| social | A login button lets you sign in with Facebook and shares your name and email. | Spotify, Pinterest |
| ads | Advanced matching sends a hashed email so Meta can join an app purchase to your account. | None named |
| analytics | A dating app counts how many installs came from video ads on Instagram. | Bumble |
| security | Privacy researchers found the SDK sending data before consent in some apps. | None named |
Risks
- Joins app use to your Facebook profile
- Logs events when signed out
Android and iPhone in short
- Android: Android sends the install referrer and the advertising ID to Meta's systems.
- iPhone: On iOS, SKAN and ATT limit how much Meta can link, but hashed email matching still works.
What the platform says
- Meta: Facebook SDK for iOS and Android. Add Facebook Login, sharing and app events to measure ads and understand your audience.
Good uses and abuse
Legitimate uses
- Ad optimization for Meta campaigns
Known abuse
- Collecting health or sensitive events (FTC and state cases)
Scores
| Score | Value | Meaning |
|---|---|---|
| Sensitivity | 4 of 5 | How revealing the data is |
| Utility | 5 of 5 | How useful it is to honest apps |
| Friction | 1 of 5 | How much the user has to do |
| Fingerprint bits | Not rated | Rough identifying entropy, when known |
History
- 2021-04, iPhone iOS 14.5: Aggregated Event Measurement for ATT-denied users
- 2022-03, iPhone iOS 15: Limited Login for Facebook Login without ATT
Related capabilities
Related
- Server-side conversions APIs. Can send your purchases and signups from its server to ad platforms
- Third-party SDK data sharing. Can share anything the app can see with its add on tools, who send it on
Same idea on the web
- Hashed email as identity. Can recognize you across sites by a scrambled version of your email
Sources
How well checked: Based on official documentation.