DocumentazioneExperience PlatformGuida al servizio di segmentazione

Endpoint "audience"

Last update: Wed Jun 12 2024 00:00:00 GMT+0000 (Coordinated Universal Time)
  • Argomenti:

Creato per:

  • Sviluppatore

Un pubblico è una raccolta di persone che condividono comportamenti e/o caratteristiche simili. Queste raccolte di persone possono essere generate utilizzando Adobe Experience Platform o da origini esterne. È possibile utilizzare /audiences nell’API di segmentazione, che consente di recuperare, creare, aggiornare ed eliminare in modo programmatico i tipi di pubblico.

Introduzione

Gli endpoint utilizzati in questa guida fanno parte del Adobe Experience Platform Segmentation Service API. Prima di continuare, controlla guida introduttiva per informazioni importanti che devi conoscere per effettuare correttamente chiamate all’API, incluse le intestazioni richieste e la lettura di esempi di chiamate API.

Recuperare un elenco di tipi di pubblico list

Per recuperare un elenco di tutti i tipi di pubblico per la tua organizzazione, devi effettuare una richiesta GET al /audiences endpoint.

Formato API

Il /audiences l’endpoint supporta diversi parametri di query per aiutare a filtrare i risultati. Anche se questi parametri sono facoltativi, si consiglia vivamente di utilizzarli per ridurre i costi comuni quando si elencano le risorse. Se effettui una chiamata a questo endpoint senza parametri, verranno recuperati tutti i tipi di pubblico disponibili per la tua organizzazione. È possibile includere più parametri, separati da e commerciali (&).

GET /audiences
GET /audiences?{QUERY_PARAMETERS}

Durante il recupero di un elenco di tipi di pubblico è possibile utilizzare i seguenti parametri di query:

Parametro query
Descrizione
Esempio
start
Specifica l'offset iniziale per i tipi di pubblico restituiti.
start=5
limit
Specifica il numero massimo di pubblici restituiti per pagina.
limit=10
sort
Specifica l'ordine di ordinamento dei risultati. Questo è scritto nel formato attributeName:[desc/asc].
sort=updateTime:desc
property
Un filtro che ti consente di specificare tipi di pubblico che esattamente corrisponde al valore di un attributo. Questo è scritto nel formato property=
property=audienceId==test-audience-id
name
Un filtro che consente di specificare tipi di pubblico i cui nomi contain il valore fornito. Questo valore non distingue tra maiuscole e minuscole.
name=Sample
description
Un filtro che consente di specificare tipi di pubblico le cui descrizioni contain il valore fornito. Questo valore non distingue tra maiuscole e minuscole.
description=Test Description

Richiesta

La richiesta seguente recupera gli ultimi due tipi di pubblico creati nell’organizzazione.

Richiesta di esempio per recuperare un elenco di tipi di pubblico.
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}'

Risposta

In caso di esito positivo, la risposta restituisce lo stato HTTP 200 con un elenco di tipi di pubblico creati nell’organizzazione come JSON.

Una risposta di esempio contenente gli ultimi due tipi di pubblico creati che appartengono alla tua organizzazione
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
Proprietà Tipo di pubblico Descrizione
id Entrambi Identificatore di sola lettura generato dal sistema per il pubblico.
audienceId Entrambi Se il pubblico è generato da Platform, è lo stesso valore del pubblico id. Se il pubblico è generato esternamente, questo valore viene fornito dal client.
schema Entrambi Lo schema Experience Data Model (XDM) del pubblico.
imsOrgId Entrambi ID dell’organizzazione a cui appartiene il pubblico.
sandbox Entrambi Informazioni sulla sandbox a cui appartiene il pubblico. Ulteriori informazioni sulle sandbox sono disponibili nella sezione panoramica sulle sandbox.
name Entrambi Il nome del pubblico.
description Entrambi Una descrizione del pubblico.
expression Generato da piattaforma L’espressione PQL (Profile Query Language) del pubblico. Ulteriori informazioni sulle espressioni PQL sono disponibili nella sezione Guida alle espressioni PQL.
mergePolicyId Generato da piattaforma ID del criterio di unione a cui è associato il pubblico. Ulteriori informazioni sui criteri di unione sono disponibili nella sezione guida ai criteri di unione.
evaluationInfo Generato da piattaforma Mostra come verrà valutato il pubblico. I possibili metodi di valutazione includono batch, sincrono (streaming) o continuo (edge). Ulteriori informazioni sui metodi di valutazione sono disponibili nella sezione panoramica sulla segmentazione
dependents Entrambi Un array di ID di pubblico che dipendono dal pubblico corrente. Questa opzione è utile per creare un pubblico che è un segmento di un segmento.
dependencies Entrambi Un array di ID di pubblico da cui dipende il pubblico. Questa opzione è utile per creare un pubblico che è un segmento di un segmento.
type Entrambi Campo generato dal sistema che indica se il pubblico è generato da Platform o da un pubblico generato esternamente. I valori possibili includono SegmentDefinition e ExternalSegment. A SegmentDefinition fa riferimento a un pubblico generato in Platform, mentre un ExternalSegment fa riferimento a un pubblico non generato in Platform.
originName Entrambi Campo che fa riferimento al nome dell’origine del pubblico. Per il pubblico generato da Platform, questo valore sarà REAL_TIME_CUSTOMER_PROFILE. Per i tipi di pubblico generati in Audience Orchestration, questo valore sarà AUDIENCE_ORCHESTRATION. Per i tipi di pubblico generati in Adobe Audience Manager, questo valore sarà AUDIENCE_MANAGER. Per altri tipi di pubblico generati esternamente, questo valore sarà CUSTOM_UPLOAD.
createdBy Entrambi ID dell’utente che ha creato il pubblico.
labels Entrambi Etichette di controllo dell’accesso basate su attributi e utilizzo dati a livello di oggetto rilevanti per il pubblico.
namespace Entrambi Lo spazio dei nomi a cui appartiene il pubblico. I valori possibili includono AAM, AAMSegments, AAMTraits, e AEPSegments.
linkedAudienceRef Entrambi Oggetto che contiene identificatori di altri sistemi relativi al pubblico.

Creare un nuovo pubblico create

Per creare un nuovo pubblico, devi effettuare una richiesta POST al /audiences endpoint.

Formato API

POST /audiences

Richiesta

Pubblico generato dalla piattaforma
accordion
Richiesta di esempio per la creazione di un pubblico generato da 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
Proprietà Descrizione
name Il nome del pubblico.
description Una descrizione del pubblico.
type Campo che indica se il pubblico è generato da Platform o da un pubblico generato esternamente. I valori possibili includono SegmentDefinition e ExternalSegment. A SegmentDefinition fa riferimento a un pubblico generato in Platform, mentre un ExternalSegment fa riferimento a un pubblico non generato in Platform.
expression L’espressione PQL (Profile Query Language) del pubblico. Ulteriori informazioni sulle espressioni PQL sono disponibili nella sezione Guida alle espressioni PQL.
schema Lo schema Experience Data Model (XDM) del pubblico.
labels Etichette di controllo dell’accesso basate su attributi e utilizzo dati a livello di oggetto rilevanti per il pubblico.
ttlInDays Rappresenta il valore di scadenza dei dati per il pubblico, in giorni.
Pubblico generato esternamente
accordion
Richiesta di esempio per la creazione di un pubblico generato esternamente
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
Proprietà Descrizione
audienceId ID fornito dall’utente per il pubblico.
name Il nome del pubblico.
namespace Lo spazio dei nomi per il pubblico.
description Una descrizione del pubblico.
type Campo che indica se il pubblico è generato da Platform o da un pubblico generato esternamente. I valori possibili includono SegmentDefinition e ExternalSegment. A SegmentDefinition fa riferimento a un pubblico generato in Platform, mentre un ExternalSegment fa riferimento a un pubblico non generato in Platform.
originName Nome dell’origine del pubblico. Per i tipi di pubblico generati esternamente, il valore predefinito è CUSTOM_UPLOAD. Altri valori supportati includono REAL_TIME_CUSTOMER_PROFILE, CUSTOM_UPLOAD, AUDIENCE_ORCHESTRATION, e AUDIENCE_MATCH.
lifecycleState Campo facoltativo che determina lo stato iniziale del pubblico che stai tentando di creare. I valori supportati includono draft, published, e inactive.
datasetId ID del set di dati in cui è possibile trovare i dati che costituiscono il pubblico.
labels Etichette di controllo dell’accesso basate su attributi e utilizzo dati a livello di oggetto rilevanti per il pubblico.
audienceMeta Metadati che appartengono al pubblico generato esternamente.
linkedAudienceRef

Oggetto che contiene identificatori per altri sistemi relativi al pubblico. Ciò può includere quanto segue:

  • flowId: questo ID viene utilizzato per collegare il pubblico al flusso di dati utilizzato per inserire i dati del pubblico. Ulteriori informazioni sugli ID richiesti sono disponibili nella sezione creare una guida al flusso di dati.
  • aoWorkflowId: questo ID viene utilizzato per connettere il pubblico a una composizione correlata di Audience Orchestration.</li/>
  • payloadFieldGroupRef: questo ID viene utilizzato per fare riferimento allo schema Gruppo di campi XDM che descrive la struttura del pubblico. Ulteriori informazioni sul valore di questo campo sono disponibili nella sezione Guida dell’endpoint gruppo di campi XDM.
  • audienceFolderId: questo ID viene utilizzato per fare riferimento all’ID cartella in Adobe Audience Manager per il pubblico. Ulteriori informazioni su questa API sono disponibili nella sezione Guida API di Adobe Audience Manager.

Risposta

In caso di esito positivo, la risposta restituisce lo stato HTTP 200 con informazioni sul pubblico appena creato.

Pubblico generato dalla piattaforma
accordion
Una risposta di esempio durante il recupero di un pubblico generato da 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"
}
Pubblico generato esternamente
accordion
Una risposta di esempio durante il recupero di un pubblico generato esternamente.
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
}

Aggiornare un campo in un pubblico update-field

Puoi aggiornare i campi di un pubblico specifico effettuando una richiesta PATCH al /audiences e fornendo l’ID del pubblico da aggiornare nel percorso della richiesta.

Formato API

PATCH /audiences/{AUDIENCE_ID}
Parametro
Descrizione
{AUDIENCE_ID}
ID del pubblico che desideri aggiornare. Tieni presente che questa è la id ed è non il audienceId campo.

Richiesta

Richiesta di esempio per aggiornare un campo in un pubblico.
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
Proprietà Descrizione
op Per aggiornare il pubblico, questo valore è sempre add.
path Percorso del campo da aggiornare.
value Il valore a cui desideri aggiornare il campo.

Risposta

In caso di esito positivo, la risposta restituisce lo stato HTTP 200 con informazioni sul pubblico appena aggiornato.

Una risposta di esempio durante l’aggiornamento di un campo in un pubblico.
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"
}

Aggiornare un pubblico put

Per aggiornare (sovrascrivere) un pubblico specifico, devi effettuare una richiesta PUT al /audiences e fornendo l’ID del pubblico da aggiornare nel percorso della richiesta.

Formato API

PUT /audiences/{AUDIENCE_ID}
Parametro
Descrizione
{AUDIENCE_ID}
ID del pubblico che desideri aggiornare. Tieni presente che questa è la id ed è non il audienceId campo.

Richiesta

Una richiesta di esempio per aggiornare un intero pubblico.
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
Proprietà Descrizione
audienceId ID del pubblico. Per i tipi di pubblico generati esternamente, questo valore può essere fornito dall’utente.
name Il nome del pubblico.
namespace Lo spazio dei nomi per il pubblico.
description Una descrizione del pubblico.
type Campo generato dal sistema che indica se il pubblico è generato da Platform o da un pubblico generato esternamente. I valori possibili includono SegmentDefinition e ExternalSegment. A SegmentDefinition fa riferimento a un pubblico generato in Platform, mentre un ExternalSegment fa riferimento a un pubblico non generato in Platform.
lifecycleState Stato del pubblico. I valori possibili includono draft, published, e inactive. draft rappresenta quando viene creato il pubblico, published quando viene pubblicato il pubblico e inactive quando il pubblico non è più attivo.
datasetId ID del set di dati in cui è possibile trovare i dati sul pubblico.
labels Etichette di controllo dell’accesso basate su attributi e utilizzo dati a livello di oggetto rilevanti per il pubblico.

Risposta

In caso di esito positivo, la risposta restituisce lo stato HTTP 200 con i dettagli del pubblico appena aggiornato. Tieni presente che i dettagli del pubblico variano a seconda che si tratti di un pubblico generato da Platform o da un pubblico generato esternamente.

Una risposta di esempio durante l’aggiornamento di un intero pubblico.
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
}

Eliminare un pubblico delete

Per eliminare un pubblico specifico, devi effettuare una richiesta DELETE al /audiences e fornendo l’ID del pubblico da eliminare nel percorso della richiesta.

Formato API

DELETE /audiences/{AUDIENCE_ID}
Parametro
Descrizione
{AUDIENCE_ID}
ID del pubblico da eliminare. Tieni presente che questa è la id ed è non il audienceId campo.

Richiesta

Una richiesta di esempio per eliminare un pubblico.
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}'

Risposta

In caso di esito positivo, la risposta restituisce lo stato HTTP 204 senza messaggio.

Recuperare più tipi di pubblico bulk-get

Per recuperare più tipi di pubblico, devi effettuare una richiesta POST al /audiences/bulk-get e fornendo gli ID dei tipi di pubblico da recuperare.

Formato API

POST /audiences/bulk-get

Richiesta

Una richiesta di esempio per recuperare più tipi di pubblico.
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"
        }
    ]
 }

Risposta

In caso di esito positivo, la risposta restituisce lo stato HTTP 207 con le informazioni relative ai tipi di pubblico richiesti.

Una risposta di esempio durante il recupero di più tipi di pubblico.
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"
      }
   }
}

Passaggi successivi

Dopo aver letto questa guida, ora hai una migliore comprensione di come creare, gestire ed eliminare i tipi di pubblico utilizzando l’API di Adobe Experience Platform. Per ulteriori informazioni sulla gestione dell'audience tramite l'interfaccia utente, leggi guida all’interfaccia utente di segmentazione.

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