Install Attribution Matching

Listen for Android install attribution results in your Expo app, inspect match confidence and read the acquisition attributes added to users.

Install attribution matching connects an install to the ad click that led to it. Use the result to inspect acquisition data in apps using the Superwall MMP.

Requirements

Use Expo SDK v1.8.0 or later on Android with the Superwall MMP configured. Declare IP address collection in your Google Play Console data safety form; the MMP collects best-effort public IPv4 and IPv6 device attributes.

Listen for results

import { useSuperwallEvents } from "expo-superwall";

function AttributionListener() {
  useSuperwallEvents({
    onSuperwallEvent: ({ event }) => {
      if (event.event === "attributionMatch") {
        console.log("Install matched:", event.info.matched);
      }
    },
  });
  return null;
}

Successful matches add acquisition_* attributes to the user. The event also fires when a match fails. In expo-superwall/compat, the event type is EventType.attributionMatch and the payload is eventInfo.event.attributionMatchInfo.

AttributionMatchInfo

Prop

Type

Limitations

This event is Android only. Optional payload fields may be absent, and a match is not guaranteed.

How is this guide?

On this page