Vous pouvez vous abonner aux événements d'analyse Places concernant les utilisateurs qui cliquent sur "Itinéraire", "Appeler" ou "Site Web", ouvrent Google Maps, cliquent sur la note ou l'attribution de l'auteur, ouvrent la visionneuse de photos ou changent d'onglet. Chaque événement fournit un ensemble de balises et l'élément gmp-* public le plus proche qui contient l'interaction (ou null), à partir duquel vous pouvez lire l'ID de lieu et l'emplacement.
Événements Analytics fournis
Le tableau suivant fournit des exemples d'événements d'analyse fournis par le Kit UI pour Places.
| Interaction avec l'UI | tags: Set<string> |
|---|---|
| Bouton "Itinéraire" | {"click", "directions", "outbound"} |
| Bouton "Ouvrir dans Maps" | {"click", "maps", "outbound"} |
| Bouton d'appel/Numéro de téléphone (onglet "Aperçu") | {"click", "call_place", "outbound"} |
| Bouton "Site Web"/Site Web (onglet "Aperçu") | {"click", "place_website", "outbound"} |
| Lien d'attribution | {"click", "attribution", "outbound"} |
| Lien d'évaluation | {"click", "reviews", "outbound"} |
Lien vers les mentions légales (liens de la boîte de dialogue ⓘ) |
{"click", "disclosure", "outbound"} |
| Lien vers le rapport | {"click", "report", "outbound"} |
| Lien d'avis | {"click", "review", "outbound"} |
| Lien vers le média/la photo | {"click", "media", "outbound"} |
| Lightbox de photo ouverte (dans l'application) | {"click", "media"} |
| Onglet "Aperçu" sélectionné (dans l'application) | {"click", "overview_tab"} |
| Onglet "Avis" sélectionné (dans l'application) | {"click", "reviews_tab"} |
| Onglet "À propos" sélectionné (dans l'application) | {"click", "about_tab"} |
Menu à développer des avis (⋮) ouvert (dans l'application) |
{"click", "reviews_menu"} |
Menu à développer Lightbox (⋮) ouvert (dans l'application) |
{"click", "lightbox_menu"} |
Menu "Résumé génératif" (⋮) ouvert (dans l'application) |
{"click", "generative_summary_menu"} |
Menu du résumé des avis génératif (⋮) ouvert |
{"click", "review_summary_menu"} |
Étant donné que de nouveaux événements et tags peuvent être ajoutés au fil du temps, vous pouvez associer un gestionnaire générique pendant le développement pour consigner chaque événement diffusé lorsque vous interagissez avec un composant :
const {Settings} = await google.maps.importLibrary('core'); // Log every gmp-analytics event broadcast on the page Settings.getInstance().addEventListener('gmp-analytics', (event) => { console.log('Analytics event:', event); });
S'abonner aux événements d'analyse et les gérer
Vous pouvez écouter les événements d'analyse sur tous les éléments du kit UI pour Places de la page en ajoutant un écouteur d'événements gmp-analytics à l'instance singleton google.maps.Settings.
google.maps.AnalyticsEvent fournit event.tags (un Set<string>) et event.element (un Element | null représentant l'élément gmp-* public le plus proche qui contient l'interaction, tel que gmp-place-details-compact, ou null si aucun ne s'applique). Lorsqu'il est présent, vous pouvez lire le Place associé à partir de event.element.place (ou event.element.places sur les éléments de liste et de recherche).
const {Settings} = await google.maps.importLibrary('core'); const {Place} = await google.maps.importLibrary('places'); const settings = Settings.getInstance(); settings.addEventListener('gmp-analytics', (event) => { const {tags, element} = event; // google.maps.AnalyticsEvent const place = element?.place; const placeId = place instanceof Place ? place.id : 'none'; // Option A: Check for specific interactions using tag strings if (tags.has('directions')) { console.log(`User requested directions for place: ${placeId}`); } if (tags.has('outbound')) { console.log(`User is leaving the page via: ${[...tags].sort().join(', ')}`); } // Option B: Forward every event to your analytics pipeline (for instance, Google Analytics / gtag) gtag('event', 'maps_javascript_api_analytics', { element_tag: element?.localName ?? 'none', tags: [...tags].sort().join(','), place_id: placeId, }); });
Si votre page affiche plusieurs éléments du kit UI pour Places, vous pouvez comparer event.element à une référence d'élément DOM spécifique pour déterminer quelle instance de fiche a déclenché l'événement :
const {Settings} = await google.maps.importLibrary('core'); const featuredCard = document.querySelector('#featured-place-card'); Settings.getInstance().addEventListener('gmp-analytics', (event) => { if (event.element?.contains(featuredCard) && event.tags.has('directions')) { console.log('Directions clicked on the featured place card:', featuredCard.place?.id); } });