Sync Data

Synkroniser dine Magento 2-produkter, attributter og kundedata til Clerk. Denne guide dækker tilpasning af produkt- og kundedata, valg af hvilke produkter der skal importeres, og håndtering af ordresynkronisering.

Tilpasning af produktdata #

Afsendelse af simple attributter #

Hvis de attributter, du vil sende, allerede er tilgængelige som simple attributter i din Magento 2 admin, kan de nemt tilføjes på Extensionsiden.

1. Start med at gå til Stores -> Product

Her kan du se alle tilgængelige attributter i din shop.

Find attributkoderne på dem, du vil sende til Clerk:

2. Sørg for, at din attribut både er Visible og used in Product Listings.

Du kan tjekke dette ved at klikke på attributten og gå til Storefront Properties:

3. Gå til Stores->Configuration->Clerk->Configuration

4. Under Synchronization -> Additonal Fields, skriv attributkoderne adskilt af kommaer :

5. Klik på Save Config i det højre hjørne.

(*Hvis du ikke kan finde Clerk extension, så sørg for at du vælger den rigtige butik ved at klikke på " Scope" øverst til venstre.)

6. Gå til System -> Cache Management

7. Ryd de forskellige caches her:

8. Efter du har implementeret dine attributter, gå til my.clerk.io->Data og klik på Start New Data Sync øverst til højre.

Hvis de attributter, du vil sende, allerede er tilgængelige som en del af dine konfigurerbare/grupperede produktdata i din Magento2 admin, kan de nemt synkroniseres med den nyeste version af dit plug-in.

De vil fremstå som child_attribute, fx child_color, child_skus osv.

Afsendelse af brugerdefinerede attributter #

Brugerdefinerede attributter kan tilføjes via extensionen i FTP.

Denne fil håndterer produktattributterne:

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

Hver attribut har sin egen fieldHandler i funktionen addFieldHandlers()

Tilføj bare din attribut her med følgende syntaks:

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

Hvor CLERK_ATTRIBUTE_NAME definerer navnet, du ønsker, at det skal have i Clerk, og MAGENTO2_LOGIC er koden, der henter attributten fra Magento 2.

Import af simple produktdata #

Koden nedenfor kan bruges til at hente enhver data, du ønsker fra simple produkter inden for et konfigurerbart produkt, så Clerk kan modtage det som et array af data.

Dette er især nyttigt til attributter som SKUs, størrelser eller farver, så disse kan gøres søgbare og filtrerbare i Clerk.

Ligesom ovenstående script til brugerdefinerede attributter kan produktdata for konfigurerbare produkter tilføjes via extensionen i FTP.

Denne fil håndterer produktattributterne:

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

Tilføj følgende kode til filen:

{%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%}

Hvor CLERK_ATTRIBUTE_NAME definerer navnet, du ønsker, at det skal have i Clerk, og getATTRIBUTE_TEXT er get funktionen med teksten for den attribut, du kalder, fx $product->getSKU().

Til sidst skal du inkludere dine nye attributter i Clerk extensionen i Magento 2 admin under Synchronization -> Additional Fields. (Som beskrevet i punkt 4)

Efter at have implementeret dine attributter, gå til my.clerk.io->Data og klik på Start New Data Sync øverst til højre.

Tilpasning af kundedata #

Ligesom med produkter er kunder repræsenteret med attributter i Clerk.

Ved at sende kundeattributter kan du bruge Audience som en Customer Data Platform (CDP) og oprette Audiences baseret på enhver attribut, du sender, såsom region, gender, tax-codes osv.

Du kan læse mere om Magento2’s måde at håndtere kundeattributter på her.

1. Start med at finde ud af, hvilke attributter du har tilgængelige, og hvad deres Attribute Codes er.

Du kan finde dette i Magento2 backend under Stores > Attributes > Customer.

2. Når du har de ønskede attributkoder, gå til:

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

3. Under Extra Customer Attributes, tilføj en komma-separeret liste af de attributter, du ønsker at synkronisere.

4. Klik på Save Config.

5. Gå til my.clerk.io > Data og klik Start New Data Sync for at synkronisere de nye attributter:

Valg af produkter til import #

Som standard importerer Magento 2 extension kun produkter, der er på lager og salgbar.

Dette kan ændres efter behov.

Medtagelse af udsolgte produkter #

I Magento 2 backend, gå til Stores->Configuration->Clerk->Configuration.

Under Product Synchronization har du to muligheder for valg af de produkter, der skal importeres:

• Only synchronize saleable products lader dig vælge, om produkter der ikke kan købes, men stadig vises, skal sendes

• Only synchronize product with visibility lader dig vælge en specifik synlighed, produkterne skal have

Efter at have foretaget dine ændringer, klik på Save Config.

Hvis du gør dette, anbefaler vi også, at du tilføjer en ekstra attribut i Magento 2, som angiver, hvornår et produkt ikke er salgbar, så du kan vise det i dit Design.

Forudsat at du opretter en attribut kaldet is_saleable, som enten er true eller false, kan du bruge den sådan her i 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 %}

Gå derefter til my.clerk.io -> Data Sync og klik Start Sync for at synkronisere med de nye regler.

Tilføjelse af brugerdefinerede regler #

Følgende fil styrer, hvilke produkter der importeres til Clerk:

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

Nederst i denne fil findes funktionen prepareCollection().

Hvis nødvendigt kan du tilføje avancerede regler til denne funktion for at styre, hvilke produkter der sendes til os:

Gå derefter til my.clerk.io -> Data og klik på Start Full Data Sync for at synkronisere med de nye regler.

Deaktivering af ordresynkronisering #

Efter den første datasynkronisering er kørt succesfuldt, kan ordresynkronisering fra Magento2 deaktiveres, da salgs-tracking fra extensionen tager over.

For at deaktivere ordresynkronisering, gå ind i din Magento2 backend, klik på STORES og derefter CONFIGURATION:

Rul derefter ned og find fanen CLERK, klik og vælg CONFIGURATION:

Klik på SYNCHRONIZATION, ændr feltet DISABLE ORDER SYNCHRONIZATION til NO og tryk SAVE øverst på siden:

Ændringerne træder i kraft med det samme.