単一イベントの設定 configure-an-event
単一イベントは、特定のプロファイルにリンクされます。ルールベースによるものと、システムで生成されるものがあります。単一イベントの詳細については、この節を参照してください。
新規イベントを設定する最初の手順は次のとおりです。
-
「管理」メニューセクションで 設定 に移動し、「イベント」セクションで「管理」をクリックします。イベントのリストが表示されます。
-
新しいイベントを作成するには、「イベントを作成」をクリックします。画面の右側にイベント設定ペインが開きます。
-
イベントの名前を入力します。説明を追加することもできます。
note note NOTE 英数字とアンダースコアのみが使用できます。最大長は 30 文字です。 -
「タイプ」フィールドで「単一」を選択します。
-
「イベント ID タイプ」フィールドで、使用するイベント ID タイプとして「ルールベース」または「システム生成」を選択します。イベント ID のタイプの詳細については、この節を参照してください。
-
このイベントを使用しているジャーニーの数は、使用されている場所 フィールドに表示されます。「ジャーニーを表示」アイコンをクリックすると、このイベントを使用しているジャーニーのリストを表示できます。
-
スキーマとペイロードのフィールドを定義します。ジャーニーが受け取るイベント情報(通常、ペイロードと呼びます)は、ここで選択します。その後、この情報をジャーニーに使うことができます。この節を参照してください。
note note NOTE システム生成 タイプを選択した場合は、eventID タイプのフィールドを持つスキーマのみを使用できます。ルールベース タイプを選択した場合は、すべてのエクスペリエンスイベントのスキーマを使用できます。 -
ルールベースのイベントの場合は、「イベント ID 条件」フィールド内でクリックします。簡単で高度な式エディターを使用して、ジャーニーをトリガーするイベントを識別するためにシステムが使用する条件を定義します。
この例では、プロファイルの市区町村に基づいて条件を作成しました。つまり、システムはこの条件(市区町村 フィールドと パリ という値)を満たすイベントを受け取るたびに、ジャーニーにイベントを渡します。
note note NOTE シンプルな式エディターでは、すべての演算子が使用できるわけではなく、データタイプに応じて異なります。例えば、文字列タイプのフィールドには、「次を含む」または「次と等しい」を使用できます。 イベントの作成後に新しい列挙値でスキーマを変更する場合、次の手順に従って既存のイベントに変更を適用する必要があります。イベントフィールドの列挙フィールドの選択を解除し、選択を確認して、列挙フィールドを再度選択します。これで、新しい列挙値が表示されます。 -
名前空間を追加します。この手順はオプションですが、名前空間を追加すると、リアルタイム顧客プロファイルサービスに保存されている情報を活用できるため、推奨されています。イベントのキーのタイプを定義します。この節を参照してください。
-
プロファイル識別子を定義します。ペイロードフィールドからフィールドを選択するか、イベントに関連付けられた個人を識別する式を定義します。このキーは、名前空間を選択すると自動的に設定されます(編集は可能)。ジャーニーは名前空間に対応するキーを選択します(例えば、メール名前空間を選択すると、メールのキーが選択されます)。この節を参照してください。
-
「保存」をクリックします。
イベントが設定され、ジャーニーで使用できる状態になりました。イベントを受信するには追加の設定手順が必要です。このページを参照してください。
ペイロードフィールドの定義 define-the-payload-fields
ペイロード定義を使用すると、ジャーニーのイベントからシステムが受け取ると想定される情報と、イベントに関連付けられている人を識別するためのキーを選択できます。ペイロードは Experience Cloud XDM フィールド定義に基づいています。XDM について詳しくは、Adobe Experience Platform ドキュメントを参照してください。
-
リストから XDM スキーマを選択し、フィールド フィールドまたは「編集」アイコンをクリックします。
スキーマで定義されているすべてのフィールドが表示されます。フィールドのリストは、スキーマによって異なります。特定のフィールドを検索し、フィルターを使用してすべてのノードとフィールドを表示、または選択したフィールドのみを表示できます。スキーマ定義によっては、一部のフィールドが必須となっており、事前に選択されている場合があります。選択を解除することはできません。ジャーニーがイベントを適切に受け取るために必須のフィールドはすべて、デフォルトで選択されます。
note note NOTE システム生成イベントの場合は、「オーケストレーション」フィールドグループが XDM スキーマに追加されていることを確認してください。これにより、Journey Optimizer と連携するために必要な情報がスキーマにすべて含まれるようになります。 -
イベントから受け取るフィールドを選択します。これらは、ビジネスユーザーがジャーニーで活用するフィールドです。また、イベントに関連付けられた人物を識別するために使用するキーも含める必要があります(この節を参照)。
note note NOTE システム生成イベントの場合は、Journey Optimizer がイベントを識別できるよう、選択されたフィールドのリストに eventID フィールドが自動的に追加されます。イベントをプッシュするシステムでは ID を生成しないため、ペイロードプレビューにある ID を使用する必要があります。この節を参照してください。 -
必要なフィールドの選択が完了したら、「OK」をクリックするか、Enter キーを押します。
選択したフィールドの数が「フィールド」フィールドに表示されます。
名前空間の選択 select-the-namespace
名前空間を使用すると、イベントに関連付けられた人物の識別に使用するキーのタイプを定義できます。設定は必須ではありません。ジャーニーで、リアルタイム顧客プロファイルから得られる追加情報を取得する場合には必須です。カスタムデータソースを介したサードパーティシステムのデータのみを使用する場合は、名前空間は必要ありません。
事前定義済みのものを使用するか、ID 名前空間サービスを使用して新しく作成できます。Adobe Experience Platform ドキュメントを参照してください。
メイン ID を持つスキーマを選択した場合は、「 プロファイラー識別子」および「 名前空間」フィールドに事前入力します。ID を定義していない場合は、identityMap > id がプライマリキーとして選択されます。次に、名前空間を選択する必要があります。キーは、identityMap > id を使用して(名前空間 フィールドの下に)事前入力されます。
フィールドを選択すると、プライマリ ID フィールドにタグ付けされます。
ドロップダウンリストから名前空間を選択します。
1 つのジャーニーで使用できる名前空間は 1 つだけです。同じジャーニーで複数のイベントを使用する場合は、同じ名前空間を使用する必要があります。このページを参照してください。
プロファイル識別子の定義 define-the-event-key
キーは、イベントのペイロードデータの一部とするフィールドまたはフィールドの組み合わせです。システムはキーを使用することでイベントに関連付けられた人を識別できます。キーには、Experience Cloud ID、CRM ID、メールアドレスなどを使用できます。
アドビのリアルタイム顧客プロファイルデータベースに保存されたデータを使用するには、イベントキーが、リアルタイム顧客プロファイルサービスでプロファイル ID として定義した情報である必要があります。
これにより、プロファイル識別子はイベントと個人プロファイルの間の紐付けを実行できます。メイン ID を持つスキーマを選択した場合、「プロファイル識別子」および「名前空間」フィールドはあらかじめ入力されます。ID を定義していない場合は、identityMap/ID がプライマリキーとして選択されます。次に、名前空間を選択する必要があります。キーは、自動的に既存の identityMap/ID を使用します。
フィールドを選択すると、プライマリ ID フィールドにタグ付けされます。
CRM ID やメールアドレスなど、別のキーを使用する必要がある場合は、以下の説明のとおり、キーを手動で追加する必要があります。
-
「プロファイル識別子」フィールド内または鉛筆アイコン上をクリックします。
-
「ペイロード」フィールドのリストでキーとして指定したフィールドを選択します。
イベントを受け取ると、キーの値によって、システムはイベントに関連付けられた人物を識別できます。キーは名前空間に関連付けられ(この節を参照)、Adobe Experience Platform でクエリの実行に使用できます。このページを参照してください。
このキーは、ある人物がジャーニーにエントリしているかどうかを確認するためにも使用されます。1 人の人物が同じジャーニーの 2 つの異なる場所に存在することはできません。その結果、同じキー(キー CRMID=3224 など)を同じジャーニー内の異なる場所に配置することはできません。
高度な式エディター adv-exp-editor
イベント ID 条件またはプロファイル識別子を定義する際に、高度な式エディターに切り替えて、より複雑なキーを作成できます(例えば、イベントの 2 つのフィールドを連結するなど)。
より高度な操作を実行する場合は、「詳細設定モード」ボタンから高度な式関数にアクセスできます。これらの関数を使用すると、形式の変更、フィールドの連結、フィールドの一部のみを考慮する(先頭の 10 文字など)など、特定のクエリの実行に用いる値を操作できます。このページを参照してください。
ペイロードのプレビュー preview-the-payload
ペイロードのプレビューを使用すると、ペイロード定義を検証できます。
-
「ペイロードを表示」アイコンをクリックして、システムが想定するペイロードをプレビューします。
選択したフィールドが表示されていることに注意してください。
-
ペイロード定義を検証するプレビューを確認します。
-
その後、イベント送信の担当者とペイロードプレビューを共有できます。このペイロードは、Journey Optimizerにプッシュするイベントのセットアップを設計するのに役立ちます。このページを参照してください。