Magento 1-datareferens

Du kommer att lära dig

Ta reda på vilka data din befintliga Magento 1-integration synkroniserar till Klaviyo, inklusive historiska beställningar, kundregister och produkter. Efter den första historiska synkroniseringen synkroniseras beställningar, kunder och produkter var 30:e minut.

I Klaviyo går du till Analytics > mättal i det vänstra sidofältet för att visa mättalen för ditt Konto. Mättal med en Magento-ikon synkroniseras från dina Magento-integrationer.

Magento-mättal

Avbruten Beställning

Den här händelsen spåras när en kund skapar en beställning i din Magento-butik men sedan avbryter beställningen innan den har fullgjorts. Klaviyo spårar tillhörande data, inklusive all produktinformation om varorna som någon har köpt. Produktinformation inkluderar produktnamn, bilder och variationsinformation som du kan använda i uppföljningsmejl efter köp.

De här händelserna inkluderar följande orderdata. Du kan använda egenskaper på toppnivå för att filtrera och rikta in händelser. Attributdetaljer under extra kan användas för meddelandeinnehåll.

• Värde: Orderns totalsumma från Magento, inklusive moms och frakt efter rabatter.
• Artiklar: Produktnamnen från varje orderrad (t.ex. t-shirt eller byxor). Ett namn kan visas mer än en gång om det finns på separata rader.
• Artikelkategorier: Kategorierna för produkterna i beställningen (t.ex. t-shirts, herrkläder, byxor och rea).
• Artikelantal: Antalet orderrader i beställningen (t.ex. 2). Detta är inte summan av de beställda kvantiteterna.
• Valutakod: Valutakoden för beställningen (t.ex. USD eller EUR).
• Rabatterad: Om en rabatt tillämpades på ordern (sant eller falskt).
• Kupong: Kupongkoden som har tillämpats.
• Unika artiklar: produktnamnen i beställningen där dubbletter har tagits bort (t.ex. tröjor eller shorts).
• Unika artikelkategorier: Produktkategorierna i ordern med dubbletter borttagna (t.ex. herr eller rea).
• Attribut (valfritt): Produktattribut i artikelinformationen under extra. Använd händelser för beställda produkter för att filtrera efter enskilda produktattribut.

Kassaprocess Slutförd

Denna händelse spåras när en kund slutför en betalning i din Magento-butik. Checkout Completed-händelser synkroniseras inte historiskt, så deras totalsummor kanske inte återspeglar alla tidigare kassor. Använd Placed Order-händelser för intäktsrapportering och segmentering.

Du kan filtrera och rikta in dig på händelserna Checkout Completed baserat på följande kriterier:

• Värde: Det totala värdet av beställningen.
• Rabattkoder: Alla kupong- eller rabattkoder som används.
• Varor: Namnen på produkterna i någons varukorg (t.ex. t-shirt eller byxor).
• Antal artiklar: Det totala antalet artiklar i någons kundvagn.
• Totala rabatter (valfritt): Totalt dollarvärde för eventuella kuponger eller rabatter.

Kassaprocess påbörjad

Den här händelsen spåras när en kund anger sin kontakt- och leveransinformation på första sidan i Magentos kassaprocess och sedan klickar på fortsätt. Klaviyo spårar relaterade produktdata om varor i någons kundvagn, inklusive produktnamn, bilder och variationsinformation, som du kan använda i dina e-postmeddelanden för övergiven kundvagn. Den här händelsen har en egenskap för utchecknings-URL som länkar tillbaka till varje kunds exakta kundvagn och som kan användas för att bygga upp kundvagnen igen om en kund öppnar e-postmeddelandet från en ny enhet.

Du kan filtrera och rikta in dig på händelserna Kassa påbörjad baserat på följande kriterier:

• Värde: Varukorgens värde vid utcheckning (delsumma + fraktkostnad – eventuella rabatter).
• Varor: Namnen på produkterna i någons varukorg (t.ex. t-shirt eller byxor).
• Antal artiklar: Det totala antalet artiklar i någons kundvagn.
• Rabattkoder (valfritt): Alla kupong- eller rabattkoder som har tillämpats.
• Totala rabatter (valfritt): Totalt dollarvärde för eventuella kuponger eller rabatter.

Hanterad Beställning

Med Magentos standardorderstatusar spåras den här händelsen när en order når statusen slutförd. Klaviyo spårar relaterad produktinformation om varorna som någon har köpt, inklusive produktnamn, bilder och variationsinformation som du kan använda i uppföljningsmejl efter köp.

De här händelserna inkluderar följande orderdata. Du kan använda egenskaper på toppnivå för att filtrera och rikta in händelser. Attributdetaljer under extra kan användas för meddelandeinnehåll.

• Värde: Orderns totalsumma från Magento, inklusive moms och frakt efter rabatter.
• Artiklar: Produktnamnen från varje orderrad (t.ex. t-shirt eller byxor). Ett namn kan visas mer än en gång om det finns på separata rader.
• Artikelkategorier: Kategorierna för produkterna i beställningen (t.ex. t-shirts, herrkläder, byxor och rea).
• Artikelantal: Antalet orderrader i beställningen (t.ex. 2). Detta är inte summan av de beställda kvantiteterna.
• Valutakod: Valutakoden för beställningen (t.ex. USD eller EUR).
• Rabatterad: Om en rabatt tillämpades på ordern (sant eller falskt).
• Kupong: Kupongkoden som har tillämpats.
• Unika artiklar: produktnamnen i beställningen där dubbletter har tagits bort (t.ex. tröjor eller shorts).
• Unika artikelkategorier: Produktkategorierna i ordern med dubbletter borttagna (t.ex. herr eller rea).
• Attribut (valfritt): Produktattribut i artikelinformationen under extra. Använd händelser för beställda produkter för att filtrera efter enskilda produktattribut.

Beställd Produkt

Den här händelsen spåras när en kund genomför sin beställning. För heltalskvantiteter spåras 1 Ordered Product-händelse för varje köpt enhet, upp till 100 händelser per orderrad. Om någon till exempel köper en t-shirt och ett par byxor registreras 1 Placed Order-händelse och 2 Ordered Product-händelser: 1 för t-shirten och 1 för byxorna. För produkter som säljs i decimalkvantiteter registrerar Klaviyo 1 händelse för orderraden och inkluderar den köpta kvantiteten.

Händelsen Ordered Product innehåller detaljerad information om varje produkt som någon köper. Detta är användbart när du skapar beteendesegment baserat på alternativ för produktvariationer och annan detaljerad information som inte finns tillgänglig i händelsen Placed Order. Du kan filtrera och rikta in dig på Ordered Product-händelser baserat på följande kriterier:

• Värde: Värdet som representeras av den här händelsen före rabatter, exklusive frakt. För kvantiteter i heltal är det här orderradens totalsumma dividerad med dess kvantitet. För decimalkvantiteter är det totalsumman för hela raden.
• Namn: Namnet som ges till det här specifika objektet.
• SKU: Den SKU som har tilldelats artikeln (t.ex. REDMEDIUMTSHIRT).
• Kategorier: Kategorierna för den här produkten (t.ex. t-shirts, herr, byxor och rea).
• Pris: Produktens styckpris i orderns valuta (t.ex. tröjor 25,50 eller skor 50,25).
• Kostnad (valfritt): Produktkostnaden som registreras i Magento, när den är tillgänglig (t.ex. skjortor 13,85 eller skor 20,00).
• Valutakod: Valutakoden för beställningen (t.ex. USD eller EUR).
• Rabatterad: Om den här specifika artikeln har en rabatt tillämpad (dvs. sant eller falskt).
• ProductID: ID för en specifik produkt i din butik.
• Kvantitet: Den kvantitet som representeras av den här händelsen: 1 för kvantiteter i heltal, eller den köpta kvantiteten för en produkt som säljs i decimalmängder.
• Attribut (valfritt): Anpassade produktattribut.

Skapade Beställning

Den här händelsen spåras när en kund slutför kassaprocessen och skapar en beställning i din Magento-butik. Klaviyo spårar relaterade data, inklusive produktinformation om artiklarna som någon har köpt, inklusive produktnamn, bilder och variationsinformation som du kan använda i uppföljningsmejl efter köp. De här Placed Order -händelserna innehåller följande orderdata. Du kan använda egenskaper på toppnivå för att filtrera och rikta in händelser; attributdetaljer under extra är tillgängliga för meddelandeinnehåll.

• Värde: Orderns totalsumma från Magento, inklusive moms och frakt efter rabatter.
• Artiklar: Produktnamnen från varje orderrad (t.ex. t-shirt eller byxor). Ett namn kan visas mer än en gång om det finns på separata rader.
• Artikelkategorier: Kategorierna för produkterna i beställningen (t.ex. t-shirts, herrkläder, byxor och rea).
• Artikelantal: Antalet orderrader i beställningen (t.ex. 2). Detta är inte summan av de beställda kvantiteterna.
• Valutakod: Valutakoden för beställningen (t.ex. USD eller EUR).
• Rabatterad: Om en rabatt tillämpades på ordern (sant eller falskt).
• Kupong: Kupongkoden som har tillämpats.
• Unika artiklar: produktnamnen i beställningen där dubbletter har tagits bort (t.ex. tröjor eller shorts).
• Unika artikelkategorier: Produktkategorierna i ordern med dubbletter borttagna (t.ex. herr eller rea).
• Attribut (valfritt): Produktattribut i artikelinformationen under extra. Använd händelser för Beställd produkt för att filtrera efter enskilda produktattribut. Lär dig hur du granskar anpassade produktattribut.

Återbetalad Beställning

Med Magentos standardstatusar för beställningar spåras den här händelsen när en beställning når statusen stängd. Dess värde är den ursprungliga beställningens totalsumma, inte beloppet för en enskild återbetalning.

• Värde: Originalorderns totalsumma från Magento, inklusive moms och frakt efter rabatter.
• Kupong: Kupongkoden som har tillämpats.
• Valutakod: Valutakoden för beställningen (t.ex. USD eller EUR).
• Rabatterad: Om en rabatt tillämpades på ordern (sant eller falskt).
• Artikelkategorier: Kategorierna för produkterna i beställningen (t.ex. t-shirts, herrkläder, byxor och rea).
• Artikelantal: Antalet orderrader i beställningen (t.ex. 2). Detta är inte summan av de beställda kvantiteterna.
• Artiklar: Produktnamnen från varje orderrad (t.ex. t-shirt eller byxor). Ett namn kan visas mer än en gång om det finns på separata rader.
• Unika artikelkategorier: Produktkategorierna i ordern med dubbletter borttagna (t.ex. herr eller rea).
• Unika artiklar: produktnamnen i beställningen där dubbletter har tagits bort (t.ex. tröjor eller shorts).

Intäkterna för Placed Order använder Magentos ordersumma, inklusive moms och frakt efter rabatter. Om du vill filtrera ett segment baserat på $value använder du Revenue.

Betalning är tillgängligt som en egenskap på andra nivån under fältet extra. Du kan inte filtrera utifrån egenskaper på andra nivån för segmentering, men du kan använda dessa data som en händelsevariabel i e-postmallar i mättalsutlösta flöden.

Synkroniserad kunddata

Klaviyo skapar eller uppdaterar profiler baserat på synkade beställningar, kundregister och påbörjade utcheckningar. Vilken information som finns tillgänglig på en profil beror på de data som Magento tillhandahåller. Det kan inkludera:

• E-post
• För- och efternamn
• Ort, delstat/region, postnummer, land
• Telefonnummer
• Magento-konto skapat (t.ex. 2015-05-01 00:00:00)
• Magento-kundgrupp (t.ex. grossist)
• Magento-butik (t.ex. USA-butiken)
• Födelsedatum (t.ex. 1990-01-01)
• Kön
• Magento WebsiteID (när kundposten innehåller ett butiks-ID)

Om du uppdaterar kundgruppen i Magento, även efter att den ursprungliga profilen har skapats i Klaviyo, uppdateras kundgruppen i Klaviyo.

Granska anpassade produktattribut

Anpassade produktattribut beror på din befintliga konfiguration för integrationer. Konfigurerade attribut visas på händelser av typen Ordered Product som egenskaper med namnet Attribute: följt av attributkoden. Attributinformation lagras också med enskilda artiklar under extra på orderhändelser. Klaviyo support hanterar inte längre förfrågningar om att aktivera eller ändra synkronisering av Magento 1-attribut. Granska dina befintliga händelsedata för att se vilka attribut som finns. Du hittar allmän supportinformation i Så kontaktar du supporten.

För att identifiera ett anpassat attribut i din befintliga konfiguration går du till Katalog > Attribut > Hantera attribut i Magentos administratörspanel och klickar på attributet.

Hitta attribut-ID:t i webbadressen, som visas nedan.

Verifiera dina synkroniserade orderdata

För att verifiera dina synkade ordrar kan du jämföra antalet Placed Order-händelser för en avslutad dag med ordrarna i Magento för samma dag och butiker. Låt den historiska synkroniseringen bli klar och den senaste 30-minuterssynkroniseringen slutföras innan du jämför antalen.

1. Gå till Analytics > mättal och välj mättalet Magento Placed Order.
2. Ställ in Datumintervall så att det inkluderar dagen du vill jämföra. Ställ in Visa efter på Dagligen och Mått på Totalt. Ta bort eventuella Filter som skulle exkludera ordrar från jämförelsen.
3. Håll muspekaren över dagens datapunkt eller läs av värdet i tabellen under diagrammet. Jämför antalet med Magentos beställningar för samma dag och butiker.

Om antalen skiljer sig åt, kontrollera att båda rapporterna använder samma tidszon och butiksomfattning och att synkroniseringen har slutförts. Kontrollera också om omatchade Magento-ordrar väntar på betalning eller saknar en giltig e-postadress för kunden. Så här kontrollerar du din tidszon i Klaviyo:

1. Klicka på ditt kontonamn nere till vänster.
2. Klicka på Inställningar.
3. Välj Allmänt > Konto och granska inställningen Tidszon.
4. Om du ändrar Tidszon klickar du på Spara. Du behöver behörighet att redigera kontoinställningar för att ändra det här värdet.

Intäkter från Placed Order i Klaviyo drar inte av annullerade eller återbetalda beställningar. Därför kan det skilja sig från en Magento-rapport som drar av de beställningarna.

Egenskaper för synkroniserade Magento-ordrar

Nedan finns exempel på JSON-nyttolaster för mättalen Placed Order, Ordered Product och Fulfilled Order som matchar de egenskaper vi lagrar för beställningar som synkroniseras via Magento SOAP API.

Använd de här exemplen för att förstå egenskapsnamnen och nästlingen i synkade händelser. De visar formatet för den äldre händelsens nyttolast och är inte instruktioner för att skicka förfrågningar till Klaviyos nuvarande API:er. Exempelvärdena är illustrativa; extra innehåller fullständiga orderdetaljer för händelser på ordernivå.

Skapade Beställning

{
  "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
}

Beställd Produkt

{
  "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
}

Hanterad Beställning

{
  "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
}

Ytterligare resurser