Documentazione Experience Platform Guida al servizio di segmentazione

Guida alla valutazione flessibile del pubblico

Ultimo aggiornamento: 28 marzo 2025

Argomenti:

Creato per:

Sviluppatore
Utente

AVAILABILITY

La valutazione flessibile del pubblico è only disponibile nelle istanze di Experience Platform in esecuzione su Microsoft Azure. Per ulteriori informazioni sull'infrastruttura Experience Platform supportata, consulta la Panoramica multi-cloud di Experience Platform.

La valutazione flessibile del pubblico consente di eseguire un processo di segmentazione batch su richiesta. Con una valutazione flessibile del pubblico, puoi eseguire campagne ad hoc, comunicazioni just-in-time o altre attività che richiedono tempo.

Guardrail

Quando esegui una valutazione flessibile del pubblico, tieni presente le seguenti condizioni:

Puoi utilizzare solo la valutazione flessibile del pubblico due al giorno per sandbox. Questo limite viene ripristinato alla mezzanotte (UTC).
Hai un massimo di 50 esecuzioni flessibili di valutazione del pubblico all'anno per sandbox di produzione.
Hai un massimo di 100 esecuzioni flessibili di valutazione del pubblico all'anno per sandbox sviluppo.
Tutti i tipi di pubblico must hanno origine "Servizio di segmentazione".
Tutti i tipi di pubblico devono essere valutati utilizzando la segmentazione batch.
Tutti i tipi di pubblico devono essere basati sulle persone.
Puoi selezionare solo un massimo di 20 tipi di pubblico per ogni esecuzione di valutazione flessibile del pubblico.

NOTE

È possibile acquistare ulteriori esecuzioni di valutazione del pubblico flessibili all’anno. Per ulteriori informazioni, contatta l’Assistenza clienti di Adobe.

Accesso

Per utilizzare la valutazione flessibile del pubblico, è necessario disporre delle seguenti autorizzazioni:

Valuta il segmento in un pubblico nella sezione Profile Management.

Per ulteriori informazioni sul controllo degli accessi basato sui ruoli, leggere la panoramica sul controllo degli accessi.

Esecuzione di una valutazione flessibile del pubblico

Puoi eseguire una valutazione flessibile del pubblico utilizzando le API o l’interfaccia utente di Experience Platform.

API di Experience Platform

Per eseguire una valutazione flessibile del pubblico nelle API di Experience Platform, è necessario creare un processo di segmentazione che contenga gli ID di tutte le definizioni di segmento (pubblico) che desideri valutare.

NOTE

Puoi aggiungere solo un massimo di 20 ID di definizione segmento per chiamata API del processo di segmento.

Per creare un nuovo processo di segmento, devi eseguire una richiesta POST all'endpoint /segment/jobs e includere gli ID delle definizioni dei segmenti nel corpo della richiesta.

Richiesta di esempio per la creazione di un nuovo processo di segmentazione

curl -X POST https://platform.adobe.io/data/core/ups/segment/jobs \
 -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 '[
    {
        "segmentId": "7863c010-e092-41c8-ae5e-9e533186752e"
    },
    {
        "segmentId": "07d39471-05d1-4083-a310-d96978fd7c85"
    }
 ]'

Proprietà

Descrizione

segmentId

ID della definizione del segmento che desideri valutare. Queste definizioni dei segmenti possono appartenere a diversi criteri di unione.

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

Una risposta di esempio durante la creazione di un nuovo processo di segmentazione.

{
    "id": "b31aed3d-b3b1-4613-98c6-7d3846e8d48f",
    "imsOrgId": "{ORG_ID}",
    "sandbox": {
        "sandboxId": "28e74200-e3de-11e9-8f5d-7f27416c5f0d",
        "sandboxName": "prod",
        "type": "production",
        "default": true
    },
    "profileInstanceId": "ups",
    "source": "api",
    "status": "PROCESSING",
    "batchId": "678f53bc-e21d-4c47-a7ec-5ad0064f8e4c",
    "computeJobId": 8811,
    "computeGatewayJobId": "9ea97b25-a0f5-410e-ae87-b2d85e58f399",
    "segments": [
        {
            "segmentId": "7863c010-e092-41c8-ae5e-9e533186752e",
            "segment": {
                "id": "7863c010-e092-41c8-ae5e-9e533186752e",
                "expression": {
                    "type": "PQL",
                    "format": "pql/json",
                    "value": "workAddress.country = \"US\""
                },
                "mergePolicyId": "25c548a0-ca7f-4dcd-81d5-997642f178b9",
                "mergePolicy": {
                    "id": "25c548a0-ca7f-4dcd-81d5-997642f178b9",
                    "version": 1
                }
            }
        },
        {
            "segmentId": "07d39471-05d1-4083-a310-d96978fd7c85",
            "segment": {
                "id": "07d39471-05d1-4083-a310-d96978fd7c85",
                "expression": {
                    "type": "PQL",
                    "format": "pql/json",
                    "value": "workAddress.country = \"US\""
                },
                "mergePolicyId": "25c548a0-ca7f-4dcd-81d5-997642f178b9",
                "mergePolicy": {
                    "id": "25c548a0-ca7f-4dcd-81d5-997642f178b9",
                    "version": 1
                }
            }
        }
    ],
    "metrics": {
        "totalTime": {
            "startTimeInMs": 1573203617195,
            "endTimeInMs": 1573204395655,
            "totalTimeInMs": 778460
        },
        "profileSegmentationTime": {
            "startTimeInMs": 1573204266727,
            "endTimeInMs": 1573204395655,
            "totalTimeInMs": 128928
        },
        "segmentedProfileCounter":{
            "7863c010-e092-41c8-ae5e-9e533186752e":1033
        },
        "segmentedProfileByNamespaceCounter":{
            "7863c010-e092-41c8-ae5e-9e533186752e":{
                "tenantiduserobjid":1033,
                "campaign_profile_mscom_mkt_prod2":1033
            }
        },
        "segmentedProfileByStatusCounter":{
            "7863c010-e092-41c8-ae5e-9e533186752e":{
                "exited":144646,
                "realized":2056
            }
        },
        "totalProfiles":13146432,
        "totalProfilesByMergePolicy":{
            "25c548a0-ca7f-4dcd-81d5-997642f178b9":13146432
        }
    },
    "requestId": "4e538382-dbd8-449e-988a-4ac639ebe72b-1573203600264",
    "schema": {
        "name": "_xdm.context.profile"
    },
    "properties": {
        "scheduleId": "4e538382-dbd8-449e-988a-4ac639ebe72b",
        "runId": "e6c1308d-0d4b-4246-b2eb-43697b50a149"
    },
    "_links": {
        "cancel": {
            "href": "/segment/jobs/b31aed3d-b3b1-4613-98c6-7d3846e8d48f",
            "method": "DELETE"
        },
        "checkStatus": {
            "href": "/segment/jobs/b31aed3d-b3b1-4613-98c6-7d3846e8d48f",
            "method": "GET"
        }
    },
    "updateTime": 1573204395000,
    "creationTime": 1573203600535,
    "updateEpoch": 1573204395
}

Dopo aver creato il processo di segmentazione, puoi controllarne lo stato effettuando una richiesta GET all'endpoint /segment/jobs, fornendo l'ID del nuovo processo di segmentazione creato nel percorso della richiesta.

Richiesta di esempio per recuperare un processo di segmentazione

curl -X GET https://platform.adobe.io/data/core/ups/segment/jobs/b31aed3d-b3b1-4613-98c6-7d3846e8d48f \
 -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}'

In caso di esito positivo, la risposta restituisce lo stato HTTP 200 con informazioni dettagliate sul processo di segmentazione specificato.

Risposta di esempio per recuperare un processo di segmentazione.

{
    "id": "b31aed3d-b3b1-4613-98c6-7d3846e8d48f",
    "imsOrgId": "{ORG_ID}",
    "sandbox": {
        "sandboxId": "28e74200-e3de-11e9-8f5d-7f27416c5f0d",
        "sandboxName": "prod",
        "type": "production",
        "default": true
    },
    "profileInstanceId": "ups",
    "source": "api",
    "status": "SUCCEEDED",
    "batchId": "678f53bc-e21d-4c47-a7ec-5ad0064f8e4c",
    "computeJobId": 8811,
    "computeGatewayJobId": "9ea97b25-a0f5-410e-ae87-b2d85e58f399",
    "segments": [
        {
            "segmentId": "7863c010-e092-41c8-ae5e-9e533186752e",
            "segment": {
                "id": "7863c010-e092-41c8-ae5e-9e533186752e",
                "expression": {
                    "type": "PQL",
                    "format": "pql/text",
                    "value": "workAddress.country = \"US\""
                },
                "mergePolicyId": "25c548a0-ca7f-4dcd-81d5-997642f178b9",
                "mergePolicy": {
                    "id": "25c548a0-ca7f-4dcd-81d5-997642f178b9",
                    "version": 1
                }
            }
        },
        {
            "segmentId": "07d39471-05d1-4083-a310-d96978fd7c85",
            "segment": {
                "id": "07d39471-05d1-4083-a310-d96978fd7c85",
                "expression": {
                    "type": "PQL",
                    "format": "pql/json",
                    "value": "workAddress.country = \"US\""
                },
                "mergePolicyId": "25c548a0-ca7f-4dcd-81d5-997642f178b9",
                "mergePolicy": {
                    "id": "25c548a0-ca7f-4dcd-81d5-997642f178b9",
                    "version": 1
                }
            }
        }
    ],
    "metrics": {
        "totalTime": {
            "startTimeInMs": 1579304313411
        },
        "profileSegmentationTime": {}
    },
    "requestId": "4e538382-dbd8-449e-988a-4ac639ebe72b-1573203600264",
    "schema": {
        "name": "_xdm.context.profile"
    },
    "_links": {
        "cancel": {
            "href": "/segment/jobs/d3b4a50d-dfea-43eb-9fca-557ea53771fd",
            "method": "DELETE"
        },
        "checkStatus": {
            "href": "/segment/jobs/d3b4a50d-dfea-43eb-9fca-557ea53771fd",
            "method": "GET"
        }
    },
    "updateTime": 1579304339000,
    "creationTime": 1579304260897,
    "updateEpoch": 1579304339
}

Interfaccia utente di Experience Platform

Per eseguire una valutazione flessibile del pubblico nell'interfaccia utente di Experience Platform, seleziona Tipi di pubblico nella sezione Clienti.

Il pulsante Tipi di pubblico nella sezione Clienti è evidenziato. Viene visualizzato il Portale pubblico per i profili dei clienti.

Viene visualizzato il Portale dei tipi di pubblico, con un elenco di tutti i tipi di pubblico relativi all’organizzazione. In Audience Portal, puoi scegliere i tipi di pubblico da valutare e selezionare Valuta pubblico.

Sono selezionati i tipi di pubblico per i quali si desidera utilizzare la valutazione flessibile del pubblico.

Viene visualizzato il popover Valuta i tipi di pubblico su richiesta, in cui viene visualizzato l'elenco dei tipi di pubblico che verranno valutati con il processo di segmentazione su richiesta. Se un pubblico non è idoneo per la valutazione su richiesta, verrà rimosso automaticamente dal processo di valutazione. Verifica che i tipi di pubblico elencati siano quelli che desideri valutare.

Vengono visualizzati i tipi di pubblico che possono essere valutati utilizzando la valutazione flessibile.

Dopo aver confermato che sono elencati i tipi di pubblico corretti, puoi procedere con la richiesta e verrà avviata la valutazione flessibile del pubblico. È possibile visualizzare lo stato di questa valutazione del pubblico nella visualizzazione di monitoraggio dei processi di valutazione.

NOTE

Lo stato del processo di segmentazione può essere segnalato come nello stato "In coda" all’interno del dashboard di monitoraggio. Per visualizzare lo stato più aggiornato del processo di segmentazione, effettua una richiesta GET all'endpoint /segment/jobs, fornendo l'ID del processo di segmentazione nel percorso della richiesta. Ulteriori informazioni sull’utilizzo di questo endpoint sono disponibili nella scheda API.

Se esegui una valutazione flessibile del pubblico e vuoi che la valutazione attivi il pubblico in una destinazione, devi assicurarti che la frequenza sia impostata su Dopo la valutazione del segmento. L'esecuzione della valutazione flessibile del pubblico su tipi di pubblico già impostati per essere attivati dopo la valutazione del segmento, attiverà i tipi di pubblico al termine del processo di valutazione flessibile del pubblico, indipendentemente da eventuali processi di attivazione giornalieri precedenti.

Video

Il video seguente illustra come accedere e utilizzare la valutazione flessibile del pubblico in Experience Platform.

video poster

https://video.tv.adobe.com/v/3453648?&captions=ita

Domande frequenti

Nella sezione seguente sono elencate le domande frequenti relative alla valutazione flessibile del pubblico.

Quando posso attivare un pubblico utilizzando una valutazione flessibile del pubblico?

Risposta

Puoi attivare un pubblico utilizzando la valutazione flessibile del pubblico subito dopo la sua creazione.

È possibile eseguire la pianificazione con una valutazione flessibile del pubblico?

Risposta

No, la pianificazione non è disponibile per l’utilizzo con la valutazione flessibile del pubblico.

È necessario eseguire un processo di esportazione aggiuntivo quando si utilizza la valutazione flessibile del pubblico?

Risposta

No, il processo di esportazione viene eseguito automaticamente dopo il completamento del processo di segmento corrispondente.

Quali servizi posso utilizzare per i tipi di pubblico valutati con una valutazione flessibile?

Risposta

Puoi utilizzare i tipi di pubblico in tutti i servizi a valle, comprese le destinazioni e i percorsi Adobe Journey Optimizer.

Quando vengono ripristinati i limiti di valutazione del pubblico flessibile?

Risposta

Il limite giornaliero viene ripristinato alla mezzanotte (UTC). Il limite annuale viene reimpostato nella data dell’anniversario del contratto.

Quali tipi di pubblico sono supportati con la valutazione flessibile del pubblico?

Risposta

Per una valutazione flessibile del pubblico sono supportati solo i tipi di pubblico con l’origine del servizio di segmentazione. Altri tipi di pubblico, come composizioni, caricamento personalizzato o Data Distiller, non sono supportati per una valutazione flessibile del pubblico.

Quali esecuzioni contribuiscono al conteggio flessibile delle esecuzioni di valutazione del pubblico?

Risposta

Versioni di valutazione del pubblico flessibili che sono state create utilizzando l’API o il conteggio dell’interfaccia utente verso il limite massimo. Tuttavia, l'esecuzione del processo di segmentazione batch giornaliera su base notturna non contribuisce a questo limite.

recommendation-more-help