Privacy Service API で、複数のユーザーおよび ID タイプを含むプライバシーリクエストを作成します
この記事では、Privacy API を使用して、複数のユーザーや ID タイプのPrivacy ServiceJSON リクエストを作成する方法について説明します。 Privacy ServiceUI では、リクエストごとに 1 つの名前空間タイプのみが許可されますが、API を使用すると、1 つの JSON ペイロードで複数の ID タイプを持つリクエストを作成できます。 この記事では、サンプル JSON と、リクエストの設定方法を順を追って説明します。
説明 description
環境
Adobe Experience Platform
問題/症状
Privacy Serviceインターフェイス（UI）は現在、リクエストごとに 1 つの ID タイプを持つリクエストの作成のみをサポートしています。 ただし、Privacy ServiceAPI を使用する場合は、異なるユーザーに対して複数の ID タイプを含む JSON リクエストを作成できます。 この方法は、1 人または複数のユーザーに対する様々なデータソースおよび識別子を含むプライバシーリクエストを処理する場合に役立ちます。
複数のユーザーと ID タイプを含むプライバシーリクエストの JSON の例を次に示します。
{
"companyContexts": [
{
"namespace": "imsOrgID",
"value": "{{IMS ORG}}"
}
] ,
"users": [
{
"key": "dbt26cf6-1942-4c4a-82bd-d790e647cxxx",
"action": [
"access"
] ,
"userIDs": [
{
"namespace": "email",
"value": "dsmith@axxx.com",
"type": "standard"
},
{
"namespace": "ECID",
"type": "standard",
"value": "443636576799758681021090721xxx",
"isDeletedClientSide": false
}
]
},
{
"key": "8dd7e4d8-13d3-442f-85d8-5e2f0779exxx",
"action": [
"access",
"delete"
] ,
"namespace": "email",
"value": "ajones@axxx.com",
"type": "standard"
},
{
"namespace": "CRM ID",
"value": "12AD45FE30xxx",
"type": "analytics"
}
] ,
"include": [
"Analytics",
"AdobeCloudPlatform",
"profileService"
] ,
"regulation": "сра"
}
解決策 resolution
プライバシー API を使用して新しいPrivacy Serviceリクエストを作成するには、次の手順に従います。
-
まず、JSON リクエストを作成します。 これには、認証用のAdobe組織 ID を含む
companyContextsの定義が含まれます。 この ID は、リクエストヘッダーで指定した値と一致します。 -
各ユーザーに対して、 一意 を割り当てます key を使用し、userIDs で識別子を指定します。 これらの識別子には、namespace、type、および value を含める必要があります。 サンプルでは、ユーザーには、email、ECID、CRM ID などの識別子があります。
-
各ユーザーには、access、delete またはその両方など、ユーザーのデータに対して実行するアクションを指定する action 配列を含めます。
-
「 含める 」フィールドに、プライバシーリクエストを処理するAdobe Experience Cloud製品（Analytics、AdobeCloudPlatform、profileService など）をリストします。
-
リクエストが提出される 規制 を指定します。 次の値がサポートされています。
- gdpr （欧州連合）
- ccpa （カリフォルニア州）
- lgpd_bra （ブラジル）
- nzpa_nzl （ニュージーランド）
- pdpa_tha （タイ）
- apa_aus （オーストラリア）
- cpa （コロラド州）
- cpra_usa （カリフォルニア州）
- ctdpa （コネチカット州）
- hipaa_usa （米国）
- ucpa_usa （ユタ州）
- vcdpa_usa （バージニア）
-
JSON リクエストを設定したら、Privacy API のジョブエンドポイントに送信します。 応答が成功すると、新しく作成されたジョブの詳細が返されます。この詳細は、追跡したり、さらに処理したりできます。
これらの手順に従うと、複数のユーザーと ID タイプに対する包括的なプライバシーリクエストを作成し、関連するプライバシー規制に準拠することができます。