Magento 2-datareferentie

Ontdek welke gegevens Klaviyo uit je Magento 2-winkel importeert wanneer je de twee platformen integreert. De eerste historische synchronisatie importeert tot 5 jaar aan bestel- en klantgegevens, inclusief informatie die is gekoppeld aan eerder geplaatste en afgehandelde bestellingen. Zodra de integratie is ingeschakeld, synchroniseert de integratie ook elke 30 minuten bestel- en klantgegevens.

Navigeer in Klaviyo naar Analytics > Meetwaarden in de linkerzijbalk om alle meetwaarden in je account te bekijken; de meetwaarden met een Magento 2-pictogram zijn de events die zijn gesynchroniseerd vanuit je Magento 2-integratie. Je ziet ook Klaviyo onsite tracking-events met een tandwielpictogram; die worden ook getrackt via de integratie.

Hoe Klaviyo Magento 2-meetwaarden bepaalt

Meetwaarden voor bestellingen

Klaviyo registreert een Placed Order -event voor elke bestelling die het synchroniseert. Het gebruikt ook de huidige Status van de bestelling en de statusgeschiedenis in Magento 2 om aanvullende bestelmeetwaarden vast te leggen.

Wanneer een bestelling wordt aangemaakt of bijgewerkt, controleert Klaviyo de huidige status en de statusgeschiedenis. De onderstaande tabel toont de standaardtoewijzingen. Bestellingen met pending_payment of met een aangepaste status die is ingesteld om te negeren, worden uitgesloten.

Als je aangepaste orderstatussen hebt die geen Geplaatste bestelling -meetwaarde mogen activeren of niet overeenkomen met de tabel hierboven, laat het ons weten, zodat we de aangepaste statussen zo kunnen configureren dat ze worden genegeerd of worden toegewezen aan aanvullende ordergebeurtenissen.

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 een winkelwagen (in Magento ‘quote’ genoemd) met een gekoppeld e-mailadres. Klaviyo synchroniseert deze alleen als de winkelwagen nog actief is en items bevat wanneer de synchronisatie wordt uitgevoerd.

Als de klant de bestelling afrondt voordat de winkelwagen synchroniseert, is de winkelwagen niet langer actief en slaat Klaviyo deze over. Een Placed Order -event wordt vastgelegd wanneer de bestelling synchroniseert, tenzij de status wordt genegeerd. Een Started Checkout -event dat al is gesynchroniseerd, blijft in Klaviyo staan. Houd er rekening mee dat het tot 1 uur kan duren voordat Started Checkout -events naar Klaviyo synchroniseren.

Meetwaarde Verzending uitgevoerd

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

Magento 2-meetwaardengegevens

In dit gedeelte komen de Magento 2-meetwaarden aan bod 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.
• Productnamen
  De namen van de producten in de geannuleerde bestelling.
• ItemCount
  Het aantal regelitems in de bestelling, niet de totale hoeveelheid eenheden.
• 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.
• ProductNames
  De namen van de producten in de bestelling.
• ItemCount
  Het aantal regelitems in de bestelling, niet de totale hoeveelheid eenheden.
• 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

Klaviyo registreert 1 Ordered Product-event per bestelde eenheid, tot maximaal 100 events per regelitem. Een bestelling van bijvoorbeeld 3 dezelfde T-shirts levert 3 Ordered Product-events op, elk met een Quantity van 1. Voor producten die in fractionele hoeveelheden worden verkocht, registreert Klaviyo 1 event met de bestelde hoeveelheid.

• 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
  (Waar of onwaar) Of er een korting op het product is toegepast.
• Aantal
  De hoeveelheid die door deze gebeurtenis wordt weergegeven: 1 voor aankopen van hele eenheden of de bestelde hoeveelheid voor producten die in fracties worden verkocht.
• 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.
• ProductNames
  De namen van de producten in de bestelling.
• ItemCount
  Het aantal regelitems in de bestelling, niet de totale hoeveelheid eenheden.
• 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 de status van een bestelling in Magento 2 wordt gesloten. Een gedeeltelijke terugbetaling waarbij de bestelling een andere status krijgt, activeert Refunded Order niet via de standaardstatusmapping.

• Waarde
  De waarde van de bestelling.
• Met korting
  Of de bestelling met korting is of niet.
• Productnamen
  De namen van alle producten in de bestelling.
• ItemCount
  Het aantal regelitems in de bestelling, niet de totale hoeveelheid eenheden.
• 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 en de winkelwagen nog actief is met items wanneer Klaviyo deze synchroniseert. Op een standaard afrekenpagina voert de klant hun contact- en verzendgegevens in en klikt op Doorgaan. Als ze de checkout voltooien voordat de winkelwagen synchroniseert, slaat Klaviyo Started Checkout over en registreert Placed Order wanneer de bestelling synchroniseert, tenzij de status wordt genegeerd. Het voltooien van een bestelling verwijdert geen Started Checkout-event dat al is gesynchroniseerd.

• Waarde
  De waarde van de bestelling tijdens het afrekenen.
• ItemCount
  Het aantal regelitems in de winkelwagen, niet het totale aantal eenheden.
• 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).

Gebruik de waarde MaskedQuoteId uit de Added To Cart-gebeurtenis om een link te maken die de winkelwagen van de klant opnieuw opbouwt wanneer ze vanaf een e-mail op een ander apparaat terugkeren. Gebruik 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 dat Klaviyo kan identificeren. Je kunt Bekeken product -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 die Klaviyo kan identificeren actief is op je site. Je kunt de activiteit Actief op site gebruiken in segmenten en flow, maar de onderstaande gebeurteniseigenschappen zijn niet beschikbaar voor segment- of flowfilters. Je kunt ze controleren in de onbewerkte gegevens van de gebeurtenis:

• utm_medium
  Het medium voor de UTM-trackingparameter (bijv. campagne).
• kx_present
  True wanneer de kx parameter aanwezig is in de URL. Het veld wordt weggelaten wanneer de parameter ontbreekt.
• 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 profielen aan of werkt ze bij op basis van gesynchroniseerde bestellingen, klantgegevens en gestarte checkouts. De volgende informatie wordt toegevoegd wanneer deze beschikbaar is in de brongegevens:

• E-mail
• Voor- en achternaam
• Stad, staat/regio, postcode, land
• Telefoonnummer
• Magento-account aangemaakt (bijv. YYYY-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

Wanneer je Magento 2’s meetwaarde Placed Order gebruikt om omzet te meten, worden geannuleerde en terugbetaalde bestellingen niet automatisch afgetrokken. Daardoor kan de omzet die in Klaviyo wordt weergegeven afwijken van de omzet die in Magento wordt weergegeven.

Extra hulpbronnen