Inzicht in sleutel-waardepaar

Wat je leert

Ontdek wat sleutel-waardeparen zijn en hoe je ze gebruikt met zowel standaard als stille pushmeldingen. Sleutel-waardeparen zijn aangepaste gegevens die worden toegevoegd aan pushmeldingen waarmee je app-gedrag kunt activeren, berichten kunt tag, meldingen kunt aanpassen en meer.

Wat zijn sleutel-waardepaaren?

Sleutel-waardeparen zijn aangepaste gegevens die je kunt opnemen bij pushmeldingen, zowel standaard (die aan gebruikers worden weergegeven) als stille (die onzichtbaar zijn voor gebruikers). De sleutel is een naam die je app herkent en de waarde is de informatie die je voor die sleutel verstuurt.

Met zowel stille als standaardmeldingen kunnen ze worden gebruikt om appcontent bij te werken, achtergrondtaken te activeren of berichten te taggen voor rapportagedoeleinden.

Met standaard push kunnen ze ook worden gebruikt om aangepaste push-templates te bouwen en te vullen.

Hoe je sleutel-waardegroepen gebruikt

Om sleutel-waardeparen te gebruiken, moet je app zo zijn ingesteld dat deze sleutels herkent en reageert op hun waarden. Werk daarom samen met je appontwikkelaar om ervoor te zorgen dat je app is gebouwd om je use cases te ondersteunen. Zorg er ook voor dat je pushmeldingen voor iOS of Android hebt ingesteld in je Klaviyo-account.

Vul beide velden in voor elk paar en gebruik een andere sleutel voor elk paar. Als je een sleutel herhaalt, wordt alleen de laatste waarde opgeslagen.

1. Wanneer je een pushmelding maakt, open je het tabblad Content en selecteer je Standard of Stil onder Type.
2. Selecteer het tabblad Gedrag en zet Aangepaste gegevens aan als het uit staat. Als je Stil selecteert, wordt dit automatisch ingeschakeld.
3. Voer een sleutel en waarde in. Klik op Toevoegen om nog een paar toe te voegen. Je kunt per pushmelding maximaal 10 sleutelwaardeparen toevoegen.
4. Sla de wijzigingen op. Klik in een flow op Opslaan en doorgaan. Klik in een campagne op Volgende of Opslaan en terug, afhankelijk van de editor.

Laten we eens kijken naar een voorbeeld voor een e-commerce-app:

• We willen de beloningspunten van een klant die in onze app worden weergegeven bijwerken nadat ze een online aankoop hebben gedaan. We doen dit door een stille push te versturen met een profieleigenschap voor beloningspunten als sleutel-waarde-paar.
• We hebben al een bedankflow die wordt geactiveerd door een Geplaatste bestelling -event. We voegen een stille push toe aan het einde van deze flow om de waarde van de beloningspunten bij te werken die in onze app wordt weergegeven.
• De stille push bevat een sleutel-waardecombinatie waarbij de Sleutel gelijk is aan rewardspoints en de Waarde is ingesteld op {{ person.rewardspoints }}. De naam van de Klaviyo-profieleigenschap waarin we deze punten opslaan heet rewardspoints en onze app is correct geconfigureerd om op basis van deze sleutel-waardecombinatie te updaten.
• In dit voorbeeld hebben we ervoor gezorgd dat de waarde rewardspoints in Klaviyo was bijgewerkt voordat deze via deze flow naar onze app werd verzonden, zodat deze de juiste waarde weergeeft.

Use-cases

Er zijn veel use-cases voor sleutel-waardegroepen, waaronder om:

• Personaliseer appcontent
  Je kunt een stille pushmelding versturen om appcontent te personaliseren op basis van de kenmerken van de ontvanger (zoals het voorbeeld met beloningspunten hierboven).
• Tags maken voor rapportage
  Je kunt sleutel-waardeparen opnemen in pushmeldingen (standaard of stil) om berichten te 'taggen' en vervolgens data ophalen voor berichten met specifieke tags om te aggregeren. Deze tags kunnen bijvoorbeeld UTM-parameters zijn.
• Maak aangepaste pushtemplates
  Je kunt de lettergrootte en kleur voor de tekst van je pushmelding bepalen of een aangepast geluid instellen dat wordt afgespeeld wanneer de pushmelding wordt afgeleverd. Accounts kunnen ook live data weergeven, zoals de locatie van een levering of een aftelling tot een aanbod verloopt, in hun melding.

We raden je aan om samen met je app-ontwikkelaar ondersteuning te bouwen voor je specifieke use cases.

Extra hulpbronnen