ジャーニーの補足識別子の使用 supplemental-id

補足 ID が bookingNum で、同じレベルの属性が bookingCountry であるオブジェクト配列では、ジャーニーは bookingNum に基づいて配列オブジェクトを反復し、各オブジェクトのジャーニーインスタンスを作成します。

• 条件アクティビティの次の式は、オブジェクト配列を反復し、bookingCountry の値が「FR」と等しいかどうかを確認します。

  code language-none
  @event{<event_name>.<object_path>.<object_array_name>.all(currentEventField.<attribute_path>.bookingNum==${supplementalId}).at(0).<attribute_path>.bookingCountry}=="FR"

• メールパーソナライゼーションエディターの次の式は、オブジェクト配列を反復し、現在のジャーニーインスタンスに適用可能な bookingCountry を取得して、コンテンツに表示します。

  code language-none
  {{#each context.journey.events.<event_ID>.<object_path>.<object_array_name> as |l|}} {%#if l.<attribute_path>.bookingNum = context.journey.technicalProperties.supplementalId%} {{l.<attribute_path>.bookingCountry}} {%/if%} {{/each}}

• ジャーニーをトリガーするために使用されるイベントの例：

  code language-none
  "bookingList": [ { "bookingInfo": { "bookingNum": "x1", "bookingCountry": "US" } }, { "bookingInfo": { "bookingNum": "x2", "bookingCountry": "FR" } } ]

作成時にオーディエンスでexpressActivationを有効にする必要があります。 これにより、Journey Optimizerは、プロファイル IDによる重複排除を行うことなく、すべてのレコードを独立してアクティブ化します。 このフラグは、オーディエンスの作成後に変更することはできません。

オーディエンスの作成時に、次のAPI呼び出しを使用します。

エンドポイント：

POST https://platform.adobe.io/data/core/ais/external-audience

必要なヘッダー：

Authorization: Bearer {ACCESS_TOKEN}
Content-Type: application/json
x-api-key: {API_KEY}
x-gw-ims-org-id: {IMS_ORG}
x-sandbox-name: {SANDBOX_NAME}

リクエスト本文（セット expressActivation: true）:

{
  "name": "my_audience_name",
  "fields": [ ... ],
  "sourceSpec": { ... },
  "audienceType": "people",
  "namespace": "CustomerAudienceUpload",
  "expressActivation": true
}

完全なリファレンスについては、外部オーディエンス APIの作成を参照してください。

このセクションには、このトピックに関連する解釈、検索、質問への回答をサポートすることを目的とした構造化された知識が含まれています。

理解を深めるには、この情報をこのページのドキュメントと組み合わせる必要があります。 どちらのソースも単独で使用することを意図していません。このページでは、機能について説明しますが、この節では、用語、意図、適用可能性、および制約の曖昧さを解消するのに役立つ追加のコンテキストを提供します。

• TL;DR:​このページでは、Adobe Journey Optimizer ジャーニーで補足識別子を使用して、1つのプロファイルが複数の同時ジャーニーインスタンスを持つようにし、各プロファイルを予約、サブスクリプション、ポリシーIDなどの個別のセカンダリ IDにスコープ設定する方法について説明します。

インテント：

• プロファイル IDのみに依存するのではなく、補完的な識別子を使用するタイミングと理由を把握します
• イベントスキーマで属性をIDとしてマークすることで、イベントトリガージャーニーで補足識別子を設定します
• オーディエンスの読み取りアクティビティのオプションを有効にして、オーディエンスジャーニーの補足識別子を設定します
• 式エディターを使用して、メッセージのパーソナライゼーションと条件付きロジックの補足識別子の属性を参照します
• 正しい式の構文を適用して、補足IDでキーを設定したオブジェクト配列を繰り返します
• ジャーニーに補足的なIDを実装する前に、ガードレールと制限事項を特定する

用語集：

• 補足識別子: プロファイル IDと一緒に使用されるセカンダリ ID （注文ID、予約ID、サブスクリプション IDなど）。ジャーニーインスタンスを特定のレコードにスコープ設定し、プロファイル （製品固有）​ごとに複数の同時インスタンスを有効にします。
• プロファイル ID: ジャーニーの実行にデフォルトで使用されるプライマリ ID。ジャーニーでアクティブなプロファイルは、追加IDがなければ別のジャーニーに再入力できません
• 人以外のID名前空間：個人を表さないID名前空間（補足IDに必要）。プライマリ ID名前空間とは異なる必要があります
• joai名前空間：このページには適用されません（インバウンドアクションのトラブルシューティングを参照）
• DULE: Data Use Labeling and Enforcement — Adobe Experience Platformのデータガバナンスポリシー検証フレームワーク。追加IDはDULE チェックの対象ではありません

ガードレール：

• 補足識別子は、イベントトリガーおよびオーディエンスジャーニーの読み取りでのみサポートされます。オーディエンスの選定ジャーニーではサポートされていません
• プロファイルに同時ジャーニーインスタンスを10個以上含めることはできません
• 各ジャーニーインスタンスは、追加識別子を介して作成された場合でも、頻度の上限にカウントされます
• 補足識別子はstring型である必要があります。文字列配列とマップはサポートされていません
• 補足ID属性は、スキーマでプライマリ IDとしてマークしてはなりません
• 補足IDに使用される名前空間は、個人でないID名前空間である必要があります
• 非ユーザーID名前空間をスキーマに適用した後、新しいイベントまたはフィールドグループを作成する必要があります。既存のエンティティは更新できません
• 追加IDを持つオーディエンスジャーニーの読み取り：読み取り率は、ジャーニーインスタンスごとに1秒あたり500 プロファイルに制限されます。統合プロファイルサービスオーディエンスのみがサポートされます。追加IDは、プロファイルフィールド（イベント/コンテキストフィールドではなく）である必要があります
• 同じジャーニー内のダウンストリームイベントでは、同じ補足IDと名前空間を使用する必要があります
• ビジネスイベントを使用するオーディエンスジャーニーの読み取りに対する補足IDは無効になっています

用語：

• 正規名：補足識別子 – 頭字語：なし – バリアント：補足ID、二次識別子
• 同義語：「補足識別子」 = 「補足ID」（UIとドキュメントで同義語として使用）
• 「補足ID」≠「プライマリ ID」は混同しないでください。補足IDは、スキーマ内でプライマリ IDとしてマークしてはなりません

FAQ:

• Q：補足識別子は何に使用されますか？ — 1つのプロファイルでジャーニーを複数回同時に入力および実行し、各インスタンスを予約、サブスクリプション、ポリシーIDなどの異なるセカンダリレコードにスコープ付けすることができます。
• Q：どのジャーニータイプが補足識別子をサポートしていますか？ — イベントをトリガーにしたジャーニーとオーディエンスジャーニーの読み取り。 オーディエンスの選定ジャーニーは、補足識別子をサポートしていません。
• Q: プロファイルに追加のIDを持つ同時ジャーニーインスタンスの数を指定できますか？ — プロファイルごとに最大10個の同時ジャーニーインスタンス。
• Q: メッセージのパーソナライゼーションに追加のID属性を使用できますか？ – はい。 式エディターまたはパーソナライゼーションエディターのコンテキスト属性メニューを使用して参照します。
• Q：補足IDは、スキーマでプライマリ IDとしてマークする必要がありますか？ – いいえ。 IDとしてマークする必要がありますが、プライマリ IDとして設定することはできません。
• Q: DULE ガバナンスポリシーは追加識別子に適用されますか？ – いいえ。 DULE検証チェックは、補足IDに対して実行されません。