Documentazione Experience Platform Guida al servizio di segmentazione

Guida alla segmentazione batch

Last update: Thu Apr 03 2025 00:00:00 GMT+0000 (Coordinated Universal Time)

Argomenti:

Creato per:

Utente

La segmentazione batch è un metodo di valutazione della segmentazione che consente di spostare i dati di profilo in una sola volta per creare tipi di pubblico corrispondenti.

Con la segmentazione in batch, puoi creare tipi di pubblico dettagliati e avanzati ed eseguire processi di segmentazione per determinare quando propagare i dati ai servizi a valle.

Tipi di query idonei query-types

Tutte le query sono idonee per la segmentazione batch.

Crea pubblico create-audience

Puoi creare un pubblico valutato utilizzando la segmentazione batch utilizzando l’API del servizio di segmentazione o tramite Audience Portal nell’interfaccia utente.

API servizio di segmentazione

Formato API

code language-http
`POST /segment/definitions`

Richiesta

accordion

Una richiesta di esempio per creare una definizione di segmento abilitata per la segmentazione batch

code language-shell

curl -X POST https://platform.adobe.io/data/core/ups/segment/definitions
 -H 'Authorization: Bearer {ACCESS_TOKEN}' \
 -H 'Content-Type: application/json' \
 -H 'x-gw-ims-org-id: {ORG_ID}' \
 -H 'x-api-key: {API_KEY}' \
 -H 'x-sandbox-name: {SANDBOX_NAME}'
 -d '{
        "name": "People in the USA",
        "description: "An audience that looks for people who live in the USA",
        "expression": {
            "type": "PQL",
            "format": "pql/text",
            "value": "homeAddress.country = \"US\""
        },
        "evaluationInfo": {
            "batch": {
                "enabled": true
            },
            "continuous": {
                "enabled": false
            },
            "synchronous": {
                "enabled": false
            }
        },
        "schema": {
            "name": "_xdm.context.profile"
        }
     }'

Risposta

In caso di esito positivo, la risposta restituisce lo stato HTTP 200 con i dettagli della definizione del segmento appena creata.

accordion

Risposta di esempio durante la creazione di una definizione di segmento.

code language-json

{
    "id": "4afe34ae-8c98-4513-8a1d-67ccaa54bc05",
    "schema": {
        "name": "_xdm.context.profile"
    },
    "profileInstanceId": "ups",
    "imsOrgId": "{ORG_ID}",
    "sandbox": {
        "sandboxId": "28e74200-e3de-11e9-8f5d-7f27416c5f0d",
        "sandboxName": "prod",
        "type": "production",
        "default": true
    },
    "name": "People in the USA",
    "description": "An audience that looks for people who live in the USA",
    "expression": {
        "type": "PQL",
        "format": "pql/text",
        "value": "homeAddress.country = \"US\""
    },
    "evaluationInfo": {
        "batch": {
            "enabled": true
        },
        "continuous": {
            "enabled": false
        },
        "synchronous": {
            "enabled": false
        }
    },
    "dataGovernancePolicy": {
        "excludeOptOut": true
    },
    "creationTime": 0,
    "updateEpoch": 1579292094,
    "updateTime": 1579292094000
}

Ulteriori informazioni sull'utilizzo di questo endpoint sono disponibili nella guida dell'endpoint di definizione del segmento.

Audience Portal

In Audience Portal, seleziona Crea pubblico.

Il pulsante Crea pubblico è evidenziato in Audience Portal.

Viene visualizzata una finestra a comparsa. Seleziona Genera regole per accedere al Generatore di segmenti.

Il pulsante Genera regole è evidenziato nel popover Crea pubblico.

Dopo aver creato la definizione del segmento, seleziona Batch come Metodo di valutazione.

Viene visualizzata la definizione del segmento. Il tipo di valutazione è evidenziato. La definizione del segmento può essere valutata utilizzando la segmentazione in streaming.

Per ulteriori informazioni sulla creazione delle definizioni dei segmenti, consulta la guida del Generatore di segmenti

Recuperare i tipi di pubblico retrieve-audiences

Puoi recuperare tutti i tipi di pubblico valutati utilizzando la segmentazione batch utilizzando l’API del servizio di segmentazione o tramite Audience Portal nell’interfaccia utente.

API servizio di segmentazione

Recupera un elenco di tutte le definizioni di segmenti valutate utilizzando la segmentazione batch all'interno della tua organizzazione effettuando una richiesta GET all'endpoint /segment/definitions.

Formato API

È necessario includere il parametro query evaluationInfo.batch.enabled=true nel percorso della richiesta per recuperare le definizioni dei segmenti valutate utilizzando la segmentazione batch.

code language-http
`GET /segment/definitions?evaluationInfo.batch.enabled=true`

Richiesta

accordion

Una richiesta di esempio per elencare tutte le definizioni di segmenti abilitati per il batch

code language-shell

curl -X GET \
  'https://platform.adobe.io/data/core/ups/segment/definitions?evaluationInfo.batch.enabled=true' \
  -H 'Authorization: Bearer {ACCESS_TOKEN}' \
  -H 'Content-Type: application/json' \
  -H 'x-api-key: {API_KEY}' \
  -H 'x-gw-ims-org-id: {ORG_ID}' \
  -H 'x-sandbox-name: {SANDBOX_NAME}'

Risposta

In caso di esito positivo, la risposta restituisce lo stato HTTP 200 con un array di definizioni di segmenti nell’organizzazione che vengono valutate utilizzando la segmentazione batch.

accordion

Una risposta di esempio contenente un elenco di tutte le definizioni di segmenti valutati per la segmentazione batch all’interno dell’organizzazione

code language-json

{
    "segments": [
        {
            "id": "15063cb-2da8-4851-a2e2-bf59ddd2f004",
            "schema": {
                "name": "_xdm.context.profile"
            },
            "ttlInDays": 30,
            "imsOrgId": "{ORG_ID}",
            "sandbox": {
                "sandboxId": "",
                "sandboxName": "",
                "type": "production",
                "default": true
            },
            "name": " People who are NOT on their homepage ",
            "expression": {
                "type": "PQL",
                "format": "pql/text",
                "value": "select var1 from xEvent where var1._experience.analytics.endUser.firstWeb.webPageDetails.isHomePage = false"
            },
            "evaluationInfo": {
                "batch": {
                    "enabled": true
                },
                "continuous": {
                    "enabled": false
                },
                "synchronous": {
                    "enabled": false
                }
            },
            "creationTime": 1572029711000,
            "updateEpoch": 1572029712000,
            "updateTime": 1572029712000
        },
        {
            "id": "f15063cb-2da8-4851-a2e2-bf59ddd2f004",
            "schema": {
                "name": "_xdm.context.profile"
            },
            "ttlInDays": 30,
            "imsOrgId": "{ORG_ID}",
            "sandbox": {
                "sandboxId": "",
                "sandboxName": "",
                "type": "production",
                "default": true
            },
            "name": "Homepage_continuous",
            "description": "People who are on their homepage - continuous",
            "expression": {
                "type": "PQL",
                "format": "pql/text",
                "value": "select var1 from xEvent where var1._experience.analytics.endUser.firstWeb.webPageDetails.isHomePage = true"
            },
            "evaluationInfo": {
                "batch": {
                    "enabled": true
                },
                "continuous": {
                    "enabled": true
                },
                "synchronous": {
                    "enabled": false
                }
            },
            "creationTime": 1572021085000,
            "updateEpoch": 1572021086000,
            "updateTime": 1572021086000
        }
    ],
    "page": {
        "totalCount": 2,
        "totalPages": 1,
        "sortField": "creationTime",
        "sort": "desc",
        "pageSize": 2,
        "limit": 100
    },
    "link": {}
}

Informazioni più dettagliate sulla definizione del segmento restituita sono disponibili nella guida dell'endpoint per le definizioni dei segmenti.

Audience Portal

Puoi recuperare tutti i tipi di pubblico abilitati per la segmentazione in batch all’interno della tua organizzazione utilizzando i filtri in Audience Portal. Seleziona l'icona per visualizzare l'elenco dei filtri.

Licona del filtro è evidenziata in Audience Portal.

All'interno dei filtri disponibili, vai a Frequenza di aggiornamento e seleziona "Batch". Utilizzando questo filtro vengono visualizzati tutti i tipi di pubblico dell’organizzazione valutati mediante segmentazione batch.

È selezionata la frequenza di aggiornamento batch, con tutti i tipi di pubblico dellorganizzazione valutati mediante segmentazione batch.

Per ulteriori informazioni sulla visualizzazione dei tipi di pubblico in Experience Platform, consulta la guida di Audience Portal.

Passaggi successivi

Questa guida spiega come creare una definizione di segmento che può essere valutata utilizzando la segmentazione batch in Adobe Experience Platform.

Per ulteriori informazioni sull'utilizzo dell'interfaccia utente di Experience Platform, leggere la Guida utente per la segmentazione.

Per le domande frequenti sulla segmentazione batch, leggi la sezione segmentazione batch delle domande frequenti.

recommendation-more-help

770bc05d-534a-48a7-9f07-017ec1e14871