Magento 2-datareferentie

Ontdek welke gegevens Klaviyo uit je Magento 2-winkel importeert wanneer je de twee platforms integreert. Klaviyo's integratie met Magento 2 haalt alle historische gegevens uit je Magento 2-winkel op met de eerste historische synchronisatie. Zodra de integraties zijn ingeschakeld, begint de integratie ook elke 30 minuten bestel- en klantgegevens te synchroniseren. Voorbeelden van deze gegevens zijn de informatie die gekoppeld is aan eerder geplaatste bestellingen, afgehandelde bestellingen, enz.

In Klaviyo kun je in de linkerzijbalk naar het tabblad Analytics van je account navigeren om alle meetwaarden in je account te bekijken; de meetwaarden met een Magento 2-pictogram zijn de bestelgebeurtenissen die zijn gesynchroniseerd vanuit je Magento 2-integratie. Je ziet ook Klaviyo onsite tracking-gebeurtenissen met een tandwielpictogram; deze worden ook bijgehouden via de integratie.

Hoe Klaviyo Magento 2-meetwaarden bepaalt

Meetwaarden voor bestellingen

Magento 2-ordermeetwaarden worden bepaald door het veld Status in een bestelling in je Magento 2-store.

Elke keer dat een bestelling wordt aangemaakt of dat de status ervan wordt bijgewerkt, wordt deze beoordeeld aan de hand van de matrix hieronder om te bepalen welke gebeurtenissen moeten worden geactiveerd.

Als je aangepaste bestelstatussen hebt die geen Bestelling geplaatst meetwaarde zouden moeten activeren, of niet overeenkomen met de bovenstaande tabel, laat het ons weten en dan kunnen we de mapping van de bestelstatus dienovereenkomstig aanpassen in je integraties.

Bestellingen met de status “pending_payment” worden genegeerd.

Meetwaarde Is begonnen met afrekenen

Met een standaard Magento-checkout wordt deze gebeurtenis geactiveerd wanneer een klant zijn contact- en verzendgegevens invoert op de eerste pagina van het Magento-afrekenproces en op Doorgaan klikt.

De gebeurtenis Started Checkout is afhankelijk van het aanmaken van een 'Quote' waaraan een e-mailadres is gekoppeld. Dit gebeurt nadat de klant zijn of haar e-mailadres heeft ingevoerd in de fase 'Shipping Information' van het afrekenen. Als een klant het afrekenen niet voltooit, wordt deze quote naar Klaviyo gesynchroniseerd als een gebeurtenis Started Checkout.

Als de klant doorgaat met het voltooien van de bestelling, wordt deze offerte omgezet naar een ‘factuur’ in de database van Magento. Hierdoor wordt er geen Started Checkout -event naar Klaviyo verzonden. In plaats daarvan wordt er een Placed Order -event verzonden. Houd er rekening mee dat het tot 1 uur kan duren voordat Started Checkout -events met Klaviyo worden gesynchroniseerd.

Meetwaarde Verzending uitgevoerd

Deze meetwaarde wordt geactiveerd wanneer er een nieuwe zending wordt aangemaakt in je Magento 2-webshop.

Magento 2-meetwaardengegevens

In deze sectie worden alle Magento 2-meetwaarden behandeld en de gegevens die beschikbaar zijn om op te filteren bij het maken van segmenten en flows.

Bestelling Geannuleerd

Deze gebeurtenis wordt geactiveerd wanneer de status van een bestelling wordt gewijzigd naar geannuleerd of geannuleerd in je Magento 2-webshop.

• ProductCategories
  De categorieën van de producten in de geannuleerde bestelling.
• Value
  De waarde van de geannuleerde bestelling.
• Met korting
  (True of False) De kortingsstatus van de geannuleerde bestelling.
• OrderedProducts
  De namen van de producten in de geannuleerde bestelling.
• OrderedProductCount
  Het aantal producten in de geannuleerde bestelling.
• OrderCurrencyCode
  De valutacode die wordt gebruikt bij de geannuleerde bestelling.
• CartPriceRuleIDs
  Een array van cart price rule-ID's (numerieke id-strings) die automatisch toegepaste regels bevat en de regel voor een toegepaste coupon.
• external_catalog_id
  Gebruikt voor het organiseren van je catalogus in Klaviyo.

Bestelling Afgerond

Deze gebeurtenis wordt bijgehouden wanneer je een bestelstatus instelt op voltooid in je Magento 2-webshop.

• ProductCategories
  De categorieën van de producten in de bestelling.
• Waarde
  De waarde van de bestelling.
• Met korting
  Of de bestelling met korting is of niet.
• OrderedProducts
  De namen van de producten in de bestelling.
• AantalBesteldeProducten
  Het aantal producten in de bestelling.
• OrderCurrencyCode
  De valutacode die bij de bestelling wordt gebruikt.
• external_catalog_id
  Gebruikt voor het organiseren van je catalogus in Klaviyo.

Verzending Uitgevoerd

Deze gebeurtenis wordt bijgehouden wanneer er een nieuwe zending wordt aangemaakt in je Magento 2-webshop.

• StoreName
  De naam van de winkel waar de bestelling is geplaatst.
• StoreID
  De ID van de winkel waar de bestelling is geplaatst.
• BillingAddress
  Het factuuradres voor de bestelling.
• Tracking
  Informatie over het volgen van zendingen.
• external_catalog_id
  Gebruikt voor het organiseren van je catalogus in Klaviyo.

Product Besteld

Deze gebeurtenis wordt één keer bijgehouden voor elk product dat een gebruiker bestelt wanneer hij of zij een bestelling plaatst.

• SKU
  De SKU van het product.
• OrderCurrencyCode
  De valutacode van het product.
• Prijs
  De waarde van het product.
• Categorieën
  De categorie van het product.
• Met korting
  Alle kortingen die op het product zijn toegepast.
• Aantal
  Het aantal producten.
• Waarde
  De waarde van het product.
• ProductID
  De ID van het product.
• RootProductID
  De ID van het bovenliggende product.
• external_catalog_id
  Gebruikt voor het organiseren van je catalogus in Klaviyo.

Bestelling geplaatst

Deze gebeurtenis wordt bijgehouden wanneer een gebruiker een bestelling plaatst.

• ProductCategories
  De categorieën van de producten in de bestelling.
• Waarde
  De waarde van de bestelling.
• Met korting
  Of de bestelling met korting is of niet.
• OrderedProducts
  De namen van de producten in de bestelling.
• AantalBesteldeProducten
  Het aantal producten in de bestelling.
• OrderCurrencyCode
  De valutacode die bij de bestelling wordt gebruikt.
• CartPriceRuleIDs
  Een array van cart price rule-ID's (numerieke id-strings) die automatisch toegepaste regels bevat en de regel voor een toegepaste coupon.
• external_catalog_id
  Gebruikt voor het organiseren van je catalogus in Klaviyo.

Bestelling Terugbetaald

Deze gebeurtenis wordt geactiveerd wanneer een klant een bestelling terugbetaalt.

• Waarde
  De waarde van de bestelling.
• Met korting
  Of de bestelling met korting is of niet.
• OrderedProducts
  De namen van alle producten in de bestelling.
• AantalBesteldeProducten
  Het aantal producten in de bestelling.
• OrderCurrencyCode
  De valutacode die bij de bestelling wordt gebruikt.
• ProductCategories
  De categorieën van de producten in de bestelling.
• CartPriceRuleIDs
  Een array van cart price rule-ID's (numerieke id-strings) die automatisch toegepaste regels bevat en de regel voor een toegepaste coupon.
• external_catalog_id
  Gebruikt voor het organiseren van je catalogus in Klaviyo.

Is begonnen met afrekenen

Deze gebeurtenis wordt geactiveerd wanneer een klant met een bekend e-mailadres een checkout start. Op een standaard afrekenpagina wordt deze gebeurtenis geactiveerd wanneer een klant hun contact- en verzendgegevens invult op de eerste pagina van het Magento-afrekenproces en op Doorgaan klikt. Er wordt geen Started Checkout -gebeurtenis naar Klaviyo gestuurd als de gebruiker het afrekenen voltooit. In plaats daarvan wordt een Placed Order -gebeurtenis gelogd.

• Waarde
  De waarde van de bestelling tijdens het afrekenen.
• ItemCount
  Het aantal artikelen in de bestelling.
• Artikelen
  De artikelen in de bestelling.
• ProductCategories
  De categorieën van de producten in de bestelling.
• ProductNames
  De namen van de producten in de bestelling.
• StoreName
  De naam van de winkel waar de bestelling is gestart.
• StoreID
  De ID van de winkel waar de bestelling is gestart.
• external_catalog_id
  Gebruikt voor het organiseren van je catalogus in Klaviyo.

Toegevoegd aan Winkelwagen

Let op: deze meetwaarde wordt alleen bijgehouden als je Klaviyo-extensie versie 4.0.0 of hoger gebruikt. Deze meetwaarde wordt bijgehouden wanneer een klant voor wie Klaviyo een cookie heeft geplaatst een item aan de winkelwagen toevoegt.

Het bevat gedetailleerde informatie over het item dat is toegevoegd. Dit is handig bij het maken van segmenten op basis van welke producten gebruikers aan hun winkelwagen hebben toegevoegd, of bij het bouwen van een flow voor een winkelwagen verlaten. Je kunt Added To Cart -meetwaarde filteren en targeten op basis van de volgende criteria:

• MaskedQuoteId
  MaskedQuoteId of unieke identificatiecode voor ingelogde klanten.
• AddedItemCategories
  De categorieën waartoe het item behoort.
• AddedItemProductName
  De naam van het product in je winkel (bijv. Rood T-shirt).
• AddedItemDescription
  De beschrijving van het item.
• AddedItemImageURLKey
  De URL van de afbeelding van het item.
• AddedItemPrice
  De prijs van het item.
• AddedItemProductID
  De aangepaste ID in je Magento 2-store van het product, bijvoorbeeld 1234.
• AddedItemSKU
  De SKU van het item in je winkel (bijv. REDMEDIUMTSHIRT).
• AddedItemURL
  De URL van het item.
• external_catalog_id
  Gebruikt voor het organiseren van je catalogus in Klaviyo.
• integration_key
  Je e-commerceplatform (Magento 2).

Klaviyo genereert een sleutel, de sleutel voor het opnieuw opbouwen van de winkelwagen, waarmee je een link kunt maken die de winkelwagen van de klant opnieuw opbouwt als die via een e-mail die door deze gebeurtenis wordt geactiveerd op een ander apparaat terugkeert naar de winkelwagen. Deze sleutel is te vinden in de array met eigenschappen 'extra'. Je kunt deze link maken met de volgende URL:

{{ organization.url|trim_slash }}reclaim/checkout/cart?quote_id={{ event.MaskedQuoteId }}

Product bekeken

Deze meetwaarde wordt bijgehouden wanneer een klant een product op je site bekijkt. Je kunt Product bekeken -meetwaarden filteren en targeten op basis van de volgende criteria:

• ProductID
  De ID van het product.
• Naam
  De naam van het product.
• SKU
  De SKU voor het product.
• URL
  De URL voor het product.
• Prijs
  De prijs van het product.
• FinalPrice
  De uiteindelijke prijs na eventuele kortingen.
• Categorieën
  Een array met de categorieën waartoe het product behoort.
• Afbeeldings-URL
  De URL voor de afbeelding van het product.
• external_catalog_id
  Gebruikt voor het organiseren van je catalogus in Klaviyo.
• integration_key
  Je e-commerceplatform (Magento 2).

Actief op Website

Deze meetwaarde wordt bijgehouden wanneer een klant actief is op je site. Je kunt meetwaarden Actief op site filteren en targeten op basis van de volgende criteria:

• utm_medium
  Het medium voor de UTM-trackingparameter (bijv. campagne).
• kx_present
  (True of False) Of de kx-parameter aanwezig is.
• os
  Het besturingssysteem van het apparaat van de gebruiker.
• initial_page_path
  Het URL-pad van de eerste pagina waarop de gebruiker terechtkwam.
• browser
  Het type browser van de gebruiker.
• page
  De URL van de pagina waarop de gebruiker actief was.
• utm_campaign
  De UTM-trackingparameter voor de campagne.
• utm_source
  De UTM (Urchin Tracking Module)-bron (bijv. Klaviyo).

Gesynchroniseerde klantgegevens

Klaviyo maakt een contact aan bij het aanmaken van een bestaande bestelling, een bestaand klantrecord of wanneer een checkout wordt gestart. Klaviyo maakt een nieuw Klaviyo-profiel aan voor elk gesynchroniseerd contact en vult dit profiel met de volgende informatie:

• E-mail
• Voor- en achternaam
• Stad, staat/regio, postcode, land
• Telefoonnummer
• Magento-account aangemaakt (bijv. YYY-mm-dd hh:mm:ss; 2015-05-21 13:04:00)
• Magento-klantgroep (bijv. Groothandel)
• Magento-winkel (bijv. Amerikaanse winkel)
• Geboortedatum (bijv. YYYY-mm-dd; 1990-03-25)
• Geslacht

Als je de klantgroep in Magento 2 bijwerkt, wordt de klantgroep ook in Klaviyo bijgewerkt, zelfs nadat het oorspronkelijke profiel in Klaviyo is aangemaakt.

Inkomstenwaarde

Je ziet misschien dat de waarde Omzet op je Klaviyo-dashboard niet altijd overeenkomt met de omzetwaarde die je in Magento ziet; dit komt doordat Klaviyo geannuleerde en terugbetaalde bestellingen niet aftrekt van onze omzetberekening.

Extra hulpbronnen