ID 名前空間設定

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

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

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

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

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

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

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

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

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

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

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

"identityNamespaces":{
      "external_id":{
         "acceptsAttributes":true,
         "acceptsCustomNamespaces":true,
         "acceptedGlobalNamespaces":{
            "Email":{
            }
         }
      },
      "another_id":{
         "acceptsAttributes":true,
         "acceptsCustomNamespaces":true
      }
   }

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

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

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

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

ソース ID名前空間を選択し、ターゲットマッピングを選択しない場合、Experience Platformは自動的にターゲットマッピングに同じ名前の属性を入力します。

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

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

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

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

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

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

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

宛先がハッシュ化されたデータのみを受け入れる場合は、書き出された属性をExperience 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名前空間を設定する方法、属性と名前空間のマッピングを許可する方法、書き出しにオプションまたは必須のハッシュを適用する方法などを理解できました。

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