Square-datareferens

Du kommer att lära dig

Läs mer om vilka data som synkas från Square till Klaviyo, hur du kan se dem och vilka egenskaper Square-händelser innehåller.

Innan du börjar

Om du inte redan har gjort det, läs vår artikel om att Komma igång med Square för steg-för-steg-instruktioner om hur du integrerar din butik innan du fortsätter med den här artikeln.

Så här visar du dina data

Se till att din Square-integration är aktiverad. Så här kontrollerar du datasynkroniseringen från Square till Klaviyo:

1. I ditt Klaviyo-konto väljer du integrationer i navigeringen till vänster.
2. Välj Square från listan.
3. Välj fliken Data högst upp.

Här ser du senaste data som har synkats från Square till Klaviyo, och en förloppsindikator medan synkningen av dina historiska data pågår.

Om du har problem med din synkronisering väljer du Starta om importen i avsnittet historiska data för att starta om en ofullständig historisk synkronisering, eller Importera om för att köra den igen efter att den har slutförts. Du behöver behörighet att hantera integrationer för att använda de här kontrollerna.

Data synkroniserade från Square

Händelser från Square Online synkroniseras till Klaviyo i realtid och händelser från Square POS synkroniseras var 30:e minut.

Data som synkroniseras från Square till Klaviyo omfattar:

• Kända webbplatsbesökare som spåras som Aktiv på webbplatsen -händelser (om du lät inställningen för JavaScript på webbplatsen vara ibockad)
• Avsluta prenumeration på e-post
• Kundinformation som är kopplad till orderhändelser
• Din Square-katalog (inklusive endast POS-artiklar)
• Följande händelser:
  • Övergav kassa
  • Skapade Beställning
  • Beställd Produkt
  • Återbetalad Beställning
  • Avbruten Beställning
  • Uppfylld partiell beställning
  • Hanterad Beställning

Square POS-händelser för beställningar synkroniseras till Klaviyo (och Klaviyo-profiler skapas) om det finns en e-postadress och/eller ett telefonnummer som är kopplat till beställningen och som kunden direkt har delat med ditt företag.

Händelser på ordernivå, som Placed Order och Refunded Order, innehåller egenskapen Source Name som identifierar källan, till exempel Square Online eller POS, så att du kan segmentera dessa händelser i Klaviyo. Den här egenskapen ingår inte i händelserna Ordered Product eller Abandoned Checkout.

Information om kundinformation

Kundprofiler synkroniseras från Square till Klaviyo om det finns en e-postadress och/eller ett telefonnummer kopplat till kunden, som kunden har delat direkt med ditt företag. Profiler som synkroniseras från Square till Klaviyo kan innehålla följande egenskaper, beroende på vilka data som finns tillgängliga i Square:

• E-post
  Kundens e-postadress
• Förnamn
  Kundens förnamn, om både för- och efternamn är tillgängliga
• Efternamn
  Kundens efternamn, om både förnamn och efternamn är tillgängliga
• Stad
  Kundens stad
• Delstat/region
  Kundens delstat
• Postnummer
  Kundens postnummer
• Land
  Kundens land
• Telefonnummer
  Kundens telefonnummer. Klaviyo skapar bara profiler med enbart telefonnummer om du har konfigurerat Klaviyo SMS.
• Födelsedag
  Kundens födelsedatum, om det har angetts
• Square-grupper
  Square-grupper som är kopplade till kunden. Detta inkluderar för närvarande inte Square-segment

E-postsamtycke

Square-integrationen synkar status för att avsluta prenumeration via e-post, men synkar inte samtycke till e-postregistrering. När email_unsubscribed är true i Square markerar Klaviyo kunden som avsluta prenumeration. När det är false ändrar synkroniseringen inte en befintlig profils prenumerationsstatus för e-post. Nya profil utan samtycke för e-post markeras som Aldrig prenumererat.

sms-samtycke

SMS-samtycke som samlas in i Square Online kan för närvarande inte synkas till Klaviyo. Du kan samla in sms-samtycke via ett Klaviyo-formulär på din Square-webbplats.

Katalogartikelinformation

Katalogobjekt synkas från Square till Klaviyo med följande egenskaper:

• Artikelnamn
• Artikel-ID
• Artikelbeskrivning
• Artikelpris
• SKU
• URL
• Bild-URL
• Lagertillgängligt antal
• Lagerpolicy
• Kategori
• Publicerad
• Varianter

Synkroniserade händelser och deras egenskaper

Övergav kassa

Den här händelsen utlöses 1 timme efter att en övergiven kundvagn har övergivits i en Square Online-butik och kan användas i ett övergiven kundvagnsflöde. Square måste tillhandahålla en kundpost med en giltig e-postadress eller ett giltigt telefonnummer för att händelsen ska synkroniseras.

För att den här händelsen ska synkas till Klaviyo måste du först stänga av e-postmeddelanden för övergiven kundvagn i Square. För att göra det:

1. Logga in på Square och gå till din översiktssida
2. Välj Kommunikationer > Övergivna kundvagnar
3. Välj Inaktivera

De övergripande egenskaperna för händelsen i Klaviyo är:

• $value
  Totalt belopp i varukorgen
• Artiklar
  Artiklar som ingår i varukorgen
• Samlingar
  Samlingar som är kopplade till artiklarna som ingår i varukorgen

Övergiven kassa -händelser inkluderar inte någon egenskap på toppnivå för antal artiklar.

Skapade Beställning

Den här händelsen utlöses när en beställning görs i en Square Online-butik eller på en POS-terminal.

De övergripande egenskaperna för händelsen i Klaviyo är:

• $value
  Totalt belopp för beställningen
• Artiklar
  Artiklar som ingår i ordern
• Samlingar
  Samlingar länkade till artiklarna som ingår i beställningen
• Antal artiklar
  Totalt antal artiklar som ingår i beställningen
• Rabattkoder
  Namn på rabatter som har tillämpats på beställningen
• Totala rabatter
  Totalt rabattbelopp
• Källnamn
  Källa för beställningen (Square Online, POS)
• Platsnamn
  Square-platsnamn

Beställd Produkt

Den här händelsen utlöses när en beställning görs i en Square Online-butik eller via en POS-terminal. För katalogprodukter som säljs i hela enheter utlöses en Ordered Product -händelse för varje enhet som köps, upp till 100 händelser per orderrad. För produkter som säljs efter vikt eller en annan fraktionerad enhet motsvarar 1 händelse hela den mängd som köps.

De övergripande egenskaperna för händelsen i Klaviyo är:

• $value
  Värdet på produktkvantiteten som representeras av den här händelsen, inklusive modifierare och exklusive moms
• Namn
  Namnet på den beställda produkten
• Variation
  Namn på produktvariationen
• SKU
  Produkt-SKU
• ProductID
  Produktidentifierare
• VariationID
  Variationsidentifierare
• Kvantitet
  1 för varje händelse för heltalsenheter, eller den totala inköpta kvantiteten för en produkt som säljs i fraktionerade enheter
• Samlingar
  Samlingar som är länkade till produkten
• Variationsalternativ: [alternativnamn]
  Värde för produktens namngivna variationsalternativ som beställts
• Modifieraralternativ: [modifier list name]
  Valda modifieraralternativ från den namngivna modifierarlistan för den beställda produkten

Återbetalad Beställning

Den här händelsen utlöses när en beställning återbetalas i en Square Online-butik eller på en POS-terminal.

De övergripande egenskaperna för händelsen i Klaviyo är:

• $value
  Återbetalt belopp
• Kvitto-URL
  URL för orderkvitto
• Källnamn
  Källa för beställningen (Square Online, POS)
• Platsnamn
  Square-platsnamn

Avbruten Beställning

Den här händelsen utlöses när en kund skapar en beställning i din butik men sedan avbryter hela beställningen. Händelsen som Klaviyo spårar innehåller all produktinformation om de varor som någon köpte, inklusive produktnamn och bilder. Partiella avbokningar stöds inte.

De övergripande egenskaperna för händelsen i Klaviyo är:

• $value
  Totalt belopp för beställningen
• Artiklar
  Artiklar som ingår i beställningen
• Samlingar
  Samlingar länkade till artiklarna som ingår i beställningen
• Antal artiklar
  Totalt antal artiklar som ingår i beställningen
• Rabattkoder
  Namn på rabatter som har tillämpats på beställningen
• Totala rabatter
  Totalt rabattbelopp
• Källnamn
  Källa för beställningen (Square Online, POS)
• Platsnamn
  Square-platsnamn

Uppfylld partiell beställning

En Fulfilled Partial Order -händelse loggas för varje slutförd försändelse, leverans eller upphämtning, samtidigt som andra uppfyllelser fortfarande är ofullständiga. När alla uppfyllelser är slutförda registreras den sista uppfyllelsen som Fulfilled Order. Om Square inte tillhandahåller artikelinformation för en delvis uppfyllelse innehåller händelsen information om hela ordern.

De övergripande egenskaperna för händelsen i Klaviyo är:

• $value
  Totalt belopp för uppfyllelsen
• Artiklar
  Artiklar som ingår i leveransen
• Kollektioner
  Kollektioner kopplade till artiklarna som ingår i leveransen
• Antal artiklar
  Totalt antal artiklar som ingår i leveransen
• Rabattkoder
  Namn på rabatter som har tillämpats på beställningen
• Totala rabatter
  Totalt rabattbelopp
• Källnamn
  Källa för beställningen (Square Online, POS)
• Platsnamn
  Square-platsnamn

Hanterad Beställning

Den här händelsen utlöses när en beställning levereras från en Square Online-butik eller POS-terminal. En Levererad beställning -händelse loggas vid den senaste leveransen om det finns flera leveranser kopplade till en beställning.

De övergripande egenskaperna för händelsen i Klaviyo är:

• $value
  Totalt belopp för beställningen
• Artiklar
  Artiklar som ingår i ordern
• Samlingar
  Samlingar länkade till artiklarna som ingår i beställningen
• Antal artiklar
  Totalt antal artiklar som ingår i beställningen
• Rabattkoder
  Namn på rabatter som har tillämpats på beställningen
• Totala rabatter
  Totalt rabattbelopp
• Leveransstatus
  Orderstatus som rapporteras av Square
• Källnamn
  Källa för beställningen (Square Online, POS)
• Platsnamn
  Square-platsnamn

Ytterligare resurser