Google Tag Manager
Produits Google Gestionnaire de balises
Google Gestionnaire de balises
Vue d'ensembleToileDémarrage rapideGuide DevVue d'ensembleEcommerce renforcée (UA)Nouveau!RéférenceDépannageAndroïdeCommencerGuides DevUniversal Analytics BalisesEcommerce renforcée Nouveau!Référence de l'APIV3 (ancien)CommencerGuides DevUniversal Analytics BalisesRéférence de l'APIRécipientRappelerFunctionCallMacroHandlerFunctionCallTagHandlerRefreshFailureRefreshTypeContainerOpenerContainerFutureNotifierOpenTypeDataLayerInstallReferrerReceiverInstallReferrerServiceLoggerLogLevelPreviewActivityTagManagerLoggerRefreshModeiOSCommencerGuides DevUniversal Analytics BalisesEcommerce renforcéeSuivi des conversions AdWordsTéléchargementsRéférenceTAGContainerTAGContainerCallbackTAGContainerFutureTAGContainerOpenerTAGContainerOpenerNotifierTAGDataLayerTAGFunctionCallMacroHandlerTAGFunctionCallTagHandlerTAGLoggerTagManagerManager API Tag (v1) BetaVue d'ensembleGuide DevRéférenceComptesobtenirlistemettre à jourVersions de conteneurscréereffacerobtenirlistepublierrestaurerUndeletemettre à jourConteneurscréereffacerobtenirlistemettre à jourMacroscréereffacerobtenirlistemettre à jourAutorisationscréereffacerobtenirlistemettre à jourRèglescréereffacerobtenirlistemettre à jourMots cléscréereffacerobtenirlistemettre à jourDéclencheurscréereffacerobtenirlistemettre à jourVariablescréereffacerobtenirlistemettre à jourParamètre RéférenceTag Dictionnaire de référenceDictionnaire Macro RéférenceStandard des paramètres de requêteRéponses d'erreurLimites et quotasTermes et conditionsRessourcesAutorisationBibliothèques à la clientèleConseils sur les performancesChangelog
V4 Android - Mise en route
IntroductionAvant de commencerCommencer1. Ajouter Google Tag Manager pour votre projet2. Ajouter un fichier conteneur par défaut à votre projet3. Initialisez Google Gestionnaire de balises4. Obtenir des valeurs de configuration du conteneur5. Pousser événements et valeurs pour l'dataLayer6. Prévisualisation, débogage, et de l'éditionConfiguration avancéeActualisation de la Container
Introduction
Google Tag Manager permet aux développeurs de modifier les valeurs de configuration dans leur application mobile en utilisant l'interface de Google Tag Manager sans avoir à reconstruire et soumettre de nouveau binaires de l'application à l'App marchés.
Ce est utile pour gérer des valeurs ou des drapeaux configuration de votre application que vous pourriez avoir besoin de changer à l'avenir, y compris:
Divers paramètres assurance-chômage et chaînes d'affichageTailles, de régions ou types d'annonces servis dans votre applicationDivers paramètres de jeu
Les valeurs de configuration peuvent également être évalués à l'exécution en utilisant des règles, permettant des configurations dynamiques tels que:
Utilisation taille de l'écran pour déterminer la taille de bannière publicitaireUtilisation de la langue et l'emplacement de configurer les éléments de l'interface utilisateur
Google TagManager permet également la mise en œuvre dynamique de suivi des étiquettes et des pixels dans les applications. Les développeurs peuvent pousser événements importants dans une couche de données et décider plus tard qui tags ou pixels de suivi devrait être congédié. TagManager prend actuellement en charge les balises suivantes:
Google App Mobile AnalyticsDoubleClick RemarketingDoubleClick FloodlightPersonnalisé Function Call
Avant de commencer
Effectuez les étapes suivantes avant de commencer ce guide de mise en route:
Installez le SDK AndroidTéléchargez le Google Play services SDKCréez un compte Google Tag ManagerConfigurer un conteneur Google Tag Manager
Une fois que vous avez terminé ces étapes, le reste de cet article vous guidera à travers la façon de configurer et utiliser Google Tag Manager au sein de votre application Android.
Commencer
Après avoir suivi ce guide de mise en route, vous comprendrez comment:
Ajouter Google Tag Manager pour votre projetInitialiser le gestionnaire de Tag dans votre applicationObtenez valeurs de configuration depuis un conteneur Gestionnaire de TagPoussez les valeurs et les événements dans le dataLayerAperçu, débogage, et de publier votre conteneur
Ce guide utilise des extraits de code des Cute Animals exemple d'application inclus avec leSDK Jouer services Google . La source complète pour ce projet est disponible en: < android-sdk-directory>/extras/google/google_play_services/tagmanager/cuteanimals .
1. Ajout Google Tag Manager pour votre projet
Pour ajouter Google Tag Manager pour votre projet:
Configuration du Google Play services SDK .Ajouter les autorisations suivantes à votre AndroidManifest.xml fichier: <! - Pour TagManager SDK ->
<Utilise-autorisation android: name = "android.permission.INTERNET" />
<Utilise-autorisation android: name = "android.permission.ACCESS_NETWORK_STATE" />
2. Ajout d'un fichier conteneur par défaut à votre projet
Remarque: Si vous ne avez pas encore configuré votre conteneur dans l'interface Web de Google Tag Manager , revenez à cette étape une fois que vous avez fait.
Google Tag Manager utilise un conteneur par défaut sur la première manche de votre demande.Le conteneur par défaut cessera d'être utilisée dès que le soft est capable de récupérer un nouveau récipient sur le réseau.
Pour télécharger et ajouter un binaire conteneur par défaut à votre application, suivez ces étapes:
Se connecter à l'interface Web Manager Tag Google.Sélectionnez la version du conteneur que vous souhaitez télécharger.Cliquez sur le bouton Télécharger pour récupérer le fichier binaire contenant.Ajouter le récipient fichier binaire téléchargé sur votre projet en tant que ressource brute.Si la raw sous-dossier <project-root>/res/ ne existe pas, créez-le.Renommez le fichier binaire contenant si nécessaire. Il se compose de seulement minuscules, chiffres et caractères de soulignement.Copiez le fichier binaire contenant le dossier <project-root>/res/raw .
Bien que l'utilisation du fichier binaire est recommandé, si votre conteneur ne contient pas de règles ou des étiquettes, vous pouvez choisir d'utiliser un fichier JSON simples à la place.
3. Initialisation Google Gestionnaire de balises
Pour initialiser Google Tag Manager dans votre application, suivre ce modèle:
Obtenez le TagManager singleton: TagManager TagManager = TagManager.getInstance (this);Utilisez le TagManager singleton pour faire une demande de charger un conteneur en précisant un Google Tag Manager conteneur ID ainsi que votre conteneur par défautfichier. L'ID de conteneur doit être en majuscules et correspondre exactement à l'ID de conteneur dans l'interface Web Manager Tag Google. L'appel àloadContainerPreferNonDefault() est non-bloquante et retourne unPendingResult : PendingResult <ContainerHolder> attente =
tagManager.loadContainerPreferNonDefault (CONTAINER_ID,
R.raw.gtm_default_container);Utilisez un ResultCallback de retourner le ContainerHolder une fois qu'il a fini de charger ou expiré: // La méthode de onResult sera appelée dès que l'une des situations suivantes se produit:
// 1. un récipient enregistrée est chargée
// 2. Se il n'y a pas de récipient enregistré, un conteneur de réseau est chargé
// 3. les demande expire. L'exemple ci-dessous utilise une constante pour gérer la période de temporisation.
pending.setResultCallback (nouvelle ResultCallback <ContainerHolder> () {
Override
onResult public void (ContainerHolder containerHolder) {
ContainerHolderSingleton.setContainerHolder (containerHolder);
conteneur conteneur = containerHolder.getContainer ();
if (! containerHolder.getStatus (). isSuccess ()) {
Log.e ("CuteAnimals", "échec de chargement du conteneur»);
displayErrorToUser (R.string.load_error);
retourner;
}
ContainerHolderSingleton.setContainerHolder (containerHolder);
ContainerLoadedCallback.registerCallbacksForContainer (conteneur);
containerHolder.setContainerAvailableListener (nouvelle ContainerLoadedCallback ());
startMainActivity ();
}
}, 2, TimeUnit.SECONDS);Remarque:. Par défaut, un conteneur devient admissible à rafraîchir sur le réseau toutes les 12 heures Apprenez à actualiser manuellement un récipient .
Création d'un ContainerHolder Singleton
Vous ne devez maintenir une instance de ContainerHolder par série de votre application. Ce est pourquoi l'exemple ci-dessus utilise unContainerHolderSingleton classe utilitaire pour gérer l'accès à l'ContainerHolder exemple. Voici ce que ContainerHolderSingleton classe ressemble à ceci:
com.google.android.tagmanager.examples.cuteanimals de colis;
com.google.android.gms.tagmanager.ContainerHolder importation;
/ **
* Singleton à tenir le récipient de GTM (car il devrait être créé une fois seulement
* Par cycle de l'application).
* /
public class ContainerHolderSingleton {
statique ContainerHolder containerHolder privé;
/ **
* Classe utilitaire; ne pas instancier.
* /
ContainerHolderSingleton privée () {
}
public static ContainerHolder getContainerHolder () {
retourner containerHolder;
}
public static void setContainerHolder (ContainerHolder c) {
containerHolder = c;
}
}
▸
Voir un code d'extraits de la Sample Application
4. Obtenir des valeurs de configuration du conteneur
Une fois le conteneur est chargé, vous pouvez récupérer les valeurs de configuration en utilisant l'un des Container.get <type> () méthodes. Les valeurs de configuration sont définies en utilisant les variables d'acquisition de la valeur Google Tag Manager. Par exemple, la méthode suivante récupère la dernière couleur que nous avons décidé d'utiliser dans un élément d'interface utilisateur et la retourne comme un entier:
/ **
* Renvoie un entier représentant une couleur.
* /
private int getColor (String key) {
retourner colorFromColorName (containerHolder.getContainer () getString (clé).);
}
Ce code fait deux choses pour récupérer le nom de la couleur du récipient:
Obtient le Container de la ContainerHolder utilisantContainerHolder.getContainer() .Obtient la valeur de couleur à l'aide Container.getString( key ) , où vous avez défini la clé et la valeur dans l'interface Web Manager Tag Google.
5. Pousser événements et valeurs pour l'dataLayer
Google Tag Manager fournit aussi un dataLayer , dans lequel vous pouvez pousser informations sur votre application qui peut être lu dans d'autres parties de votre application ou utilisé pour les balises que vous avez configurés dans l'interface Web Manager Tag Google feu.
Pousser Valeurs à l'dataLayer
Le dataLayer fournit une couche de persistance que vous pouvez utiliser pour stocker des paires clé-valeur que vous pouvez utiliser dans d'autres parties de votre application, ou comme entrées vers Google Tags Manager Tag.
Pour pousser une valeur à la dataLayer , suivre ce modèle:
Obtenez le DataLayer singleton: DataLayer dataLayer = TagManager.getInstance (contexte) .getDataLayer ();Poussez l'événement en utilisant DataLayer.pushEvent() : // Mettez le image_name dans la couche de données pour une utilisation future.
. TagManager.getInstance (cette) .getDataLayer () pousser (IMAGE_NAME_KEY, imageName);
Pour obtenir une valeur de la dataLayer , utiliser DataLayer.get( key ) .
Pousser événements à l'dataLayer
Pousser les événements à la dataLayer vous permet de séparer votre code d'application des étiquettes que vous pourriez vouloir tirer en réponse à ces événements.
Par exemple, au lieu de Google Analytics screenview appels de suivi codage en dur dans votre application, vous pouvez pousser événements de l'écran sur le dataLayer et définir vos tags de tracking via l'interface Web Manager Tag Google. Cela vous donne la possibilité de modifier cette étiquette, ou d'ajouter des balises supplémentaires qui répondent aux événements de l'écran, sans mettre à jour votre code d'application.
Pour pousser un événement au dataLayer , suivre ce modèle:
Obtenez le DataLayer singleton: DataLayer dataLayer = TagManager.getInstance (contexte) .getDataLayer ();Poussez l'événement en utilisant DataLayer.pushEvent() : dataLayer.pushEvent ("OpenScreen", DataLayer.mapOf ("Pseudo", Pseudo));
DataLayer.mapOf() est une méthode d'utilitaire que vous pouvez utiliser pour générer facilement une carte de paires clé-valeur qui sera mise à jour dataLayer en même temps l'événement est poussé.
▸
Voir un code d'extraits de la Sample Application
6. Prévisualisation, débogage, et de l'édition
Avant de publier une version de votre récipient, vous voulez avoir un aperçu pour vous assurer qu'il fonctionne comme prévu. Google Tag Manager vous donne la possibilité de prévisualiser les versions de votre conteneur en établissant des liens et des codes QR dans l'interface Web et de les utiliser pour ouvrir votre application. Vous pouvez également activer un mode de journalisation détaillée pour déboguer tout comportement inattendu.
Prévisualisation
Pour prévisualiser une version de votre récipient, suivez ces étapes:
Ajout cet aperçu Activity à votre AndroidManifest fichier: <! - Ajouter activité de prévisualisation. ->
<Activité
android: name = "com.google.android.gms.tagmanager.PreviewActivity"
android: label = "@ string / app_name"
Android: Nohistory = "true"> <- optionnel, supprime le previewActivity de la pile de l'activité. ->
<Intention filtre>
<Android de données: scheme = "tagmanager.c.your.application.packagename" />
<Action android: name = "android.intent.action.VIEW" />
<Catégorie android: name = "android.intent.category.DEFAULT" />
<Catégorie android: name = "android.intent.category.BROWSABLE" />
</ Intention filtre>
</ Activité>
Assurez-vous de modifier cette ligne pour inclure le nom du package de votre application:
<Android de données: scheme = "tagmanager.c.your.application.packagename" />Générer un lien d'aperçu dans l'interface Web Manager Tag GoogleConnectez-vous à Google Gestionnaire de balisesSélectionnez la version de conteneurs pour prévisualiserCliquez sur le bouton AperçuEntrez le nom du package de votre application et cliquez sur Générer commencer aperçu lienUtilisez le lien généré ou code QR pour lancer votre applicationVous pouvez quitter le mode de prévisualisation en suivant un lien généré par l'optionaperçu de lien Générer de fin dans l'interface web.
Débogage
Si vous avez besoin pour dépanner votre mise en œuvre de conteneurs, activer la journalisation détaillée en appelant TagManager.setVerboseLoggingEnabled(true) :
// Modifier le niveau de l'enregistreur de journal d'imprimer non seulement
// Avertissement et les messages d'erreur, mais aussi les messages verbeux, debug, info.
tagManager.setVerboseLoggingEnabled (true);
Édition
Après avoir prévisualisé votre récipient et vérifié qu'il fonctionne comme prévu, vous pouvezpublier votre récipient . Vos valeurs de configuration du conteneur, tags, et les événements seront en direct pour les utilisateurs la prochaine fois que leurs contenants sont actualisées. En savoir plus sur les conteneurs rafraîchissantes .
Configuration avancée
Les sections suivantes décrivent les options de configuration avancées que vous souhaitez utiliser afin de personnaliser votre application Google Tag Manager.
Actualisation de la Container
Par défaut, votre conteneur devient admissible à être rafraîchi toutes les 12 heures. Pour actualiser manuellement le conteneur, utiliser ContainerHolder.refresh() :
ContainerHolderSingleton.getContainerHolder () refresh ().
Ce est un appel asynchrone qui ne reviendra pas immédiatement. Pour réduire le trafic réseau,refresh() ne peut être appelée une fois tous les 15 minutes, sinon ce sera un no-op.
Remarque: Cet extrait de code utilise le ContainerHolderSingleton classe utilitairedécrit dans l'exemple ci-dessus d'initialisation.▸
Voir un code d'extraits de la Sample Application
Sauf indication contraire, le contenu de cette page est sous licence 3.0 License Creative Commons Attribution , et des exemples de code sont sous licence Apache License 2.0 . Pour plus de détails, consultez nos Politiques du site .
Dernière Updated 11 Février 2015.
Explorer
ProduitsVitrineÉvénementsCommunautés
Relier
BlogGoogle+ CommunautéYouTubeSignaler un problèmeOffres d'emploi
Programmes
GroupesExpertsStartupsFemmes Techmakers
Top Produits
AnnoncesAnalytiqueAndroïdeJeterChromeNuageVerreGoogle AppsGoogle+PlansPortefeuilleYouTube
Conditions d'utilisation Politique de confidentialité
العربية
български català 简体 中文繁體 中文 Hrvatski česky dansk Nederlands Anglais فارسی suomi français Deutsch Ελληνικά עברית Hindi Magyar Indonésien italiano 日本語 한국어 latviešu Lituanien Norsk (bokmål) Norsk (nynorsk) Polski Português Brasileiro Português Română Русский српски slovenský Slovenščina español svenska Thaï Türkçe Українська Vietnamien
Anglais
UA-46322091-11 | [WMT-95212] 'Par Wâmuffïn-R Thierry Arnaud TAREAU") Le Père! Et Son Fils!!!
Aucun commentaire:
Enregistrer un commentaire