Bing UET Tag: configurazione e aiuto

Carica lo ZIP del modulo in Moduli > "Module Manager". Installalo e apri "Configure" per Bing UET Tag + Conversions API.

Recupera l'ID numerico del tag UET dal tuo account Microsoft Advertising. Il modulo non crea tag o obiettivi di conversione in quell'account. Seleziona il negozio desiderato prima di salvare.

Inserisci ID del tag UET, attiva Attiva il tag Bing UET, seleziona gli eventi browser e salva. L'ID deve essere un numero positivo. In una nuova installazione il tracciamento browser rimane disattivo fino alla configurazione.

Tutti questi campi sono nella schermata di configurazione.

L'integrazione del consenso supporta i moduli MPR e gli stati riconosciuti dei fornitori di consenso. Non mostra un proprio banner. Con Rispetta il consenso marketing attivo, l'assenza di una decisione supportata non autorizza l'invio.

Il tracker controlla anche la titolarità dell'integrazione nel negozio e la politica di tracciamento in uscita. I segnali dipendente e opt-out possono impedire l'invio. Non valutare il tracciamento cliente da un browser riconosciuto come interno dal modulo.

Queste opzioni sono disattive nelle nuove installazioni. Attiva solo i segnali forniti dal negozio.

Le impostazioni convalidano soglie di galleria, varianti e dettagli da 1 a 20, permanenza da 5 a 600 secondi e limitazione delle opzioni da 250 a 60000 ms. Lascia il JSON vuoto per usare i valori predefiniti.

UET browser e Conversions API si attivano separatamente. Per usare gli acquisti server:

1. Mantieni Attiva il tag Bing UET e Traccia gli acquisti attivi.
2. Attiva "Capture durable buyer evidence" prima di fare l'ordine di prova.
3. Attiva Attiva l’API di conversione e inserisci Token dell’API di conversione.
4. Salva e controlla i pannelli di preparazione e della coda.
5. Configura la voce cron generata dal modulo nel pianificatore dell'hosting.
6. Accetta i cookie in una normale sessione del browser, fai un ordine come cliente o come ospite, poi controlla che l'acquisto compaia nella coda.

Quando viene creato un ordine, il modulo controlla la sessione di checkout e il consenso dell'acquirente prima di aggiungere l'acquisto alla coda. Un acquisto senza dati dell'acquirente salvati viene sospeso, quindi attivare CAPI non invia ogni ordine.

Il modello dell'endpoint è:

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

L'attività installata è send_bing_uet_conversions, pianificata ogni 300 secondi. L'installazione crea una voce cron tramite il pacchetto cron condiviso. Copia il token e il comando effettivi forniti dal modulo installato. Un tipico comando server è:

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

Sostituisci percorso PHP, percorso del negozio e token. Il pianificatore richiama il runner; le attività dovute usano la propria pianificazione di cinque minuti.

Il pannello della coda mostra In attesa, Invio in corso, Inviato, Non riuscito, "Held", "Terminal" e "Suppressed". Usa Riprova eventi non riusciti dopo aver corretto l'errore segnalato. Gli eventi sospesi o soppressi aspettano dati dell'acquirente mancanti o sono stati fermati dal consenso o da una regola; risolvi quella causa invece di reinviare.

Invia evento di test al momento non invia nulla: mostra solo un messaggio che la modalità di test Microsoft non è disponibile. Per controllare il tracciamento, fai un ordine di prova, guarda la coda e usa gli strumenti diagnostici del tuo account Microsoft Advertising.

Questa configurazione è facoltativa e si trova sotto "Microsoft online refund and cancellation corrections".

Compila "Microsoft customer ID", "Microsoft account ID", "Developer token", "OAuth client ID", "OAuth client secret", "OAuth refresh token" e "Exact purchase conversion goal name". Questi campi partono vuoti. "Use Microsoft adjustments sandbox" parte disattivo.

L'interruttore "Enable online corrections" appare solo quando "Capture durable buyer evidence" è attivo, tutte le credenziali Microsoft e il nome dell'obiettivo d'acquisto sono compilati ed esiste per il negozio un collegamento salvato tra account Microsoft, tag UET e obiettivo d'acquisto. La schermata delle impostazioni non ha un campo per creare questo collegamento, quindi in un'installazione standard l'interruttore resta nascosto e rimborsi e annullamenti non vengono inviati a Microsoft.

Attiva Traccia gli eventi personalizzati e inserisci un array JSON in Regole degli eventi personalizzati. I nomi evento ammettono lettere, numeri, underscore e trattini, fino a 64 caratteri. Puoi usare fino a 15 nomi distinti e 30 parametri configurati per regola. Il modulo invia solo nomi di parametri UET supportati, tra cui event_category, event_label, event_value, value, currency e campi degli articoli e-commerce.

Regola di clic:

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

Regola URL:

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

Regola controller:

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

Regola evento DOM:

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

Il tema può generare l'evento corrispondente:

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

Usa queste regole configurate per le chiamate personalizzate. Il modulo non offre il vecchio helper window.mprbinguetTrack né legge i vecchi attributi data-mprbinguet-param-*. Le regole URL, controller e DOM partono una volta per pagina per impostazione predefinita; quelle di clic si ripetono. Imposta esplicitamente once quando necessario.

Controlla il pannello di preparazione dopo ogni modifica. Verifica ID tag, tracciamento browser, consenso, regole personalizzate e stato CAPI.

Usa un browser cliente separato. Concedi il consenso richiesto, apri un prodotto e controlla nel registro di rete lo script Microsoft UET a bat.bing.com/bat.js e gli eventi selezionati. Nega il consenso in una nuova prova e conferma che il tracciamento rimanga bloccato con la protezione attiva.

Prova un'aggiunta riuscita al carrello e alla wishlist. Un'azione fallita non deve diventare un evento e-commerce confermato. Se tema o checkout usano eventi personalizzati, verifica che forniscano il segnale di successo supportato.

Per gli acquisti, confronta riferimento della transazione, politica del valore, valuta e articoli con l'ordine. Controlla coda server e log oltre alle richieste del browser. È Microsoft a decidere quali conversioni accettare e riportare, quindi controlla i risultati anche nel tuo account Microsoft Advertising.

Se il tag non si carica, controlla attivazione principale, ID numerico positivo, consenso, esclusione dipendenti, opt-out e politica di titolarità del negozio. Controlla poi blocchi degli script ed errori del browser. Se CAPI resta in attesa, controlla il runner cron. Se è sospeso, controlla che l'acquirente abbia dato il consenso e che i suoi dati di checkout siano stati salvati. Se fallisce, controlla token e risposta prima di riprovare.

Disattiva tracciamento browser e server se vuoi solo sospendere la raccolta. Prima di disinstallare, salva le impostazioni e i registri di invio necessari. La disinstallazione rimuove menu, attività pianificata e configurazione del modulo. La tabella condivisa della coda conversioni viene eliminata solo se nessun altro modulo usa il pacchetto conversioni; i dati possono restare se un altro utilizzatore mantiene la tabella condivisa.

Richiede PrestaShop 1.6.0.0 o successivo e PHP 7.1 o successivo.