Skip to content

イベント・オブジェクト

この記事では、イベント・オブジェクトのさまざまな構成要素、このオブジェクトの使用方法、そして使用例について説明する。

イベントオブジェクトとは何か?

イベント・オブジェクトは、特定のイベントが発生したときにAPIを通じて渡されるオブジェクトである。イベント・オブジェクトはイベント配列に格納される。events配列の各イベントオブジェクトは、指定された時間値における、特定のユーザーによるカスタムイベントの単一の発生を表す。イベント・オブジェクトにはさまざまなフィールドがあり、それらを使用して、メッセージ、データ収集、パーソナライゼーションにおいてイベントプロパティを設定し、使用することでカスタマイズすることができます。

特定のプラットフォーム用にカスタムイベントをセットアップする方法については、「開発者ガイド」の「プラットフォーム総合ガイド」を参照してください。この情報は、各プラットフォームのアナリティクス・タブにある「カスタムイベントのトラッキング」ページで確認できる。いくつかリンクを貼っておく。

カスタムイベント記事の追跡:

オブジェクト本体

既存のプロファイルのみを更新する

Braze で既存のユーザープロファイルのみを更新したい場合は、リクエスト本文の中で、_update_existing_only キーと true の値を渡す必要があります。この値を省略すると、external_id がまだ存在しない場合、Brazeは新しいユーザープロファイルを作成する。

イベント・プロパティ・オブジェクト

カスタムイベントと購入にはイベントプロパティが含まれる場合があります。「プロパティ」値は、キーがプロパティ名で値がプロパティ値であるオブジェクトである必要があります。プロパティ名は、255文字以下の空でない文字列でなければならず、先頭にドル記号($)は付けない。

プロパティ値は、次のデータ型のいずれでもかまいません。

データ型 説明
数値 整数 または浮動小数点数として
ブール値 true または false
日時 ISO-8601 またはyyyy-MM-dd'T'HH:mm:ss:SSSZ 形式の文字列としてフォーマットされる。アレイ内ではサポートされていない。
文字列 255 文字以下。
配列 配列に日時を含めることはできない。
オブジェクト オブジェクトは文字列として取り込まれます。

配列またはオブジェクト値を含むイベントプロパティオブジェクトには、最大 100 KB のイベントプロパティペイロードを設定できます。

イベント・プロパティの永続性

イベント・プロパティは、親イベントによってトリガーされるメッセージのフィルタリングと、リキッド・パーソナライゼーションのために設計されている。デフォルトでは、Braze ユーザープロファイルでは永続化されません。セグメンテーションでイベントプロパティ値を使用するには、イベントプロパティ値を長期的に保存するための様々なアプローチについて詳述しているカスタムイベントを参照のこと。

イベント依頼例

イベント・オブジェクト

提供された例を使えば、誰かが最近予告編を見て、映画をレンタルしたことがわかる。キャンペーンに入り、これらのプロパティに基づいてユーザーをセグメントすることはできませんが、Liquid を使用してチャネルを介し、カスタムメッセージを送信するために、受け取りの形でこれらのプロパティを使用することで、戦略的に使用することができます。例えば、『こんにちは、BethDan AlexanderThe Sad Egg をレンタルしていただき、ありがとうございます。お客様のレンタル状況に基づいて、お勧めの映画をご紹介いたします…』のように使用できます。

「このページはどの程度役に立ちましたか?」
New Stuff!