Square gegevens referentie

Wat je leert

Leer welke gegevens van Square naar Klaviyo worden gesynchroniseerd, hoe je ze kunt bekijken en welke eigenschappen Square-gebeurtenissen bevatten. Leer ook hoe je je Square gegevens in Klaviyo kunt bekijken.

Voordat je van start gaat

Als je dat nog niet hebt gedaan, lees dan eerst ons artikel over Aan de slag met Square voor stapsgewijze instructies over hoe je je zaak kunt integreren voordat je verder gaat met dit artikel.

Je gegevens bekijken

Om de gegevenssynchronisatie van Square naar Klaviyo te controleren:

1. Selecteer in je Klaviyo account het tabblad integraties .
2. Selecteer Vierkant op de lijst van inschakelen integraties.
3. Selecteer bovenaan de tab Gegevens.

Hier zie je recente gegevens die zijn gesynchroniseerd van Square naar Klaviyo en een voortgang van synchronisatiebalk voor je historische gegevens synchronisatie.

Als je problemen ondervindt met je synchronisatie, kun je hier Herstart importeren selecteren om de historische gegevens synchronisatie opnieuw te starten.

gegevens gesynchroniseerd van Square

Gebeurtenissen van Square Online synchroniseren in realtime met Klaviyo en gebeurtenissen van Square POS synchroniseren elke 30 minuten. 

De gegevens die van Square naar Klaviyo worden gesynchroniseerd zijn onder andere:

• Bekende websitebezoekers bijgehouden als actief op sitegebeurtenissen (als je de JavaScript-instelling op locatie hebt ingeschakeld)
• Email afmelden
• klantinformatie gekoppeld aan bestelgebeurtenissen
• Je Square catalogus (inclusief POS-only artikelen)
• De volgende evenementen:
  • Afrekenen verlaten
  • Bestelling geplaatst
  • Product besteld
  • Terugbetaalde bestelling
  • Geannuleerde bestelling
  • Gedeeltelijke bestelling uitgevoerd
  • Afgeronde bestelling

Square POS bestelgebeurtenissen worden gesynchroniseerd met Klaviyo (en Klaviyo profiel wordt aangemaakt) als er een e-mailadres en/of telefoonnummer is gekoppeld aan de bestelling die de klant direct heeft gedeeld met je bedrijf.

Vierkante gebeurtenissen hebben een eigenschap met de naam bronnaam die aangeeft of de gebeurtenis afkomstig is van een POS of van online/web, zodat je deze gebeurtenissen kuntsegment in Klaviyo.

klant informatie details

klantprofiel informatie synchroniseert van Square naar Klaviyo met de volgende eigenschappen:

• Email
  Email adres van klant
• Voornaam
  Voornaam van klant (verplicht)
• Achternaam
  Achternaam van klant
• City
  City van klant
• Staat/regio
  Staat van klant
• Zip Code
  Zip Code van klant
• Country
  Country van klant
• Telefoonnummer
  Telefoonnummer van de klant. Klaviyo maakt alleen een alleen-telefoon profiel aan als je SMS hebt ingesteld.Klaviyo 
• Verjaardag
  De geboortedatum van de klant, indien opgegeven
• Vierkante Groepen
  Vierkante Groepen gekoppeld aan de klant. Dit omvat momenteel niet het Vierkante segment

E-mailtoestemming

Het Square platform is een "opt-out" marketingtoestemmingsplatform. Dit betekent dat iedereen die jou zijn e-mailadres geeft, niet de kans heeft gekregen om expliciet toestemming te geven voor jouw e-mailmarketing. In plaats daarvan markeert Klaviyo degenen die e-mail_afgemeld op false hebben ingesteld in Square als "Nooit aangemeld" in Klaviyo, en degenen die e-mail_afgemeld op true hebben ingesteld in Square als "afgemeld" in Klaviyo.

toestemming voor sms

sms abonnee verzameld in Square Online kan momenteel niet synchroniseren met Klaviyo. Je kunt toestemming voor sms verzamelen via een Klaviyo formulier op je Square site.

Catalogus item details

Catalogusitems synchroniseren van Square naar Klaviyo met de volgende eigenschappen:

• Naam
• Artikel-ID
• Beschrijving
• Artikelprijs
• SKU
• URL
• Afbeelding-URL
• Inventarishoeveelheid
• Inventarisbeleid
• Categorie
• Gepubliceerd
• Varianten

Gesynchroniseerde gebeurtenissen en hun eigenschappen

Afrekenen verlaten

Deze gebeurtenis wordt getriggerd 1 uur nadat een winkelwagen is verlaten in een Square webshop, en kan worden gebruikt in een winkelwagen verlaten flow.

Om deze gebeurtenis te synchroniseren met Klaviyo, moet je eerst winkelwagen verlaten e-mail op Square uitschakelen. Om dit te doen:

1. inloggen op Square en navigeer naar je overzichtspagina
2. Selecteer communicatie > winkelwagen verlaten
3. Selecteer uitschakelen

De top-level eigenschappen van de gebeurtenis in Klaviyo zijn:

• Waarde
  Totaalbedrag in de winkelwagen
• Artikelen
  Artikelen in de bestelling
• Verzamelingen
  Verzamelingen gekoppeld aan de items in de bestelling
• Aantal artikelen
  Totaal aantal artikelen in de bestelling

Bestelling geplaatst

Deze gebeurtenis wordt geactiveerd wanneer een bestelling wordt geplaatst op een Square webshop of betaalautomaat.

De top-level eigenschappen van de gebeurtenis in Klaviyo zijn:

• Waarde
  Totaalbedrag voor de bestelling
• Artikelen
  Artikelen in de bestelling
• Verzamelingen
  Verzamelingen gekoppeld aan de items in de bestelling
• Aantal artikelen
  Totaal aantal artikelen in de bestelling
• Kortingscodes
  Kortingscodes toegepast op de bestelling
• Totaal kortingen
  Totaal kortingsbedrag
• Naam bron
  Bron van de bestelling (Square Online, POS)
• Naam locatie
  Naam vierkante locatie

Product besteld

Deze gebeurtenis wordt geactiveerd wanneer een bestelling wordt geplaatst op een Square webshop of betaalautomaat. Voor elk artikel in een geplaatste bestelling wordt een gebeurtenis Besteld product geactiveerd.

De top-level eigenschappen van de gebeurtenis in Klaviyo zijn:

• Waarde
  Totaalbedrag voor de bestelling
• Naam
  Naam van het bestelde product
• variatie naam
  Naam van de productvariatie
• SKU
  Product SKU
• Product-ID
  Product-ID
• variatie ID
  variatie identificator
• Hoeveelheid
  Aantal producten
• Verzamelingen
  Collecties gekoppeld aan het product
• variatie optie
  variatie optie van besteld product
• Wijzigingsoptie
  Wijzigingsopties toegepast op de bestelling

Terugbetaalde bestelling

Deze gebeurtenis wordt geactiveerd wanneer een bestelling wordt terugbetaald op een Square webshop of betaalautomaat.

De top-level eigenschappen van de gebeurtenis in Klaviyo zijn:

• Waarde
  Totaalbedrag voor de bestelling
• Ontvangst URL
  URL van het ontvangstbewijs van de bestelling
• Naam bron
  Bron van de bestelling (Square Online, POS)
• Naam locatie
  Naam vierkante locatie

Geannuleerde bestelling

Deze gebeurtenis wordt geactiveerd wanneer een klant een order aanmaakt in je zaak, maar vervolgens de hele order annuleert. De gebeurtenis die Klaviyo bijhoudt, bevat alle productinformatie over de artikelen die iemand heeft gekocht, inclusief productnamen en afbeeldingen. Gedeeltelijke annuleringen worden niet ondersteund.

De top-level eigenschappen van de gebeurtenis in Klaviyo zijn:

• Waarde
  Totaalbedrag voor de bestelling
• Artikelen
  Artikelen in de bestelling
• Verzamelingen
  Verzamelingen gekoppeld aan de items in de bestelling
• Aantal artikelen
  Totaal aantal artikelen in de bestelling
• Kortingscodes
  Kortingscodes toegepast op de bestelling
• Totaal kortingen
  Totaal kortingsbedrag
• Naam bron
  Bron van de bestelling (Square Online, POS)
• Naam locatie
  Naam vierkante locatie

Gedeeltelijke bestelling uitgevoerd

Een gebeurtenis voor een gedeeltelijk uitgevoerde bestelling wordt gelogd als een bestelling in meerdere keren wordt verzonden, en er wordt één gebeurtenis gelogd voor elke gedeeltelijke uitvoering.

De top-level eigenschappen van de gebeurtenis in Klaviyo zijn:

• Waarde
  Totaalbedrag voor de vervulling
• Artikelen
  Items inbegrepen in de vervulling
• Verzamelingen
  Verzamelingen gekoppeld aan de items in de vervulling
• Aantal items
  Totaal aantal items in de vervulling
• Kortingscodes
  Kortingscodes toegepast op de bestelling
• Totaal kortingen
  Totaal kortingsbedrag
• Bronnaam
  Bron van de bestelling (Square Online, POS)
• Naam locatie
  

Afgeronde bestelling

Deze gebeurtenis wordt geactiveerd wanneer een bestelling wordt uitgevoerd op een Square webshop of betaalautomaat. Een gebeurtenis voor Vervulde bestellingen wordt gelogd bij de laatste vervulling, als er meerdere aan een bestelling zijn gekoppeld.

De top-level eigenschappen van de gebeurtenis in Klaviyo zijn:

• Waarde
  Totaalbedrag voor de bestelling
• Artikelen
  Artikelen in de bestelling
• Verzamelingen
  Verzamelingen gekoppeld aan de items in de bestelling
• Aantal artikelen
  Totaal aantal artikelen in de bestelling
• Kortingscodes
  Kortingscodes toegepast op de bestelling
• Totaal kortingen
  Totaal kortingsbedrag
• FulfillmentStatus
  Status van de vervulling
• Bronnaam
  Bron van de bestelling (Square Online, POS)
• Naam locatie
  

Extra hulpbronnen

• Aan de slag met Square
• Aan de slag met segmenten
• Aan de slag met flows