Aan de slag met aangepaste objecten

Meer informatie over aangepaste objecten, waarmee je meerdere eigenschappen kunt opslaan en aan één 'object' kunt koppelen.  Met aangepaste objecten kun je aan Klaviyo diverse, multi-relationele gegevensconcepten toewijzen die niet kunnen worden opgeslagen met profieleigenschappen. Vervolgens kun je aangepaste objecten gebruiken in je berichten, segmenten en meer.

Wat zijn de verschillen tussen aangepaste objecten en profieleigenschappen?

profieleigenschappen zijn een geweldige manier om eenvoudige informatie op te slaan. Als je bijvoorbeeld een favoriete kleureigenschap hebt, kun je de favoriete kleur van elke klant opslaan.

Maar wat als je meer gegevens of meerdere versies van die eigenschap nodig hebt? Een goed voorbeeld is voor huisdieren. Je kunt profieleigenschappen gebruiken om dingen op te slaan zoals naam, leeftijd en ras, maar deze kunnen maar één keer per profiel worden gebruikt.

Als iemand meerdere huisdieren heeft, kun je in plaats daarvan aangepaste objecten gebruiken. Op die manier heeft Pluizig de Duitse Dog zijn eigen digitale ID-kaart met zijn naam, leeftijd, gewicht, enz., en heeft de hamster Cheeks dezelfde informatie, maar met (heel) verschillende antwoorden. 

Voorbeelden van use cases

Hieronder zie je enkele voorbeelden die laten zien hoe aangepaste objecten flexibel zijn in de gegevens die je kunt opslaan in Klaviyo.

Afspraak

Als je een bedrijf hebt waar klanten afspraken kunnen inplannen, kun je een Afspraak-object gebruiken om afspraakgegevens op te slaan voor profiel. 

Binnen elk objectrecord voor het Afspraak-object zijn enkele voorbeelden van gegevens die je kunt opnemen:

• Afspraak-ID
• Afspraakdatum
• Persoon voor afspraak (bijv. specifieke arts, cursusleider, enz.)
• Locatie van afspraak
• Afspraaktype

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 versturen.

Abonnement

Als je een bedrijf bent waar klanten zich kunnen aanmelden voor een abonnement, kun je een Abonnement-object gebruiken om abonnementsgegevens op te slaan voor profiel. 

Binnen elk objectrecord voor het Abonnement-object zijn enkele voorbeelden van gegevens die je mogelijk wilt opnemen:

• Abonnement-ID
• Abonnementsproduct
• Abonnementsprijs
• 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 reserveringen kunnen boeken, kun je een Reserveringsobject gebruiken om reserveringsgegevens voor profiel op te slaan. 

Binnen elk objectrecord voor het reserveringsobject zijn enkele voorbeelden van gegevens die je mogelijk wilt opnemen:

• Reserverings-ID
• Reserveringsdatum
• Reserveringslocatie
• Reserveringsmoment
• Aantal gasten 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 versturen.

Huisdier

Als je een bedrijf hebt dat huisdiereigenaren bedient, kun je een huisdier-object gebruiken om gegevens op te slaan over huisdieren in een profiel. 

Binnen elk objectrecord voor het huisdier-object zijn voorbeelden van gegevens die je mogelijk wilt opnemen:

• Microchip-ID huisdier
• Koosnaam
• Type huisdier (bijv. hond of kat)
• Dierenras
• 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 flow te versturen.

Accountlimieten

Aangepaste objecten hebben 3 sets accountlimieten:

• Objectlimiet
  Totaal aantal objecten dat een account kan hebben.
• Limieten voorobjecteigenschappen Het aantal eigenschappen dat een account per object kan hebben.
  
• Limieten objectrecord
  Het aantal objectrecords dat is toegestaan voor een account.

Het aantal beschikbare objecten en objectrecords is gebaseerd op het totale aantal actief profiel in je hele account. Recordlimieten worden voor alle accounts gedeeld, terwijl objectlimieten voor elk account afzonderlijk gelden.

Als je bijvoorbeeld een accountgroep hebt met 5 onderliggende accounts en elk account 100.000 actief profiel heeft, is je totale actief profiel gelijk aan 500.000. Zoals je in de onderstaande grafiek kunt zien, hebben accounts met meer dan 400.000 profiel een objectrecord-multiplier van 10. Als gevolg daarvan kunnen deze accounts gecombineerd maximaal 5 miljoen records (500.000 x 10) opslaan. Dit betekent dat je 1 account met 3 miljoen records kunt hebben zolang de resterende 4 accounts samen minder dan 2 miljoen objectrecords hebben. Wat het aantal objecten per account betreft, aangezien het gecombineerde aantal profielen meer dan 400.000 is, kan elk 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.
• Elk aangepast objectrecord mag niet meer dan 2 KB groot zijn.

Een object maken

Om aan de slag te gaan met het maken van een object in Klaviyo, ga je naar Content > Objecten. en klik op Object maken.

Van hieruit kun je een object van het begin af aanmaken of een aanbevolen objecttemplate selecteren. Om een object van het begin af aan te maken, selecteer je de knop Zelf bouwen.

In het eerste deel van de workflow voor het maken van objecten moet je de volgende informatie voor je object instellen:

• Naam
  Een naam om je object te identificeren
• Beschrijving (optioneel)
  Een beschrijving van de gegevens die je object vertegenwoordigt
• Gegevensbron
  De gegevensbron waar je objectgegevens zich bevinden.

Om een nieuwe gegevensbron aan te maken, klik je op het dropdownmenu Selecteer een gegevensbron en selecteer je vervolgens Een nieuwe gegevensbron maken.

Om een gegevensbron te maken, moet je de volgende informatie instellen:

• Naam
  Een unieke naam om de bron van je objectgegevens te identificeren.
• Beschrijving (optioneel)
  Een beschrijving van je gegevensbron.

Object-ID instellen

Zodra je een naam voor je object instelt en de gegevensbron kiest, is de volgende stap om een object-id in te stellen en de gewenste objecteigenschappen te koppelen. Tijdens deze stap kun je een voorbeeld bekijken van de gegevens die aan de gegevensbron zijn gekoppeld en die via de API voor aangepaste objecten naar Klaviyo zijn verzonden.

Het instellen van een object-ID is nodig om objectrecords van elkaar te onderscheiden. Je moet een gegevensbroneigenschap opgeven die moet worden gebruikt voor de unieke object-ID.

De object-ID moet een unieke gegevensbroneigenschap zijn die kan worden gebruikt om specifieke instanties van een objectrecord te identificeren. Met een cadeaubon-object kun je bijvoorbeeld zoiets als de unieke kortingscode als object-ID gebruiken. Deze is uniek voor elke instantie van de gegevensbron en bestaat voor elke objectrecord.

Wanneer Klaviyo gegevens ontvangt van je gegevensbron met dezelfde object-ID, wordt het bijbehorende objectrecord bijgewerkt. Om deze reden is het belangrijk dat de object-ID uniek is, zodat het juiste record wordt bijgewerkt.

Objectgegevens verzenden

Wanneer je een bestaand objectrecord bijwerkt, wordt het hele record vervangen. Daarom is het belangrijk om het hele objectrecord te verzenden, zelfs als je maar 1 eigenschap wilt bijwerken.

Stel bijvoorbeeld dat je slechts 1 van de 5 eigenschappen in een record wilt bijwerken. Als je bijgewerkte data verstuurt met de ID en alleen de 1 eigenschap die je wilt updaten, worden de andere 4 eigenschappen op nul gezet. Als een van de nieuwe nul velden is gebruikt in je profielrelatie (bijv. een profiel-ID zoals een e-mailadres), dan is het object niet langer gerelateerd aan dat profiel.

Objecteigenschappen toewijzen

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

Maar om deze reden raden we aan om objectgegevens via de API voor objectinname te verzenden in gestandaardiseerde datum- en tijdstempelindelingen. Als de waarde voor een specifieke eigenschap niet bekend is, kun je hiervoor een null-waarde instellen.

Objecteigenschappen toewijzen:

1. Selecteer in de kolom Gegevensbroneigenschap de gegevensbroneigenschap die je in je object wilt opnemen.
2. Voer in de kolom Toegewezen eigenschap de naam in die je de gegevensbroneigenschap in het object wilt hebben.
3. Selecteer in de kolom Gegevenstype het juiste gegevenstype van de eigenschap van je gegevensbron.
4. Schakel in de kolom Vereist het selectievakje in als je deze eigenschap verplicht wilt stellen in het object.
5. Selecteer de knop Toewijzing toevoegen als je extra objecteigenschappen moet toewijzen.

Geneste gegevens in toewijzing

Standaard ondersteunt de objectmanager-interface 1 nestingsniveau. Om toegang te krijgen tot diepere gegevens, moet je het pad van je keuze handmatig invoeren.

Bekijk als voorbeeld de onderstaande gegevensbron.

text Copy

{
  "type": "data-source-record",
  "attributes": {
    "record": {
      "child": {
        "child_id": "d64b8458",
        "name": {
          "first": "Theodore",
          "last": "Customer"
        },
        "birth_date": "2022-04-12",
        "email": "jon.customer@klaviyo.com",
        "phone_numbers": [
              "+11234567899",
              "+13456789123"
        ]
      }
    }      
  }
}

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

Als je een reeks in je brongegevens hebt, kun je eigenschappen per positie vinden om toe te wijzen. Je kunt bijvoorbeeld het eerste telefoonnummer binnen de Phone_ Numbers-reeks 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 koppelen je object aan een relevant profiel. Definieer de volgende informatie om een relatie in te stellen:

• Relatienaam
  Stel een naam in voor je relatie. Als je bijvoorbeeld een huisdier hebt, kun je de naam van de relatie instellen als 'Eigenaar van een huisdier'.
• Brongegevens
  Selecteer de gegevensbroneigenschappen die je aan een profiel wilt koppelen.
• Profiel-ID
  Stel de profiel-ID in (bijv. e-mail, telefoonnummer, enz.). Dit moet worden opgenomen in de gegevensbron zodat een object aan een profiel kan worden gekoppeld. Gebruik de knop Een andere eigenschap koppelen om extra paren van eigenschappen en id's toe te voegen.

Koppelingen bevestigen en object maken

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. Houd er rekening mee dat bestaande toewijzingen niet kunnen worden bewerkt als het object eenmaal is gemaakt, en dat het synchroniseren van gegevens onmiddellijk zal beginnen.

Je object wordt samen met de volgende informatie weergegeven op de pagina Objecten in Klaviyo:

• Objectnaam
• Datum aangemaakt
• Datum laatste update
• Status

Statussen van aangepaste objecten

Er zijn drie statusstatussen bij het publiceren van aangepaste objecten:

• Concept
  Het object kan nog worden bewerkt en is niet gepubliceerd of actief.
• Publiceren
  Het object maakt aangepaste objectrecords van de gegevens die je naar je gegevensbron hebt verzonden.  Als je een paar duizend records vanuit je gegevensbron hebt verzonden, wordt je object direct gepubliceerd. Als je een paar miljoen records hebt verzonden, kan het uren duren om te publiceren. Zodra dit voltooid is, wordt de status gewijzigd in Actief.
• actief
  Het object is gepubliceerd en live. Alle aangepaste objectrecords zijn gemaakt op basis van de gegevens die door je gegevensbron zijn verzonden. Alle nieuwe gegevens die voor dit object worden verzonden, genereren extra aangepaste objectrecords die aan je profiel zijn gekoppeld.

Objecten op profielpagina's

Relevante objecten verschijnen ook op een profielpagina, zodat je de objectrecords kunt bekijken die bij een profiel horen. Om de objectrecords te bekijken, ga je naar het tabblad Objecten op een profielpagina. Je kunt tussen objecten schakelen via het dropdownmenu boven de objectkaarten.

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

Een object updaten

Als je nieuwe gegevens voor een object wilt verzenden, voeg je de extra objecteigenschappen toe aan je gegevensbron en bewerk je je objecttoewijzing om deze nieuwe eigenschap op te nemen. Alle eerder gemaakte objecten geven een null weer voor deze eigenschap omdat die gegevens niet beschikbaar zijn, maar vanaf nu worden objecten gemaakt en bijgewerkt met deze eigenschap.

Als je nieuwe objecteigenschappen verstuurt die nog niet zijn toegewezen aan een object, kun je je aangepaste object updaten om het op te nemen. Alle aangepaste objectrecords worden vervolgens opnieuw verwerkt om deze gegevens op te nemen.

Een object bijwerken:

1. Klik op Content > 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 Objecteigenschappen toewijzen op Toewijzing toevoegen.

1. Selecteer in de kolom Gegevensbroneigenschap de gegevensbroneigenschap die je in je object wilt opnemen.
2. Voer in de kolom Toegewezen eigenschap de naam in die je de gegevensbroneigenschap in het object wilt hebben.
3. Selecteer in de kolom Gegevenstype het juiste gegevenstype voor de eigenschap van je gegevensbron.

1. Klik op Volgende in de rechterbovenhoek.
2. Klik op Volgende in de rechterbovenhoek. Je hoeft geen wijzigingen in je relaties aan te brengen.
3. Klik op Wijzigingen publiceren.

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

Een object verwijderen

Een object verwijderen:

1. Klik op Content > Objecten in de Klaviyo zijbalk.
2. Klik in het menu rechts van je object op Verwijderen.
   

3. Klik opnieuw op Verwijderen om de verwijdering van het object te bevestigen.
4. Het object en alle bijbehorende aangepaste objectrecords worden verwijderd.

Als je een nieuw aangepast object maakt met behulp van de gegevensbron van een vorige object, worden er 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. Alle segmenten, flow, template en campagnes moeten dus worden bijgewerkt om dit nieuwe object te kunnen gebruiken.