Magento 1-gegevensreferentie

Wat je leert

Ontdek welke gegevens je bestaande Magento 1-integratie synchroniseert met Klaviyo, waaronder historische bestellingen, klantrecords en producten. Na de eerste historische synchronisatie worden bestellingen, klanten en producten elke 30 minuten gesynchroniseerd.

Navigeer in Klaviyo naar Analytics > meetwaarden in de linkerzijbalk om de meetwaarden van je account te bekijken. Meetwaarden met een Magento-pictogram worden gesynchroniseerd vanuit je Magento-integraties.

Meetwaarden van Magento

Bestelling Geannuleerd

Deze gebeurtenis wordt bijgehouden wanneer een klant een bestelling aanmaakt in je Magento-store, maar de bestelling vervolgens annuleert vóór fulfillment. Klaviyo houdt gekoppelde gegevens bij, waaronder alle productinformatie over de items die iemand heeft gekocht. Productinformatie bevat productnamen, afbeeldingen en variatie-informatie die je kunt gebruiken in follow-up e-mails na aankoop.

Deze events bevatten de volgende bestelgegevens. Je kunt eigenschappen op het hoogste niveau gebruiken om events te filteren en te targeten; attribuutdetails onder extra zijn beschikbaar voor berichtinhoud.

• Waarde: het eindtotaal van de bestelling uit Magento, inclusief belasting en verzending na kortingen.
• Items: De productnamen van elk orderregelitem (bijv. T-shirt of broek). Een naam kan meer dan één keer voorkomen als die op afzonderlijke regelitems staat.
• Itemcategorieën: De categorieën van de producten in de bestelling (bijv. T-shirts, heren, broeken en uitverkoop).
• Aantal artikelen: Het aantal regelitems in de bestelling (bijvoorbeeld 2). Dit is niet de som van de bestelde aantallen.
• Valutacode: De valutacode voor de bestelling (bijv. USD of EUR).
• Met korting: Of er een korting is toegepast op de bestelling (true of false).
• Coupon: de toegepaste couponcode.
• Unieke items: de productnamen in de bestelling met dubbele items verwijderd (bijv. shirts of shorts).
• Unieke artikelcategorieën: De productcategorieën in de bestelling, waarbij duplicaten zijn verwijderd (bijv. heren of uitverkoop).
• Kenmerken (optioneel): Productkenmerken in de artikelgegevens onder extra. Gebruik Ordered Product-gebeurtenissen om te filteren op afzonderlijke productkenmerken.

Afrekenen Voltooid

Deze gebeurtenis wordt bijgehouden wanneer een klant een checkout voltooit in je Magento-webshop. Checkout Completed-gebeurtenissen worden niet met terugwerkende kracht gesynchroniseerd, dus de totalen geven mogelijk niet alle eerdere checkouts weer. Gebruik Placed Order-gebeurtenissen voor omzetrapportage en segmentatie.

Je kunt gebeurtenissen Checkout Completed filteren en targeten op basis van de volgende criteria:

• Waarde: De totale waarde van de bestelling.
• Kortingscodes: alle toegepaste coupon- of kortingscodes.
• Items: de namen van de producten in iemands winkelwagen (bijv. t-shirt of broek).
• Aantal items: Het totale aantal items in iemands winkelwagen.
• Totaal aan kortingen (optioneel): totale waarde in dollars van coupons of kortingen.

Afrekenen gestart

Deze gebeurtenis wordt bijgehouden wanneer een klant zijn contact- en verzendgegevens invoert op de eerste pagina van het Magento-afrekenproces en vervolgens op doorgaan klikt. Klaviyo houdt gerelateerde productgegevens bij over items in iemands winkelwagen, waaronder productnamen, afbeeldingen en variatiegegevens die je kunt gebruiken in je e-mails over winkelwagen verlaten. Deze gebeurtenis heeft een eigenschap voor afreken-URL die teruglinkt naar de exacte winkelwagen van elke klant en die kan worden gebruikt om de winkelwagen opnieuw op te bouwen als een klant de e-mail opent vanaf een nieuw apparaat.

Je kunt Checkout Started-gebeurtenissen filteren en targeten op basis van de volgende criteria:

• Waarde: De waarde van de winkelwagen op het moment van afrekenen (subtotaal + verzendkosten - eventuele kortingen).
• Items: de namen van de producten in iemands winkelwagen (bijv. t-shirt of broek).
• Aantal items: Het totale aantal items in iemands winkelwagen.
• Kortingscodes (optioneel): Alle coupon- of kortingscodes die zijn toegepast.
• Totaal aan kortingen (optioneel): totale waarde in dollars van coupons of kortingen.

Bestelling Afgerond

Bij standaard Magento-bestelstatussen wordt deze gebeurtenis bijgehouden wanneer een bestelling de status voltooid bereikt. Klaviyo houdt gerelateerde productinformatie bij over de items die iemand heeft gekocht, waaronder productnamen, afbeeldingen en variatie-informatie die je kunt gebruiken in e-mails voor aankoopopvolging.

Deze events bevatten de volgende bestelgegevens. Je kunt eigenschappen op het hoogste niveau gebruiken om events te filteren en te targeten; attribuutdetails onder extra zijn beschikbaar voor berichtinhoud.

• Waarde: het eindtotaal van de bestelling uit Magento, inclusief belasting en verzending na kortingen.
• Items: De productnamen van elk orderregelitem (bijv. T-shirt of broek). Een naam kan meer dan één keer voorkomen als die op afzonderlijke regelitems staat.
• Itemcategorieën: De categorieën van de producten in de bestelling (bijv. T-shirts, heren, broeken en uitverkoop).
• Aantal artikelen: Het aantal regelitems in de bestelling (bijvoorbeeld 2). Dit is niet de som van de bestelde aantallen.
• Valutacode: De valutacode voor de bestelling (bijv. USD of EUR).
• Met korting: Of er een korting is toegepast op de bestelling (true of false).
• Coupon: de toegepaste couponcode.
• Unieke items: de productnamen in de bestelling met dubbele items verwijderd (bijv. shirts of shorts).
• Unieke artikelcategorieën: De productcategorieën in de bestelling, waarbij duplicaten zijn verwijderd (bijv. heren of uitverkoop).
• Kenmerken (optioneel): Productkenmerken in de artikelgegevens onder extra. Gebruik Ordered Product-gebeurtenissen om te filteren op afzonderlijke productkenmerken.

Product Besteld

Deze gebeurtenis wordt bijgehouden wanneer een klant zijn bestelling plaatst. Voor aantallen in hele getallen wordt voor elke gekochte eenheid 1 Ordered Product-event bijgehouden, tot maximaal 100 events per orderregel. Als iemand bijvoorbeeld een T-shirt en een broek koopt, worden 1 Placed Order-event en 2 Ordered Product-events vastgelegd: 1 voor het T-shirt en 1 voor de broek. Voor producten die in decimale hoeveelheden worden verkocht, legt Klaviyo 1 event vast voor de orderregel en neemt het de gekochte hoeveelheid op.

De Ordered Product-gebeurtenis bevat gedetailleerde informatie over elk product dat iemand koopt. Dit is handig bij het maken van gedragssegmenten op basis van opties voor productvariaties en andere gedetailleerde informatie die niet beschikbaar is in de gebeurtenis Bestelling geplaatst. Je kunt gebeurtenissen Besteld product filteren en targeten op basis van de volgende criteria:

• Waarde: De waarde die door deze gebeurtenis wordt weergegeven vóór kortingen, exclusief verzending. Voor hoeveelheden in hele getallen is dit het totaal van de orderregel gedeeld door de hoeveelheid. Voor decimale hoeveelheden is dit het volledige regeltotaal.
• Naam: de naam die aan dit specifieke item is gegeven.
• SKU: De SKU die aan het item is toegewezen (bijv. REDMEDIUMTSHIRT).
• Categorieën: De categorieën van dit product (bijv. T-shirts, heren, broeken en uitverkoop).
• Prijs: De eenheidsprijs van het product in de valuta van de bestelling (bijv. shirts 25,50 of schoenen 50,25).
• Kosten (optioneel): De productkosten die in Magento zijn geregistreerd, indien beschikbaar (bijv. shirts 13,85 of schoenen 20,00).
• Valutacode: De valutacode voor de bestelling (bijv. USD of EUR).
• Met korting: of op dit specifieke item een korting is toegepast (oftewel true of false).
• ProductID: ID van een specifiek product in je winkel.
• Aantal: Het aantal dat wordt weergegeven door deze gebeurtenis: 1 voor hoeveelheden in gehele getallen, of de gekochte hoeveelheid voor een product dat wordt verkocht in decimale hoeveelheden.
• Attributen (optioneel): aangepaste productattributen.

Bestelling geplaatst

Deze gebeurtenis wordt bijgehouden wanneer een klant het afrekenproces voltooit en een bestelling aanmaakt in je Magento-webshop. Klaviyo houdt gerelateerde gegevens bij, waaronder productinformatie over de items die iemand heeft gekocht, zoals productnamen, afbeeldingen en variatie-informatie die je kunt gebruiken in opvolgmails na een aankoop. Deze Placed Order -gebeurtenissen bevatten de volgende bestelgegevens. Je kunt eigenschappen op het hoogste niveau gebruiken om gebeurtenissen te filteren en te targeten; attribuutdetails onder extra zijn beschikbaar voor berichtinhoud.

• Waarde: het eindtotaal van de bestelling uit Magento, inclusief belasting en verzending na kortingen.
• Items: De productnamen van elk orderregelitem (bijv. T-shirt of broek). Een naam kan meer dan één keer voorkomen als die op afzonderlijke regelitems staat.
• Itemcategorieën: De categorieën van de producten in de bestelling (bijv. T-shirts, heren, broeken en uitverkoop).
• Aantal artikelen: Het aantal regelitems in de bestelling (bijvoorbeeld 2). Dit is niet de som van de bestelde aantallen.
• Valutacode: De valutacode voor de bestelling (bijv. USD of EUR).
• Met korting: Of er een korting is toegepast op de bestelling (true of false).
• Coupon: de toegepaste couponcode.
• Unieke items: de productnamen in de bestelling met dubbele items verwijderd (bijv. shirts of shorts).
• Unieke artikelcategorieën: De productcategorieën in de bestelling, waarbij duplicaten zijn verwijderd (bijv. heren of uitverkoop).
• Kenmerken (optioneel): Productkenmerken in de artikelgegevens onder extra. Gebruik gebeurtenissen van Besteld product om te filteren op individuele productkenmerken. Lees hoe je aangepaste productkenmerken beoordeelt.

Bestelling Terugbetaald

Met standaard orderstatussen van Magento wordt deze gebeurtenis bijgehouden wanneer een bestelling de status Gesloten bereikt. De Value ervan is het oorspronkelijke eindtotaal van de bestelling, niet het bedrag van een individuele terugbetaling.

• Waarde: Het eindtotaal van de oorspronkelijke bestelling uit Magento, inclusief belasting en verzendkosten na kortingen.
• Coupon: de toegepaste couponcode.
• Valutacode: De valutacode voor de bestelling (bijv. USD of EUR).
• Met korting: Of er een korting is toegepast op de bestelling (true of false).
• Itemcategorieën: De categorieën van de producten in de bestelling (bijv. T-shirts, heren, broeken en uitverkoop).
• Aantal artikelen: Het aantal regelitems in de bestelling (bijvoorbeeld 2). Dit is niet de som van de bestelde aantallen.
• Items: De productnamen van elk orderregelitem (bijv. T-shirt of broek). Een naam kan meer dan één keer voorkomen als die op afzonderlijke regelitems staat.
• Unieke artikelcategorieën: De productcategorieën in de bestelling, waarbij duplicaten zijn verwijderd (bijv. heren of uitverkoop).
• Unieke items: de productnamen in de bestelling met dubbele items verwijderd (bijv. shirts of shorts).

Omzet van Bestelling geplaatst gebruikt het totaalbedrag van de bestelling in Magento, inclusief belasting en verzendkosten na kortingen. Als je een segment wilt filteren op basis van $value, gebruik dan Revenue.

Payment is beschikbaar als een eigenschap op het tweede niveau onder het veld extra. Je kunt niet filteren op eigenschappen op het tweede niveau voor segmentatie, maar je kunt deze gegevens als een gebeurtenisvariabele gebruiken in e-mailsjablonen voor meetwaarde-getriggerde flow.

Gesynchroniseerde klantgegevens

Klaviyo maakt profielen aan of werkt ze bij op basis van gesynchroniseerde bestellingen, klantgegevens en gestarte checkouts. Welke informatie beschikbaar is op een profiel hangt af van de gegevens die Magento aanlevert. Dit kan het volgende omvatten:

• E-mail
• Voor- en achternaam
• Stad, staat/regio, postcode, land
• Telefoonnummer
• Magento-account aangemaakt (bijv. 2015-05-01 00:00:00)
• Magento-klantgroep (bijv. Groothandel)
• Magento-winkel (bijv. Amerikaanse winkel)
• Geboortedatum (bijv. 1990-01-01)
• Geslacht
• Magento WebsiteID (wanneer het klantrecord een winkel-ID bevat)

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

Beoordeel aangepaste productkenmerken

Aangepaste productattributen zijn afhankelijk van je bestaande configuratie van integraties. Geconfigureerde attributen verschijnen bij Ordered Product-evenementen als eigenschappen met de naam Attribute:, gevolgd door de attribuutcode. Attribuutdetails worden ook opgeslagen bij afzonderlijke items onder extra bij bestelevenementen. Klaviyo Support behandelt geen verzoeken meer om het synchroniseren van Magento 1-attributen in te schakelen of te wijzigen. Bekijk je bestaande gebeurtenisgegevens om te zien welke attributen aanwezig zijn. Algemene supportinformatie vind je in Contact opnemen met support.

Ga om een aangepast kenmerk in je bestaande configuratie te identificeren naar Catalogus > Kenmerken > Kenmerken beheren in het Magento-beheerderspaneel en klik op het kenmerk.

Zoek de attribute-ID in de URL, zoals hieronder wordt weergegeven.

Controleer je gesynchroniseerde bestelgegevens

Om je gesynchroniseerde bestellingen te verifiëren, vergelijk je voor een voltooide dag het aantal Placed Order-events met de bestellingen in Magento voor dezelfde dag en winkels. Laat de historische synchronisatie afronden en de laatste synchronisatie van 30 minuten voltooien voordat je de aantallen vergelijkt.

1. Navigeer naar Analytics > meetwaarden en selecteer de Magento- Placed Order -meetwaarde.
2. Stel datumbereik zo in dat de dag die je wilt vergelijken erin zit. Stel weergave per in op dagelijks en meting op totaal. Verwijder alle filters die orders zouden uitsluiten van de vergelijking.
3. Ga met de muis over het gegevenspunt van de dag of lees de waarde ervan in de tabel onder de grafiek. Vergelijk het aantal met de bestellingen van Magento voor dezelfde dag en winkels.

Als de aantallen verschillen, controleer dan of beide rapporten dezelfde tijdzone en winkeltoepassing gebruiken en of de synchronisatie is voltooid. Controleer ook of niet-gematchte Magento-bestellingen nog op betaling wachten of geen geldig e-mailadres van de klant hebben. Zo controleer je je tijdzone in Klaviyo:

1. Klik linksonder op je accountnaam.
2. Klik op Instellingen.
3. Selecteer Algemeen > account en controleer de instelling Tijdzone.
4. Als je de tijdzone wijzigt, klik je op Opslaan. Je hebt toestemming nodig om accountinstellingen te bewerken om deze waarde te wijzigen.

De omzet van Placed Order in Klaviyo trekt geannuleerde of terugbetaalde bestellingen niet af. Daarom kan dit afwijken van een Magento-rapport dat die bestellingen wel aftrekt.

Eigenschappen voor gesynchroniseerde Magento-bestellingen

Hieronder vind je voorbeeld-JSON-payloads voor de meetwaarden Bestelling geplaatst, Product besteld en Bestelling afgehandeld die overeenkomen met de eigenschappen die we opslaan voor bestellingen die via de Magento SOAP API worden gesynchroniseerd.

Gebruik deze voorbeelden om de eigenschapsnamen en nesting van gesynchroniseerde events te begrijpen. Ze laten de legacy event-payloadindeling zien en zijn geen instructies voor het versturen van requests naar Klaviyo’s huidige API’s. De voorbeeldwaarden zijn illustratief; extra bevat de volledige ordergegevens voor events op orderniveau.

Bestelling geplaatst

{
  "token": "PUBLIC_API_KEY",
  "service": "magento",
  "event": "Placed Order",
  "customer_properties": {
    "$email": "john.smith@test.com",
    "$first_name": "John",
    "$last_name": "Smith"
  },
  "properties": {
    "$event_id": "1234",
    "$value": 29.98,
    "$extra": {},
    "Currency Code": "USD",
    "Item Count": 2,
    "Items": [
      "Winnie the Pooh",
      "A Tale of Two Cities"
    ],
    "Discounted": true,
    "Coupon": "COUPON123",
    "Unique Items": [
      "Winnie the Pooh",
      "A Tale of Two Cities"
    ],
    "Item Categories": [
      "Fiction",
      "Classics",
      "Children"
    ],
    "Unique Item Categories": [
      "Fiction",
      "Classics",
      "Children"
    ]
  },
  "time": 1387302423
}

Product Besteld

{
  "token": "PUBLIC_API_KEY",
  "service": "magento",
  "event": "Ordered Product",
  "customer_properties": {
    "$email": "john.smith@test.com",
    "$first_name": "John",
    "$last_name": "Smith"
  },
  "properties": {
    "$event_id": "123456789",
    "$value": 9.99,
    "Currency Code": "USD",
    "Name": "Winnie the Pooh",
    "SKU": "WINNIEPOOH",
    "ProductID": "567",
    "Categories": [
      "Fiction",
      "Classics"
    ],
    "Price": 9.99,
    "Discounted": true,
    "Cost": 5.0,
    "Attribute: Color": "Red",
    "$extra": {
      "Product URL Key": "winnie-pooh",
      "Product URL": "https://www.store.com/winnie-pooh",
      "Image URL": "https://cnd.store.com/images/winnie-pooh.png"
    },
    "Quantity": 1
  },
  "time": 1387302423
}

Bestelling Afgerond

{
  "token": "PUBLIC_API_KEY",
  "service": "magento",
  "event": "Fulfilled Order",
  "customer_properties": {
    "$email": "john.smith@test.com",
    "$first_name": "John",
    "$last_name": "Smith"
  },
  "properties": {
    "$event_id": "1234",
    "$value": 29.98,
    "$extra": {},
    "Currency Code": "USD",
    "Item Count": 2,
    "Items": [
      "Winnie the Pooh",
      "A Tale of Two Cities"
    ],
    "Discounted": true,
    "Coupon": "COUPON123",
    "Unique Items": [
      "Winnie the Pooh",
      "A Tale of Two Cities"
    ],
    "Item Categories": [
      "Fiction",
      "Classics",
      "Children"
    ],
    "Unique Item Categories": [
      "Fiction",
      "Classics",
      "Children"
    ]
  },
  "time": 1387302423
}

Extra hulpbronnen