Sync Data

Personalizzazione dei dati del prodotto #

Inviare attributi semplici dall’amministrazione di Magento 2 #

Se gli attributi che desideri inviare sono già disponibili come attributi semplici nel tuo amministratore di Magento 2, possono essere facilmente aggiunti nella pagina dell’estensione.

1. Inizia andando su Negozi -> Prodotto

Qui puoi vedere tutti gli attributi disponibili nel tuo negozio. Trova i codici degli attributi di quelli che desideri inviare a Clerk.io:

2. Assicurati che il tuo attributo sia sia Visibile che utilizzato nelle liste dei prodotti. Puoi controllarlo cliccando sull’attributo e andando su Proprietà del Negozio:

3. Vai su Negozi->Configurazione->Clerk->Configurazione

4. Sotto Sincronizzazione -> Campi Aggiuntivi, scrivi i codici degli attributi separati da virgole :

5. Clicca su Salva Configurazione nell’angolo in alto a destra.

(*Se non riesci a trovare l’estensione Clerk, assicurati di selezionare il negozio giusto, cliccando su " Ambito" in alto a sinistra.)

6. Vai su Sistema -> Gestione Cache

7. Pulisci le varie cache qui:

8. Dopo aver implementato i tuoi attributi, vai su my.clerk.io->Dati e clicca su Inizia Nuova Sincronizzazione Dati nell’angolo in alto a destra.

Se gli attributi che desideri inviare sono già disponibili come parte dei dati dei tuoi prodotti configurabili/gruppati nel tuo amministratore di Magento2, possono essere facilmente sincronizzati nell’ultima versione del tuo plug-in. Appariranno come child_attribute, ad esempio, child_color, child_skus ecc.

Inviare attributi personalizzati #

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

Questo file gestisce gli attributi del 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 desideri abbia in Clerk.io, e MAGENTO2_LOGIC è il codice per estrarre l’attributo da Magento 2.

Importazione dei Dati dei Prodotti Semplici per Prodotti Configurabili #

Il codice sottostante può essere utilizzato per recuperare qualsiasi dato desideri dai prodotti semplici all’interno di un prodotto configurabile, in modo che Clerk.io possa riceverlo come un array di dati.

Questo è particolarmente utile per attributi come SKU, taglie o colori, per rendere questi dati ricercabili e filtrabili in Clerk.io.

Come nello script dell’attributo personalizzato sopra, i dati del prodotto per i prodotti configurabili possono essere aggiunti tramite l’estensione in FTP.

Questo file gestisce gli attributi del 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 desideri abbia in Clerk.io, e getATTRIBUTE_TEXT è la funzione get con il testo per l’attributo che stai chiamando, ad esempio $product->getSKU().

Infine, includi i tuoi nuovi attributi nell’estensione Clerk.io nell’amministrazione di Magento 2, sotto Sincronizzazione -> Campi Aggiuntivi.(Come spiegato al punto 4)

Dopo aver implementato i tuoi attributi, vai su my.clerk.io->Dati e clicca su Inizia Nuova Sincronizzazione Dati nell’angolo in alto a destra.

Personalizzazione dei dati dei clienti #

Come per i Prodotti, i Clienti sono rappresentati con attributi in Clerk.io.

Inviando gli attributi dei Clienti, puoi utilizzare Audience come Piattaforma di Dati Clienti(CDP) e creare Pubblici basati su qualsiasi attributo tu invii, come regione, genere, codici fiscali e così via.

Puoi leggere di più sul modo in cui Magento2 gestisce gli Attributi dei Clienti qui.

1. Inizia scoprendo quali attributi hai disponibili e quali sono i loro Codici Attributo. Puoi trovare questo nel backend di Magento2 su Negozi > Attributi > Cliente.

2. Una volta che hai i codici degli attributi che desideri, vai a:

Negozi > Impostazioni > Configurazione > Clerk > Configurazione > Sincronizzazione Clienti

3. In Attributi Clienti Aggiuntivi, aggiungi un elenco di attributi separati da virgole che desideri sincronizzare.

4. Clicca su Salva Configurazione.

5. Vai su my.clerk.io > Dati e clicca su Inizia Nuova Sincronizzazione Dati per sincronizzare i nuovi attributi:

Scelta dei prodotti da importare #

Per impostazione predefinita, l’estensione di Magento 2 importa solo prodotti che sono disponibili e vendibili.

Questo può essere cambiato se necessario.

Inclusione di prodotti esauriti o con visibilità specifiche #

Nel backend di Magento 2, vai su Negozi->Configurazione->Clerk->Configurazione.

Sotto Sincronizzazione Prodotti hai due opzioni per scegliere i prodotti da importare:

• Sincronizza solo prodotti vendibili ti consente di scegliere se inviare prodotti che non possono essere acquistati, ma sono comunque mostrati

• Sincronizza solo prodotti con visibilità ti consente di scegliere una visibilità specifica che i prodotti dovrebbero avere

Dopo aver apportato le modifiche, clicca su Salva Configurazione.

Se fai questo, ti consigliamo di aggiungere un attributo extra a Magento 2, che indica quando un prodotto non è vendibile, in modo da poterlo mostrare nel tuo Design.

Supponendo che tu crei un attributo chiamato is_saleable che sia true o false, puoi usarlo in questo modo in Design:

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

Quindi vai su my.clerk.io -> Sincronizzazione Dati e clicca su Inizia Sincronizzazione per sincronizzare con le nuove regole.

Aggiunta di regole personalizzate #

Il seguente file controlla quali prodotti vengono importati in Clerk.io:

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

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

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

Quindi vai su my.clerk.io -> Dati e clicca su Inizia Sincronizzazione Completa Dati per sincronizzare con le nuove regole.

Disattivare la sincronizzazione degli ordini #

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

Per disattivare la sincronizzazione degli ordini, accedi al tuo backend di Magento2, clicca su NEGOZI e poi su CONFIGURAZIONE:

Successivamente, scorri verso il basso e trova la scheda chiamata CLERK, clicca e premi CONFIGURAZIONE:

Clicca su SINCRONIZZAZIONE, cambia il campo DISABILITA SINCRONIZZAZIONE ORDINI in NO e premi SALVA in cima alla pagina:

Le modifiche hanno effetto immediato.