Magento 1 gegevens referentie

Wat je leert

Leer welke Magento 1-gegevens worden geïmporteerd in Klaviyo wanneer je de twee platforms integreert. KlaviyoDe integratie met Magento haalt alle historische gegevens op in je Magento zaak op het moment van je eerste historische synchronisatie. Eenmaal ingeschakeld zullen de integraties beginnen met het synchroniseren van meetwaarde en klantgegevens in bijna realtime. Voorbeelden van deze gegevens zijn de informatie over eerder geplaatste bestellingen, uitgevoerde bestellingen, enz.

In Klaviyo kun je naar account het tabblad analyses in de linkerzijbalk van je navigeren om alle meetwaarden in je te account bekijken; de meetwaarden met een Magento pictogram zijn de meetwaarden die zijn gesynchroniseerd vanuit je Magento integraties.

Magento meetwaarde

Geannuleerde bestelling

Deze gebeurtenis wordt bijgehouden wanneer een klant een bestelling aanmaakt in je Magento zaak, maar de bestelling vervolgens annuleert voordat deze wordt uitgevoerd. Klaviyo houdt de bijbehorende gegevens bij, inclusief alle productinformatie over de artikelen die iemand heeft gekocht. Productinformatie bevat productnamen, afbeeldingen en variatie-informatie die je kunt gebruiken in follow-up e-mails over aankopen.

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

• Waarde: Totale waarde van de bestelling (subtotaal + verzendkosten - eventuele kortingen).
• Artikelen: De namen van de producten in iemands bestelling.
  ex: T-shirt of broek. Als het artikel meerdere keren wordt besteld, worden er meerdere van hetzelfde artikel weergegeven.
• Item Categorieën: De volledige set categorieën van de items in iemands bestelling; (bijv. t-shirts, heren, broeken en sale).
• Aantal items: Het aantal items in de bestelling (bijvoorbeeld 2).
• Valutacode: De specifieke valuta die voor een artikel is betaald op basis van het land (bijv. USD, EUR).
• Korting: Als op dit specifieke item een korting is toegepast (waar/onwaar).
• coupon: De code coupontoegepast.
• Unieke artikelen: Het individuele artikel in een bestelling (bijv. shirts, shorts). Als er meerdere producten worden besteld, wordt het unieke item maar één keer weergegeven.
• Categorieën unieke items: De categorieën waarin unieke items zijn gegroepeerd (bijv. heren, uitverkoop).
• Attributen (optioneel): Aangepaste productattributen.

Afrekenen Voltooid

Deze gebeurtenis wordt bijgehouden wanneer een klant een afrekening voltooit in je Magento zaak. De gebeurtenis Afrekenen Voltooid synchroniseert niet historisch, dus is niet altijd een nauwkeurige maatstaf als je kijkt naar totalen gebeurtenissen in de loop van de tijd. Voor tracking inkomsten en segmentatie gebruik je de Placed Order event.

Je kunt Afrekenen Voltooid gebeurtenissen filteren en targeten op basis van de volgende criteria:

• Waarde: De totale waarde van de bestelling. 
• Kortingscodes: Eventuele coupon of kortingscodes toegepast.
• Artikelen: De namen van de producten in iemands winkelwagentje (bijv. t-shirt of broek).
• Aantal items: Het totale aantal items in iemands winkelwagentje.
• Totale kortingen (optioneel): Totale dollarwaarde van coupons of kortingen.

Afrekenen gestart

Deze gebeurtenis wordt bijgehouden wanneer een klant zijn contactpersoon en verzendgegevens invoert op de eerste pagina van het proces Magento afrekenen en vervolgens op doorgaan klikt. Klaviyo houdt gerelateerde productgegevens bij over items in iemands winkelwagen, inclusief productnamen, afbeeldingen en variatie-informatie die je kunt gebruiken in je winkelwagen verlaten e-mail. Deze gebeurtenis heeft een URL-eigenschap die terug linkt 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 Afrekenen Afgehandeld 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).
• Artikelen: De namen van de producten in iemands winkelwagentje (bijv. t-shirt of broek).
• Aantal items: Het totale aantal items in iemands winkelwagentje.
• Kortingscodes (optioneel): Eventuele coupon- of kortingscodes die zijn toegepast.
• Totale kortingen (optioneel): Totale dollarwaarde van coupons of kortingen.

Afgeronde bestelling

Deze gebeurtenis wordt bijgehouden wanneer je een bestelling in je Magento zaak markeert als verzonden. Klaviyo houdt gerelateerde productinformatie bij over de items die iemand heeft gekocht, inclusief productnamen, afbeeldingen en variatie-informatie die kan worden gebruikt in follow-up e-mails over aankopen.

Je kunt gebeurtenissen van Vervulde orders filteren en targeten op basis van de volgende criteria:

• Waarde: Totale waarde van de bestelling (subtotaal + verzendkosten - eventuele kortingen).
• Artikelen: De namen van de producten in iemands bestelling (bijv. t-shirt of broek). Als je meerdere keren bestelt, verschijnt er een veelvoud van hetzelfde artikel. 
• Item Categorieën: De volledige set categorieën van de items in iemands bestelling (bijv. t-shirts, heren, broeken en sale).
• Aantal artikelen: Het aantal items in de bestelling. (bijvoorbeeld 2).
• Valutacode: De specifieke valuta die voor een artikel is betaald op basis van het land (bijv. USD, EUR).
• Korting: Als op dit specifieke item een korting is toegepast (waar/onwaar).
• coupon: De code coupontoegepast.
• Unieke artikelen: Het individuele artikel dat is aangemaakt in een bestelling (bijv. shirts, shorts). Als er meerdere producten worden besteld, wordt het unieke artikel maar één keer weergegeven.
• Categorieën unieke items: De categorieën waarin unieke items zijn gegroepeerd (bijv. heren, uitverkoop).
• Attributen (optioneel): Aangepaste productattributen.

Product besteld

Deze gebeurtenis wordt bijgehouden wanneer een klant zijn bestelling plaatst. Voor elk artikel dat iemand koopt, wordt een gebeurtenis Besteld product bijgehouden. Als iemand bijvoorbeeld een t-shirt en een broek koopt, wordt er één Geplaatste Bestelling-gebeurtenis bijgehouden en twee Bestelde Product-gebeurtenissen - één gebeurtenis voor het t-shirt en één gebeurtenis voor de broek.

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

• Waarde: Totale prijs van het item (exclusief verzendkosten of eventuele kortingen).
• Naam: De naam die aan dit specifieke item is gegeven.
• SKU: De specifieke SKU die is toegewezen om een artikel te volgen (bijv. REDMEDIUMTSHIRT).
• Categorieën: De volledige verzameling van de collecties van de producten in iemands bestelling (bijv. t-shirts, heren, broeken en sale).
• Prijs: De dollarwaarde van het specifieke product (bijv. overhemden 25,50, schoenen 50,25).
• Kosten: De kosten om een product te maken (bijv. overhemden 13,85, schoenen 20,00).
• Valutacode: De specifieke valuta die voor een artikel is betaald op basis van het land (bijv. USD, EUR). 
• Korting: Als op dit specifieke item korting is toegepast (waar of onwaar).
• ProductID: ID van specifiek product in je zaak.
• Hoeveelheid: Bestelde hoeveelheid.
• Attributen (optioneel): Aangepaste productattributen.

Bestelling geplaatst

Deze gebeurtenis wordt bijgehouden wanneer een klant het afrekenproces voltooit en een bestelling aanmaakt in je Magento zaak. Klaviyo houdt gerelateerde gegevens bij, waaronder productinformatie over de artikelen die iemand heeft gekocht, inclusief productnamen, afbeeldingen en variatie-informatie die je kunt gebruiken in follow-up e-mails over aankopen. Je kunt Geplaatste bestellingen filteren en targeten op basis van de volgende criteria:

• Waarde: Totale waarde van de bestelling (subtotaal + verzendkosten - eventuele kortingen).
• Artikelen: De namen van de producten in iemands bestelling, bijvoorbeeld: T-shirt of broek. Bij meerdere bestellingen worden meerdere exemplaren van hetzelfde artikel weergegeven. 
• Item Categorieën: De volledige set categorieën van de items in iemands bestelling (bijv. t-shirts, heren, broeken en sale).
• Aantal items: Het aantal items in de bestelling (bijvoorbeeld 2). 
• Valutacode: De specifieke valuta die voor een artikel is betaald op basis van het land (bijv. USD, EUR).
• Korting: Als op dit specifieke item een korting is toegepast (waar/onwaar).
• coupon: De code coupontoegepast.
• Unieke artikelen: Het individuele artikel dat in een bestelling is aangemaakt (bijv. shirts, shorts). Als er meerdere producten worden besteld, wordt het unieke item maar één keer weergegeven.
• Categorieën unieke items: De categorieën waarin unieke items zijn gegroepeerd (bijv. heren, uitverkoop).
• Attributen (optioneel): Er kunnen maximaal 10 aangepaste productattributen worden gesynchroniseerd voor geplaatste bestellingen Deze synchronisatie moet worden ingeschakeld voordat aangepaste attribuutgegevens naar je Klaviyo account stromen. Zie het gedeelte hieronder over hoe je dit instelt.

Terugbetaalde bestelling

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

• Waarde: Totale waarde van de bestelling (subtotaal + verzendkosten - eventuele kortingen).
• coupon: De code coupontoegepast.
• Valutacode: De specifieke valuta die voor een artikel is betaald op basis van het land (bijv. USD, EUR).
• Korting: Als op dit specifieke artikel een korting is toegepast (waar/onwaar).
• Item Categorieën: De volledige set categorieën van de items in iemands bestelling (bijv. t-shirts, heren, broeken en sale).
• Aantal items: Het aantal items in de bestelling (bijvoorbeeld 2).
• Artikelen: De namen van de producten in iemands bestelling (bijv. t-shirt of broek). Bij meerdere bestellingen worden meerdere exemplaren van hetzelfde artikel weergegeven.
• Categorieën unieke items: De categorieën waarin unieke items zijn gegroepeerd (bijv. heren, uitverkoop).
• Unieke artikelen: Het individuele artikel dat in een bestelling is gemaakt, bijvoorbeeld: shirts, shorts. Als er meerdere producten worden besteld, wordt het unieke item maar één keer weergegeven.

Inkomsten, of geplaatste bestelwaarde, wordt als volgt berekend: (prijs van bestellingen + verzendkosten - kortingen). Om een segment te filteren op basis van $waarde, filter je de segment met inkomsten.

Betaling 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 wel gebruiken als gebeurtenisvariabele in je e-mailtemplate.

Klantgegevens synchroniseren

Klaviyo creëert een contactpersoon bij het aanmaken van een bestaande order, een bestaand klantrecord of wanneer een afrekenen wordt gestart. Klaviyo maakt een nieuw Klaviyo profiel aan voor elke gesynchroniseerde contactpersoon en vult dit profiel met de volgende informatie:

• E-mail
• Eerst en Last Name
• City, Deelstaat/Regio, Zip Code, Country
• Telefoonnummer
• Magento account Created (bijv. 2015-05-01 00:00:00)
• Magento klant Groep (bijv. Groothandel)
• Magento zaak (bijv. US zaak)
• Geboortedatum (bijv. 1990-01-01)
• Geslacht
• website_ID wordt niet opgehaald
• onderdrukking worden niet gekopieerd naar Klaviyo dus ze zullen niet in het Klaviyo-platform staan.

Als je update de klantgroep in Magento zet, zelfs nadat het oorspronkelijke profiel in Klaviyo is aangemaakt, zal de klantgroep update in Klaviyo staan.

Aangepaste productattributen synchroniseren voor geplaatste bestellingen

Klaviyo kun je tot 10 aangepaste productattributen synchroniseren voor de geplaatste order meetwaarde. Aangepaste productattributen worden niet automatisch flow in Klaviyo; je kunt echter Klaviyo vragen om ze op te nemen. Hiervoor moet je de aangepaste attribuut-ID verzamelen (instructies hieronder) en een verzoek sturen naar ons supportteam.

Zoek de aangepaste product-ID's in het beheerderspaneel van Magento door naar Catalogus > Attributen > Attributen beheren te gaan en op het attribuut te klikken.

De ID kan als volgt in de url worden gevonden: 

Controleer je gesynchroniseerde bestelgegevens

Klaviyo importeer al je Magento gegevens. Om dit te controleren kun je het aantal bestellingen op een bepaalde dag vergelijken met wat er in de Magento interface staat en bevestigen dat ze overeenkomen. Klik op analyses in de linker zijbalk, zoek de geplaatste bestelling meetwaarde en klik erop. Dit brengt je naar de meetwaarde grafiek pagina en laat standaard de laatste 30 dagen aan gegevens zien. Hieronder zie je een voorbeeld van de meetwaardetabel.

Ga met je muis over het gegevenspunt van gisteren of kijk in de tabel met gegevens onder de grafiek om te zien hoeveel orders je gisteren had. Vergelijk dat getal met wat zaak is in Magento 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 de tijdzone van Magento. Je tijdzone-instellingen controleren:

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

Het kan zijn dat de waarde inkomsten op je Klaviyo dashboard niet altijd overeenkomt met de inkomstenwaarde die je ziet in Magento; dit komt omdat Klaviyo geannuleerde en terugbetaalde bestellingen niet aftrekt van onze inkomstenberekening.

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

{
 " token": "PUBLIC_API_KEY",
 " service": "Magento",
 " event": "Geplaatste bestelling",
 " customer_properties": {
    "$email" : "john.smith@test.com",
    "$first_name" : "John",
    "$last_name" : "Smith"
  },
 " properties": {
 " $event_id": "1234",
 " $value": 29,98,
 " $extra": {},
 " Valutacode": "USD,
 " Item Count": 2,
 " Items": ["Winnie the Pooh", "A Tale of Two Cities"], // Als een item meer dan eens wordt besteld, dupliceer het dan. Als iemand bijvoorbeeld twee t-shirts bestelt, zou dit zijn: ["T-Shirt", "T-Shirt"]
 " Korting": true,
 " coupon": "COUPON123",
 " Unieke items": ["Winnie the Pooh", "A Tale of Two Cities"],
 " Itemcategorieën": ["Fictie", "Klassiekers", "Kinderen"],
 " Unieke itemcategorieën": ["Fictie", "Klassiekers", "Kinderen"]
 }, "tijd": 1387302423
}

// 
// BESTELD PRODUCT
// ------------------------------------------

{
 " token": "PUBLIC_API_KEY",
 " service": "Magento",
 " event": "Besteld product",
 " customer_properties": {
    "$email" : "john.smith@test.com",
    "$first_name" : "John",
    "$last_name" : "Smith"
  },
 " properties": {
 " $event_id": "123456789", // LineId (uniek)
 " $value": 9,99,
 " Valutacode": "USD",
 Naam": "Winnie de Poeh",
 " SKU": "WINNIEPOOH",
 " ProductID": "567",
 " Categorieën": ["Fictie", "Klassiekers"],
 " Prijs": 9,99,
 " Korting": true,
 " Kosten": 5,00, // (optioneel),
 " Attribuut: Kleur": "Rood" // productattributen (optioneel)
 " $extra": {
        "Product URL Key" : "winnie-pooh",
        "Product URL" : "https://www.store.com/winnie-pooh",
        "Image URL" : "https://cnd.store.com/images/winnie-pooh.png",
    }
  }, " tijd": 1387302423
}

// 
// 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": {},
 " Valutacode": " USD",
 " Item Count": 2,
 " Items": ["Winnie the Pooh", "A Tale of Two Cities"], // Als een item meer dan eens wordt besteld, dupliceer het dan. Als iemand bijvoorbeeld twee t-shirts bestelt, zou dit zijn: ["T-Shirt", "T-Shirt"]
 " Korting": true,
 " coupon": "COUPON123",
 " Unieke items": ["Winnie the Pooh", "A Tale of Two Cities"],
 " Itemcategorieën": ["Fictie", "Klassiekers", "Kinderen"],
 " Unieke itemcategorieën": ["Fictie", "Klassiekers", "Kinderen"]
 }, "tijd": 1387302423
}

Extra hulpbronnen

• Hoe integreren met Magento 1.x (CE en EE)
• Magento integratiesysteem vereisten referentie