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.

Før du synkroniserer data, skal du sikre dig, at du har installeret og konfigureret Clerk-udvidelsen i din Magento 2-backend. Se Kom i gang-guiden for installationsinstruktioner.

Opsæt synkronisering #

For at synkronisere din Magento 2-butik med Clerk, skal du konfigurere synkroniseringsindstillingerne i Clerk.

1. Gå til my.clerk.io > Data > Configuration.

2. Indtast din webshop-URL og eventuelle ønskede indstillinger.

3. Hvis du planlægger at bruge Email & Audience, sæt Collect Emails til Ja i Magento-udvidelsen og tryk Gem.

4. Vælg sproget for dit domæne, hvis relevant.

5. Klik på Start Sync og vent på, at synkroniseringen gennemføres.

Din butik er nu forbundet til Clerk.

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å Udvidelsessiden.

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

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

Find attributkoderne for dem, du vil sende til Clerk:

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

Dette kan du tjekke 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 komma :

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

(*Hvis du ikke kan finde Clerk-udvidelsen, skal du sikre dig, at du vælger den rigtige butik ved at klikke på “Scope” i øverste venstre hjørne.)

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 Start New Data Sync i øverste højre hjørne.

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

De vil blive vist som child_attribute, for eksempel child_color, child_skus osv.

Afsendelse af brugerdefinerede attributter #

Brugerdefinerede attributter kan tilføjes gennem udvidelsen i FTP.

Denne fil håndterer produktattributter:

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

Hver attribut har sin egen fieldHandler i funktionen addFieldHandlers()

Tilføj blot 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, den skal have i Clerk, og MAGENTO2_LOGIC er koden til at hente attributten fra Magento 2.

Import af simple produktdata #

Koden nedenfor kan bruges til at hente de 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 for attributter som SKUs, størrelser eller farver, for at gøre dem søgbare og filtrerbare i Clerk.

Ligesom ovenstående script til brugerdefinerede attributter kan produktdata for konfigurerbare produkter tilføjes gennem udvidelsen 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, den skal have i Clerk, og getATTRIBUTE_TEXT er get-funktionen med teksten for den attribut, du kalder, for eksempel $product->getSKU().

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

Efter du har implementeret dine attributter, gå til my.clerk.io->Data og klik Start New Data Sync i øverste højre hjørne.

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å alle de attributter, du sender, såsom region, gender, tax-codes osv.

Du kan læse mere om Magento2’s håndtering af kundeattributter her.

1. Begynd med at finde ud af, hvilke attributter du har tilgængelige, og hvad deres attributkoder er.

Du finder 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 kommasepareret liste over de attributter, du vil 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 der skal importeres #

Som standard importerer Magento 2-udvidelsen kun produkter, der er på lager og kan sælges.

Dette kan ændres hvis nødvendigt.

Inkludér udsolgte produkter #

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

Under Product Synchronization har du to muligheder for at vælge hvilke produkter der skal importeres:

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

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

Efter du har foretaget dine ændringer, klik på Save Config.

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

Antag, at du opretter en attribut kaldet is_saleable, som enten er true eller false, kan du bruge den således 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

I bunden af denne fil skal du finde funktionen prepareCollection().

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

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

Deaktiver ordresynkronisering #

Når den første datasynkronisering er gennemført med succes, kan ordresynkronisering fra Magento2 deaktiveres, da salgs-tracking fra udvidelsen overtager.

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

Rul derefter ned og find tab’en med navnet CLERK, klik og tryk på CONFIGURATION:

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

Ændringerne træder i kraft med det samme.