ドキュメントExperience Platformセグメント化サービスガイド

オーディエンスエンドポイント

Last update: Wed Jun 12 2024 00:00:00 GMT+0000 (Coordinated Universal Time)
  • トピック：

作成対象：

  • 開発者

オーディエンスは、類似の行動や特徴を共有する人々の集まりです。 これらの人物のコレクションは、Adobe Experience Platformを使用するか、外部ソースから生成できます。 を使用できます /audiences segmentation API のエンドポイント。プログラムによって、オーディエンスを取得、作成、更新、削除できます。

はじめに

このガイドで使用するエンドポイントは、 Adobe Experience Platform Segmentation Service API です。 続行する前に、を確認してください はじめる前に は、必要なヘッダーやサンプル API 呼び出しの読み取り方法など、API に対する呼び出しを正常に実行するために知っておく必要がある重要な情報です。

オーディエンスのリストの取得 list

に対してGETリクエストを行うことで、組織のすべてのオーディエンスのリストを取得できます。 /audiences エンドポイント。

API 形式

/audiences エンドポイントは、結果を絞り込むのに役立つ、複数のクエリパラメーターをサポートしています。これらのパラメーターはオプションですが、リソースをリストする際の高価なオーバーヘッドを削減するために、使用することを強くお勧めします。 パラメーターを指定せずにこのエンドポイントを呼び出すと、組織で使用可能なすべてのオーディエンスが取得されます。 複数のパラメーターを使用する場合は、アンパサンド（&）で区切ります。

GET /audiences
GET /audiences?{QUERY_PARAMETERS}

オーディエンスのリストを取得する際には、次のクエリパラメーターを使用できます。

クエリーパラメーター
説明
例
start
返されるオーディエンスの開始オフセットを指定します。
start=5
limit
ページごとに返されるオーディエンスの最大数を指定します。
limit=10
sort
結果の並べ替え順序を指定します。 これは、フォーマットで記述されます attributeName:[desc/asc].
sort=updateTime:desc
property
次のオーディエンスを指定できるフィルター 正確に 属性の値に一致します。 これは、フォーマットで記述されます property=
property=audienceId==test-audience-id
name
名前が付いたオーディエンスを指定できるフィルター contain 指定された値。 この値では、大文字と小文字が区別されません。
name=Sample
description
説明を持つオーディエンスを指定できるフィルター contain 指定された値。 この値では、大文字と小文字が区別されません。
description=Test Description

リクエスト

次のリクエストでは、組織で作成された最後の 2 つのオーディエンスを取得します。

オーディエンスのリストを取得するリクエストのサンプル。
code language-shell 
curl -X GET https://platform.adobe.io/data/core/ups/audiences?limit=2 \
 -H 'Authorization: Bearer {ACCESS_TOKEN}' \
 -H 'x-gw-ims-org-id: {IMS_ORG}' \
 -H 'x-api-key: {API_KEY}' \
 -H 'x-sandbox-name: {SANDBOX_NAME}'

応答

応答に成功すると、HTTP ステータス 200 が、組織内で JSON として作成されたオーディエンスのリストと共に返されます。

組織に属する最後に作成された 2 つのオーディエンスを含む応答のサンプル
code language-json 
{
    "children": [
        {
            "id": "60ccea95-1435-4180-97a5-58af4aa285ab",
            "audienceId": "60ccea95-1435-4180-97a5-58af4aa285ab",
            "schema": {
                "name": "_xdm.context.profile"
            },
            "ttlInDays": 60,
            "profileInstanceId": "ups",
            "imsOrgId": "{ORG_ID}",
            "sandbox": {
                "sandboxId": "6ed34f6f-fe21-4a30-934f-6ffe21fa3075",
                "sandboxName": "prod",
                "type": "production",
                "default": true
            },
            "name": "People who ordered in the last 30 days",
            "description": "Last 30 days",
            "expression": {
                "type": "PQL",
                "format": "pql/text",
                "value": "workAddress.country = \"US\""
            },
            "mergePolicyId": "ef006bbe-750e-4e81-85f0-0c6902192dcc",
            "evaluationInfo": {
                "batch": {
                    "enabled": false
                },
                "continuous": {
                    "enabled": true
                },
                "synchronous": {
                    "enabled": false
                }
            },
            "dataGovernancePolicy": {
                "excludeOptOut": true
            },
            "isSystem": false,
            "creationTime": 1650374572000,
            "updateEpoch": 1650374573,
            "updateTime": 1650374573000,
            "createEpoch": 1650374572,
            "_etag": "\"33120d7c-0000-0200-0000-625eb7ad0000\"",
            "dependents": [],
            "definedOn": [
                {
                    "meta: resourceType": "unions",
                    "meta: containerId": "tenant",
                    "$ref": "https: //ns.adobe.com/xdm/context/profile__union"
                }
            ],
            "dependencies": [],
            "type": "SegmentDefinition",
            "originName": "REAL_TIME_CUSTOMER_PROFILE",
            "overridePerformanceWarnings": false,
            "createdBy": "{CREATED_BY_ID}",
            "lifecycleState": "published",
            "labels": [
                "core/C1"
            ],
            "namespace": "AEPSegments"
        },
        {
            "id": "32a83b5d-a118-4bd6-b3cb-3aee2f4c30a1",
            "audienceId": "test-external-audience-id",
            "name": "externalSegment1",
            "namespace": "aam",
            "imsOrgId": "{ORG_ID}",
            "sandbox":{
                "sandboxId": "6ed34f6f-fe21-4a30-934f-6ffe21fa3075",
                "sandboxName": "prod",
                "type": "production",
                "default": true
            },
            "isSystem": false,
            "description": "Last 30 days",
            "type": "ExternalSegment",
            "originName": "CUSTOM_UPLOAD",
            "lifecycleState": "published",
            "createdBy": "{CREATED_BY_ID}",
            "datasetId": "6254cf3c97f8e31b639fb14d",
            "labels":[
                "core/C1"
            ],
            "linkedAudienceRef": {
                "flowId": "4685ea90-d2b6-11ec-9d64-0242ac120002"
            },
            "creationTime": 1642745034000000,
            "updateEpoch": 1649926314,
            "updateTime": 1649926314000,
            "createEpoch": 1642745034
        }
    ],
    "_page":{
      "totalCount": 111,
      "pageSize": 2,
      "next": "1"
   },
   "_links":{
      "next":{
         "href":"@/audiences?start=1&limit=2&totalCount=111"
      }
   }
}
table 0-row-3 1-row-3 2-row-3 3-row-3 4-row-3 5-row-3 6-row-3 7-row-3 8-row-3 9-row-3 10-row-3 11-row-3 12-row-3 13-row-3 14-row-3 15-row-3 16-row-3 17-row-3 18-row-3
プロパティ オーディエンスタイプ 説明
id 両方 オーディエンスのシステム生成の読み取り専用識別子。
audienceId 両方 オーディエンスが Platform で生成されたオーディエンスの場合、これは id. オーディエンスが外部で生成される場合、この値はクライアントから提供されます。
schema 両方 オーディエンスのエクスペリエンスデータモデル（XDM）スキーマ。
imsOrgId 両方 オーディエンスが属する組織の ID。
sandbox 両方 オーディエンスが属するサンドボックスに関する情報。 サンドボックスの詳細については、次を参照してください。 サンドボックスの概要.
name 両方 オーディエンスの名前。
description 両方 オーディエンスの説明。
expression Platform で生成 オーディエンスのプロファイルクエリ言語（PQL）式。 PQL 式について詳しくは、を参照してください。 PQL 式ガイド.
mergePolicyId Platform で生成 オーディエンスが関連付けられている結合ポリシーの ID。 結合ポリシーについて詳しくは、結合ポリシーガイドを参照してください。
evaluationInfo Platform で生成 オーディエンスの評価方法を表示します。 考えられる評価方法には、バッチ、同期（ストリーミング）または連続（エッジ）があります。 評価方法について詳しくは、を参照してください。 セグメント化の概要
dependents 両方 現在のオーディエンスに依存するオーディエンス ID の配列。 これは、セグメントのセグメントであるオーディエンスを作成する場合に使用されます。
dependencies 両方 オーディエンスが依存するオーディエンス ID の配列。 これは、セグメントのセグメントであるオーディエンスを作成する場合に使用されます。
type 両方 オーディエンスが Platform で生成されたものか、外部で生成されたオーディエンスかを表示する、システムで生成されたフィールド。 使用可能な値は次のとおりです SegmentDefinition および ExternalSegment. A SegmentDefinition は、Platform で生成されたオーディエンスを参照し、は ExternalSegment platform で生成されなかったオーディエンスを参照します。
originName 両方 オーディエンスの接触チャネルの名前を参照するフィールド。 Platform で生成されたオーディエンスの場合、この値はになります REAL_TIME_CUSTOMER_PROFILE. Audience Orchestration で生成されたオーディエンスの場合、この値はになります AUDIENCE_ORCHESTRATION. Adobe Audience Managerで生成されたオーディエンスの場合、この値はになります AUDIENCE_MANAGER. 外部で生成されたその他のオーディエンスの場合、この値は次のようになります CUSTOM_UPLOAD.
createdBy 両方 オーディエンスを作成したユーザーの ID。
labels 両方 オーディエンスに関連するオブジェクトレベルのデータ使用と属性ベースのアクセス制御ラベル。
namespace 両方 オーディエンスが属する名前空間。 使用可能な値は次のとおりです AAM, AAMSegments, AAMTraits、および AEPSegments.
linkedAudienceRef 両方 他のオーディエンス関連システムへの識別子を含むオブジェクト。

新しいオーディエンスの作成 create

にPOSTリクエストを実行することで、新しいオーディエンスを作成できます。 /audiences エンドポイント。

API 形式

POST /audiences

リクエスト

Platform で生成されたオーディエンス
accordion
Platform で生成されたオーディエンスを作成するためのサンプルリクエスト
code language-shell 
curl -X POST https://platform.adobe.io/data/core/ups/audiences
 -H 'Authorization: Bearer {ACCESS_TOKEN}' \
 -H 'Content-Type: application/json' \
 -H 'x-gw-ims-org-id: {IMS_ORG}' \
 -H 'x-api-key: {API_KEY}' \
 -H 'x-sandbox-name: {SANDBOX_NAME}'
 -d '{
        "name": "People who ordered in the last 30 days",
        "profileInstanceId": "ups",
        "description": "Last 30 days",
        "type": "SegmentDefinition",
        "expression": {
            "type": "PQL",
            "format": "pql/text",
            "value": "workAddress.country = \"US\""
        },
        "schema": {
            "name": "_xdm.context.profile"
        },
        "labels": [
          "core/C1"
        ],
        "ttlInDays": 60
    }'
table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2 5-row-2 6-row-2 7-row-2
プロパティ 説明
name オーディエンスの名前。
description オーディエンスの説明。
type オーディエンスが Platform で生成されたものか、外部で生成されたものかを表示するフィールド。 使用可能な値は次のとおりです SegmentDefinition および ExternalSegment. A SegmentDefinition は、Platform で生成されたオーディエンスを参照し、は ExternalSegment platform で生成されなかったオーディエンスを参照します。
expression オーディエンスのプロファイルクエリ言語（PQL）式。 PQL 式について詳しくは、を参照してください。 PQL 式ガイド.
schema オーディエンスのエクスペリエンスデータモデル（XDM）スキーマ。
labels オーディエンスに関連するオブジェクトレベルのデータ使用と属性ベースのアクセス制御ラベル。
ttlInDays オーディエンスのデータ有効期限値を日単位で表します。
外部で生成されたオーディエンス
accordion
外部で生成されたオーディエンスを作成するためのサンプルリクエスト
code language-shell 
curl -X POST https://platform.adobe.io/data/core/ups/audiences
 -H 'Authorization: Bearer {ACCESS_TOKEN}' \
 -H 'Content-Type: application/json' \
 -H 'x-gw-ims-org-id: {IMS_ORG}' \
 -H 'x-api-key: {API_KEY}' \
 -H 'x-sandbox-name: {SANDBOX_NAME}'
 -d '{
        "audienceId":"test-external-audience-id",
        "name":"externalAudience",
        "namespace":"aam",
        "description":"Last 30 days",
        "type":"ExternalSegment",
        "originName":"CUSTOM_UPLOAD",
        "lifecycleState":"published",
        "datasetId":"6254cf3c97f8e31b639fb14d",
        "labels":[
            "core/C1"
        ],
        "linkedAudienceRef":{
            "flowId": "4685ea90-d2b6-11ec-9d64-0242ac120002"
        }
    }'
table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2 5-row-2 6-row-2 7-row-2 8-row-2 9-row-2 10-row-2 11-row-2
プロパティ 説明
audienceId オーディエンスのユーザー指定の ID。
name オーディエンスの名前。
namespace オーディエンスの名前空間。
description オーディエンスの説明。
type オーディエンスが Platform で生成されたものか、外部で生成されたものかを表示するフィールド。 使用可能な値は次のとおりです SegmentDefinition および ExternalSegment. A SegmentDefinition は、Platform で生成されたオーディエンスを参照し、は ExternalSegment platform で生成されなかったオーディエンスを参照します。
originName オーディエンスの接触チャネルの名前。 外部で生成されたオーディエンスの場合、このデフォルト値はです。 CUSTOM_UPLOAD. その他にサポートされている値は次のとおりです REAL_TIME_CUSTOMER_PROFILE, CUSTOM_UPLOAD, AUDIENCE_ORCHESTRATION、および AUDIENCE_MATCH.
lifecycleState 作成しようとしているオーディエンスの初期状態を決定するオプションのフィールド。 次の値がサポートされています draft, published、および inactive.
datasetId オーディエンスを含むデータが見つかるデータセットの ID。
labels オーディエンスに関連するオブジェクトレベルのデータ使用と属性ベースのアクセス制御ラベル。
audienceMeta 外部で生成されたオーディエンスに属するメタデータです。
linkedAudienceRef

他のオーディエンス関連システムの識別子を含むオブジェクト。 これには以下が含まれます。

  • flowId：この ID は、オーディエンスデータの取り込みに使用されたデータフローにオーディエンスを接続するために使用されます。 必要な ID について詳しくは、を参照してください。 データフローガイドの作成.
  • aoWorkflowId：この ID は、オーディエンスを関連するオーディエンスオーケストレーション構成に接続するために使用されます。</li/>
  • payloadFieldGroupRef：この ID は、オーディエンスの構造を説明する XDM フィールドグループスキーマを参照するために使用されます。 このフィールドの値について詳しくは、 XDM フィールドグループエンドポイントガイド.
  • audienceFolderId：この ID は、オーディエンスのAdobe Audience Managerのフォルダー ID を参照するために使用されます。 この API について詳しくは、 Adobe Audience Manager API ガイド.

応答

応答に成功すると、HTTP ステータス 200 と、新しく作成されたオーディエンスに関する情報が返されます。

Platform で生成されたオーディエンス
accordion
Platform で生成されたオーディエンスを取得する際の応答のサンプル。
code language-json 
{
    "id": "60ccea95-1435-4180-97a5-58af4aa285ab",
    "audienceId": "60ccea95-1435-4180-97a5-58af4aa285ab",
    "schema": {
        "name": "_xdm.context.profile"
    },
    "ttlInDays": 60,
    "profileInstanceId": "ups",
    "imsOrgId": "{ORG_ID}",
    "sandbox": {
        "sandboxId": "6ed34f6f-fe21-4a30-934f-6ffe21fa3075",
        "sandboxName": "prod",
        "type": "production",
        "default": true
    },
    "isSystem": false,
    "name": "People who ordered in the last 30 days",
    "description": "Last 30 days",
    "expression": {
        "type": "PQL",
        "format": "pql/text",
        "value": "workAddress.country = \"US\""
    },
    "mergePolicyId": "ef006bbe-750e-4e81-85f0-0c6902192dcc",
    "evaluationInfo": {
        "batch": {
            "enabled": false
        },
        "continuous": {
            "enabled": true
        },
        "synchronous": {
            "enabled": false
        }
    },
    "dataGovernancePolicy": {
        "excludeOptOut": true
    },
    "creationTime": 1650374572000,
    "updateEpoch": 1650374573,
    "updateTime": 1650374573000,
    "createEpoch": 1650374572,
    "_etag": "\"33120d7c-0000-0200-0000-625eb7ad0000\"",
    "dependents": [],
    "definedOn": [
        {
            "meta:resourceType": "unions",
            "meta:containerId": "tenant",
            "$ref": "https://ns.adobe.com/xdm/context/profile__union"
        }
    ],
    "dependencies": [],
    "type": "SegmentDefinition",
    "overridePerformanceWarnings": false,
    "createdBy": "{CREATED_BY_ID}",
    "lifecycleState": "active",
    "labels": [
        "core/C1"
    ],
    "namespace": "AEPSegments"
}
外部で生成されたオーディエンス
accordion
外部で生成されたオーディエンスを取得する際の応答のサンプル。
code language-json 
{
    "id": "60ccea95-1435-4180-97a5-58af4aa285ab",
    "audienceId": "test-external-audience-id",
    "name": "externalAudience",
    "namespace": "aam",
    "imsOrgId": "{ORG_ID}",
    "sandbox": {
        "sandboxId": "6ed34f6f-fe21-4a30-934f-6ffe21fa3075",
        "sandboxName": "prod",
        "type": "production",
        "default": true
    },
    "isSystem": false,
    "description": "Last 30 days",
    "type": "ExternalSegment",
    "lifecycleState": "active",
    "createdBy": "{CREATED_BY_ID}",
    "datasetId": "6254cf3c97f8e31b639fb14d",
    "labels": [
        "core/C1"
    ],
    "_etag": "\"f4102699-0000-0200-0000-625cd61a0000\"",
    "creationTime": 1650251290000,
    "updateEpoch": 1650251290,
    "updateTime": 1650251290000,
    "createEpoch": 1650251290
}

オーディエンスのフィールドの更新 update-field

特定のオーディエンスのフィールドを更新するには、次の項目に対してPATCHリクエストを実行します。 /audiences エンドポイントと、更新するオーディエンスの ID をリクエストパスで指定します。

API 形式

PATCH /audiences/{AUDIENCE_ID}
パラメーター
説明
{AUDIENCE_ID}
更新するオーディエンスの ID。 これはです id フィールド、およびは ではない この audienceId フィールド。

リクエスト

オーディエンスのフィールドを更新するリクエストの例。
code language-shell 
curl -X PATCH https://platform.adobe.io/data/core/ups/audiences/4afe34ae-8c98-4513-8a1d-67ccaa54bc05 \
 -H 'Authorization: Bearer {ACCESS_TOKEN}' \
 -H 'Content-Type: application/json' \
 -H 'x-gw-ims-org-id: {IMS_ORG}' \
 -H 'x-api-key: {API_KEY}' \
 -H 'x-sandbox-name: {SANDBOX_NAME}' \
 -d '
     [
        {
            "op": "add",
            "path": "/expression",
            "value": {
                "type": "PQL",
                "format": "pql/text",
                "value": "workAddress.country = \"CA\""
            }
        }
      ]'
table 0-row-2 1-row-2 2-row-2 3-row-2
プロパティ 説明
op オーディエンスを更新する場合、この値は常にです add.
path 更新するフィールドのパス。
value フィールドの更新先の値。

応答

応答に成功すると、HTTP ステータス 200 と、新しく更新されたオーディエンスに関する情報が返されます。

オーディエンス内のフィールドを更新する際の応答例。
code language-json 
{
    "id": "60ccea95-1435-4180-97a5-58af4aa285ab",
    "audienceId": "60ccea95-1435-4180-97a5-58af4aa285ab",
    "schema": {
        "name": "_xdm.context.profile"
    },
    "ttlInDays": 60,
    "profileInstanceId": "ups",
    "imsOrgId": "{ORG_ID}",
    "sandbox": {
        "sandboxId": "6ed34f6f-fe21-4a30-934f-6ffe21fa3075",
        "sandboxName": "prod",
        "type": "production",
        "default": true
    },
    "name": "People who ordered in the last 30 days",
    "description": "Last 30 days",
    "expression": {
        "type": "PQL",
        "format": "pql/text",
        "value": "workAddress.country = \"CA\""
    },
    "mergePolicyId": "ef006bbe-750e-4e81-85f0-0c6902192dcc",
    "evaluationInfo": {
        "batch": {
          "enabled": false
        },
        "continuous": {
          "enabled": true
        },
        "synchronous": {
          "enabled": false
        }
    },
    "dataGovernancePolicy": {
      "excludeOptOut": true
    },
    "creationTime": 1650374572000,
    "updateEpoch": 1650374573,
    "updateTime": 1650374573000,
    "createEpoch": 1650374572,
    "_etag": "\"33120d7c-0000-0200-0000-625eb7ad0000\"",
    "dependents": [],
    "definedOn": [
        {
          "meta:resourceType": "unions",
          "meta:containerId": "tenant",
          "$ref": "https://ns.adobe.com/xdm/context/profile__union"
        }
    ],
    "dependencies": [],
    "type": "SegmentDefinition",
    "overridePerformanceWarnings": false,
    "createdBy": "{CREATED_BY_ID}",
    "lifecycleState": "active",
    "labels": [
      "core/C1"
    ],
    "namespace": "AEPSegments"
}

オーディエンスの更新 put

特定のオーディエンスを更新（上書き）するには、に対してPUTリクエストを実行します。 /audiences エンドポイントと、更新するオーディエンスの ID をリクエストパスで指定します。

API 形式

PUT /audiences/{AUDIENCE_ID}
パラメーター
説明
{AUDIENCE_ID}
更新するオーディエンスの ID。 これはです id フィールド、およびは ではない この audienceId フィールド。

リクエスト

オーディエンス全体を更新するリクエストのサンプル。
code language-shell 
curl -X PUT https://platform.adobe.io/data/core/ups/audiences/4afe34ae-8c98-4513-8a1d-67ccaa54bc05 \
 -H 'Authorization: Bearer {ACCESS_TOKEN}' \
 -H 'Content-Type: application/json' \
 -H 'x-gw-ims-org-id: {IMS_ORG}' \
 -H 'x-api-key: {API_KEY}' \
 -H 'x-sandbox-name: {SANDBOX_NAME}' \
 -d '{
    "audienceId": "test-external-audience-id",
    "name": "New external audience",
    "namespace": "aam",
    "description": "Last 30 days",
    "type": "ExternalSegment",
    "lifecycleState": "published",
    "datasetId": "6254cf3c97f8e31b639fb14d",
    "labels": [
        "core/C1"
    ]
}'
table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2 5-row-2 6-row-2 7-row-2 8-row-2
プロパティ 説明
audienceId オーディエンスの ID。 外部で生成されたオーディエンスの場合、この値はユーザーによって指定される場合があります。
name オーディエンスの名前。
namespace オーディエンスの名前空間。
description オーディエンスの説明。
type オーディエンスが Platform で生成されたものか、外部で生成されたオーディエンスかを表示する、システムで生成されたフィールド。 使用可能な値は次のとおりです SegmentDefinition および ExternalSegment. A SegmentDefinition は、Platform で生成されたオーディエンスを参照し、は ExternalSegment platform で生成されなかったオーディエンスを参照します。
lifecycleState オーディエンスのステータス。使用可能な値は次のとおりです draft, published、および inactive. draft オーディエンスが作成されると、を表します。 published オーディエンスが公開されるタイミング、および inactive オーディエンスがアクティブでなくなった場合。
datasetId オーディエンスデータを検索できるデータセットの ID。
labels オーディエンスに関連するオブジェクトレベルのデータ使用と属性ベースのアクセス制御ラベル。

応答

応答が成功すると、HTTP ステータス 200 が、新しく更新されたオーディエンスの詳細と共に返されます。 オーディエンスの詳細は、Platform で生成されたオーディエンスか、外部で生成されたオーディエンスかによって異なることに注意してください。

オーディエンス全体を更新する際の応答のサンプル。
code language-json 
{
    "id": "4afe34ae-8c98-4513-8a1d-67ccaa54bc05",
    "audienceId": "test-external-audience-id",
    "name": "New external audience",
    "namespace": "aam",
    "imsOrgId": "{ORG_ID}",
    "sandbox": {
        "sandboxId": "6ed34f6f-fe21-4a30-934f-6ffe21fa3075",
        "sandboxName": "prod",
        "type": "production",
        "default": true
    },
    "description": "Last 30 days",
    "type": "ExternalSegment",
    "lifecycleState": "published",
    "createdBy": "{CREATED_BY_ID}",
    "datasetId": "6254cf3c97f8e31b639fb14d",
    "_etag": "\"f4102699-0000-0200-0000-625cd61a0000\"",
    "creationTime": 1650251290000,
    "updateEpoch": 1650251290,
    "updateTime": 1650251290000,
    "createEpoch": 1650251290
}

オーディエンスの削除 delete

特定のオーディエンスを削除するには、次の項目に対してDELETEリクエストを実行します。 /audiences エンドポイントと、削除するオーディエンスの ID をリクエストパスで指定します。

API 形式

DELETE /audiences/{AUDIENCE_ID}
パラメーター
説明
{AUDIENCE_ID}
削除するオーディエンスの ID。 これはです id フィールド、およびは ではない この audienceId フィールド。

リクエスト

オーディエンスの削除リクエストのサンプル。
code language-shell 
curl -X DELETE https://platform.adobe.io/data/core/ups/audiences/60ccea95-1435-4180-97a5-58af4aa285ab5 \
 -H 'Authorization: Bearer {ACCESS_TOKEN}' \
 -H 'x-gw-ims-org-id: {ORG_ID}' \
 -H 'x-api-key: {API_KEY}' \
 -H 'x-sandbox-name: {SANDBOX_NAME}'

応答

リクエストが成功した場合、HTTP ステータス 204 が返され、メッセージは返されません。

複数のオーディエンスの取得 bulk-get

に対してPOSTリクエストを実行すると、複数のオーディエンスを取得できます。 /audiences/bulk-get エンドポイントと、取得するオーディエンスの ID を指定します。

API 形式

POST /audiences/bulk-get

リクエスト

複数のオーディエンスを取得するリクエストのサンプル。
code language-shell 
curl -X POST https://platform.adobe.io/data/core/ups/audiences/bulk-get
 -H 'Authorization: Bearer {ACCESS_TOKEN}' \
 -H 'Content-Type: application/json' \
 -H 'x-gw-ims-org-id: {IMS_ORG}' \
 -H 'x-api-key: {API_KEY}' \
 -H 'x-sandbox-name: {SANDBOX_NAME}' \
 -d ' {
    "ids": [
        {
            "id": "72c393ea-caed-441a-9eb6-5f66bb1bd6cd"
        },
        {
            "id": "QU9fLTEzOTgzNTE0MzY0NzY0NDg5NzkyOTkx_6ed34f6f-fe21-4a30-934f-6ffe21fa3075"
        }
    ]
 }

応答

応答に成功すると、HTTP ステータス 207 と、リクエストされたオーディエンスの情報が返されます。

複数のオーディエンスを取得する場合の応答例。
code language-json 
{
   "results":{
      "72c393ea-caed-441a-9eb6-5f66bb1bd6cd":{
         "id": "72c393ea-caed-441a-9eb6-5f66bb1bd6cd",
         "audienceId": "72c393ea-caed-441a-9eb6-5f66bb1bd6cd",
         "schema": {
            "name": "_xdm.context.profile"
         },
         "ttlInDays": 30,
         "imsOrgId": "{ORG_ID}",
         "sandbox": {
            "sandboxId": "6ed34f6f-fe21-4a30-934f-6ffe21fa3075",
            "sandboxName": "prod",
            "type": "production",
            "default": true
         },
         "name": "Sample audience",
         "expression": {
            "type": "pql",
            "format": "pql/text",
            "value": "_id = \"abc\""
        },
         "mergePolicyId": "87c94d51-239c-4391-932c-29c2412100e5",
         "evaluationInfo": {
            "batch": {
               "enabled": false
            },
            "continuous": {
               "enabled": true
            },
            "synchronous": {
               "enabled": false
            }
         },
         "ansibleUiEnabled": false,
         "dataGovernancePolicy": {
            "excludeOptOut": true
         },
         "creationTime": 1623889553000000,
         "updateEpoch": 1674646369,
         "updateTime": 1674646369000,
         "createEpoch": 1623889552,
         "_etag": "\"61030ec7-0000-0200-0000-63d113610000\"",
         "dependents": [],
         "definedOn": [
            {
               "meta:resourceType": "unions",
               "meta:containerId": "tenant",
               "$ref": "https://ns.adobe.com/xdm/context/profile__union"
            }
         ],
         "dependencies": [],
         "type": "SegmentDefinition",
         "state": "enabled",
         "overridePerformanceWarnings": false,
         "lastModifiedBy": "{CREATED_ID}",
         "lifecycleState": "published",
         "namespace": "AEPSegments",
         "isSystem": false,
         "saveSegmentMembership": true,
         "originName": "REAL_TIME_CUSTOMER_PROFILE"
      },
      "QU9fLTEzOTgzNTE0MzY0NzY0NDg5NzkyOTkx_6ed34f6f-fe21-4a30-934f-6ffe21fa3075":{
         "id": "QU9fLTEzOTgzNTE0MzY0NzY0NDg5NzkyOTkx_6ed34f6f-fe21-4a30-934f-6ffe21fa3075",
         "name": "label test24764489707692",
         "namespace": "AO",
         "imsOrgId": "{ORG_ID}",
         "sandbox":{
            "sandboxId": "6ed34f6f-fe21-4a30-934f-6ffe21fa3075",
            "sandboxName": "prod",
            "type": "production",
            "default": true
         },
         "type": "ExternalSegment",
         "lifecycleState": "published",
         "sourceId": "source-id",
         "createdBy": "{USER_ID}",
         "datasetId": "62bf31a105e9891b63525c92",
         "_etag": "\"3100da6d-0000-0200-0000-62bf31a10000\"",
         "creationTime": 1656697249000,
         "updateEpoch": 1656697249,
         "updateTime": 1656697249000,
         "createEpoch": 1656697249,
         "audienceId": "test-audience-id",
         "isSystem": false,
         "saveSegmentMembership": true,
         "linkedAudienceRef": {
            "aoWorkflowId": "62bf31858e87e34c8364befa"
         },
         "originName": "AUDIENCE_ORCHESTRATION"
      }
   }
}

次の手順

このガイドを読むことで、Adobe Experience Platform API を使用してオーディエンスを作成、管理および削除する方法について、理解が深まりました。 UI を使用した Audience Management について詳しくは、を参照してください。 セグメント化 UI ガイド.

recommendation-more-help
770bc05d-534a-48a7-9f07-017ec1e14871