Aan de slag met aangepaste objecten

Wat je leert

Leer meer over aangepaste objecten, inclusief hoe je een object instelt en hoe je objecten in heel Klaviyo kunt gebruiken.

Voordat je van start gaat

Je moet toegang hebben tot aangepaste objecten om deze functionaliteit te kunnen gebruiken. 

Wat zijn aangepaste objecten?

Aangepaste objecten zijn een soort gegevensstructuur in Klaviyo die je inschakelt om diverse, multirelationele gegevensconcepten in kaart te brengen in Klaviyo die niet kunnen worden aangepakt met profieleigenschappen. Stel bijvoorbeeld dat je gegevens over klant' huisdieren wilt opzoeken in Klaviyo. Elk huisdier heeft een aantal kenmerken (bijv. naam, leeftijd, ras). etc.) waardoor het een uitdaging is om deze informatie met profieleigenschappen te achterhalen als een profiel meerdere huisdieren heeft. 

Je kunt deze objectgegevens vervolgens gebruiken in flows, sjablonen en segmenten op Klaviyo om je marketing beter te personaliseren. 

Voorbeeld gebruikssituaties

Hieronder zie je een aantal voorbeelden die laten zien hoe flexibel aangepaste objecten zijn in de gegevens die je in Klaviyo kunt wijzigen. 

Afspraak

Als je een bedrijf bent waar klanten afspraken kunnen inplannen, kun je een Afspraakobject gebruiken om afspraakgegevens voor een profiel te regelen.  

Binnen elk objectrecord voor het Afspraakobject kun je bijvoorbeeld de volgende gegevens opnemen:

• Afspraak ID 
• Afspraakdatum
• Afspraak persoon (bijv. specifieke arts, instructeur, etc.)
• Afspraaklocatie
• Type afspraak 

Profiel kan meerdere objectrecords hebben als ze meerdere afspraken hebben, en je kunt deze objectgegevens gebruiken om segmenten te maken en gepersonaliseerde berichten en flow te sturen. 

Abonnement 

Als je een bedrijf bent waar klanten zich kunnen aanmelden voor een abonnement, kun je een Abonnementsobject gebruiken om abonnementsgegevens voor profielen in te vullen.  

Binnen elk objectrecord voor het Abonnementsobject kun je bijvoorbeeld de volgende gegevens opnemen:

• ID abonnement 
• Abonnementsproduct
• Prijs abonnement
• Abonnementsstatus 
• Volgende factureringsdatum

Profiel kan meerdere objectrecords hebben als ze meerdere abonnementen hebben, en je kunt deze objectgegevens gebruiken om segmenten te maken en gepersonaliseerde berichten en flow te versturen. 

Reservering

Als je een bedrijf bent waar klanten kunnen reserveren, dan kun je een Reserveringsobject gebruiken om reserveringsgegevens voor profielen in te vullen.  

Binnen elk objectrecord voor het Reserveringsobject kun je bijvoorbeeld de volgende gegevens opnemen:

• Reservering ID
• Datum reservering
• Reserveringslocatie
• Reservering gelegenheid 
• Aantal gasten bij reservering 

Profiel kan meerdere objectrecords hebben als ze meerdere reserveringen hebben, en je kunt deze objectgegevens gebruiken om segmenten te maken en gepersonaliseerde berichten en flow te sturen. 

Huisdier

Als je een bedrijf hebt dat huisdiereigenaren bedient, kun je een Huisdierobject gebruiken om gegevens over profiel 'huisdieren' in te vullen.  

Binnen elk objectrecord voor het huisdierobject kun je bijvoorbeeld de volgende gegevens opnemen:

• Identificatie microchip huisdier
• Naam huisdier 
• Type huisdier (bijv. hond of kat)
• Ras
• Verjaardag huisdier 

Profiel kan meerdere objectrecords hebben als ze meerdere huisdieren hebben, en je kunt deze objectgegevens gebruiken om segmenten te maken en gepersonaliseerde berichten en stromen te sturen. 

accountlimieten 

Aangepaste objecten hebben 3 sets van account limieten: 

• Objectlimiet
  Totaal aantal objecten dat een account kan hebben.
• Objecteigendomslimieten 
  Het aantal eigenschappen dat een account per object kan hebben.
  
• Objectrecord limieten
  Het aantal objectrecords dat is toegestaan voor een account.

Het aantal beschikbare objecten en objectrecords is gebaseerd op het totale aantal actieve profielen in al je accounts. Opnamelimieten worden gedeeld door alle accounts, terwijl objectlimieten gelden voor elke account afzonderlijk. 

Als je bijvoorbeeld een familie account hebt met 5 kindaccounts waarbij elke account 100.000 actief profiel heeft, is je totale actief profiel gelijk aan 500.000. Zoals te zien is in de grafiek hieronder, hebben accounts met meer dan 400.000 profielen een objectrecord vermenigvuldiger van 10. Hierdoor kunnen deze accounts samen maximaal 5 miljoen records (500.000 x 10) opvragen. Dit betekent dat je 1 account kunt hebben met 3 miljoen records zolang de overige 4 accounts samen minder dan 2 miljoen objectrecords hebben. Wat betreft het aantal objecten per account, aangezien het gecombineerde aantal profielen meer dan 400.000 is, kan elke account maximaal 5 objecten hebben.

Daarnaast hebben alle accounts de volgende limieten: 

• Maximaal 500 records per profiel per object.
• Elk aangepast object mag niet groter zijn dan 8 KB.
• Elke aangepaste objectrecord mag niet meer dan 2 KB zijn.

Een object maken 

Om te beginnen met het maken van een object in Klaviyo, navigeer je naar Inhoud > Objecten. 

Volg de stappen om een gegevensbron te maken en te synchroniseren voor je aangepaste object. Zodra deze stappen zijn voltooid, selecteer je de knop Aangepast object maken om het object te maken. 

Vanaf hier kun je een object vanaf nul maken of een aanbevolen object selecteren template. Om een object vanaf nul te maken, selecteer je de knop Bouw je eigen object.

Het eerste deel van de workflow voor het maken van een object vereist het instellen van de volgende informatie voor je object:

• Naam
  Een naam om je object te identificeren
• Beschrijving (optioneel)
  Een beschrijving van de gegevens die je object vertegenwoordigt
• gegevens bron
  De gegevensbron om objectgegevens vandaan te halen. Er moet minstens 1 record naar Klaviyo worden verzonden met behulp van de aangepaste object-API om als optie in de vervolgkeuzelijst te verschijnen. 

Stel de object-ID in

Zodra je een naam hebt ingesteld voor je object en de gegevensbron hebt gekozen, is de volgende stap het instellen van een object-ID en het in kaart brengen van de gewenste objecteigenschappen. Tijdens deze stap kun je een voorbeeld bekijken van de gegevens die zijn gekoppeld aan de gegevensbron die is verzonden naar Klaviyo via het aangepaste object API.

Het instellen van het object ID is nodig om objectrecords van elkaar te onderscheiden. Je moet een gegevensbron eigenschap specificeren om te gebruiken voor de unieke object ID. 

Het object-ID moet een unieke gegevensbron-eigenschap zijn die kan worden gebruikt om specifieke instanties van een objectrecord te identificeren. Met een cadeaukaartobject kunt u bijvoorbeeld de unieke kortingscode als object-ID gebruiken. Dit is uniek voor elke instantie van de gegevensbron en zal voor elk objectrecord bestaan. 

Wanneer Klaviyo gegevens ontvangt van je gegevensbron met hetzelfde object ID, wordt het bijbehorende objectrecord bijgewerkt. Daarom is het belangrijk dat het object ID uniek is, zodat het juiste record wordt bijgewerkt.

Objectgegevens verzenden

Als je update een bestaand objectrecord gebruikt, wordt het hele object vervangen. Daarom is het cruciaal om elke keer het hele object te versturen, zelfs als je maar 1 record wilt update. 

Stel bijvoorbeeld dat je slechts 1 van de 5 records in een object wilt update. Als je updategegevens stuurt met de ID en alleen de 1 record die je wilt update, worden de andere 4 records op nul gezet. Als een van de nieuwe nulvelden werd gebruikt in je profielrelatie (bijvoorbeeld een profielidentificatie zoals een e-mailadres), dan zal het object niet langer gerelateerd zijn aan dat profiel.

Eigenschappen kaartobject 

Door objecteigenschappen toe te wijzen, kun je selecteren welke informatie binnen de gegevensbron beschikbaar zal zijn binnen een object in Klaviyo.

Om deze reden raden wij u echter aan om objectgegevens via de object-ingestie-API in gestandaardiseerde datum- en tijdstempelformaten te verzenden. Indien de waarde voor een specifieke eigenschap niet bekend is, kunt u er een null-waarde voor instellen.

Objecteigenschappen in kaart brengen:

1. Selecteer in de gegevens bron eigenschap kolom de gegevens bron eigenschap die je wilt opnemen in je object. 
2. Voer in de kolom Mapped property de naam in die je aan de gegevensbron-eigenschap in het object wilt geven. 
3. Selecteer in de kolom Gegevenstype het juiste gegevenstype van je gegevensbron eigenschap.
4. Schakel in de kolom Vereist het selectievakje in als je wilt dat deze eigenschap vereist is in het object.
5. Selecteer de knop Voeg toewijzing toe als je extra objecteigenschappen wilt toewijzen. 

Geneste gegevens in mapping

Standaard ondersteunt de objectmanagerinterface 1 niveau van nesten. Om toegang te krijgen tot diepere gegevens moet je handmatig het pad van je keuze invoeren.

Kijk als voorbeeld naar de gegevensbron hieronder. 

{
  "type": "data-source-record",
  "attributen": {
    "record": {
      "kind": {
        "child_id": "d64b8458",
        "naam": {
          "first": "Theodore",
          "last": "Customer"
        },
        "geboortedatum": "2022-04-12",
        "e-mail": "jon.customer@klaviyo.com",
        "telefoonnummers": [
              "+11234567899",
              "+13456789123"
        ]
      }
    }      
  }
}

Om gegevens over de voornaam van een kind te openen, kun je het volgende pad invoeren, omdat de gegevens anders te ver genest zijn om met de interface te openen.

Als je een array in je brongegevens hebt, kun je eigenschappen vinden om in kaart te brengen op positie. Je kunt bijvoorbeeld het eerste telefoonnummer in de array phone_numbers ophalen door [0] aan het einde van je pad op te nemen. 

Relatie toevoegen 

Na het instellen van een object-ID en het toewijzen van je objecteigenschappen, is de volgende stap het toevoegen van een relatie aan je object. 

Relaties verbinden je object met relevant profiel. Definieer de volgende informatie om een relatie in te stellen: 

• Naam relatie
  Stel een naam in voor je relatie. Als je bijvoorbeeld een huisdierobject hebt, wil je misschien de relatienaam instellen op iets als "Huisdiereigenaar". 
• Brongegevens
  Selecteer de gegevensbrontypeigenschappen die je wilt koppelen aan een profiel. 
• Profiel-ID
  Stel de profielidentifier in (bijv. e-mail, telefoonnummer, enz.). Deze moet worden opgenomen in de gegevensbron om een object te kunnen koppelen aan een profiel. Gebruik de knop Koppel een andere eigenschap om aanvullende paren van eigenschappen en identifiers toe te voegen.

Bevestig toewijzingen en maak object

Zodra je klaar bent met het toewijzen van de objecteigenschappen en het instellen van de relatie, bevestig je de toewijzingen in het bevestigingsvenster en selecteer je de knop Object maken. Merk op dat bestaande mappings niet kunnen worden bewerkt zodra het object is aangemaakt, en dat de gegevens direct zullen beginnen met synchroniseren. 

Je ziet je object op de Objecten pagina in Klaviyo, samen met de volgende informatie: 

• Objectnaam
• Datum aangemaakt
• Datum laatste update
• Status

Aangepaste objectstatusstatussen

 Er zijn drie statusstatussen bij het publiceren van aangepaste objecten: 

• Concept
  Het object is nog bewerkbaar en niet gepubliceerd of actief .
• Publiceren
  Het object maakt aangepaste objectrecords van de gegevens die u naar uw gegevensbron hebt gestuurd. Als u een paar duizend records van uw gegevensbron hebt verzonden, zal uw object onmiddellijk publiceren. Als u een paar miljoen records hebt verzonden, kan het uren duren om te publiceren. Zodra het voltooid is, wordt de status gewijzigd in Actief.
• Actief
  Het object is gepubliceerd en live. Alle aangepaste objectrecords zijn aangemaakt volgens de gegevens die zijn verzonden vanuit uw gegevensbron. Alle nieuwe gegevens die voor dit object worden verzonden, zullen extra aangepaste objectrecords genereren die gekoppeld zijn aan uw profielen.

Objecten op profielpagina's

Relevante objecten verschijnen ook op een profielpagina, zodat je de objectrecords kunt bekijken die betrekking hebben op een profiel. Om de objectrecords te bekijken, navigeer je naar het tabblad Objecten op een profielpagina. Je kunt tussen objecten wisselen met het dropdown menu boven de objectkaarten. 

Om een volledig objectrecord te bekijken, selecteer je het menu met 3 puntjes en klik je op Bekijken. Er verschijnt een zijpaneel met het volledige objectrecord. 

een object bijwerken 

Als je nieuwe gegevens voor een object wilt gaan verzenden, voeg dan de aanvullende objecteigenschappen toe aan je gegevensbron en bewerk vervolgens je objectmapping om deze nieuwe eigenschap op te nemen. Alle eerder aangemaakte objecten zullen een nul retourneren voor deze eigenschap omdat die gegevens niet beschikbaar zijn, maar in de toekomst zullen objecten worden aangemaakt en bijgewerkt met deze eigenschap.

Als je nieuwe objecteigenschappen verstuurt die nog niet zijn toegewezen aan een object, kun je update gebruiken om je aangepaste object erbij te betrekken. Alle aangepaste objectrecords worden dan opnieuw bewerkt om deze gegevens op te nemen.

Een object update:

1. Klik op Inhoud > Objecten in de Klaviyo zijbalk.
2. Selecteer de naam van het object dat je wilt bewerken. 
3. Klik op Volgende in de rechterbovenhoek.
4. Klik in het gedeelte Eigenschappen kaartobject op Mapping toevoegen.

   Deze optie is alleen beschikbaar als je object extra eigenschappen heeft die kunnen worden toegevoegd.

5. Selecteer in de gegevens bron eigenschap kolom de gegevens bron eigenschap die je wilt opnemen in je object. 
6. Voer in de kolom Mapped property de naam in die je aan de gegevensbron-eigenschap in het object wilt geven. 
7. Selecteer in de kolom Gegevenstype het juiste gegevenstype van je gegevensbron eigenschap.

   Nieuw in kaart gebrachte eigenschappen kunnen niet als vereist worden gemarkeerd.

   
8. Klik op Volgende in de rechterbovenhoek. 
9. Klik op Volgende in de rechterbovenhoek. Je hoeft je relaties niet te veranderen.
10. Klik op Wijzigingen publiceren.

Als je dit proces hebt voltooid, worden alle records van je gegevensbron opnieuw verwerkt en worden bestaande aangepaste objectrecords dienovereenkomstig bijgewerkt. 

Een object verwijderen 

Om een object te verwijderen: 

1. Klik op Inhoud > Objecten in de Klaviyo zijbalk.
2. Klik in het menu rechts van je object op Verwijderen. 
   
3. Klik nogmaals op Verwijderen om het verwijderen van het object te bevestigen. 
4. Het object en alle bijbehorende aangepaste objectrecords worden verwijderd. 

Als je een nieuw aangepast object maakt met de gegevensbron van een vorig object, dan worden nieuwe aangepaste objectrecords gegenereerd met de gegevens die je al hebt gesynchroniseerd. Hoewel het dezelfde gegevens gebruikt, wordt het beschouwd als een nieuw object met nieuwe records, dus alle segmenten, stromen, sjablonen en campagnes moeten worden bijgewerkt om dit nieuwe object te gebruiken.

Extra hulpbronnen 

Hoe gebruik je aangepaste objecten in een sjabloon

Hoe gebruik je aangepaste objecten in segmenten

Hoe gebruik je aangepaste objecten in flow

API-overzicht voor aangepaste objecten