Intégration Quora Pixel : installation et aide

Suivez les étapes du Démarrage rapide.

• "Enable Quora Pixel". Active ou désactive le suivi Pixel dans le navigateur ; défaut : 0. Activez-le dans la configuration du module après avoir saisi un Pixel ID valide.
• Pixel ID. Stocke votre ID de Pixel Quora depuis "Quora Ads Manager" ; défaut : empty. Il doit comporter 4 à 128 lettres, chiffres, traits de soulignement ou tirets.
• "Advanced match email". Envoie à Quora l'e-mail client haché en SHA-256 lorsqu'un client connecté est disponible ; défaut : 1.
• "Exclude employee browsing". Empêche le suivi lorsqu'un employé du back-office parcourt la boutique ; défaut : 1.
• "Respect marketing consent". Exige le consentement marketing lorsque ce réglage est activé. Sa désactivation autorise le suivi sans décision de consentement distincte uniquement si aucun gestionnaire de consentement pris en charge n’est détecté ; défaut : 1.
• "Track page visits". Envoie les visites comme événements Quora Generic avec event_label=PageVisit ; défaut : 1.
• "Track ViewContent". Envoie les vues de pages produit avec ID, nom, catégorie, valeur et devise lorsqu'ils sont disponibles ; défaut : 1.
• "Track AddToCart". Suit les ajouts au panier réussis et confirmés avec une augmentation de quantité prouvée ; défaut : 1.
• "Track AddToWishlist". Suit les ajouts à la liste de souhaits à partir d'ajouts réussis dont le succès est confirmé ; défaut : 1.
• "Track InitiateCheckout". Envoie InitiateCheckout lorsque le client atteint la page de début de commande ; défaut : 1.
• "Track Search". Envoie des événements Search avec le texte de recherche soumis lorsqu'il est disponible ; défaut : 1.
• "Track Purchase". Envoie les achats à la confirmation de commande et peut mettre en file des achats serveur lorsque Conversions API est configurée ; défaut : 1.
• "Track CompleteRegistration". Envoie CompleteRegistration après la création d'un compte client ; défaut : 1.
• "Track custom events". Active vos règles d'événements personnalisées JSON ; défaut : 0.
• Règles d'événements personnalisés. Stocke les règles JSON de suivi personnalisé des clics, URL, contrôleurs et événements DOM ; défaut : empty.
• "Enable Conversions API events". Active la mise en file et l'envoi côté serveur pour les événements avec un ID de clic Quora valide ; défaut : 0.
• ID de compte publicitaire Quora. Stocke l'ID numérique du compte publicitaire Quora requis pour Conversions API ; défaut : empty.
• Token d’accès Conversions API. Stocke le jeton généré dans "Quora Ads Manager" pour l'envoi des conversions côté serveur ; défaut : empty.
• "Test qclid". Conserve un véritable ID de clic Quora pour les diagnostics ; aucune conversion de test n'est envoyée ; défaut : empty.
• "Queue batch limit". Limite le nombre d'événements par traitement de file, de 1 à 100 ; le commerce et les formulaires confirmés ont des files distinctes ; défaut : 20.

Cliquez sur Enregistrer après les modifications. L'ID du compte publicitaire doit être un entier positif, jusqu'à 9007199254740991. "Test qclid" accepte jusqu'à 500 lettres, chiffres, points, traits de soulignement, deux-points et tirets.

Le formulaire actuel propose aussi ces paramètres. Tous les interrupteurs de signaux sont sur Non par défaut. Activez uniquement les actions que vous souhaitez observer.

Les seuils partagés sont trois vues de galerie, un changement de déclinaison, un clic de détail, 45 secondes de présence et une temporisation des options de 1500 ms. Les compteurs de galerie, de déclinaison et de détail sont limités de 1 à 20. La durée est limitée de 5 à 600 secondes. La temporisation est limitée de 250 à 60000 ms. Par exemple :

{"min_gallery_views":3,"min_variant_changes":1,"min_detail_clicks":1,"dwell_seconds":45,"option_throttle_ms":1500}

Vous pouvez aussi fournir gallery_selectors, variant_selectors et detail_selectors. Gardez les valeurs par défaut sauf si votre thème exige d'autres sélecteurs. Ces signaux facultatifs nécessitent les mêmes contrôles de consentement, de politique employés et de responsabilité du suivi que les événements commerciaux.

Gardez les paramètres de consentement et d'exclusion des employés activés lors de la configuration initiale. Testez depuis un navigateur visiteur normal non marqué comme employé. Une session back-office connectée, une règle de trafic interne ou le refus d'un visiteur peut empêcher le suivi.

Le module prend en charge les intégrations de consentement MPR et des adaptateurs CMP supplémentaires. Lorsqu’un gestionnaire de consentement pris en charge est détecté, le suivi exige une décision marketing valide pour la destination. Une décision inconnue, périmée ou négative retient les événements. Le module ne fournit pas de bannière de cookies. Désactiver "Respect marketing consent" ne permet pas de passer outre le refus d’un gestionnaire de consentement détecté.

Le module doit être responsable de la destination configurée dans le coordinateur de suivi partagé. Une responsabilité absente, ambiguë ou conflictuelle peut retenir les envois navigateur et serveur. Supprimez les balises de thème dupliquées ou résolvez la responsabilité lorsqu'un autre module MPR gère le même compte.

L’envoi en production suit aussi la politique des transmissions sortantes. Le mode démonstration et les domaines d’aperçu ou de test reconnus bloquent l’envoi à votre compte publicitaire. Les achats et événements de formulaire côté serveur utilisent l’autorisation enregistrée au moment de l’action de l’acheteur ; une exécution cron ultérieure ne peut pas fournir une autorisation manquante.

Le module charge https://a.quora.com/qevents.js lorsque le consentement marketing et les autres conditions de suivi le permettent. Vos clients ne voient aucun widget dans la boutique.

Les visites utilisent Quora Generic avec une étiquette de visite. Les pages produit, ajouts confirmés au panier et à la liste de souhaits, début de commande, recherche, inscription et confirmation de commande utilisent ViewContent, AddToCart, AddToWishlist, InitiateCheckout, Search, CompleteRegistration et Purchase. Le contexte produit et commande peut inclure ID, noms, catégories, quantités, valeur, devise et référence de commande. L'événement correspondant doit être activé et ses données disponibles.

Les achats admissibles sont mis en file pour l'envoi serveur à la validation de la commande et suivis dans le navigateur à la confirmation de commande. La création de compte est suivie au prochain chargement de page admissible. Les envois de formulaire confirmés sont également suivis.

L'attribution des clics publicitaires Quora utilise qclid. Lorsque le suivi est autorisé, le module le conserve pendant 30 jours dans le cookie mprqrpx_qclid et sans expiration automatique dans le stockage local du navigateur. Le refus de consentement efface ces données d'attribution. Le suivi dans le navigateur fonctionne sans CAPI, mais les événements serveur exigent un ID de clic capturé valide.

"Advanced match email" active le rapprochement par e-mail haché en SHA-256 lorsque cela est autorisé et que les données client sont disponibles. Il reste soumis aux contrôles distincts de consentement au rapprochement ; un client connecté ne suffit pas à l'autoriser.

Activez "Track custom events", collez un tableau JSON dans Règles d'événements personnalisés et enregistrez. Adaptez les sélecteurs et chemins à votre boutique. Utilisez les déclencheurs click, url, controller ou event. Une règle de contrôleur peut aussi inclure une liste modules. Les noms autorisent lettres, chiffres, traits de soulignement et tirets, jusqu'à 64 caractères. La limite est de 15 noms distincts. once limite une règle pendant l'exécution de la page actuelle.

[
  {
    "event": "GalleryBrowse",
    "trigger": "click",
    "selector": ".product-images img,.images-container img",
    "params": {
      "property": "product_gallery"
    },
    "once": false,
    "capi": true
  },
  {
    "event": "LandingView",
    "trigger": "url",
    "contains": [
      "/special-offer"
    ],
    "params": {
      "property": "special_offer"
    },
    "once": true,
    "capi": true
  },
  {
    "event": "ContactView",
    "trigger": "controller",
    "controllers": [
      "contact"
    ],
    "params": {
      "property": "contact_page"
    },
    "once": true,
    "capi": true
  },
  {
    "event": "SizeGuideOpen",
    "trigger": "event",
    "dom_event": "mprquora:custom",
    "params": {
      "property": "size_guide"
    },
    "once": false,
    "capi": true
  }
]

Déclenchez la règle DOM depuis votre thème après l'initialisation du suivi :

document.dispatchEvent(new CustomEvent('mprquora:custom'));

Quora reçoit les règles personnalisées sous forme de Generic avec les métadonnées custom_event_name. Les règles URL comparent location.pathname ; les fragments de requête comme utm_campaign=quora ne sont pas reconnus par le runtime personnalisé actuel. Placez les paramètres statiques pris en charge, comme value, dans params. Les clés arbitraires comme property dans les exemples ne sont pas transmises au Pixel navigateur ; la charge utile serveur conserve le nom, l'heure, l'identifiant de l'événement, l'identifiant de clic et la valeur facultative. Le gestionnaire DOM accepte un detail.event_id approprié, mais ne fusionne pas de valeurs detail.params arbitraires. Les anciens exemples d'attributs de données de clic ne sont pas lus par ce runtime.

Les événements navigateur et serveur utilisent un event_id correspondant lorsque l'événement d'origine est admissible aux deux. Une demande personnalisée capi exige toujours une attribution de clic capturée, une identité d'événement acceptée et une autorisation actuelle de l'acheteur.

La tâche send_quora_conversions est enregistrée avec la planification every:300. Elle devient due toutes les cinq minutes. Votre exécuteur cron MPR partagé doit exécuter les tâches dues ; la déclaration seule ne lance aucun worker. La limite de lot plafonne les lignes par traitement de file de 1 à 100, avec 20 par défaut. Les files du commerce et des formulaires confirmés sont traitées séparément pour chaque boutique.

Le module utilise le planificateur partagé configuré pour votre boutique et ne possède pas de cron.php distinct. Confirmez-y l'exécution des tâches et vérifiez les horodatages et l'état de la file sur la page de configuration du module.

Les diagnostics comprennent les contrôles de disponibilité, les compteurs de file, les lignes récentes, Envoyer une sonde API et Réessayer les événements échoués. Corrigez la cause de l'échec avant de réessayer. Remettre les lignes échouées en attente ne contourne pas les contrôles actuels de consentement, de politique employés, de responsabilité du compte ou de destination.

Le client serveur envoie à https://api.quora.com/ads/v0/conversion. Configurez l'ID numérique du compte et son jeton. Envoyer une sonde API n'envoie rien, car cette intégration ne dispose d'aucun mode d'envoi de test ou de simple validation. "Test qclid" n'envoie aucune conversion de test.

1. Vérifiez les avis de configuration requise, la disponibilité, l'intégrité et la responsabilité de la destination.
2. Dans un navigateur visiteur normal, accordez le consentement marketing et ouvrez un produit. Vérifiez que qevents.js se charge et que l'événement produit est émis.
3. Effectuez un véritable ajout au panier réussi et inspectez l'événement navigateur.
4. Pour tester le serveur, utilisez un parcours réel autorisé attribué à une publicité avec un qclid valide. Inspectez l'état en file de l'événement et les diagnostics réels de la plateforme après le traitement cron.
5. Confirmez les ID navigateur et serveur lorsque les deux événements ont été admis.

Si les événements navigateur manquent, vérifiez Pixel ID, les interrupteurs, le consentement, les marqueurs employés, le responsable du suivi, la politique sortante et le blocage navigateur. Si les événements serveur manquent, vérifiez l'attribution du clic, les identifiants, le consentement enregistré de l'acheteur et les exécutions du planificateur. Les événements serveur nécessitent un identifiant de clic qclid ; une visite ordinaire sans lui ne produit donc aucun événement CAPI. Utilisez la relance uniquement après avoir corrigé l'échec enregistré.

Si une règle personnalisée ne s'exécute pas, validez le JSON et la syntaxe des sélecteurs, puis vérifiez si vous vouliez comparer le chemin ou la requête. Le runtime actuel n'expose pas window.mprquoraTrack.

Désactivez les interrupteurs navigateur et serveur et enregistrez pour arrêter le suivi en conservant la configuration. Désinstallez depuis "Module Manager" pour supprimer les paramètres, entrées de menu et tâches enregistrées du module.

La désinstallation appelle le nettoyage partagé de la file de conversions. La table partagée est conservée tant qu'un autre module de conversion l'utilise et peut être supprimée au retrait du dernier utilisateur. Exportez les diagnostics nécessaires avant de désinstaller. Les événements déjà envoyés restent sur la plateforme publicitaire. La désinstallation n’efface pas les données d’attribution du navigateur.

Nécessite PrestaShop 1.6 ou ultérieur et PHP 7.1 ou ultérieur.