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?

Ja, deze functies zijn afhankelijk van het gebruik van API's om gegevensbronnen te verzenden en uiteindelijk objecten te maken.

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

Klaviyo vereist momenteel dat accounts nieuwe custom objects maken door ons data te sturen via API.

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 het tracking van items zoals een lidmaatschapsstatus, waarbij een profiel maar 1 status tegelijk kan hebben, passen profieleigenschappen beter. Als je echter 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 altijd extra, niet-verplichte eigenschappen toevoegen aan je aangepaste object. Lees voor meer informatie over het bijwerken van een aangepast object.

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. Gebruik de {{ event }} -tag om relevante properties toe te voegen aan de metadata van je event, zodat je ze in je template kunt gebruiken. Dit werkt goed wanneer timing belangrijk is.
2. Neem de ID van het object op in de metadata van het event, waardoor je het object in de template kunt ophalen met de {% customobject id={{ event.pet_id }} as pet %}. Het kan echter even duren voordat het object wordt bijgewerkt met de meest recente eigenschappen, dus het is mogelijk dat de flow een bericht heeft geactiveerd om te verzenden voordat het object was bijgewerkt.

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 (zie voorbeeld-JSON).
3. Verzend je gegevensbronrecords naar Klaviyo via API.
4. Maak je aangepaste object.
5. Maak de relatie tussen je aangepaste object en je profielen.

Hoe worden gegevensbronnen gemaakt en gebruikt?

Na het maken van een nieuwe gegevensbron geeft Klaviyo een unieke identificatiecode terug als onderdeel van de respons op je API-aanvraag. Zo 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 vertrouwt voor de bedrijfsvoering).

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

Hoe moet ik mijn gegevens opmaken?

Je developer moet gegevens in JSON-indeling naar Klaviyo sturen. We raden aan om je gegevens als tekst te verzenden met een door komma's gescheiden lijst. Je kunt segmentatie en de operator "bevat" van flowfilter gebruiken om te filteren op de waarden in deze door komma's gescheiden string. Zie de referentie voor segmentvoorwaarden voor meer informatie over filteren. 

Ondersteunde gegevenstypen in aangepaste objecten:

• Tekst
• Geheel getal
• Decimaal
• Datum - Alle datums en tijden worden in ons systeem omgezet naar UTC. Als je bijvoorbeeld “2025-04-03” uploadt, wordt dit omgezet naar “2025-04-03 00:00:00”. Voor klanten met tijdzones die drie uur voorlopen, luidt de datum en tijd “2025-04-02 21:00:00”.
• Booleaans

Het lijstgegevenstype wordt momenteel niet ondersteund. Bekijk voor een voorbeeld-payload voor de API voor data source records Data source records in bulk maken.

Wat zijn de datalimieten voor aangepaste objecten?

Je kunt maximaal 2 KB per eigenschap en 8 KB per record uploaden.

Kan ik mappen met geneste gegevens?

We raden aan om je JSON-object te definiëren zonder de eigenschappen te nesten die je voor je aangepaste object wilt gebruiken. Als je brongegevens diep genest zijn of een lijst gebruiken, moet je het JSON-pad handmatig invoeren in de objectbeheerder. Voor lijsten kun je een eigenschap alleen toewijzen aan een positie binnen die lijst (bijv. de eerste of tweede waarde).

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?

Op dit moment is het niet mogelijk om in de app de previewfunctie te gebruiken om een bericht te bekijken wanneer je de {{ object }} tag gebruikt.

Een flowbericht testen:

1. Maak een op datum getriggerde flow en zet deze live.
2. Maak een profiel met een object met een datum die pas over minimaal 24 uur wordt geactiveerd.

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.