Bing UET Tag : installation et aide

Importez le ZIP du module dans Modules > "Module Manager". Installez-le et ouvrez "Configure" pour Bing UET Tag + Conversions API.

Récupérez l'identifiant numérique de votre balise UET dans votre compte Microsoft Advertising. Le module n'y crée ni balise ni objectifs de conversion. Sélectionnez la boutique voulue avant d'enregistrer les paramètres.

Saisissez ID de la balise UET, activez Activer la balise Bing UET, sélectionnez les événements navigateur et enregistrez. L'ID doit être positif. Après une nouvelle installation, le suivi navigateur reste désactivé jusqu'à sa configuration.

Tous ces champs figurent sur l'écran de configuration.

L'intégration du consentement prend en charge les modules de consentement MPR et les états reconnus des fournisseurs de consentement. Elle n'affiche pas sa propre bannière. Avec Respecter le consentement marketing activé, l'absence de décision prise en charge n'autorise pas l'envoi.

Le traceur vérifie aussi la propriété de l'intégration pour la boutique et la politique de suivi sortant. Les signaux d'employé et de refus du suivi peuvent empêcher l'envoi. N'évaluez pas le suivi client depuis un navigateur reconnu comme interne par le module.

Ces options sont désactivées à l'installation. N'activez que les signaux fournis par votre boutique.

Les paramètres d'engagement valident les seuils de galerie, variantes et détails de 1 à 20, la durée de 5 à 600 secondes et la temporisation des options de 250 à 60000 ms. Laissez le JSON vide pour les valeurs par défaut.

UET navigateur et Conversions API s'activent séparément. Pour utiliser les achats serveur :

1. Laissez Activer la balise Bing UET et Suivre les achats activés.
2. Activez "Capture durable buyer evidence" avant de passer votre commande test.
3. Activez Activer l’API de conversions et saisissez Jeton de l’API de conversions.
4. Enregistrez et consultez les panneaux de préparation et de file d'attente.
5. Configurez l'entrée cron générée par le module dans le planificateur de votre hébergement.
6. Acceptez les cookies dans une session de navigateur normale, passez une commande en tant que client ou invité, puis vérifiez que l'achat apparaît dans la file.

À la création d'une commande, le module vérifie la session de commande et le consentement de l'acheteur avant d'ajouter l'achat à la file. Un achat sans données acheteur enregistrées est suspendu : activer CAPI n'envoie donc pas toutes les commandes.

Le modèle de point d'accès est :

https://capi.uet.microsoft.com/v1/{TAG_ID}/events

La tâche installée est send_bing_uet_conversions, planifiée toutes les 300 secondes. L'installation crée une entrée cron via le paquet cron partagé. Copiez le jeton et la commande réels fournis par votre module installé. Commande serveur type :

* * * * * php /var/www/html/modules/mprbinguet/cron.php --token=YOUR_TOKEN --max-seconds=300

Remplacez le chemin PHP, le chemin de boutique et le jeton. Le planificateur appelle l'exécuteur ; les tâches dues utilisent leur propre fréquence de cinq minutes.

Le panneau de file affiche En attente, Envoi en cours, Envoyé, Échec, "Held", "Terminal" et "Suppressed". Utilisez Réessayer les événements échoués après avoir corrigé l'erreur signalée. Les événements suspendus ou bloqués attendent des données acheteur manquantes ou ont été arrêtés par le consentement ou une règle ; corrigez cette cause au lieu de renvoyer.

Envoyer un événement de test n'envoie rien pour le moment : il affiche seulement un message indiquant que le mode test Microsoft n'est pas disponible. Pour contrôler le suivi, passez une commande test, surveillez la file et utilisez les outils de diagnostic de votre compte Microsoft Advertising.

Cette configuration facultative se trouve sous "Microsoft online refund and cancellation corrections".

Renseignez "Microsoft customer ID", "Microsoft account ID", "Developer token", "OAuth client ID", "OAuth client secret", "OAuth refresh token" et "Exact purchase conversion goal name". Ces champs sont initialement vides. "Use Microsoft adjustments sandbox" est initialement désactivé.

Le bouton "Enable online corrections" n'apparaît que si "Capture durable buyer evidence" est activé, que tous les identifiants Microsoft et le nom de l'objectif d'achat sont renseignés et qu'une liaison enregistrée entre votre compte Microsoft, la balise UET et l'objectif d'achat existe pour la boutique. L'écran de configuration n'a aucun champ pour créer cette liaison : sur une installation standard, le bouton reste donc masqué et les remboursements et annulations ne sont pas envoyés à Microsoft.

Activez Suivre les événements personnalisés et saisissez un tableau JSON dans Règles d’événements personnalisés. Les noms d'événements acceptent lettres, chiffres, traits de soulignement et traits d'union, jusqu'à 64 caractères. Vous pouvez utiliser jusqu'à 15 noms distincts et 30 paramètres configurés par règle. Le module n'envoie que les noms de paramètres UET pris en charge, dont event_category, event_label, event_value, value, currency et les champs d'articles e-commerce.

Règle de clic :

[
  {"event":"GalleryBrowse","trigger":"click","selector":".product-images img, .images-container img","params":{"event_category":"Product","event_label":"Gallery browse"}}
]

Règle d'URL :

[
  {"event":"PromoPageView","trigger":"url","contains":["/promo/"],"params":{"event_category":"Campaign"}}
]

Règle de contrôleur :

[
  {"event":"CheckoutPageView","trigger":"controller","controllers":["order"],"params":{"event_category":"Checkout"}}
]

Règle d'événement DOM :

[
  {"event":"QuoteRequest","trigger":"event","dom_event":"shop:quote-request","params":{"event_category":"Lead"}}
]

Votre thème peut déclencher l'événement correspondant :

document.dispatchEvent(new CustomEvent('shop:quote-request', {
  detail: {params: {event_label: 'Product page quote button'}}
}));

Utilisez ces règles configurées pour les appels personnalisés. Le module ne fournit pas l'ancien assistant window.mprbinguetTrack et ne lit pas les anciens attributs data-mprbinguet-param-*. Par défaut, les règles URL, contrôleur et DOM se déclenchent une fois par page ; les règles de clic se répètent. Définissez explicitement once si nécessaire.

Consultez le panneau de préparation après chaque modification. Vérifiez l'ID de balise, le suivi navigateur, le consentement, les règles personnalisées et l'état CAPI.

Utilisez un navigateur client distinct. Accordez le consentement requis, ouvrez un produit et inspectez le journal réseau pour le script Microsoft UET à bat.bing.com/bat.js et les événements choisis. Refusez le consentement dans un nouveau test et confirmez l'absence de suivi lorsque la protection est activée.

Testez un ajout réussi au panier et à la liste de souhaits. Une action échouée ne doit pas devenir un événement e-commerce confirmé. Si votre thème ou commande utilise des événements personnalisés, vérifiez qu'il fournit le signal de réussite pris en charge.

Pour les achats, comparez la référence de transaction, la politique de valeur, la devise et les articles avec la commande. Contrôlez la file serveur et les journaux ainsi que les requêtes navigateur. Microsoft décide quelles conversions il accepte et affiche : vérifiez donc aussi les résultats dans votre compte Microsoft Advertising.

Si aucune balise ne charge, vérifiez l'activation générale, l'ID numérique positif, le consentement, l'exclusion des employés, le refus du suivi et la politique de propriété de la boutique. Vérifiez ensuite les bloqueurs de scripts et les erreurs navigateur. Si CAPI reste en attente, vérifiez l'exécuteur cron. S'il est suspendu, vérifiez que l'acheteur a donné son consentement et que ses données de commande ont été enregistrées. En cas d'échec, contrôlez le jeton et la réponse avant de réessayer.

Désactivez le suivi navigateur et serveur pour simplement suspendre la collecte. Avant de désinstaller, sauvegardez les paramètres et les preuves d'envoi nécessaires. La désinstallation retire le menu, la tâche planifiée et la configuration du module. La table de file de conversions partagée n'est supprimée que si aucun autre module n'utilise le paquet de conversions ; les données peuvent rester si un autre utilisateur conserve la table partagée.

Nécessite PrestaShop 1.6.0.0 ou une version ultérieure et PHP 7.1 ou une version ultérieure.