ID 名前空間設定

Experience Platform は、ID 名前空間を使用して、特定の ID のタイプを記述します。例えば、Email と呼ばれる ID 名前空間は、name@email.com のような値をメールアドレスとして識別します。

作成する宛先のタイプ(ストリーミングまたはファイルベース)に応じて、次の ID 名前空間要件に注意してください。

  • Destination SDKを通じてリアルタイム(ストリーミング)宛先を作成する場合、ユーザーがプロファイル属性や ID をマッピングできる パートナースキーマの設定に加えて、宛先プラットフォームでサポートされている 少なくとも 1 つ ID 名前空間も定義する必要があります。 例えば、宛先プラットフォームがハッシュ化されたメールと IDFA を受け入れる場合、これら 2 つの ID をとして定義する必要があります 詳しくは、このドキュメントの後半で説明します

    note important
    IMPORTANT
    ストリーミング宛先に対してオーディエンスをアクティブ化する場合、ユーザーは、ターゲットプロファイル属性に加えて、少なくとも 1 つのターゲット ID もマッピングする必要があります。 そうでない場合、オーディエンスは宛先プラットフォームに対してアクティブ化されません。
  • Destination SDKを使用してファイルベースの宛先を作成する場合、ID 名前空間の設定は オプション です。

Experience Platform の ID 名前空間について詳しくは、ID 名前空間ドキュメントを参照してください。

宛先用に ID 名前空間を設定する場合、宛先でサポートされているターゲット ID マッピングを微調整できます。以下に例を示します。

  • ユーザーは、XDM 属性を ID 名前空間にマッピングできます。
  • ユーザーは、標準的な ID 名前空間を独自の ID 名前空間にマッピングできます。
  • ユーザーは、カスタム ID 名前空間を独自の ID 名前空間にマッピングできます。

このコンポーネントがDestination SDKで作成される統合のどこに適合するかを把握するには、 設定オプションドキュメントの図を参照するか、Destination SDKを使用したファイルベースの宛先の設定方法に関するガイドを参照してください。

/authoring/destinations エンドポイントを介して、サポートされる ID 名前空間を設定できます。このページに表示されるコンポーネントを設定できる、詳細な API 呼び出しの例については、以下の API リファレンスページを参照してください。

この記事では、宛先に使用できる、サポートされるすべての ID 名前空間設定オプションを説明し、Platform UI で顧客に何が表示されるかを示します。

IMPORTANT
Destination SDK でサポートされているすべてのパラメーター名および値は、大文字と小文字が区別 ​されます。大文字と小文字を区別することに関するエラーを避けるために、ドキュメントに示すように、パラメーター名および値を正確に使用してください。

サポートされる統合タイプ supported-integration-types

このページで説明される機能をサポートする統合のタイプについて詳しくは、以下の表を参照してください。

統合タイプ
機能のサポート
リアルタイム(ストリーミング)統合
はい(必須)
ファイルベースの(バッチ)統合
はい(オプション)

サポートされるパラメーター supported-parameters

宛先がサポートするターゲット ID を定義する際に、以下の表で説明されているパラメーターを使用して、その動作を設定できます。

パラメーター
タイプ
必須/オプション
説明
acceptsAttributes
ブール値
オプション
顧客が標準的なプロファイル属性を設定中の ID にマッピングできるかどうかを示します。
acceptsCustomNamespaces
ブール値
オプション
顧客がカスタム ID 名前空間を設定中の ID 名前空間にマッピングできるかどうかを示します。
acceptedGlobalNamespaces
-
オプション
設定中の ID に顧客がマッピングできる標準的な ID 名前空間(例えば、IDFA)を示します。
transformation
文字列
オプション
ソースフィールドが XDM 属性かカスタム ID 名前空間のどちらかの場合に、Platform UI に「変換を適用」チェックボックスを表示します。このオプションを使用して、書き出し時にソース属性をハッシュ化する機能をユーザーに提供します。このオプションを有効にするには、値を sha256(lower($)) に設定します。
requiredTransformation
文字列
オプション
顧客がこのソース ID 名前空間を選択すると、「変換を適用」チェックボックスが自動的にマッピングに適用され、顧客は無効にすることができなくなります。このオプションを有効にするには、値を sha256(lower($)) に設定します。
"identityNamespaces":{
      "external_id":{
         "acceptsAttributes":true,
         "acceptsCustomNamespaces":true,
         "acceptedGlobalNamespaces":{
            "Email":{
            }
         }
      },
      "another_id":{
         "acceptsAttributes":true,
         "acceptsCustomNamespaces":true
      }
   }

どの Platform ID の顧客が宛先に書き出すことができるかを示す必要があります。例として、Experience Cloud ID、ハッシュ化されたメール、デバイス ID(IDFA、GAID)などがあります。これらの値は、Platform ID 名前空間であり、顧客が宛先から ID 名前空間にマッピングできます。

ID 名前空間は、Platform と宛先が 1 対 1 で対応している必要はありません。
例えば、顧客は Platform IDFA 名前空間を宛先からの IDFA 名前空間にマッピングすることができ、また顧客は同じ Platform IDFA 名前空間を宛先の Customer ID 名前空間にマッピングすることもできます。

ID について詳しくは、ID 名前空間の概要を参照してください。

マッピングに関する考慮事項

顧客がソース ID 名前空間を選択して、ターゲットマッピングを選択しない場合、Platform は、自動的に同じ名前の属性でターゲットマッピングを設定します。

オプションのソースフィールドハッシュの設定

Experience Platform 顧客は、ハッシュ化された形式またはプレーンテキストでデータを Platform に取り込むことを選択できます。宛先プラットフォームがハッシュ化されたデータとハッシュ化されていないデータの両方を受け入れる場合、宛先に書き出される際に、Platform がソースフィールド値をハッシュ化する必要があるかどうかを顧客が選択できるようにすることができます。

以下の設定は、Platform UI のマッピング手順でオプションの「変換を適用」オプションを有効にします。

"identityNamespaces":{
      "Customer_contact":{
         "acceptsAttributes":true,
         "acceptsCustomNamespaces":true,
         "transformation": "sha256(lower($))",
         "acceptedGlobalNamespaces":{
            "Email":{
            },
            "Phone":{
            }
         }
      }
   }

ハッシュ化されていないソースフィールドを使用している場合に、このオプションを有効にすると、Adobe Experience Platform でアクティベーション時に自動的にハッシュ化されます。

ハッシュ化されていないソース属性を、宛先によってハッシュ化されることが期待されているターゲット属性(例:email_lc_sha256phone_sha256)にマッピングしている場合、アクティベーション時に Adobe Experience Platform にソース属性を自動的にハッシュ化させるために、「変換を適用」オプションをオンにします。

必須のソースフィールドハッシュの設定

宛先がハッシュ化されたデータのみを受け入れる場合、書き出された属性が Platform によって自動的にハッシュ化されるように設定できます。以下の設定は、Email および Phone ID がマッピングされると、「変換を適用」オプションを自動的にオンにします。

"identityNamespaces":{
      "Customer_contact":{
         "acceptsAttributes":true,
         "acceptsCustomNamespaces":true,
         "transformation": "sha256(lower($))",
         "acceptedGlobalNamespaces":{
            "Email":{
               "requiredTransformation": "sha256(lower($))"
            },
            "Phone":{
               "requiredTransformation": "sha256(lower($))"
            }
         }
      }
   }

次の手順 next-steps

この記事を読むことで、Destination SDK で作成された宛先に対する ID 名前空間の設定方法ついて、理解を深めることができました。

その他の宛先コンポーネントについて詳しくは、以下の記事を参照してください。

recommendation-more-help
7f4d1967-bf93-4dba-9789-bb6b505339d6