Sync Data

Sincronizza i tuoi prodotti, attributi e dati dei clienti di Magento 2 su Clerk. Questa guida spiega come personalizzare i dati di prodotto e cliente, scegliere quali prodotti importare e gestire la sincronizzazione degli ordini.

Personalizzazione dei dati prodotto #

Invio di attributi semplici #

Se gli attributi che desideri inviare sono già disponibili come attributi semplici nell’amministrazione di Magento 2, possono essere facilmente aggiunti nella pagina dell’Estensione.

1. Inizia andando su Store -> Product

Qui puoi vedere tutti gli attributi disponibili nel tuo shop.

Trova i codici attributo di quelli che vuoi inviare a Clerk:

2. Assicurati che il tuo attributo sia sia Visibile che utilizzato nelle Liste Prodotto.

Puoi verificarlo cliccando sull’attributo, e andando su Proprietà Storefront:

3. Vai su Stores->Configuration->Clerk->Configuration

4. Sotto Synchronization -> Additonal Fields, scrivi i codici attributo separati da virgole :

5. Fai clic su Save Config nell’angolo in alto a destra.

(*Se non riesci a trovare l’estensione Clerk, assicurati di aver selezionato il negozio corretto, cliccando su " Scope" in alto a sinistra.)

6. Vai su System -> Cache Management

7. Cancella le varie cache qui:

8. Dopo aver implementato i tuoi attributi, vai su my.clerk.io->Data e clicca su Start New Data Sync in alto a destra.

Se gli attributi che desideri inviare sono già disponibili come parte dei dati dei tuoi prodotti configurabili/raggruppati nell’amministrazione di Magento2, possono essere facilmente sincronizzati nell’ultima versione del tuo plug-in.

Appariranno come child_attribute, ad esempio, child_color, child_skus ecc.

Invio di attributi personalizzati #

Gli attributi personalizzati possono essere aggiunti tramite l’estensione in FTP.

Questo file gestisce gli attributi prodotto:

vendor->clerk->magento2->Model->Adapter->Product.php

Ogni attributo ha il proprio fieldHandler, nella funzione addFieldHandlers()

Aggiungi semplicemente il tuo attributo qui, con la seguente sintassi:

$this->addFieldHandler('CLERK_ATTRIBUTE_NAME', function($item) {
   return MAGENTO2_LOGIC;
});

Dove CLERK_ATTRIBUTE_NAME definisce il nome che vuoi abbia in Clerk, e MAGENTO2_LOGIC è il codice per estrarre l’attributo da Magento 2.

Importazione dei dati dei prodotti semplici #

Il codice seguente può essere utilizzato per recuperare qualsiasi dato tu voglia dai prodotti semplici all’interno di un prodotto configurabile, così che Clerk possa riceverlo come un array di dati.

Questo è particolarmente utile per attributi come SKU, taglie o colori, per renderli ricercabili e filtrabili in Clerk.

Come per lo script degli attributi personalizzati sopra, i dati dei prodotti per i prodotti configurabili possono essere aggiunti tramite l’estensione in FTP.

Questo file gestisce gli attributi prodotto:

vendor->clerk->magento2->Model->Adapter->Product.php

Aggiungi il seguente codice al file:

{%raw%}
$this->addFieldHandler('CLERK_ATTRIBUTE_NAME', function ($item) {
 $simple_products_array = [];
 if ($item->getTypeId() === Configurable::TYPE_CODE) {
  $simple_products = $item->getTypeInstance()->getUsedProducts($item);
   foreach ($simple_products as $product) {
    array_push($simple_products_array, $product->getATTRIBUTE_TEXT());
         }
       }
  return array_values(array_unique($simple_products_array));
            });
{%endraw%}

Dove CLERK_ATTRIBUTE_NAME definisce il nome che vuoi abbia in Clerk e getATTRIBUTE_TEXT è la funzione get con il testo relativo all’attributo che stai chiamando, ad esempio $product->getSKU().

Infine, includi i tuoi nuovi attributi nell’estensione Clerk dall’amministrazione di Magento 2, sotto Synchronization -> Additional Fields. (Come spiegato al punto 4)

Dopo aver implementato i tuoi attributi, vai su my.clerk.io->Data e clicca su Start New Data Sync in alto a destra.

Personalizzazione dei dati cliente #

Come per i prodotti, anche i clienti sono rappresentati con attributi in Clerk.

Inviando attributi Cliente, puoi usare Audience come Customer Data Platform (CDP) e creare Audiences in base a qualsiasi attributo inviato, come regione, genere, codici fiscali e altro.

Puoi leggere di più sul modo in cui Magento2 gestisce gli attributi cliente qui.

1. Inizia scoprendo quali attributi hai disponibili e quali sono i Codici Attributo.

Puoi trovarli nel backend Magento2 in Stores > Attributes > Customer.

2. Una volta che hai i codici attributo desiderati, vai su:

Stores > Settings **> Configuration > Clerk > Configuration > Customer Synchronization**

3. In Extra Customer Attributes, aggiungi una lista di attributi separati da virgola che vuoi sincronizzare.

4. Clicca su Save Config.

5. Vai su my.clerk.io > Data e clicca su Start New Data Sync per sincronizzare i nuovi attributi:

Scelta dei prodotti da importare #

Per impostazione predefinita, l’estensione Magento 2 importa solo i prodotti disponibili in stock e vendibili.

Questo può essere modificato se necessario.

Inclusione dei prodotti esauriti #

Nel backend Magento 2, vai su Stores->Configuration->Clerk->Configuration.

Sotto Product Synchronization hai due opzioni per scegliere i prodotti da importare:

• Only synchronize saleable products ti permette di scegliere se inviare prodotti non acquistabili ma ancora visualizzati

• Only synchronize product with visibility ti permette di scegliere una specifica visibilità che i prodotti devono avere

Dopo aver apportato le modifiche, clicca su Save Config.

Se scegli questa opzione, ti consigliamo anche di aggiungere un attributo extra su Magento 2 che indichi quando un prodotto non è vendibile, così da poterlo mostrare nel tuo Design.

Supponendo che tu crei un attributo chiamato is_saleable che può essere true o false, puoi usarlo così nei Designs:

{% raw %}
{% if product.is_saleable %}
   <div class="in-stock">In Stock</div>
{% else %}
  <div class="not-in-stock">Not In Stock</div>
{% endif %}
{% endraw %}

Poi vai su my.clerk.io -> Data Sync e clicca su Start Sync per sincronizzare con le nuove regole.

Aggiunta di regole personalizzate #

Il file seguente controlla quali prodotti vengono importati su Clerk:

vendor->clerk->magento2->Model->Adapter->Product.php

In fondo a questo file, individua la funzione chiamata prepareCollection().

Se necessario, puoi aggiungere regole avanzate a questa funzione, per controllare quali prodotti inviare:

Quindi vai su my.clerk.io -> Data e clicca su Start Full Data Sync per sincronizzare con le nuove regole.

Disattivare la sincronizzazione ordini #

Dopo che la prima sincronizzazione dei dati è stata completata con successo, la sincronizzazione degli ordini da Magento2 può essere disattivata poiché il monitoraggio delle vendite dell’estensione prende il sopravvento.

Per disattivare la sincronizzazione ordini, entra nel backend di Magento2, clicca su STORES e poi su CONFIGURATION:

Poi scorri in basso e trova il tab chiamato CLERK, clicca e poi vai su CONFIGURATION:

Clicca su SYNCHRONIZATION, cambia il campo DISABLE ORDER SYNCHRONIZATION su NO e premi SAVE in cima alla pagina:

Le modifiche hanno effetto immediato.