Magento 2

Integrazione di Fanplayr con il tuo negozio Magento 2

L'installazione delle estensioni per Magento 2 è leggermente più complessa rispetto a Magento 1.x e dovrebbe essere eseguita dal tuo sviluppatore. Richiede l'accesso alla riga di comando del tuo host del sito web o dell'ambiente di sviluppo.

Scarica l'Estensione

Attualmente, suggeriamo di scaricare l'estensione direttamente da qui:

https://cdn.fanplayr.com/integrations/magento2/packages/fanplayr_smartandtargeted-1.6.19.zip

Oppure da Packagist:

composer require fanplayr/smartandtargeted

Decomprimi in una directory temporanea

Decomprimi il contenuto dell'estensione in una directory temporanea. Sposta o carica la directory 'SmartAndTargeted' nella seguente posizione:

/app/code/Fanplayr/

Disabilita la Cache

Accedi alla tua area Admin, quindi vai su System / Tools / Cache Management. Seleziona tutti i tipi di cache, scegli "Disable" (Disabilita) dall'elenco a discesa, e poi Submit (Invia).

Console: Esegui Upgrade

Anche se hai copiato i file dell'estensione nella tua installazione di Magento 2, non saranno visibili finché il sistema non li scansionerà. Per fare ciò, a livello locale dovrai aprire la tua console, o su una macchina remota avrai bisogno dell'accesso al terminale.

Una volta nel terminale, vai alla root della tua installazione di Magento 2. Quindi esegui il seguente comando:

php ­bin/magento setup:upgrade

Questo aggiornerà il file app/etc/config.php con i dettagli del tuo nuovo modulo.

Questo processo potrebbe chiederti di rieseguire la compilazione di Magento. Se non sei in un ambiente di sviluppo, puoi farlo con il seguente comando:

php ­bin/magento setup:di:compile

Se riscontri errori di memoria, esegui come segue:

php -d memory_limit=-1 ­bin/magento setup:di:compile

Nota: Anche se il tuo negozio è in modalità sviluppatore, a volte potrebbe essere necessario eseguire la compilazione affinché Fanplayr finalizzi l'integrazione.

Aggiungi la tua Chiave Account Fanplayr

Nella tua area Admin vai su Stores / Settings / Configuration. Dovresti ora vedere una nuova opzione nel menu a sinistra, Fanplayr / Smart And Targeted.

Ora puoi inserire la Chiave Account fornita dal tuo account manager Fanplayr. Assicurati di cliccare su Save Config (Salva Configurazione).

Riabilita la Cache

Accedi alla tua area Admin, quindi vai su System / Tools / Cache Management. Seleziona tutti i tipi di cache, scegli "Enable" (Abilita) dall'elenco a discesa, e poi Submit (Invia).

Test / QA

Una volta installato Fanplayr, dovresti essere in grado di vedere la variabile fanplayr nella tua console Javascript. Se questa variabile è presente, dovremmo verificare che tutte le informazioni attese vengano tracciate su ogni tipo di pagina. Questo comporterà l'accesso al tipo di pagina specifico e quindi la verifica della variabile fanplayr nella tua console Javascript per controllare che i valori vengano tracciati.

Variabili specifiche della pagina (Tracciamento Utente)

La variabile specifica che vuoi controllare è la seguente:

fanplayr._i[0].data

Dovrebbe apparire come segue:

Pagina Iniziale

C'è solo una variabile che devi controllare qui, il pageType che dovrai controllare su ogni pagina.

• pageType: "home"

Pagina Categoria

Dovresti controllare alcune pagine di categoria per assicurarti che il tracciamento sia corretto. Le variabili che devi controllare:

• pageType: "cat"
• categoryId: Dovrebbe essere un numero
• categoryName: Dovrebbe essere il nome della categoria

Pagina Prodotto

Anche in questo caso, è una buona idea controllare alcune pagine di prodotto:

• pageType: "prod"
• productId: L'ID del prodotto.
• productImage: Un URL che punta all'immagine principale del prodotto.
• productName: Il nome del prodotto.
• productPrice: Il prezzo del prodotto. Nota che per le configurazioni VAT/GST mostrerà il prezzo al netto delle tasse.
• productSku: Lo SKU del prodotto.
• productUrl: Un URL che dovrebbe puntare a questa pagina prodotto.

Pagina Carrello

La configurazione per questo test è un po' più complessa. Per favore, fai quanto segue:

• Aggiungi almeno 2 prodotti
• Assicurati che uno di questi prodotti abbia almeno 2 (quantità) nel carrello.
• Applica un coupon al carrello.

I dettagli del carrello vengono tracciati su tutte le pagine, ma controlleremo la pagina del carrello stessa:

• pageType: "cart"
• discount: L'ammontare dello sconto applicato.
• discountCode: Il codice usato per lo sconto.
• lineItemCount: Il numero di articoli (righe) nel carrello.
• numItems: La quantità totale di articoli: numero di righe X quantità.
• subTotal: Il totale del carrello prima di sconti, spedizione o tasse.
• total: Il totale del carrello prima di spedizione o tasse, ma dopo lo sconto.
• products: Una rappresentazione JSON dei prodotti nel carrello inclusi i seguenti dettagli:
  • id
  • sku
  • name
  • price
  • qty
  • catId

Tracciamento Ordini

Per verificare che il tracciamento degli ordini funzioni, procedi effettuando un ordine di prova utilizzando la stessa configurazione che hai usato per il test della pagina del carrello sopra. Ovvero, assicurati di avere più prodotti e uno sconto applicato.

Una volta effettuato l'ordine, ti dovrebbe essere presentata una pagina "Thank You" (Grazie) o "Order Complete" (Ordine Completato). Su questa pagina dovresti essere in grado di vedere la seguente variabile nella tua console Javascript:

fp_sales_orders;

Se questa variabile è presente, tutto dovrebbe essere stato tracciato correttamente. Ora puoi accedere al tuo account Fanplayr e vedere l'ordine andando su:

• Account / Transactions

Nota che anche se le transazioni dovrebbero apparire abbastanza presto dopo essere state effettuate, il tracciamento delle sessioni richiederà un po' più di tempo per apparire nelle tue analisi. Ricontrolla che i dettagli in Account / Transactions siano corretti.

Offerte di Sessione

Fanplayr ha la capacità di limitare offerte specifiche ai tuoi utenti in modo che possano essere utilizzate solo una volta presentate da Fanplayr. Per maggiori dettagli, consulta la guida all'implementazione:

Session Offers

Per testare le Offerte di Sessione, crea un coupon con il prefisso che hai impostato nella tua configurazione Fanplayr.

• Applica questo coupon al tuo carrello. Dovrebbe fallire.
• Guarda la variabile Javascript fanplayr._i[0].sessionOfferUrl. Questo dovrebbe essere un URL come https://myshop.com/fanplayr/coupon/session/?coupon_code=%c includendo %c alla fine.
• In una nuova scheda vai a questo URL, sostituendo %c con il coupon che hai appena provato ad usare.
• Prova ad applicare di nuovo questo coupon. Dovrebbe ora essere applicato correttamente (date eventuali altre restrizioni che hai sul coupon, come l'acquisto minimo ecc.).

Se quanto sopra è tutto come previsto, sei a posto! Non esitare a contattarci per qualsiasi domanda tu possa avere.

Variabili Personalizzate Fanplayr e JS Pre-Esecuzione

A seconda della configurazione di Magento, potrebbe essere necessario definire variabili personalizzate che Fanplayr possa utilizzare. Queste sono definite in JS in window.fanplayr.custom.

Attualmente le variabili disponibili sono:

• embedUrl
• doNotTrack
• accountKey
• storeDomain
• applyToCartUrl
• sessionOfferUrl

[I dettagli su cosa fa ogni variabile arriveranno più avanti]

Poiché Magento 2 non consente facilmente di inserire JS che appaia su tutte le pagine come Magento 1, abbiamo aggiunto la possibilità di aggiungere uno snippet JS prima che qualsiasi codice specifico di Fanplayr venga incorporato.

Inserisci il codice andando su Stores / Settings / Configuration / Fanplayr / Smart and Targeted / Extras

Un esempio di JS che aggiungeresti per cambiare l'embedUrl è qui sotto:

Variabili Personalizzate

• embedUrl: Usala per sovrascrivere l'URL base predefinito che Fanplayr utilizzerà per accedere alle chiamate interne di Fanplayr.
• doNotTrack: Se impostato su qualsiasi valore "truthy" (vero), non verrà eseguito alcun tracciamento per questa pagina.
• accountKey: Usala per sovrascrivere la Chiave Account Fanplayr.
• storeDomain: Usala per sovrascrivere il dominio. Ad esempio, traccia il dominio per lingua.
• applyToCartUrl: Usala per sovrascrivere l'URL Apply To Cart. Potrebbe essere necessario impostarla se embedUrl cambia.
• sessionOfferUrl: Usala per sovrascrivere l'URL Session Offer. Potrebbe essere necessario impostarla se embedUrl cambia.