Déchiffrer le Meta Install Referrer sur Android

Le Google Play Install Referrer ne transporte que les clics sur une publicité Meta suivis d’une installation dans la même session. Le Meta Install Referrer couvre tout le reste : les apps Facebook, Instagram et Facebook Lite gardent en mémoire la publicité que votre utilisateur a vue ou cliquée, et la transmettent à votre app.

Avant de commencer

1. Le lire au premier lancement

<queries>
    <package android:name="com.facebook.katana" />
    <package android:name="com.instagram.android" />
    <package android:name="com.facebook.lite" />
</queries>

val providers = listOf(
    "com.facebook.katana.provider.InstallReferrerProvider",
    "com.instagram.contentprovider.InstallReferrerProvider",
    "com.facebook.lite.provider.InstallReferrerProvider",
)

fun readMetaReferrer(context: Context, facebookAppId: String): String? {
    for (authority in providers) {
        val uri = Uri.parse("content://$authority/$facebookAppId")
        runCatching { context.contentResolver.query(uri, null, null, null, null) }
            .getOrNull()?.use { cursor ->
                if (cursor.moveToFirst()) {
                    return cursor.getString(cursor.getColumnIndexOrThrow("install_referrer"))
                }
            }
    }
    return null
}

2. Le déchiffrer sur votre serveur

Ne livrez jamais la clé dans votre app. N’importe qui décompilant l’APK pourrait la lire.

import crypto from 'node:crypto';

export function decryptMetaReferrer(installReferrer, keyHex) {
  const {utm_content} = JSON.parse(installReferrer);
  const {source} = typeof utm_content === 'string' ? JSON.parse(utm_content) : utm_content;
  const sealed = Buffer.from(source.data, 'hex');
  const decipher = crypto.createDecipheriv('aes-256-gcm', Buffer.from(keyHex, 'hex'), Buffer.from(source.nonce, 'hex'));
  decipher.setAuthTag(sealed.subarray(-16));
  return JSON.parse(Buffer.concat([decipher.update(sealed.subarray(0, -16)), decipher.final()]).toString());
}

Des noms de champs décalés d’un cran

Quand le résultat revient vide

Avec Appy, la clé se colle une fois

Sur l’offre Enterprise, vous ajoutez la clé dans le tableau de bord et votre App ID dans le SDK. Le déchiffrement se fait sur les serveurs d’Appy.

À lire ensuite

• Attribution Apple Ads sans MMPLe pendant iOS.
• Postbacks et webhooks d’installationEnvoyez les installations à un réseau ou à votre serveur.
• Les réseaux publicitaires dans la docChaque champ, pour les développeurs.

Questions