Ce guide explique étape par étape comment intégrer le SDK Engage dans votre application.
Ressources partagées
Les ressources suivantes sont disponibles pour faciliter l'intégration :
Application de validation
Une application de validation utilisée pour valider la publication de contenu dans l'UI.
Consignes concernant la publication de contenu
Documentation fournissant des instructions sur la manière de publier efficacement du contenu à l'aide des API.
Étape 1 : Développer une application avec le mode débogage du SDK
Ajoutez le SDK Engage dans le fichier build.gradle et suivez le guide d'intégration approprié pour mener à bien votre intégration.
dependencies {
// Make sure you also include the repository in your project's
// build.gradle file.
implementation 'com.google.android.engage:engage-core:1.5.7'
}
Étape 2 : Installer l'application de validation
L'application de validation est une application Android que vous pouvez utiliser pour vérifier que l'intégration fonctionne. Elle comprend des fonctionnalités permettant aux développeurs de valider des données et de diffuser des intents.
Étape 3 : Vérifier que les données sont visibles dans l'application de validation
L'application de validation doit afficher chaque cluster sur une ligne distincte.
- Saisissez le nom du package de développeur qui publie les données.
- Vérifiez que toutes les entités du cluster sont publiées.
- Vérifiez que tous les champs de l'entité sont publiés. Pour chaque élément de la ligne, vous pouvez cliquer sur l'image poster pour vérifier l'intent.
- Consultez les récapitulatifs pour les niveaux d'application, de cluster et d'entité, qui indiquent le nombre d'erreurs de validation. Examinez les messages d'erreur de validation qui s'affichent en rouge sous chaque champ concerné. Des erreurs de validation se produisent lorsque des champs obligatoires sont manquants ou contiennent des valeurs incorrectes.
- Vérifiez que toutes les erreurs de validation ont été résolues. Exemple d'état :
Étape 4 : Vérifier le flux de l'intent de diffusion
Pour vérifier l'intent de diffusion, cliquez sur le bouton en haut de l'interface utilisateur pour déclencher la logique d'envoi d'annonces.
Une fois les étapes 1 à 4 terminées, vous pouvez considérer l'intégration comme testée de votre côté.
Étape 5 : Certifiez vous-même votre intégration
Avant que nous puissions examiner votre application, vous devez remplir une auto-certification. Il s'agit d'une étape essentielle pour vérifier que votre intégration est prête et pour simplifier le processus d'examen.
Créez une copie de la feuille de calcul des cas de test du SDK Engage.
Utilisez l'application Verify pour tester votre intégration par rapport à chaque cas listé dans la feuille de calcul pour vos secteurs spécifiques.
Documentez vos résultats directement dans votre copie de la feuille en indiquant "Réussite" ou "Échec" dans la colonne "État", et en ajoutant les commentaires pertinents.
Une fois les étapes 1 à 5 terminées, vous pouvez considérer l'intégration comme testée.
Étape 6 : Passer à la version de production du SDK
Une fois le débogage terminé, vous devez mettre à jour les métadonnées dans le fichier manifeste :
<application>
...
<meta-data
android:name="com.google.android.engage.service.ENV"
android:value="PRODUCTION"></meta-data>
</application>
Étape 7 : Envoyer à Google le fichier APK final
Envoyez une copie du fichier APK prêt à être publié en tant que pièce jointe à l'adresse engage-developers@google.com. Joignez également la feuille de calcul d'autocertification remplie. Google vérifiera que l'ensemble de l'intégration fonctionne comme prévu. Une fois que Google a vérifié l'intégration, vous pouvez envoyer l'application en production pour la publier.
Étape 8 : Publier l'APK sur le Play Store
Une fois que vous avez reçu les approbations, publiez l'APK sur le Play Store. Une fois l'APK publié, envoyez un e-mail à engage-developers@google.com avec le numéro de version correspondant. Google vous indiquera les prochaines étapes.
Télécharger
Avant de procéder au téléchargement, vous devez accepter les conditions d'utilisation suivantes.