Veelgestelde vragen over aangepaste objecten

Wat je leert

Lees meer over veelgestelde vragen over aangepaste objecten in Klaviyo. Als je je vraag niet terugziet in de bron hieronder, neem dan contact op via ons Community-forum.

Algemene vragen over objecten

Heb ik een developer nodig om een object te maken?

Je hebt een developer nodig om aangepaste gegevens te versturen via API's. Je kunt de gegevensbron maken en het object configureren in Klaviyo.

Kan ik aangepaste objecten maken met Klaviyo-formulieren of CSV-uploads?

Klaviyo-formulieren en CSV-uploads verzenden geen records van aangepaste objecten. Gebruik de API om je aangepaste gegevens te verzenden en koppel deze vervolgens aan een object in Klaviyo.

Wanneer moet ik een aangepast object gebruiken in plaats van een profieleigenschap of event?

Je moet aangepaste objecten gebruiken als je een many-to-one-relatie hebt tussen de categorie die je aangepaste object vertegenwoordigt en je profielen. Als je bijvoorbeeld informatie wilt bewaren over de huisdieren van je klant en je klant mogelijk meer dan één huisdier heeft, werkt het veel beter om deze als een aangepast object weer te geven dan als profieleigenschappen of events.

Bij tracking van items zoals een lidmaatschapsstatus, waarbij een profiel maar één status tegelijk kan hebben, is een profieleigenschap een betere keuze. Maar als je ook andere details over het lidmaatschap van een profiel wilt opslaan, kan een object beter werken.

Wanneer je iets groots tracking, zoals hoe vaak een ontvanger een e-mail heeft geopend, raden we aan om events te gebruiken.

Kan ik mijn aangepaste object bijwerken nadat het is gemaakt?

Ja, je kunt niet-verplichte eigenschappen toevoegen tot aan de limiet voor objecteigenschappen van je account. Lees voor meer informatie over een aangepast object bijwerken.

Wanneer moet ik een event verzenden in plaats van de eigenschappen van het aangepaste object bij te werken?

Events zijn bedoeld om flows snel te triggeren, zodat je tijdige en relevante berichten kunt sturen. Wanneer de status van een object verandert en je als gevolg daarvan een bericht wilt triggeren, moet je het object bijwerken met de nieuwe informatie en ons een event sturen om de flow te triggeren.

Je kunt templates personaliseren met de objectgegevens in de door events geactiveerde flow. Er zijn twee manieren om dit te doen:

1. Neem de eigenschappen die je nodig hebt op in de gebeurtenisgegevens en verwijs er vervolgens naar in je template. Als het event bijvoorbeeld een pet_name-eigenschap bevat, gebruik je {{ event.pet_name }}. Dit werkt goed als timing belangrijk is.
2. Neem de ID van het object op in de eventgegevens en haal daarna het object op in de template. Voor een object met de naam Pet met een eigenschap Name en een eventeigenschap met de naam pet_id gebruik je {% customobject event.pet_id object_type_title="Pet" as pet %}{{ pet.Name }}{% endcustomobject %}. Vervang deze namen door de namen van je eigen object, eigenschap en eventveld. Het kan even duren voordat objectupdates beschikbaar zijn, dus een flow-bericht kan worden verzonden voordat het object de nieuwste waarden heeft.

Vragen over het verzenden van objectdata

Hoe begin ik met het verzenden van mijn gegevens voor aangepaste objecten?

1. Maak een nieuwe gegevensbron met onze API.
2. Definieer je gegevensstructuur met het voorbeeld-JSON in Data source-records in bulk aanmaken.
3. Verzend je gegevensbronrecords naar Klaviyo via API.
4. Maak je aangepaste object met die gegevensbron. Kies een unieke object-ID en wijs de eigenschappen toe die je wilt gebruiken.
5. Maak de relatie tussen je aangepaste object en je profielen door de profiel-id’s in je gegevens te koppelen, zoals e-mailadres of telefoonnummer.
6. Controleer je mappings, klik op Object maken en klik daarna nogmaals op Object maken om te bevestigen.

Hoe worden gegevensbronnen gemaakt en gebruikt?

Wanneer je via de API een gegevensbron maakt, retourneert Klaviyo een unieke identificatiecode als onderdeel van de respons op je API-aanvraag. Hierdoor kan Klaviyo gegevensbronnen identificeren, vooral in gevallen waarin een account meerdere gegevensbronnen heeft (bijv. 1 voor elke aangepaste integratie, datawarehouse of aangepaste integratie van een externe partij waarop het merk voor zijn bedrijf vertrouwt).

Met deze unieke identificatie kan je developer vervolgens gegevensbronrecords maken via de API van Klaviyo.

Hoe moet ik mijn gegevens opmaken?

Je developer moet JSON-gegevens naar Klaviyo sturen. Voor een eigenschap met meerdere tekstwaarden stuur je een array met strings en wijs je deze toe als Lijst (tekst). Je kunt deze waarden filteren in segmenten en flows. Bekijk de referentie voor segmentvoorwaarden voor meer informatie over filteren.

Ondersteunde gegevenstypen in aangepaste objecten:

• Tekst
• Getal (geheel getal)
• Getal (decimaal)
• Tijdstempel: datums en tijden worden opgeslagen in UTC. Een waarde zonder tijdzone, zoals 2025-04-03, wordt behandeld als 2025-04-03 00:00:00 UTC. Een waarde met een offset, zoals 2025-04-03T00:00:00+03:00, wordt geconverteerd naar 2025-04-02 21:00:00 UTC.
• Booleaans
• Lijst (tekst)

Lijst (tekst) ondersteunt arrays van strings, zoals ["dog", "cat"]. Het ondersteunt geen arrays van getallen, geneste lijsten of objecten. Bekijk voor een voorbeeldpayload voor de data source record API Data source records in bulk aanmaken.

Wat zijn de datalimieten voor aangepaste objecten?

Elke toegewezen aangepaste objecteigenschap kan maximaal 2 KB bevatten en elk toegewezen aangepast objectrecord kan maximaal 8 KB bevatten.

Kan ik mappen met geneste gegevens?

We raden aan je JSON-object te definiëren zonder de eigenschappen te nesten die je voor je aangepaste object wilt gebruiken. Voor geneste gegevens selecteer je een eigenschap in het vervolgkeuzemenu Eigenschap van gegevensbron of voer je het JSON-pad handmatig in. Voor een lijst met tekstwaarden wijs je de lijst zelf toe als Lijst (Tekst). Om één item uit een array toe te wijzen, gebruik je de positie, zoals [0] voor het 1e item of [1] voor het 2e.

Kan ik meerdere identifiers koppelen aan een profiel?

Ja, als je 2 of meer profiel-id's (bijv. e-mail en telefoonnummer) wilt gebruiken om je aangepaste objectrecords aan een profiel te koppelen, zorg er dan voor dat je beide eigenschappen in elke synchronisatie opneemt, zelfs als de waarde van een van beide null is. 

Vragen over het gebruik van objecten met flows

Als mijn object geen flow heeft geactiveerd en ik geen object-id uit een event heb, kan ik mijn berichten dan nog steeds personaliseren?

Ja, je kunt objectfilters gebruiken om het juiste object te vinden bij het personaliseren van je berichten.

Kan ik flow-berichten bekijken wanneer een object een flow triggert?

Ja. Je kunt berichten die {{ object }} -gegevens gebruiken vooraf bekijken in een op datum getriggerde flow op basis van een aangepast object, voordat je de flow live zet.

Om een e-mail te bekijken:

1. Open een e-mail in een datumgestuurde flow op basis van een aangepast object en klik vervolgens op Voorbeeld bekijken in de e-maileditor.
2. Selecteer een profiel dat is gekoppeld aan een record voor dat object en controleer vervolgens het gepersonaliseerde bericht.

De preview gebruikt een voorbeeldobject dat is gekoppeld aan het geselecteerde profiel. Als er geen beschikbaar is, gebruikt de preview een voorbeeldrecord van hetzelfde objecttype. Controleer de weergegeven waarden: de preview bevestigt niet welk record de flow activeert. Als er geen records beschikbaar zijn, zijn er geen objectgegevens om te previewen.

Kan ik mijn objecten bijwerken met flow-acties zoals webhooks en Klaviyo-code?

Op dit moment raden we je aan om eerst je oorspronkelijke gegevensbron bij te werken en vervolgens het herziene object in de toegestane indeling terug naar Klaviyo te sturen. Als deze twee systemen niet meer synchroon lopen, loop je het risico dat je een verouderd record vanuit je systeem terug naar Klaviyo stuurt, waardoor het wordt teruggezet naar de oorspronkelijke waarde.