Skip to Content
Platform.Ontology

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.

Used to track youAds and install trackingSDKs and measurementAndroid and iPhoneWhen the app opensWhile you use itWhen you are signed in

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

AndroidiPhone
StatusSupportedSupported
First versionNot availableNot available
Permission or entitlementINTERNET; AD_ID; Install Referrer; optional Facebook LoginNSUserTrackingUsageDescription for advertiser ID; privacy manifest for the SDK
Protection levelnormalprompt
How access is grantedinstallprompt
What the user seesNot listedNot listed
How long it lastsNot listedNot listed
How to take it backNot listedNot listed
Store policyData safety: advertising ID, app activity; Play SDK Index lists the SDKPrivacy manifest; ATT; 5.1.2
APIFacebook SDK for Android, FacebookSdk.setAutoLogAppEventsEnabledFBSDKCoreKit, AEM (Aggregated Event Measurement), Limited Login
NotesMeta 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

FieldTypeUnitRangePrecision
advertiser_idstringNoneGAID or IDFANot listed
hashed email/phonehashSHA-256Not listedNot 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

TypeExampleApps
gamesA game reports 'level 10 reached' so Meta can find more players like your best ones.Candy Crush, Words With Friends
shoppingA store app reports a purchase so the advertiser sees which Instagram ad drove the sale.Shein, Temu
socialA login button lets you sign in with Facebook and shares your name and email.Spotify, Pinterest
adsAdvanced matching sends a hashed email so Meta can join an app purchase to your account.None named
analyticsA dating app counts how many installs came from video ads on Instagram.Bumble
securityPrivacy 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

Good uses and abuse

Legitimate uses

  • Ad optimization for Meta campaigns

Known abuse

  • Collecting health or sensitive events (FTC and state cases)

Scores

ScoreValueMeaning
Sensitivity4 of 5How revealing the data is
Utility5 of 5How useful it is to honest apps
Friction1 of 5How much the user has to do
Fingerprint bitsNot ratedRough 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

Same idea on the web

Sources

How well checked: Based on official documentation.

On this page