Magento 1-gegevensreferentie

Wat je leert

Lees welke Magento 1-gegevens in Klaviyo worden geïmporteerd wanneer je de twee platforms integreert. Klaviyo's integraties met Magento haalt alle historische gegevens in je Magento-winkel op op het moment van je eerste historische synchronisatie. Zodra dit is ingeschakeld, begint de integratie meetwaarden en klantgegevens bijna in realtime 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-pictogram zijn degene die zijn 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.

Je kunt gebeurtenissen Geannuleerde bestelling filteren en targeten op basis van de volgende criteria:

• Waarde: Totale waarde van de bestelling (subtotaal + verzendkosten - eventuele kortingen).
• Items: De namen van de producten in iemands bestelling.
  bijv.: t-shirt of broek. Als dit meerdere keren is besteld, worden er meerdere keren hetzelfde item weergegeven
• Itemcategorieën: De volledige set categorieën van de items in iemands bestelling; (bijv. t-shirts, heren, broeken en uitverkoop).
• Aantal items: Het aantal items in de bestelling (bijvoorbeeld 2).
• Valutacode: de specifieke valuta waarmee je voor een item betaalt op basis van het land (bijv. USD, EUR).
• Korting toegepast: Of er korting op dit specifieke item is toegepast (d.w.z. waar/onwaar).
• Coupon: de toegepaste couponcode.
• Unieke items: Het afzonderlijke item dat in een bestelling is opgenomen (bijv. shirts, shorts). Als er meerdere producten worden besteld, wordt het unieke item maar één keer weergegeven.
• Unieke itemcategorieën: de categorieën waarin unieke items zijn gegroepeerd (bijv. heren, sale).
• Attributen (optioneel): aangepaste productattributen.

Afrekenen Voltooid

Deze gebeurtenis wordt bijgehouden wanneer een klant een checkout afrondt in je Magento-webshop. De gebeurtenis Checkout Completed wordt historisch niet gesynchroniseerd en is dus niet altijd een nauwkeurige maatstaf wanneer je naar het totaal aantal gebeurtenissen in de loop van de tijd kijkt. Gebruik voor het tracking van omzet en segmentatie de gebeurtenis Placed Order.

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

Dit event wordt bijgehouden wanneer je een bestelling in je Magento-webshop als verzonden markeert. Klaviyo houdt gerelateerde productinformatie bij over de items die iemand heeft gekocht, waaronder productnamen, afbeeldingen en informatie over variaties die je kunt gebruiken in e-mails voor opvolging na aankoop.

Je kunt gebeurtenissen Uitgevoerde bestelling filteren en targeten op basis van de volgende criteria:

• Waarde: Totale waarde van de bestelling (subtotaal + verzendkosten - eventuele kortingen).
• Items: De namen van de producten in iemands bestelling (bijv. t-shirt of broek). Als je meerdere keren bestelt, worden er meerdere exemplaren van hetzelfde item weergegeven.
• Itemcategorieën: De volledige set categorieën van de items in iemands bestelling (bijv. t-shirts, heren, broeken en uitverkoop).
• Aantal items: Het aantal artikelen in de bestelling. (bijv. 2).
• Valutacode: De specifieke valuta die voor een item is betaald op basis van het land (bijv. USD, EUR).
• Korting toegepast: Of er korting op dit specifieke item is toegepast (d.w.z. waar/onwaar).
• Coupon: de toegepaste couponcode.
• Unieke items: Het afzonderlijke item dat in een bestelling is gemaakt (bijv. shirts, shorts). Als er meerdere producten worden besteld, wordt het unieke item slechts één keer weergegeven.
• Unieke itemcategorieën: de categorieën waarin unieke items zijn gegroepeerd (bijv. heren, sale).
• Attributen (optioneel): aangepaste productattributen.

Product Besteld

Deze gebeurtenis wordt bijgehouden wanneer een klant een bestelling plaatst. Voor elk artikel dat iemand koopt, wordt één Ordered Product-gebeurtenis bijgehouden. Als iemand bijvoorbeeld een T-shirt en een broek koopt, wordt er één Placed Order-gebeurtenis bijgehouden en worden er twee Ordered Product-gebeurtenissen geregistreerd: één gebeurtenis voor het T-shirt en één gebeurtenis voor de broek.

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: totale prijs van het item (exclusief verzendkosten of toegepaste kortingen).
• Naam: de naam die aan dit specifieke item is gegeven.
• SKU: De specifieke SKU die is toegewezen om een item te volgen (bijv. REDMEDIUMTSHIRT).
• Categorieën: De complete set van de collecties van de producten in iemands bestelling (bijv. T-shirts, heren, broeken en uitverkoop).
• Prijs: De dollarwaarde van het specifieke product (bijv. shirts 25,50, schoenen 50,25).
• Kosten: De kosten om een product te maken (bijv. shirts 13,85, schoenen 20,00).
• Valutacode: De specifieke valuta waarmee voor een item is betaald op basis van land (bijv. USD, 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: Bestelde hoeveelheid.
• Attributen (optioneel): aangepaste productattributen.

Bestelling geplaatst

Deze gebeurtenis wordt bijgehouden wanneer een klant het afrekenproces voltooit en een bestelling plaatst 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 follow-up-e-mails na een aankoop. Je kunt Geplaatste bestelling -gebeurtenissen filteren en targeten op basis van de volgende criteria:

• Waarde: Totale waarde van de bestelling (subtotaal + verzending - eventuele kortingen).
• Items: de namen van de producten in iemands bestelling, bijv. t-shirt of broek. Als dit meerdere keren is besteld, worden meerdere van hetzelfde item weergegeven.
• Itemcategorieën: De volledige set categorieën van de items in iemands bestelling (bijv. t-shirts, heren, broeken en uitverkoop).
• Aantal items: Het aantal items in de bestelling (bijv. 2).
• Valutacode: De specifieke valuta waarmee voor een item is betaald op basis van land (bijv. USD, EUR).
• Korting toegepast: Of er korting op dit specifieke item is toegepast (d.w.z. waar/onwaar).
• Coupon: de toegepaste couponcode.
• Unieke items: Het afzonderlijke item dat in een bestelling is gemaakt (bijv. shirts, shorts). Als er meerdere producten worden besteld, wordt het unieke item maar één keer weergegeven.
• Unieke itemcategorieën: de categorieën waarin unieke items worden gegroepeerd (bijv. mens, sale).
• Attributen (optioneel): er kunnen maximaal 10 aangepaste productattributen worden gesynchroniseerd voor geplaatste bestellingen  Deze synchronisatie moet zijn ingeschakeld voordat gegevens van aangepaste attributen in je Klaviyo-account terechtkomen. Bekijk de sectie hieronder over hoe je dit instelt.

Bestelling Terugbetaald

Deze gebeurtenis wordt bijgehouden wanneer een bestelling wordt terugbetaald in Magento.

• Waarde: Totale waarde van de bestelling (subtotaal + verzending - eventuele kortingen).
• Coupon: de toegepaste couponcode.
• Valutacode: De specifieke valuta waarmee voor een item is betaald op basis van land (bijv. USD, EUR).
• Met korting: of op dit specifieke item een korting is toegepast (d.w.z. waar/onwaar).
• Itemcategorieën: De volledige set categorieën van de items in iemands bestelling (bijv. t-shirts, heren, broeken en uitverkoop).
• Aantal items: het aantal items in de bestelling (bijv. 2).
• Items: De namen van de producten in iemands bestelling (bijv. t-shirt of broek). Als dit meerdere keren is besteld, worden meerdere van hetzelfde item weergegeven.
• Unieke itemcategorieën: de categorieën waarin unieke items zijn gegroepeerd (bijv. heren, sale).
• Unieke items: Het individuele item dat in een bestelling is aangemaakt, bijv.: shirts, shorts. Als er meerdere producten zijn besteld, wordt het unieke item slechts één keer weergegeven.

Omzet, of de waarde van Placed Order, wordt als volgt berekend: (prijs van bestellingen + verzending - kortingen). Als je een segment wilt filteren op $value, filter je het segment met Omzet.

Betaling is beschikbaar als 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 gebruiken als eventvariabele in je e-mailtemplates.

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. 2015-05-01 00:00:00)
• Magento-klantgroep (bijv. Groothandel)
• Magento-winkel (bijv. Amerikaanse winkel)
• Geboortedatum (bijv. 1990-01-01)
• Geslacht
• website_ID wordt niet opgehaald
• Onderdrukkingen worden niet naar Klaviyo gekopieerd, dus ze staan niet in het Klaviyo-platform.

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

Aangepaste productkenmerken synchroniseren voor geplaatste bestellingen

Klaviyo kan voor de meetwaarde Placed Order maximaal 10 aangepaste productattributen synchroniseren. Aangepaste productattributen worden niet automatisch in Klaviyo opgenomen; je kunt Klaviyo echter vragen om ze op te halen. Hiervoor moet je de ID van het aangepaste attribuut verzamelen (instructies hieronder) en een verzoek sturen naar ons supportteam.

Zoek de aangepaste product-ID's in het Beheerder-paneel van Magento door naar Catalog > Attributes > Manage Attributes te gaan en op het attribuut te klikken.

Je vindt de ID in de url, zoals hier:

Controleer je gesynchroniseerde bestelgegevens

Klaviyo importeert al je Magento-gegevens. Om dit te verifiëren, kun je het aantal bestellingen op een bepaalde dag vergelijken met wat er in de Magento-interface staat en bevestigen dat ze overeenkomen. Klik in de linkerzijbalk op Analytics, zoek de meetwaarde Placed Order en klik erop. Dit brengt je naar de pagina met de meetwaardegrafiek en toont standaard de gegevens van de afgelopen 30 dagen. Je ziet hieronder een voorbeeld van de weergegeven meetwaardegrafiek.

Ga met de muis over het gegevenspunt van gisteren of kijk in de gegevenstabel onder de grafiek om te zien hoeveel bestellingen je gisteren had. Vergelijk dat aantal met wat er in Magento is opgeslagen en je zou moeten zien dat ze precies overeenkomen. Als dat niet zo is, is het meest waarschijnlijke probleem dat de tijdzone van je Klaviyo-account niet overeenkomt met je Magento-tijdzone. Je tijdzone-instelling controleren:

1. Klik linksonder op de naam van je organisatie.
2. Klik op Instellingen.
3. Selecteer Organisatie.

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.

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.

Dit is handig om de juiste eigenschappen te verzenden voor bestellingen die worden gecombineerd met Magento-bestelgegevens.

Bestelling geplaatst

// 
// PLACED ORDER
// ------------------------------------------

{
  "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"], // If an item is ordered more than once, duplicate it. For example, someone orders two t-shirts this would be: ["T-Shirt", "T-Shirt"]
    "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

// 
// ORDERED PRODUCT
// ------------------------------------------

{
  "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", // LineId (unique)
    "$value" : 9.99,
    "Currency Code" : "USD",
    "Name" : "Winnie the Pooh",
    "SKU" : "WINNIEPOOH",
    "ProductID" : "567",
    "Categories" : ["Fiction", "Classics"],
    "Price" : 9.99,
    "Discounted" : true,
    "Cost" : 5.00, // (optional),
    "Attribute: Color" : "Red" // product attributes (optional)
    "$extra" : {
        "Product URL Key" : "winnie-pooh",
        "Product URL" : "https://www.store.com/winnie-pooh",
        "Image URL" : "https://cnd.store.com/images/winnie-pooh.png",
    }
  },
  "time" : 1387302423
}

Bestelling Afgerond

// 
// FULFILLED ORDER
// ------------------------------------------

{
  "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"], // If an item is ordered more than once, duplicate it. For example, someone orders two t-shirts this would be: ["T-Shirt", "T-Shirt"]
    "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
}