Skip to content

イベント・オブジェクト

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

イベントオブジェクトとは。

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

特定のプラットフォームにカスタムイベントを設定する手順については、開発者ガイドの『Platform Integration Guide』を参照してください。ご使用のプラットフォームに基づいて、関連記事を参照してください。

オブジェクト本体

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

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

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

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

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

データ型 説明
数値 整数 または浮動小数点数として
ブール値 true または false
日時 文字列としてISO 8601 形式または以下のいずれかの形式でフォーマットする必要があります。
- yyyy-MM-ddTHH:mm:ss:SSSZ
- yyyy-MM-ddTHH:mm:ss
- yyyy-MM-dd HH:mm:ss
- yyyy-MM-dd
- MM/dd/yyyy
- ddd MM dd HH:mm:ss.TZD YYYY

アレイ内ではサポートされていない。

「T」は時間指定子であり、プレースホルダーではないことに注意してください。変更または削除しないでください。

タイムゾーンのないタイム属性は、デフォルトではUTC の午前0 時になります(また、ダッシュボードでは、会社のタイムゾーンのUTC の午前0 時に相当する形式になります)。

タイムスタンプが未来のイベントはデフォルトで現在の時刻になります。
文字列 255 文字以下。
配列 配列に日時を含めることはできない。
オブジェクト オブジェクトは文字列として取り込まれます。

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

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

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

イベント依頼例

イベント・オブジェクト

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

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