キーと値のペアについて理解する

このページで学べること

キーと値のペアとは何か、また標準のプッシュ通知とサイレントプッシュ通知の両方での使用方法をご確認ください。キー値ペアはプッシュ通知に含まれるカスタム データで、アプリの動作をトリガーしたり、メッセージにタグを付けたり、通知をカスタマイズしたりできます。

キーと値のペアとは？

キーと値のペアは、ユーザーに表示される標準のプッシュ通知と、ユーザーに表示されないサイレントのプッシュ通知の両方に含めることができるカスタムデータです。

サイレント通知と標準通知のどちらも、アプリコンテンツの更新、バックグラウンドタスクのトリガー、またはレポート作成目的でメッセージにタグを付けるために使用できます。

標準プッシュを使用すると、カスタムプッシュ テンプレートを作成してデータを設定するためにも使用できます。

キーと値のペアの使用方法

キーと値のペアを使用するには、アプリ側でキーを認識し、その値に応答できるように設定する必要があります。ユースケースをサポートできるように構築されていることを確認するため、アプリ開発者と連携してください。さらに、Klaviyo アカウントでプッシュ通知を設定していることをご確認ください。

プッシュ通知を作成する際に、行動 タブで見つけることができます。使用するには、カスタムデータ をオンに切り替え、キーと値を追加します。プッシュ通知 1 件につき、最大 10 個のキーと値のペアを追加できます。

E コマース アプリの例を見てみましょう：

• オンライン購入後に、アプリに表示される顧客のリワードポイントを更新したいと考えています。リワードポイントのプロファイルプロパティをキー・バリューのペアとして含むサイレントプッシュを送信して、これを実行します。
• すでに、Placed Order イベントによってトリガーされる Thank you フローがあります。アプリに表示される特典ポイントの値を更新するために、このフローの末尾にサイレントプッシュを追加します。
• サイレントプッシュにはキーと値のペアが含まれ、Key は rewardspoints に等しく、Value は {{ person.rewardspoints }} に設定されています。これらのポイントを保存する Klaviyo のプロファイルプロパティの名前は rewardspoints と呼ばれ、アプリはこのキーと値のペアに基づいて更新されるように正しく設定されています。
• この例では、このフローを通じてアプリに送信される前に、Klaviyo で rewardspoints の値が更新されていることを確認し、正確に反映されるようにしました。

ユースケース

キー・バリュー ペアには多くのユースケースがあり、例として次のようなものがあります。

• アプリコンテンツをパーソナライズ
  サイレントプッシュ通知を送信して、受信者の属性（上記のリワードポイントの例など）に基づいてアプリコンテンツをパーソナライズできます。
• レポート作成用のタグを作成
  プッシュ通知（標準またはサイレント）にキーと値のペアを含めてメッセージに“タグ”を付け、特定のタグが付いたメッセージのデータを抽出して集計できます。たとえば、これらのタグは UTM パラメーターにできます。
• カスタムプッシュテンプレートを作成
  プッシュ通知の本文のフォントサイズや色を定義したり、プッシュ通知の配信時に再生されるカスタムサウンドを設定したりできます。アカウントでは、通知内に配達場所などのライブデータや、オファーの有効期限までのカウントダウンを表示することもできます。

特定のユースケースに対応するためのサポートを構築するには、アプリ開発者と連携することをおすすめします。

その他のリソース