Esistono diversi modi per integrare il plugin nel vostro negozio Magento: attraverso il marketplace con composer. Composer è preferibile in quanto è più facile aggiornare alle nuove versioni e risolvere i problemi utilizzando l'interfaccia a riga di comando (CLI). Inoltre, le ultime versioni del plugin saranno disponibili prima su GitHub, quindi è possibile che il marketplace non abbia la versione più recente. Se possibile, si consiglia di utilizzare composer.

Dopo l'installazione del plug-in, è necessario tenere conto di alcuni passaggi, descritti di seguito.

Per prima cosa, accedere al back-end di Magento e andare a Negozi > Configurazione > Datatrics.

1. Il primo passo è verificare se la configurazione è stata eseguita correttamente. È possibile farlo cliccando sul pulsante blu Perform Testing.

Sullo schermo apparirà il self-test. Se tutto è stato impostato correttamente, tutti i controlli saranno superati.

Se non tutti i segni di spunta sono verdi, è necessario adottare ulteriori misure per il corretto funzionamento del plug-in.

1.1 Se la versione di PHP non è supportata, è necessario aggiornarla affinché il plug-in funzioni. Il requisito minimo è PHP 7.1.

1.2 Se il cron job non è in esecuzione, è necessario attivarlo. Il cron job può essere abilitato nelle impostazioni globali generali.

1.3 Se la versione di Magento non è supportata, purtroppo non è possibile utilizzare il plug-in. La versione deve essere almeno la 2.3.

1.4 Quando è disponibile una nuova versione del plug-in, installare e aggiornare la versione. L'ultima versione contiene gli aggiornamenti più recenti, che renderanno l'integrazione più efficiente. È possibile seguire questo link per scaricare l'ultima versione.

2. Nelle impostazioni del plug-in è sempre necessario inserire una chiave API e un projectid corretti. Dopo aver inserito l'id e la chiave API, fare clic sul pulsante grigio per convalidare le credenziali.

3. Se si gestiscono più progetti all'interno di Datatrics, è necessaria una chiave API che abbia accesso a tutti i progetti. Anche la modifica del projectid e del nome della fonte per ogni store view è essenziale. Se non si imposta correttamente questo aspetto, si creeranno problemi durante l'importazione dei dati.

Nell'angolo in alto a destra fare clic sul menu a tendina sotto Scope e passare alla storeview giusta.

In seguito, è possibile modificare le impostazioni del plugin per ogni storeview.

3.1 Quando si dispone di un progetto e di più store view, è indispensabile modificare l'ambito e regolare la configurazione per ogni store view, per evitare problemi con l'importazione dei dati e dei contenuti.

4. Se quanto sopra è impostato correttamente, i dati di vendita e di profilo saranno sincronizzati correttamente con Datatrics. Se necessario, è ancora possibile configurare il tipo di ordini e profili che si desidera sincronizzare. Quando si controlla la piattaforma Datatrics, si dovrebbero vedere i profili nella sezione del pubblico. Possono essere necessarie alcune ore prima che il segmento sia visibile nel frontend di Datatrics.

5. Per la sezione dei contenuti, è possibile impostare tutti i campi per ogni storeview che si desidera sincronizzare con Datatrics e aggiungerne altri. Tenere presente che questi campi devono essere disponibili nel catalogo. Se i campi sono personalizzati o un array/misura di campi diversi, il plug-in non sarà in grado di sincronizzarli.

5.1 Dopo aver configurato tutti i campi desiderati, è necessario invalidare tutti gli elementi e aggiornarli.

Invalidated items:

Update all invalid items:

Se la sincronizzazione è andata a buon fine, viene visualizzata una casella di controllo con il numero di elementi sincronizzati:

5.2 Se questa operazione non è stata eseguita correttamente, o se non tutti gli elementi sono stati aggiornati, potrebbe essere dovuto al limite di elaborazione. È possibile modificarlo nella parte superiore della sezione dei contenuti:

5.3 Se si aggiornano gli elementi e si vede una pagina bianca o non succede nulla, il modo migliore per risolvere il problema è utilizzare la CLI..

È possibile aggiornare manualmente i prodotti tramite la CLI utilizzando il seguente codice:

È essenziale impostare anche lo storeid del vostro negozio Magento. Si trova nell'ultima parte dell'URL quando si cambia la vista del negozio:

6. L'ultima parte del plugin Magento è il tracciamento. Il tracciamento viene attivato automaticamente quando si configura il plugin.

When you don’t have any tracking activity on your website, these settings can stay enabled. However, if you already have tracking on your website, for example, via Google Tag Manager (GTM), this will cause conflicts. The best way to go is to deactivate the tracking in either the plug-in or in GTM. Only one form of tracking can be active at one time.

Furthermore, if you use a one-page application, or a progressive web app, the standard tracking of the Magento 2 plug-in won’t suffice. You will then need to implement the tracking via GTM. You can read more information about that here.

When all the above steps are completed, the plug-in should run successfully on your website.