Veelgestelde vragen over aangepaste objecten

Wat je leert

Lees meer over veelgestelde vragen over aangepaste objecten in Klaviyo. Als je je vraag niet terugvindt in de bronnen hieronder, bereik hem dan op ons community forum.

Algemene vragen over objecten

Heb ik een ontwikkelaar nodig om een object te maken?

Ja, deze functie is afhankelijk van het gebruik van API om gegevensbronnen te verzenden en uiteindelijk objecten te maken.

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

Klaviyo Momenteel is een account nodig om nieuwe aangepaste objecten te maken door ons gegevens te sturen via API. 

Wanneer moet ik een aangepast object gebruiken in plaats van een profieleigenschappen of gebeurtenis?

Je moet aangepaste objecten gebruiken als je een veel-op-één relatie hebt tussen de categorie die je aangepaste object vertegenwoordigt en je profiel. Als je bijvoorbeeld informatie wilt bijhouden over de huisdieren van je klant, en je klant kan meer dan één huisdier hebben, dan werkt het veel beter om deze als een aangepast object weer te geven dan profieleigenschappen of gebeurtenissen.

Bij tracking items zoals een lidmaatschapsstatus, waarbij een profiel maar één status tegelijk kan hebben, passen profieleigenschappen beter. Als je echter ook andere details over het lidmaatschap van een profiel wilt bekijken, kan een object beter werken. 

Wanneer tracking iets breed is, zoals hoe vaak een ontvanger een e-mail heeft geopend, raden we aan om gebeurtenissen te gebruiken.

Kan ik mijn aangepaste object na het maken update?

Ja, je kunt altijd extra, niet-vereiste eigenschappen toevoegen aan je aangepaste object. Lees meer over het bijwerken van een aangepast object. 

Wanneer moet ik een gebeurtenis uitzenden versus de eigenschappen van het aangepaste object bijwerken?

Gebeurtenissen zijn bedoeld om de stroom snel op gang te brengen, zodat je tijdig relevante berichten kunt sturen. Als de status van een object verandert en je wilt als gevolg daarvan een bericht triggeren, dan moet je het object update met de nieuwe informatie en ons een event sturen om de flow te triggeren.

Je kunt de sjabloon personaliseren met de objectinformatie in de getriggerde gebeurtenis flow. Er zijn twee manieren om dit te bereiken: 

1. Gebruik de {{ event }} tag om relevante eigenschappen toe te voegen aan de metagegevens van je gebeurtenis voor gebruik in je template. Dit werkt goed als tijdigheid belangrijk is.
2. Neem de ID van het object op in de metadata van de gebeurtenis, waardoor je het object kunt ophalen in de template met de {% customobject id={{ event.pet_id }} as pet %}. Het kan echter enige tijd duren voordat het object is bijgewerkt met de nieuwste eigenschappen, dus het is mogelijk dat de flow een bericht heeft getriggerd om te verzenden voordat het object was bijgewerkt.

Vragen over objectgegevens verzenden 

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. Stuur je gegevensbronrecords naar Klaviyo via API.
4. Maak je aangepaste object.
5. Maak de relatie tussen je aangepaste object en je profiel.

Hoe worden gegevensbronnen gemaakt en gebruikt?

Na het aanmaken van een nieuwe gegevensbron zal Klaviyo een unieke identifier retourneren als onderdeel van het antwoord op je API verzoek. 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 derden waarop het merk vertrouwt voor zijn bedrijf).

Met deze unieke identificatie kan je ontwikkelaar vervolgens gegevensbronrecords aanmaken via Klaviyo's API.

Hoe moet ik mijn gegevens opmaken?

Je ontwikkelaar moet JSON-geformatteerde gegevens naar Klaviyo sturen. We raden aan om je gegevens als tekst te versturen met een door komma's gescheiden lijst. Je kunt segmentatie en flowfilter's "contains" operator gebruiken om te filteren op de waarden in deze door komma's gescheiden tekenreeks. Zie de referentiesegment voorwaarden voor meer informatie over filteren.  

Ondersteunde gegevenstypen in aangepaste objecten:

• Tekst
• Integer
• Decimaal
• Datum - Alle datatijden worden in ons systeem geconverteerd naar UTC. Als je bijvoorbeeld "2025-04-03" uploadt, wordt dit geconverteerd naar "2025-04-03 00:00:00". Voor klanten met tijdzones van drie uur vooruit zou de datetime "2025-04-02 21:00:00" zijn.
• Booleaans

Het type lijstgegevens wordt momenteel niet ondersteund. Voor een voorbeeld payload voor het gegevensbronrecord API, zie Gegevensbronrecords in bulk aanmaken.

Wat zijn de gegevenslimieten voor aangepaste objecten?

Je kunt maximaal 2 KB per object uploaden en 8 KB per totale record.

Kan ik mappen met geneste gegevens?

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

Kan ik meerdere identifiers aan een profiel koppelen?

Ja, als je 2 of meer profielidentifiers (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 de eigenschappen null is.  

Vragen over het gebruik van objecten met flow 

Kan ik triggersplitsing of triggerfilters gebruiken voor datumgetriggerde stroom?

Op dit moment is het maken van triggersplitsingen en triggerfilters voor datumgetriggerde stroom niet beschikbaar.

Als mijn object geen flow heeft getriggerd en ik heb geen object-id van een gebeurtenis, 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 een voorbeeld weergeven van flow berichten wanneer een object een flow triggert? 

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

Om een flow bericht te testen:

1. Maak een datumgestuurde flow en stel deze in op live.
2. Maak een profiel met een object dat een datum heeft die over minstens 24 uur wordt getriggerd.

Kan ik update mijn objecten gebruiken met flow acties zoals webhook en Klaviyo code?

Op dit moment raden we je aan om eerst je originele gegevensbron te update en dan het herziene object terug te sturen naar Klaviyo in het toegestane formaat. Als deze twee systemen niet meer synchroon lopen, loop je het risico dat je een verouderde record terugstuurt naar Klaviyo vanuit jouw systeem, waardoor de oorspronkelijke waarde wordt hersteld.