Tracking V2 : relier l’iFrame et le consentement

Lors d’une intégration dans un site web, Tracking V2 doit recevoir la session et le consentement réels de votre site. Le processus de réservation ne prend pas en charge de session de remplacement indépendante dans l’iFrame. Cette configuration s’adresse à la personne ou à l’agence qui gère le site web, Google Tag Manager et la gestion du consentement.

Configurez d’abord les destinations de suivi dans edoobox et utilisez le code d’intégration actuel de Aperçu / Partage.

Préparer le conteneur GTM web V2

Dans edoobox, exportez le conteneur GTM V2.
Dans Google Tag Manager, ouvrez le conteneur web approprié et sélectionnez Administration → Importer un conteneur.
Importez le fichier JSON en complément du conteneur existant et vérifiez les conflits avant de confirmer. La procédure Google distingue « Fusionner » et « Écraser » ; un écrasement complet supprime les anciennes balises, déclencheurs et variables. Voir Google : importer un conteneur.
Assurez-vous que la balise Google correspondant au même identifiant de mesure existe sur votre site web. Le module edoobox n’installe pas de propriété GA4 supplémentaire.
Désactivez les anciennes balises d’achat edoobox du même compte. Conservez le parcours de navigateur autorisé et la configuration du consentement.
Vérifiez le conteneur en mode aperçu et publiez les modifications préparées.

L’export V2 contient exclusivement des événements du navigateur. Les achats, paiements, annulations et remboursements proviennent de l’envoi côté serveur d’edoobox.

Ajouter l’assistant du site web à l’iFrame

Conservez le code d’intégration edoobox, puis chargez les deux scripts supplémentaires sur votre site web. Utilisez l’hôte de l’environnement edoobox réellement employé :

<script src="https://app2.edoobox.com/js/home/tools/booking-analytics-v2.js"></script>
<script src="https://app2.edoobox.com/js/home/tools/booking-analytics-embedded-v2.js"></script>

Enregistrez ensuite l’iFrame précis :

edooboxBookingAnalyticsEmbedV2.register({
    iframeId: 'edoobox_customer',
    bookingOrigin: 'https://app2.edoobox.com',
    measurementId: 'G-CUSTOMERID',
    googleEnabled: true,
    microsoftEnabled: false,
    openaiEnabled: false,
    getConsent: function () {
        return readCurrentConsentFromYourCmp();
    }
});

Dans cet exemple, readCurrentConsentFromYourCmp() est une variable de remplacement pour votre connexion CMP. Remplacez la fonction par l’accès réel au consentement. La fonction de rappel doit fournir un objet au format suivant :

{
    analytics_storage: 'denied',
    ad_storage: 'denied',
    ad_user_data: 'denied',
    ad_personalization: 'denied'
}

Définissez une valeur sur granted uniquement lorsqu’une décision valide correspondante existe. Les valeurs manquantes ou inconnues sont traitées comme un refus.

Associer correctement les paramètres

Paramètres	Configuration
iframeId	L’identifiant unique de l’élément DOM de l’iFrame réel. Il doit correspondre exactement.
bookingOrigin	Protocole et hôte de la page de réservation, avec le port si nécessaire ; sans chemin ni barre oblique finale.
measurementId	Le même identifiant de mesure GA4 que dans la configuration edoobox active.
googleEnabled / microsoftEnabled / openaiEnabled	Exactement les mêmes prestataires activés que dans le compte edoobox.
getConsent	Fournit l’état actuel de la CMP à chaque appel.

Pour des publicités sans Google, définissez googleEnabled: false et omettez measurementId. Pour plusieurs comptes edoobox, enregistrez chaque iFrame séparément avec ses propres destinations. Les changements de prestataires doivent être répercutés à la fois dans edoobox et dans l’enregistrement du site web.

L’iFrame nécessite le référent d’origine de votre site web, par exemple avec referrerpolicy="origin" ou la valeur standard habituelle strict-origin-when-cross-origin. Avec no-referrer, aucun contexte parent n’est repris. Utilisez l’origine exacte plutôt qu’un caractère générique.

Après chaque modification de la CMP, demandez une nouvelle collecte pour cet iFrame :

edooboxBookingAnalyticsEmbedV2.refresh('edoobox_customer');

Cela s’applique après le consentement comme après son retrait. L’analyse et la publicité sont traitées séparément. L’attribution publicitaire nécessite simultanément ad_storage: 'granted' et ad_user_data: 'granted'. Un retrait supprime également les identifiants publicitaires enregistrés du contexte de réservation.

Le module ne recueille pas de session Google autorisée si le site web ne contient qu’un identifiant de mesure sans fournir de balise Google appropriée. Le processus de réservation n’attend pas la réussite d’une récupération de suivi.

Page edoobox directe et CMP propre

Dans une vue participant directe, le bandeau de cookies edoobox peut fournir le consentement explicite. Sans bandeau, V2 démarre avec un refus. Si vous utilisez votre propre CMP, fournissez cette fonction avant l’initialisation :

window.edooboxAnalyticsConsent = function (measurementId) {
    return readCurrentConsentFromYourCmp();
};

Lors d’un changement ultérieur, transmettez l’état actuel :

window.dispatchEvent(new CustomEvent('edoobox:analytics-consent', {
    detail: {
        measurement_id: 'G-CUSTOMERID',
        consent: readCurrentConsentFromYourCmp()
    }
}));

Pour des publicités sans Google, utilisez measurement_id: '' dans l’événement de consentement direct. L’exemple doit être placé sur la page réellement gérée ou dans son intégration appropriée ; ne le saisissez pas comme HTML quelconque dans les balises méta de vérification.

Trois cas de contrôle avant la mise en ligne

Refus : commencez avec le consentement refusé. Aucun événement analytique ou publicitaire soumis à consentement ne doit être transmis pour cette opération.
Consentement : autorisez les finalités prévues. Vérifiez le parcours de navigateur et une réservation définitive contrôlée dans le système cible.
Retrait : retirez le consentement pendant l’opération et actualisez l’assistant. Vérifiez qu’aucune nouvelle autorisation ne provient d’un ancien contexte.

Vérifiez sur ordinateur et smartphone ainsi qu’après un changement de page entre la vue d’ensemble des offres et la réservation. En présence de plusieurs iFrames, un événement doit être attribué uniquement au compte et à la destination de suivi prévus.

Suite : Événements et dépannage · Bandeau de cookies · Configurer les prestataires

Vérifier le contexte parent réel dans le CMS

L’enregistrement nécessite que l’iFrame edoobox réel soit un élément DOM sur la page où les scripts auxiliaires s’exécutent. Un cadre d’intégration supplémentaire d’un constructeur de sites peut modifier cet accès. Vérifiez la mise en page concrète publiée dans le CMS ; un emplacement extérieur ayant la même taille visible n’est pas automatiquement le bon élément.

Ne chargez les assistants qu’une seule fois par page gérée et enregistrez chaque instance edoobox avec un identifiant unique. Dans la fonction de rappel, transmettez une nouvelle évaluation actuelle de la CMP, et non un consentement figé au chargement de la page. Après un changement de prestataire ou de compte, l’enregistrement et la configuration cible enregistrée doivent correspondre.