Nello sviluppo di una definizione di segmento, potete utilizzare gli strumenti di stima e anteprima in Adobe Experience Platform per visualizzare le informazioni a livello di riepilogo, in modo da garantire che l'audience prevista sia isolata.
Le anteprime forniscono elenchi impaginati di profili di qualifica per una definizione di segmento, consentendo di confrontare i risultati rispetto alle aspettative.
Le stime forniscono informazioni statistiche su una definizione di segmento, come la dimensione dell'audience proiettata, l'intervallo di confidenza e la deviazione standard dell'errore.
Per accedere a metriche simili correlate ai dati del profilo cliente in tempo reale, ad esempio il numero totale di frammenti di profilo e profili uniti all'interno di spazi dei nomi specifici o dell'archivio dei dati del profilo nel suo insieme, fare riferimento alla guida dell'endpoint profile preview (preview sample status) (guida di anteprima dello stato), parte della guida per gli sviluppatori dell'API del profilo.
Gli endpoint utilizzati in questa guida fanno parte dell'API Adobe Experience Platform Segmentation Service. Prima di continuare, controlla la guida introduttiva per informazioni importanti che devi conoscere per effettuare correttamente le chiamate all'API, comprese le intestazioni richieste e come leggere le chiamate API di esempio.
Quando l’inserimento di record nell’archivio profili aumenta o diminuisce il conteggio totale dei profili di oltre il 5%, viene attivato un processo di campionamento per aggiornare il conteggio. Il modo in cui viene attivato il campionamento dei dati dipende dal metodo di assimilazione:
La dimensione del campione della scansione dipende dal numero complessivo di entità nell'archivio profili. Queste dimensioni di campione sono rappresentate nella seguente tabella:
Entità nell'archivio profili | Dimensione del campione |
---|---|
Meno di 1 milione | Set di dati completo |
Da 1 a 20 milioni | 1 milione |
Oltre 20 milioni | 5% del totale |
Le stime impiegano generalmente dai 10 ai 15 secondi per essere eseguite, a partire da una stima approssimativa e affinando man mano che vengono letti più record.
Potete creare una nuova anteprima effettuando una richiesta di POST all'endpoint /preview
.
Quando viene creato un processo di anteprima, viene creato automaticamente un processo di stima. Questi due processi condividono lo stesso ID.
Formato API
POST /preview
Richiesta
curl -X POST https://platform.adobe.io/data/core/ups/preview \
-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 '
{
"predicateExpression": "xEvent.metrics.commerce.abandons.value > 0",
"predicateType": "pql/text",
"predicateModel": "_xdm.context.profile"
}'
Proprietà | Descrizione |
---|---|
predicateExpression |
Espressione PQL per eseguire una query sui dati. |
predicateType |
Il tipo di predicato per l'espressione della query in predicateExpression . Attualmente, l'unico valore accettato per questa proprietà è pql/text . |
predicateModel |
Nome della classe dello schema Experience Data Model (XDM) su cui si basano i dati del profilo. |
Risposta
Una risposta corretta restituisce lo stato HTTP 201 (Creato) con i dettagli della nuova anteprima creata.
{
"state": "NEW",
"previewQueryId": "e890068b-f5ca-4a8f-a6b5-af87ff0caac3",
"previewQueryStatus": "NEW",
"previewId": "MDphcHAtMzJiZTAzMjgtM2YzMS00YjY0LThkODQtYWNkMGM0ZmJkYWQzOmU4OTAwNjhiLWY1Y2EtNGE4Zi1hNmI1LWFmODdmZjBjYWFjMzow",
"previewExecutionId": 0
}
Proprietà | Descrizione |
---|---|
state |
Stato corrente del processo di anteprima. Quando viene creato inizialmente, lo stato sarà "NEW". Successivamente, sarà in stato "RUNNING" fino al completamento dell'elaborazione, al punto in cui diventa "RESULT_READY" o "FAILED". |
previewId |
L’ID del processo di anteprima, da utilizzare a scopo di ricerca quando si visualizza una stima o un’anteprima, come indicato nella sezione successiva. |
Potete recuperare informazioni dettagliate su una specifica anteprima effettuando una richiesta di GET all'endpoint /preview
e fornendo l'ID di anteprima nel percorso della richiesta.
Formato API
GET /preview/{PREVIEW_ID}
Parametro | Descrizione |
---|---|
{PREVIEW_ID} |
Il valore previewId dell'anteprima che si desidera recuperare. |
Richiesta
curl -X GET https://platform.adobe.io/data/core/ups/preview/MDphcHAtMzJiZTAzMjgtM2YzMS00YjY0LThkODQtYWNkMGM0ZmJkYWQzOmU4OTAwNjhiLWY1Y2EtNGE4Zi1hNmI1LWFmODdmZjBjYWFjMzow \
-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
Una risposta corretta restituisce lo stato HTTP 200 con informazioni dettagliate sull'anteprima specificata.
{
"results": [{
"XID_ADOBE-MARKETING-CLOUD-ID-1": {
"_href": "https://platform.adobe.io/data/core/ups/models/profile/XID_ADOBE-MARKETING-CLOUD-ID-1",
"endCustomerIds": {
"XID_COOKIE_ID_1": {
"_href": "https://platform.adobe.io/data/core/ups/models/profile/XID_COOKIE_ID_1"
},
"XID_PROFILE_ID_1": {
"_href": "https://platform.adobe.io/data/core/ups/models/profile/XID_PROFILE_ID_1"
}
}
}
},
{
"XID_COOKIE-ID-2": {
"_href": "https://platform.adobe.io/data/core/ups/models/profile/XID_COOKIE-ID-2",
"endCustomerIds": {
"XID_COOKIE_ID_2-1": {
"_href": "https://platform.adobe.io/data/core/ups/models/profile/XID_COOKIE_ID_2-1"
},
"XID_PROFILE_ID_2": {
"_href": "https://platform.adobe.io/data/core/ups/models/profile/XID_PROFILE_ID_2"
}
}
},
"XID_ADOBE-MARKETING-CLOUD-ID-3": {
"_href": "https://platform.adobe.io/data/core/ups/models/profile/XID_ADOBE-MARKETING-CLOUD-ID-1000"
}
}],
"state": "RESULT_READY",
"links": {
"_self": "https://platform.adobe.io/data/core/ups/preview?expression=<expr-1>&limit=1000",
"next": "",
"prev": ""
},
"page": {
"offset": 0,
"size": 3
}
}
Dopo aver creato un processo di anteprima, potete utilizzare il relativo percorso previewId
nel percorso di una richiesta di GET all'endpoint /estimate
per visualizzare informazioni statistiche sulla definizione del segmento, incluse le dimensioni del pubblico proiettate, l'intervallo di confidenza e la deviazione standard dell'errore.
Formato API
GET /estimate/{PREVIEW_ID}
Parametro | Descrizione |
---|---|
{PREVIEW_ID} |
Un processo di stima viene attivato solo quando viene creato un processo di anteprima e i due processi condividono lo stesso valore ID a scopo di ricerca. Nello specifico, si tratta del valore previewId restituito al momento della creazione del processo di anteprima. |
Richiesta
La richiesta seguente recupera i risultati di un processo di stima specifico.
curl -X GET https://platform.adobe.io/data/core/ups/estimate/MDoyOjRhNDVlODUzLWFjOTEtNGJiNy1hNDI2LTE1MDkzN2I2YWY1Yzo0Mg \
-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
Una risposta corretta restituisce lo stato HTTP 200 con i dettagli del processo stimato.
{
"estimatedSize": 4275,
"numRowsToRead": 4275,
"estimatedNamespaceDistribution": [
{
"namespaceId": "4",
"profilesMatchedSoFar": 35
},
{
"namespaceId": "6",
"profilesMatchedSoFar": 4275
}
],
"state": "RESULT_READY",
"profilesReadSoFar": 4275,
"standardError": 0,
"error": {
"description": "",
"traceback": ""
},
"profilesMatchedSoFar": 4275,
"totalRows": 4275,
"confidenceInterval": "95%",
"_links": {
"preview": "https://platform.adobe.io/data/core/ups/preview/app-32be0328-3f31-4b64-8d84-acd0c4fbdad3/execution/0?previewQueryId=e890068b-f5ca-4a8f-a6b5-af87ff0caac3"
}
}
Proprietà | Descrizione |
---|---|
estimatedNamespaceDistribution |
Un array di oggetti che mostra il numero di profili all'interno del segmento suddivisi per namespace di identità. Il numero totale di profili per namespace (sommando insieme i valori mostrati per ogni namespace) potrebbe essere superiore alla metrica del conteggio dei profili, perché un profilo potrebbe essere associato a più spazi dei nomi. Ad esempio, se un cliente interagisce con il tuo marchio su più di un canale, a quel singolo cliente saranno associati più spazi dei nomi. |
state |
Stato corrente del processo di anteprima. Lo stato sarà "ESECUZIONE" finché l'elaborazione non viene completata, al punto che diventa "RESULT_READY" o "FAILED". |
_links.preview |
Quando il valore state è "RESULT_READY", questo campo fornisce un URL per visualizzare la stima. |
Dopo aver letto questa guida è necessario avere una migliore comprensione di come lavorare con le anteprime e le stime utilizzando l'API di segmentazione. Per informazioni su come accedere alle metriche correlate ai dati del profilo cliente in tempo reale, ad esempio il numero totale di frammenti di profilo e di profili uniti all'interno di spazi dei nomi specifici o dell'archivio dati del profilo nel suo insieme, visita la guida dell'endpoint Anteprima profilo (/previewsamplestatus
).