X Pixel + Web Conversions API: configurazione e aiuto

1. Carica e installa lo ZIP in Moduli > "Module Manager", poi apri X Pixel + Web Conversions API > "Configure".
2. Inserisci ID Pixel X in Impostazioni Pixel X.
3. Inserisci i veri "ViewContent Event ID", ID evento acquisto e gli ID delle altre conversioni che intendi attivare.
4. Controlla gli interruttori degli eventi "Track", attiva "Enable X Pixel" e fai clic su Salva.
5. Concedi il consenso marketing in un normale browser visitatore e apri una pagina prodotto.
6. Verifica che uwt.js si carichi e che l'evento ViewContent configurato venga emesso.
7. Se usi Web Conversions API, configura tutte e quattro le credenziali OAuth e verifica un evento idoneo tramite la coda e il task send_x_conversions.

• "Enable X Pixel". Interruttore principale del monitoraggio X nel browser; predefinito: 0. Impostalo nella pagina di configurazione del modulo dopo aver inserito un "Pixel ID" valido.

• ID Pixel X. ID origine eventi da "X Events Manager"; predefinito: empty. Accetta lettere, numeri, trattini bassi e trattini.

• "Exclude employees". Blocca l'inserimento del monitoraggio mentre un dipendente connesso al back office visita il negozio; predefinito: 1.

• "Respect cookie consent". Attende il consenso marketing quando è attivo mprcookiesrevolution o mprcookiebanner; predefinito: 1.

• "Track PageView". Consente alla chiamata di configurazione base X Pixel di registrare le visite; predefinito: 1.

• "Track ViewContent". Invia eventi di visualizzazione sulle pagine prodotto quando è configurato un "ViewContent Event ID"; predefinito: 1.

• "Track AddToCart". Invia eventi di aggiunta al carrello da aggiunte riuscite e confermate; predefinito: 1.

• "Track StartCheckout". Invia eventi di avvio checkout quando PrestaShop rileva la pagina iniziale del checkout e il carrello contiene prodotti; predefinito: 1.

• "Track Purchase". Invia eventi di acquisto alla conferma e alla validazione dell'ordine; predefinito: 1.

• "Track Search". Invia eventi di ricerca sul controller di ricerca PrestaShop quando è presente una query; predefinito: 1.

• "Track AddToWishlist". Invia eventi della lista desideri da segnali di successo confermati; predefinito: 1.

• "Track SignUp". Invia eventi di registrazione dopo la creazione di un account cliente; predefinito: 1.

• "ViewContent Event ID". ID evento X per conversioni di visualizzazione prodotto; predefinito: empty.

• "AddToCart Event ID". ID evento X per conversioni di aggiunta al carrello; predefinito: empty.

• "StartCheckout Event ID". ID evento X per conversioni di avvio checkout; predefinito: empty.

• ID evento acquisto. ID evento X per conversioni di acquisto; predefinito: empty. Obbligatorio con il monitoraggio acquisti attivo.

• "Search Event ID". ID evento X per conversioni di ricerca; predefinito: empty.

• "AddToWishlist Event ID". ID evento X per conversioni della lista desideri; predefinito: empty.

• "SignUp Event ID". ID evento X per conversioni di creazione account; predefinito: empty.

• "Track custom events". Attiva il campo delle regole JSON degli eventi personalizzati; predefinito: 0.

• Regole eventi personalizzati. Array JSON che definisce regole di conversione per clic, URL, controller o eventi DOM; predefinito: empty.

• "Enable Web Conversions API events". Accoda gli eventi server idonei e li invia a X Ads API quando le credenziali sono complete; predefinito: 0.

• Chiave API X. Chiave consumer OAuth 1.0a per X Ads API; predefinito: empty.

• Segreto API X. Segreto consumer OAuth 1.0a per X Ads API; predefinito: empty.

• Token di accesso X. Token di accesso OAuth 1.0a per X Ads API; predefinito: empty.

• Segreto del token di accesso X. Segreto del token di accesso OAuth 1.0a per X Ads API; predefinito: empty.

• "Test twclid". ID clic di test facoltativo conservato; la prova attuale rifiuta l'invio; predefinito: empty.

• "X Ads API version". Versione numerica API usata nell'endpoint X Ads API; predefinito: 12.

• "Send IP and user agent match keys". Consente indirizzo IP e user agent insieme come identificatori di corrispondenza quando autorizzato; predefinito: 1.

• "Queue batch limit". Massimo di eventi di conversione in coda elaborati per esecuzione, da 1 a 100; predefinito: 20.

• "Persist consent withdrawals". Predefinito: 0. Attiva il veto persistente di revoca del consenso marketing per le conversioni in coda.

Fai clic su Salva dopo le modifiche. ID Pixel X richiede da 3 a 128 lettere, numeri, trattini bassi o trattini. Inserisci l'ID evento configurato nell'account per ogni conversione attivata. I campi ID evento sono vuoti per impostazione predefinita. Identificano la definizione di conversione e sono distinti dal conversion_id di ogni occorrenza usato per la deduplicazione.

Il form attuale espone anche queste impostazioni. Tutti gli interruttori dei segnali sono su No per impostazione predefinita. Attiva solo le azioni che intendi osservare.

Le soglie condivise sono tre visualizzazioni della galleria, un cambio variante, un clic sui dettagli, 45 secondi di permanenza e un intervallo minimo di 1500 ms per le opzioni. I conteggi di galleria, varianti e dettagli sono limitati da 1 a 20. La permanenza è limitata da 5 a 600 secondi. L'intervallo è limitato da 250 a 60000 ms. Per esempio:

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

Puoi anche fornire gallery_selectors, variant_selectors e detail_selectors. Mantieni i valori predefiniti se il tema non richiede selettori diversi. Questi segnali facoltativi richiedono controlli di consenso, criteri relativi ai dipendenti e titolarità del monitoraggio come gli eventi commerciali.

Mantieni attive le impostazioni di consenso ed esclusione dipendenti durante la configurazione iniziale. Prova da un normale browser visitatore non contrassegnato come dipendente. Una sessione back office connessa, una regola di traffico interno o la rinuncia del visitatore può impedire il monitoraggio.

Il livello di consenso condiviso supporta le integrazioni MPR e altri adattatori CMP. Deve ottenere una decisione marketing utilizzabile per la destinazione. Una decisione sconosciuta, scaduta o negativa può trattenere gli eventi. Il modulo non fornisce un banner cookie. Una preferenza di consenso precedente non prevale su un rifiuto attuale di una CMP rilevata.

Il modulo deve essere titolare della destinazione configurata nel coordinatore di monitoraggio condiviso. Una titolarità assente, ambigua o in conflitto può trattenere gli invii browser e server. Rimuovi i tag duplicati nel tema o risolvi la titolarità quando un altro modulo MPR gestisce lo stesso account.

L’invio in produzione segue anche i criteri di uscita. Un evento mostrato in demo o anteprima non viene necessariamente consegnato al tuo account pubblicitario. Gli acquisti e gli eventi dei moduli lato server vengono inviati solo con il consenso dato dall’acquirente in quel momento; un’esecuzione cron successiva non può sostituirlo.

Il runtime carica https://static.ads-twitter.com/uwt.js e usa twq. Il PageView base usa la chiamata di configurazione Pixel. Gli altri eventi attivi richiedono i rispettivi ID evento X associati. Un ID Pixel valido da solo non configura conversioni di prodotto, carrello, checkout, acquisto, ricerca, lista desideri o registrazione.

Il modulo usa hook header e media per la configurazione, conferma ordine per l'acquisto browser, validazione ordine per registrare il consenso dell'acquirente e mettere in coda l'invio server idoneo, e creazione account per il successivo evento di registrazione idoneo. Le richieste private legano i dati di checkout e registrazione alla sessione visitatore nativa. Gli hook footer gestiscono moduli di contatto riusciti. I marcatori dipendenti vengono aggiornati tramite hook back office e dispatcher.

StartCheckout richiede una pagina iniziale checkout rilevata e un contesto carrello utilizzabile. Le ricerche richiedono una query disponibile. Gli eventi automatici carrello richiedono un aumento di quantità riuscito. Gli eventi lista desideri richiedono aggiunte riuscite e confermate.

Un clic pubblicitario valido twclid viene salvato come mprxpix_twclid con durata del cookie di 90 giorni. L'API X può usare anche altri identificatori di corrispondenza autorizzati, inclusi IP e user agent insieme se attivi. Un ID clic non è l'unica chiave di corrispondenza server possibile.

Attiva "Track custom events", incolla un array JSON in Regole eventi personalizzati e salva. Adatta selettori e percorsi al negozio. Usa i trigger click, url, controller o event. Una regola controller può includere anche una lista modules. I nomi consentono lettere, numeri, trattini bassi e trattini, fino a 64 caratteri. Il limite è di 15 nomi distinti. once limita una regola nell'esecuzione della pagina corrente.

[
  {
    "event": "GalleryBrowse",
    "trigger": "click",
    "selector": ".product-images img,.images-container img",
    "params": {
      "property": "product_gallery"
    },
    "once": false,
    "x_event_id": "tw-replace-with-real-event-1",
    "capi": true
  },
  {
    "event": "LandingView",
    "trigger": "url",
    "contains": [
      "/special-offer"
    ],
    "params": {
      "property": "special_offer"
    },
    "once": true,
    "x_event_id": "tw-replace-with-real-event-2",
    "capi": true
  },
  {
    "event": "ContactView",
    "trigger": "controller",
    "controllers": [
      "contact"
    ],
    "params": {
      "property": "contact_page"
    },
    "once": true,
    "x_event_id": "tw-replace-with-real-event-3",
    "capi": true
  },
  {
    "event": "SizeGuideOpen",
    "trigger": "event",
    "dom_event": "mprxpix:custom",
    "params": {
      "property": "size_guide"
    },
    "once": false,
    "x_event_id": "tw-replace-with-real-event-4",
    "capi": true
  }
]

Attiva la regola DOM dal tema dopo l'inizializzazione del monitoraggio:

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

Sostituisci ogni x_event_id di esempio con il tuo vero ID evento X. Il runtime invia il nome personalizzato e il target configurati. Le regole URL corrispondono al percorso della pagina, anziché a stringhe di query come utm_campaign=x. Usa i parametri configurati della regola per i dati evento statici supportati. Il gestore attuale non unisce valori DOM arbitrari di detail.params e data-x-param-*.

I nomi comuni degli eventi in ingresso vengono normalizzati in tipi interni. ViewContent corrisponde a view_item; AddToCart a add_to_cart; StartCheckout e InitiateCheckout a begin_checkout; Purchase e CompletePayment a purchase; Search a search; AddToWishlist a add_to_wishlist; SignUp e CompleteRegistration a sign_up.

Il task send_x_conversions è registrato con pianificazione every:300. Risulta dovuto ogni cinque minuti. Il runner cron MPR condiviso deve eseguire i task dovuti; la sola dichiarazione non avvia un worker. Il limite del lotto limita le righe della coda per esecuzione da 1 a 100, con 20 come predefinito.

Il modulo non include un punto di ingresso autonomo cron.php. Usa lo scheduler condiviso già configurato per il negozio. Conferma lì l'esecuzione dei task e controlla date, orari e stato della coda nella pagina di configurazione del modulo.

La diagnostica include controlli di prontezza, contatori della coda, righe recenti, Invia prova API e Riprova eventi non riusciti. Risolvi la causa dell'errore prima di riprovare. Riportare le righe non riuscite in attesa non aggira i controlli attuali di consenso, criteri relativi ai dipendenti, titolarità dell'account o destinazione.

Configura tutte e quattro le credenziali OAuth 1.0a per Web Conversions API. Il client usa https://ads-api.x.com/{version}/measurement/conversions/{pixel_id} con la versione numerica "X Ads API version". Il valore installato è 12; cambialo solo nella versione richiesta dal tuo account e dall'integrazione API distribuita.

Il pulsante visibile Invia prova API rifiuta l'invio perché non è disponibile una modalità test o un codice evento test verificato. Compilare "Test twclid" non abilita un invio di prova. Usa invece un evento reale autorizzato e ispeziona il risultato della consegna.

1. Controlla "Pixel ID", ogni ID evento attivo, gli avvisi di configurazione richiesta, la prontezza, l'integrità e la titolarità.
2. Concedi il consenso marketing da un normale browser visitatore.
3. Apri un prodotto e conferma uwt.js e l'evento per il tuo "ViewContent Event ID".
4. Esegui un'aggiunta al carrello riuscita e conferma il relativo evento associato.
5. Per un ordine di prova, ispeziona il conversion_id dell'occorrenza e il risultato della coda dove l'invio server è attivo.
6. Conferma l'esecuzione del task cron condiviso e controlla i registri eventi della piattaforma stessa.

Se il monitoraggio base funziona ma le conversioni no, controlla gli ID evento. Se non si carica nulla, controlla stato dipendente e consenso, titolarità, politica in uscita, snippet twq o SDK duplicati e blocchi browser. Se la coda server fallisce, controlla tutte e quattro le credenziali, versione API, dati di corrispondenza ed esecuzioni dello scheduler. Una configurazione JSON di coinvolgimento vuota o non valida può bloccare il runtime fino alla correzione.

Il runtime attuale non espone window.mprxpixTrack. Usa regole configurate e trigger DOM supportati per le tue integrazioni.

Disattiva gli interruttori browser e server e salva per interrompere il monitoraggio conservando la configurazione. Disinstalla da "Module Manager" per rimuovere impostazioni del modulo, voci di menu e task registrati.

La disinstallazione richiama la pulizia condivisa della coda conversioni. La tabella condivisa viene conservata finché un altro modulo conversioni la usa e può essere eliminata quando viene rimosso l'ultimo utilizzatore. Esporta la diagnostica necessaria prima di disinstallare. Non presumere che la disinstallazione elimini gli eventi già inviati alla piattaforma pubblicitaria o cancelli tutta l'archiviazione di attribuzione del browser.

Richiede PrestaShop 1.6 o successivo e PHP 7.1 o successivo.