Aangepaste objecten

Overzicht

Custom Objects zijn Klaviyo objecten die elk schema kunnen accepteren en die een foreign-key verwijzing naar elk Klaviyo profielobject kunnen bevatten. Terwijl onze andere recordtypes (profiel, evenementen, campagnes, etc.) vaste schema's hebben (een profiel heeft bijvoorbeeld voornaam, achternaam, e-mail, locatie, accepteert marketing, etc.), en terwijl sommige, zoals profiel, aangepaste velden kunnen accepteren (favoriete kleur, huisdiertype), is er een beperkte hoeveelheid flexibiliteit om alternatieve gegevensstructuren te accepteren. Aangepaste objecten zijn een flexibel alternatief.

Wat is een schema?

Een schema is de structuur die een databasetabel definieert. Je kunt een schema zien als de kolomkoppen in een Excel spreadsheet: het vertelt je hoe elk veld heet en wat voor soort gegevens het bevat, zoals data, string (tekst), numeriek, boolean (waar/onwaar), enz.

Het volgende is bijvoorbeeld een standaard profielzaak in Klaviyo.

Als we kijken hoe de gegevens zaak is in Klaviyo, kunnen we de structuur (of het schema) in JSON-formaat zien.

{
 "created": "2018-07-10 13:28:25",
 "updated": "2018-07-10 13:28:26",
 "object": "person",
 "id": "Lwxf3r",
 "$email": "klaviyogreen@gmail.com", 
 "$first_name": "John",
 "$last_name": "Smith",
}

Wat kun je doen met aangepaste objecten?

Met aangepaste objecten kun je een schema definiëren voor een nieuw databaseobject. Dit object kan een foreign key relatie hebben (dat wil zeggen, het kan verwijzen naar) elk ander bestaand profielobject binnen Klaviyo.

Dit is handig als je een profiel hebt met meerdere gerelateerde records die allemaal hetzelfde schema hebben. Als je bedrijfsmodel bijvoorbeeld cadeaukaarten gebruikt, dan kan een enkele klant nul, één of honderden cadeaukaarten aan zijn profiel gekoppeld hebben.

Andere voorbeelden zijn de volgende:

• Enquêtereacties (als een klant dezelfde enquête meerdere keren invult)
• Evenement bijwonen
• Gesprekken met je klanten
• Productreviews

Hoe kun je aangepaste objectgegevens gebruiken in Klaviyo?

Aangepaste objectgegevens kunnen worden gebruikt om segmenten op te bouwen binnen Klaviyo en om gegevens door te geven in een e-mail. 

segment met aangepaste objectgegevens

Momenteel werkt segmentatie alleen op datumvelden (voor / na / op / tussen datums) en getalvelden (meer dan, minder dan, gelijk aan, tussen).

Laten we zeggen dat je een aangepast object hebt gemaakt dat cadeaukaartinformatie voor je klant regelt. Met de gegevens van je aangepaste objecten kun je een segment samenstellen die alle profielen bevat met een of meer cadeaubonnen met een waarde van minder dan $50 of meer.

Als je datuminformatie doorgeeft, zou je een segment kunnen bouwen die alle profielen bevat die een evenement hebben bijgewoond tussen 1 maart 2018 en 31 maart 2018.

Aangepaste objectgegevens doorgeven in een Email

Elk veld binnen een aangepast object kan in de hoofdtekst van een e-mail worden opgenomen. Je kunt bijvoorbeeld een templatetag gebruiken om een variabele in te voegen die de cadeaukaartcode, de huidige waarde van de cadeaukaart en de vervaldatum weergeeft.

De tag kan alle records met betrekking tot een profiel doorlopen en de waarden van al deze records weergeven. Als een klant acht verschillende cadeaukaarten heeft, kun je al hun codes in een tekstblok laten zien, met de huidige waarde ernaast.

De tag kan optellen of andere basisbewerkingen (min, max) uitvoeren op numerieke gegevens uit aangepaste objectrecords. Je kunt bijvoorbeeld de waarde van alle acht cadeaubonnen bij elkaar optellen en dit weergeven in de onderwerpregel van je e-mail. Raadpleeg onze gids voor templatetag en variabele syntaxis voor meer informatie.

Hoe stel ik het in?

Nadat je contact hebt opgenomen met ons klant supportteam, is je eerste stap om je bestaande databron in kaart te brengen met het schema framework voor het maken van een Klaviyo Custom object.

Hieronder zie je een voorbeeld van de gegevens van een enkel aangepast object in Klaviyo.

"config": {
 " 602": {
 " desired_fields": [
 " custrecord_gc_shopify_gc_internal_id",
 " custrecord_gc_remaining_balance",
 " custrecord_gc_initial_balance",
 " custrecord_gc_disabled",
          "custrecord_gc_gift_card_type",
 " custrecord_gc_sales_order",
 " custrecord_gc_customer",
 " custrecord_gc_retrieve_balance",
 " custrecord_gc_gift_card_number
 ],
 " desired_fields_mapping": {
            "custrecord_gc_gift_card_number": "code",
            "custrecord_gc_gift_card_type": "type",
            "custrecord_gc_remaining_balance": "value",
            "custrecord_gc_sales_order": "shopify_order_number"
        },
 " email_field": "custrecord_gc_customer",
 " emails_separate": 1,
 " fields_to_display": [
 " custrecord_gc_sales_order",
 " created_external",
 " custrecord_gc_gift_card_type",
 " custrecord_gc_initial_balance",
 " custrecord_gc_remainining_balance"
 ],
 " index_on": [
            "custrecord_gc_gift_card_type",
 [
 " klaviyo_customer_id",
 " custrecord_gc_gift_card_number",
 " custrecord_gc_remaining_balance"
 ]
       ],
 " mapping": "gift_card",
 " parsers": {
            "custrecord_gc_sales_order": [
                "Sales Order #",
                "after"
            ]
        }
    }
}

We kunnen deze voorbeeldgegevens gebruiken om Klaviyo's aangepaste object schema framework af te breken.

"config": {
 " 602": {
 " desired_fields": [],
 " desired_fields_mapping": {},
 " email_field": "custrecord_gc_customer",
 " emails_separate": 1,
 " fields_to_display": [],
 " index_on": [
 " custrecord_gc_gift_card_type",
 [
 " klaviyo_customer_id",
 " custrecord_gc_gift_card_number",
 custrecord_gc_remaining_balance"
 ]
       ],
 " mapping": "gift_card",
 " parsers": {
            "custrecord_gc_sales_order": [
                "Sales Order #",
                "after"
            ]
        }
    }
}

Zodra u uw schema hebt gedefinieerd zodat het overeenkomt met het aangepaste objectframework van Klaviyo, werkt u samen met de ingenieurs van Klaviyo om een methode te implementeren om uw gegevens naar Klaviyo te sturen.