Guide technique de la liaison ciblée avec Android : Référent de Google Play

Il s’agit de la partie quatre du guide technique en quatre parties de la liaison ciblée avec Android. Les articles précédents traitaient des schémas URI, des intents de Chrome, et des liens d’application.

Utilisation du référent de Google Play pour la liaison ciblée

Une technique de liaison ciblée concerne un cas d’utilisation de niche lorsque l’application n’est pas installée. En tant que développeur, vous avez la possibilité de passer sous un paramètre personnalisé dans le magasin Google Play qui est alors reçu dans votre application après sa première ouverture par l’utilisateur. Si vous gérez correctement ce paramètre, cette technique vous permet de savoir d’où vient ce nouvel utilisateur et vous pouvez créer des pages d’accueil personnalisées ou une liaison ciblée au cours du processus d’installation.

Exigences pour le référent d’installation d’Android

• L’application ne doit pas être installée
• Elle ne peut pas être utilisée avec les intents de Chrome, car vous devez structurer l’URL de Play Store

Configuration du référent d’installation d’Android

Afin de configurer votre application pour la réception du référent d’installation d’Android, vous devez enregistrer votre application pour qu’elle reçoive la diffusion de com.android.vending.INSTALL_REFERRER. Insérez ce qui suit entre les balises <application /> de votre manifeste.

	<receiver android:name=“io.branch.testbed.InstallListener“ android:exported=“true“>
	<intent-filter>
	<action android:name=“com.android.vending.INSTALL_REFERRER“ />
	</intent-filter>
	</receiver>

view rawinstallbroadcast.xml hosted with  by GitHub

Dans ce cas, io.branch.testbed.InstallListener est le nom de votre classe personnalisée qui recevra les diffusions. Il s’agit simplement d’une sous-classe de BroadcastReceiver. Voici le code réutilisable dont vous aurez besoin pour cette classe:

	public class InstallListener extends BroadcastReceiver {
	@Override
	public void onReceive(Context context, Intent intent) {
	// called in the install referrer broadcast case
	}
	}

view rawinstalllistener.java hosted with  by GitHub

Gestion dans l’application

Une fois que vous avez configuré votre BroadcastReceiver comme décrit ci-dessus, la gestion de l’intention est vraiment facile ! Le mécanisme est très semblable à celui de la gestion des intentions du schéma URI, mais il se produit à partir de l’appel onReceive. Vous pouvez en voir un exemple ici:

	@Override
	public void onReceive(Context context, Intent intent) {
	String rawReferrerString = intent.getStringExtra(“referrer”);
	if(rawReferrerString != null) {
	Log.i(“MyApp”, “Received the following intent “ + rawReferrerString);
	}
	}

view rawbroadcastreceive.java hosted with  by GitHub

Utilisation pratique du référent Google Play

Afin de bien utiliser cette technique, vous devez être en mesure de contrôler la liaison vers Google Play Store avec lequel l’utilisateur interagit. Supposons que le nom du package de votre application est io.branch.testbed, nous savons alors que Google Play peut être ouvert par un des liens suivants:

1. market://details?id=io.branch.testbed
2. https://play.google.com/store/apps/details?id=io.branch.testbed

Pour ajouter un référent, il vous suffira d’ajouter &referrer=specialparam à l’un de ces liens. Pour ce faire, vous devez contrôler le lien lui-même.

Remarque: Comme vous l’avez probablement remarqué lors de la lecture de la section sur les intents de Chrome, vous ne disposez d’aucun contrôle sur le lien de Play Store, ce qui signifie que vous ne pourrez pas exploiter cette méthode.

Afin de contrôler le paramètre du référent, nous vous recommandons de l’intégrer dans le JS côté client décrit dans la méthode pour l’URI. Voici un extrait de code qui montre comment le référent est ajouté à la fonction de retour au lien du marché qui est exécutée après la tentative d’ouverture de l’application:

	var fallbackFunction = function() {
	window.location.replace(‘market://details?id=io.branch.testbed&referrer=specialparam’);
	};
	var addIFrame = function() {
	var iframe = document.createElement(“iframe”);
	iframe.style.border = “none”;
	iframe.style.width = “1px”;
	iframe.style.height = “1px”;
	iframe.src = ‘your_uri_scheme://’;
	document.body.appendChild(iframe);
	};
	addIFrame();
	setTimeout(fallbackFunction, 250);

view rawreferrer.js hosted with  by GitHub

Conclusion

Si vos yeux perdent le fil au cours de cette lecture, nous vous comprenons. La liaison ciblée Google est incroyablement complexe et truffée de cas limites. Si vous utilisez l’outil de Branch, vous pouvez être sûr que vos liens fonctionneront partout.

Commencer