Förhandsgranska exempelstatusslutpunkt (förhandsgranskning av profil)
Med Adobe Experience Platform kan ni importera kunddata från flera olika källor för att skapa en robust, enhetlig profil för varje enskild kund. När data hämtas till Platform körs ett exempeljobb för att uppdatera profilantalet och andra datarelaterade mått för kundprofiler i realtid.
Resultaten av det här exempeljobbet kan visas med slutpunkten /previewsamplestatus
, som ingår i kundprofils-API:t i realtid. Den här slutpunkten kan också användas för att lista profildistributioner av både datauppsättningen och identitetsnamnutrymmet, samt för att generera flera rapporter för att få synlighet i kompositionen för organisationens profilarkiv. Den här guiden går igenom de steg som krävs för att visa dessa mått med API-slutpunkten /previewsamplestatus
.
Komma igång
API-slutpunkten som används i den här guiden ingår i Real-Time Customer Profile API. Innan du fortsätter bör du läsa kom igång-guiden för att få länkar till relaterad dokumentation, en guide till hur du läser exempelanropen för API i det här dokumentet och viktig information om vilka huvuden som krävs för att kunna anropa ett Experience Platform -API.
Profilfragment jämfört med sammanslagna profiler
Den här guiden refererar till både profilfragment och sammanfogade profiler. Det är viktigt att förstå skillnaden mellan dessa villkor innan du fortsätter.
Varje enskild kundprofil består av flera profilfragment som har sammanfogats till en enda vy av kunden. Om en kund till exempel interagerar med varumärket i flera kanaler har organisationen troligen flera profilfragment som är kopplade till den enskilda kunden i flera datauppsättningar.
När profilfragment hämtas till Platform sammanfogas de (baserat på en sammanfogningspolicy) för att skapa en enda profil för den kunden. Det totala antalet profilfragment är därför sannolikt alltid högre än det totala antalet sammanfogade profiler, eftersom varje profil består av flera fragment.
Om du vill veta mer om profiler och deras roll i Experience Platform börjar du med att läsa Översikt över kundprofiler i realtid.
Hur exempeljobbet utlöses
När data som har aktiverats för kundprofilen i realtid hämtas till Platform lagras de i profildatalagret. När inmatningen av poster i profilarkivet ökar eller minskar det totala antalet profiler med mer än 5 %, utlöses ett samplingsjobb för att uppdatera antalet. Hur provet utlöses beror på vilken typ av intag som används:
- För direktuppspelningsarbetsflöden görs en timkontroll för att avgöra om tröskelvärdet på 5 % har uppnåtts eller inte. Om den har det utlöses ett exempeljobb automatiskt för att uppdatera antalet.
- Om tröskelvärdet på 5 % ökning eller minskning uppnås, kommer ett jobb att köras för att uppdatera antalet för batchinmatning inom 15 minuter efter att en batch har importerats till profilbutiken. Med hjälp av profil-API:t kan du förhandsgranska det senaste framgångsrika exempeljobbet samt lista profildistributionen per datauppsättning och per identitetsnamnområde.
Profilantal och profiler efter namnområdesmått är också tillgängliga i avsnittet Profiles i användargränssnittet för Experience Platform. Mer information om hur du får åtkomst till profildata via användargränssnittet finns i Profile gränssnittshandboken.
Visa senaste exempelstatus view-last-sample-status
Du kan utföra en GET-förfrågan till /previewsamplestatus
-slutpunkten för att visa information om det senaste slutförda samplingsjobbet som kördes för din organisation. Detta inkluderar det totala antalet profiler i exemplet, liksom antalet profiler eller det totala antalet profiler som din organisation har i Experience Platform.
Profilantalet genereras efter sammanfogning av profilfragment för att skapa en enda profil för varje enskild kund. När profilfragment sammanfogas returnerar de med andra ord antalet "1"-profiler eftersom de alla är relaterade till samma individ.
Profilantalet omfattar även både profiler med attribut (postdata) och profiler som endast innehåller tidsseriedata (händelsedata), t.ex. Adobe Analytics-profiler. Exempeljobbet uppdateras regelbundet när profildata importeras för att ge ett aktuellt totalt antal profiler inom plattformen.
API-format
GET /previewsamplestatus
Begäran
curl -X GET \
https://platform.adobe.io/data/core/ups/previewsamplestatus \
-H 'Authorization: Bearer {ACCESS_TOKEN}' \
-H 'x-api-key: {API_KEY}' \
-H 'x-gw-ims-org-id: {ORG_ID}' \
-H 'x-sandbox-name: {SANDBOX_NAME}' \
Svar
Svaret innehåller information om det senaste slutförda exempeljobbet som kördes för organisationen.
numRowsToRead
och totalRows
lika. Beroende på hur många profiler din organisation har i Experience Platform kan detta vara fallet. Vanligtvis är dessa två tal olika, och numRowsToRead
är det mindre talet eftersom det representerar exemplet som en delmängd av det totala antalet profiler (totalRows
).{
"numRowsToRead": "41003",
"sampleJobRunning": {
"status": true,
"submissionTimestamp": "2020-08-01 17:57:57.0"
},
"cosmosDocCount": "\"300803\"",
"totalFragmentCount": 47429,
"lastSuccessfulBatchTimestamp": "\"null\"",
"streamingDriven": "\"false\"",
"totalRows": "41003",
"lastBatchId": "\"null\"",
"status": "TASK_FINISHED",
"samplingRatio": 1.0,
"mergeStrategy": "timestampOrdered_auto",
"lastSampledTimestamp": "2020-08-01 17:57:57.0"
}
numRowsToRead
sampleJobRunning
true
när ett provjobb pågår. Ger transparens i den fördröjning som uppstår när en gruppfil överförs till när den läggs till i profilarkivet.cosmosDocCount
totalFragmentCount
lastSuccessfulBatchTimestamp
streamingDriven
totalRows
lastBatchId
status
samplingRatio
numRowsToRead
) och det totala antalet sammanfogade profiler (totalRows
), uttryckt i procent i decimalformat.mergeStrategy
lastSampledTimestamp
Visa profildistribution efter datauppsättning
Om du vill visa profildistributionen efter datauppsättning kan du utföra en GET-förfrågan till slutpunkten /previewsamplestatus/report/dataset
.
API-format
GET /previewsamplestatus/report/dataset
GET /previewsamplestatus/report/dataset?{QUERY_PARAMETERS}
date
date=2024-12-31
Begäran
I följande begäran används parametern date
för att returnera den senaste rapporten för det angivna datumet.
curl -X GET \
https://platform.adobe.io/data/core/ups/previewsamplestatus/report/dataset?date=2020-08-01 \
-H 'Authorization: Bearer {ACCESS_TOKEN}' \
-H 'x-api-key: {API_KEY}' \
-H 'x-gw-ims-org-id: {ORG_ID}' \
-H 'x-sandbox-name: {SANDBOX_NAME}' \
Svar
Svaret innehåller en data
-matris som innehåller en lista med datauppsättningsobjekt. Svaret som visas har trunkerats så att tre datauppsättningar visas.
{
"data": [
{
"sampleCount": 12577,
"samplePercentage": 0.306734,
"fullIDsCount": 20988,
"fullIDsPercentage": 0.511865,
"name": "CRM Profiles",
"description": "Profiles from the CRM.",
"value": "5f160106be34361915754b9c",
"streamingIngestionEnabled": "",
"createdUser": "{CREATED_USER}",
"reportTimestamp": "2020-08-01T17:57:58.697",
},
{
"sampleCount": 12938,
"samplePercentage": 0.315538,
"fullIDsCount": 21796,
"fullIDsPercentage": 0.531571,
"name": "AAM Authenticated Profiles",
"description": "This data set contains AAM authenticated profiles.",
"value": "5dc77ec6eed47f18a796ca90",
"streamingIngestionEnabled": "",
"createdUser": "{CREATED_USER}",
"reportTimestamp": "2020-08-01T17:57:58.697"
},
{
"sampleCount": 22725,
"samplePercentage": 0.554228,
"fullIDsCount": 41003,
"fullIDsPercentage": 1.0,
"name": "Loyalty Program Members",
"description": "Members of the loyalty program at all levels.",
"value": "5d0fda92274e55144d4de620",
"streamingIngestionEnabled": "",
"createdUser": "{CREATED_USER}",
"reportTimestamp": "2020-08-01T17:57:58.697"
}
],
"reportTimestamp": "2020-08-01T17:57:58.697"
}
sampleCount
samplePercentage
sampleCount
som en procentandel av det totala antalet sammanfogade profiler i prov (värdet numRowsToRead
som returneras i den senaste exempelstatusen), uttryckt i decimalformat.fullIDsCount
fullIDsPercentage
fullIDsCount
som en procentandel av det totala antalet sammanfogade profiler (värdet totalRows
som returnerades i den senaste exempelstatusen), uttryckt i decimalformat.name
description
value
streamingIngestionEnabled
createdUser
reportTimestamp
date
-parameter angavs under begäran är den returnerade rapporten för det angivna datumet. Om ingen date
-parameter anges returneras den senaste rapporten.Visa profildistribution efter ID-namnområde
Du kan utföra en GET-förfrågan till slutpunkten /previewsamplestatus/report/namespace
för att visa uppdelningen efter identitetsnamnområde för alla sammanfogade profiler i profilarkivet. Detta omfattar både standardidentiteter från Adobe och anpassade identiteter som definieras av organisationen.
Identitetsnamnutrymmen är en viktig komponent i Adobe Experience Platform Identity Service som fungerar som indikatorer för det sammanhang som kunddata hör till. Om du vill veta mer börjar du med att läsa översikten över identitetsnamnområdet.
API-format
GET /previewsamplestatus/report/namespace
GET /previewsamplestatus/report/namespace?{QUERY_PARAMETERS}
date
date=2024-12-31
Begäran
Följande begäran anger ingen date
-parameter och returnerar därför den senaste rapporten.
curl -X GET \
https://platform.adobe.io/data/core/ups/previewsamplestatus/report/namespace \
-H 'Authorization: Bearer {ACCESS_TOKEN}' \
-H 'x-api-key: {API_KEY}' \
-H 'x-gw-ims-org-id: {ORG_ID}' \
-H 'x-sandbox-name: {SANDBOX_NAME}' \
Svar
Svaret innehåller en data
-matris, med enskilda objekt som innehåller informationen för varje namnutrymme. Svaret som visas har trunkerats så att fyra namnutrymmen visas.
{
"data": [
{
"sampleCount": 12148,
"samplePercentage": 0.296271,
"reportTimestamp": "2020-08-01T17:57:58.697",
"fullIDsFragmentCount": 13141,
"fullIDsCount": 12631,
"fullIDsPercentage": 0.308051,
"code": "Email",
"value": "6"
},
{
"sampleCount": 6989,
"samplePercentage": 0.170451,
"reportTimestamp": "2020-08-01T17:57:58.697",
"fullIDsFragmentCount": 7543,
"fullIDsCount": 7042,
"fullIDsPercentage": 0.171744,
"code": "ECID",
"value": "4"
},
{
"sampleCount": 888,
"samplePercentage": 0.021657,
"reportTimestamp": "2020-08-01T17:57:58.697",
"fullIDsFragmentCount": 3801,
"fullIDsCount": 3206,
"fullIDsPercentage": 0.078189,
"code": "AAID",
"value": "10"
},
{
"sampleCount": 21809,
"samplePercentage": 0.531888,
"reportTimestamp": "2020-08-01T17:57:58.697",
"fullIDsFragmentCount": 27023,
"fullIDsCount": 21936,
"fullIDsPercentage": 0.534985,
"code": "Phone",
"value": "7"
}
],
"reportTimestamp": "2020-08-01T17:57:58.697"
}
sampleCount
samplePercentage
sampleCount
som en procentandel av de sammanfogade profilerna (värdet numRowsToRead
som returnerades i den senaste exempelstatusen), uttryckt i decimalformat.reportTimestamp
date
-parameter angavs under begäran är den returnerade rapporten för det angivna datumet. Om ingen date
-parameter anges returneras den senaste rapporten.fullIDsFragmentCount
fullIDsCount
fullIDsPercentage
fullIDsCount
som en procentandel av det totala sammanslagna profilerna (värdet totalRows
som returnerades i den senaste exempelstatusen), uttryckt i decimalformat.code
code
för namnutrymmet. Detta kan du hitta när du arbetar med namnutrymmen med hjälp av Adobe Experience Platform Identity Service API och kallas även Identity symbol i användargränssnittet för Experience Platform. Mer information finns i översikten över identitetsnamnet.value
id
för namnutrymmet. Detta kan du hitta när du arbetar med namnutrymmen med hjälp av identitetstjänstens API.Generera överlappningsrapport för datauppsättning
Rapporten om överlappning av datauppsättningar ger synlighet i kompositionen för organisationens profilbutik genom att visa de datauppsättningar som bidrar mest till den adresserbara målgruppen (sammanslagna profiler). Förutom att ge insikter om era data kan den här rapporten hjälpa er att vidta åtgärder för att optimera licensanvändningen, som att ange förfallodatum för vissa datauppsättningar.
Du kan generera överlappningsrapporten för datauppsättningen genom att utföra en GET-förfrågan till slutpunkten /previewsamplestatus/report/dataset/overlap
.
Stegvisa instruktioner om hur du genererar överlappningsrapporten för datauppsättningar med kommandoraden eller användargränssnittet i Postman finns i generera självstudiekursen om överlappande datauppsättningar.
API-format
GET /previewsamplestatus/report/dataset/overlap
GET /previewsamplestatus/report/dataset/overlap?{QUERY_PARAMETERS}
date
date=2024-12-31
Begäran
I följande begäran används parametern date
för att returnera den senaste rapporten för det angivna datumet.
curl -X GET \
https://platform.adobe.io/data/core/ups/previewsamplestatus/report/dataset/overlap?date=2021-12-29 \
-H 'Authorization: Bearer {ACCESS_TOKEN}' \
-H 'x-api-key: {API_KEY}' \
-H 'x-gw-ims-org-id: {ORG_ID}' \
Svar
En lyckad begäran returnerar HTTP-status 200 (OK) och datasetet överlappar rapporten.
{
"data": {
"5d92921872831c163452edc8,5da7292579975918a851db57,5eb2cdc6fa3f9a18a7592a98": 123,
"5d92921872831c163452edc8,5eb2cdc6fa3f9a18a7592a98": 454412,
"5eeda0032af7bb19162172a7": 107
},
"reportTimestamp": "2021-12-29T19:55:31.147"
}
data
data
innehåller kommaavgränsade listor med datauppsättningar och deras respektive profilantal.reportTimestamp
date
-parameter angavs under begäran är den returnerade rapporten för det angivna datumet. Om ingen date
-parameter anges returneras den senaste rapporten.Tolka överlappningsrapporten för datauppsättningen
Resultatet av rapporten kan tolkas utifrån datauppsättningar och antal profiler i svaret. Titta på följande exempelrapportobjekt data
:
"5d92921872831c163452edc8,5da7292579975918a851db57,5eb2cdc6fa3f9a18a7592a98": 123,
"5d92921872831c163452edc8,5eb2cdc6fa3f9a18a7592a98": 454412,
"5eeda0032af7bb19162172a7": 107
Den här rapporten innehåller följande information:
- Det finns 123 profiler med data från följande datauppsättningar:
5d92921872831c163452edc8
,5da7292579975918a851db57
,5eb2cdc6fa3f9a18a7592a98
. - Det finns 454 412 profiler som består av data från dessa två datauppsättningar:
5d92921872831c163452edc8
och5eb2cdc6fa3f9a18a7592a98
. - Det finns 107 profiler som endast består av data från datauppsättningen
5eeda0032af7bb19162172a7
. - Det finns totalt 454 642 profiler i organisationen.
Generera rapport över namnutrymmesöverlappning identity-overlap-report
Rapporten om överlappning av identitetsnamn ger synlighet i sammansättningen av organisationens profilarkiv genom att visa de identitetsnamnutrymmen som bidrar mest till den adresserbara målgruppen (sammanslagna profiler). Detta omfattar både de vanliga identitetsnamnutrymmena från Adobe och de anpassade identitetsnamnutrymmen som definieras av din organisation.
Du kan generera överlappningsrapporten för identitetsnamnrymden genom att utföra en GET-begäran till slutpunkten /previewsamplestatus/report/namespace/overlap
.
API-format
GET /previewsamplestatus/report/namespace/overlap
GET /previewsamplestatus/report/namespace/overlap?{QUERY_PARAMETERS}
date
date=2024-12-31
Begäran
I följande begäran används parametern date
för att returnera den senaste rapporten för det angivna datumet.
curl -X GET \
https://platform.adobe.io/data/core/ups/previewsamplestatus/report/namespace/overlap?date=2021-12-29 \
-H 'Authorization: Bearer {ACCESS_TOKEN}' \
-H 'x-api-key: {API_KEY}' \
-H 'x-gw-ims-org-id: {ORG_ID}' \
Svar
En lyckad begäran returnerar HTTP-status 200 (OK) och identitetsnamnutrymmets överlappningsrapport.
{
"data": {
"Email,crmid,loyal": 2,
"ECID,Email,crmid": 7,
"ECID,Email,mobilenr": 12,
"AAID,ECID,loyal": 1,
"mobilenr": 25,
"AAID,ECID": 1508,
"ECID,crmid": 1,
"AAID,ECID,crmid": 2,
"Email,crmid": 328,
"CORE": 49,
"AAID": 446,
"crmid,loyal": 20988,
"Email": 10904,
"crmid": 249,
"ECID,Email": 74,
"Phone": 40,
"Email,Phone,loyal": 48,
"AAID,AVID,ECID": 85,
"Email,loyal": 1002,
"AAID,ECID,Email,Phone,crmid": 5,
"AAID,ECID,Email,crmid,loyal": 23,
"AAID,AVID,ECID,Email,crmid": 2,
"AVID": 3,
"AAID,ECID,Phone": 1,
"loyal": 43,
"ECID,Email,crmid,loyal": 6,
"AAID,ECID,Email,Phone,crmid,loyal": 1,
"AAID,ECID,Email": 2,
"AAID,ECID,Email,crmid": 142,
"AVID,ECID": 24,
"ECID": 6565
},
"reportTimestamp": "2021-12-29T16:55:03.624"
}
data
data
innehåller kommaavgränsade listor med unika kombinationer av ID-namnområdeskoder och deras respektive profilantal.code
är ett kort formulär för varje namn på identitetsnamn. En mappning av varje code
till dess name
finns med hjälp av Adobe Experience Platform Identity Service API. code
kallas även Identity symbol i användargränssnittet för Experience Platform. Mer information finns i översikten över identitetsnamnet.reportTimestamp
date
-parameter angavs under begäran är den returnerade rapporten för det angivna datumet. Om ingen date
-parameter anges returneras den senaste rapporten.Tolka rapporten om namnutrymmesöverlappning
Resultatet av rapporten kan tolkas utifrån identiteten och antalet profiler i svaret. Det numeriska värdet för varje rad visar hur många profiler som består av den exakta kombinationen av standard- och anpassade identitetsnamnutrymmen.
Titta på följande utdrag från objektet data
:
"AAID,ECID,Email,crmid": 142,
"AVID,ECID": 24,
"ECID": 6565
Den här rapporten innehåller följande information:
- Det finns 142 profiler som består av
AAID
,ECID
ochEmail
standardidentiteter samt av ett anpassatcrmid
-identitetsnamnutrymme. - Det finns 24 profiler som består av
AAID
ochECID
identitetsnamnutrymmen. - Det finns 6 565 profiler som bara innehåller en
ECID
-identitet.
Generera rapport över profiler som inte sammanställts
Du kan få mer insyn i hur din organisations profilbutik är uppbyggd genom rapporten för icke sammansatta profiler. En "sammanfogad" profil är en profil som bara innehåller ett profilfragment. En okänd profil är en profil som är associerad med pseudonyma identitetsnamnutrymmen som ECID
och AAID
. Okända profiler är inaktiva, vilket innebär att de inte har lagt till nya händelser under den angivna tidsperioden. I rapporten för icke sammansatta profiler finns en beskrivning av profilerna för en period på 7, 30, 60, 90 och 120 dagar.
Du kan generera rapporten för icke sammansatta profiler genom att utföra en GET-förfrågan till slutpunkten /previewsamplestatus/report/unstitchedProfiles
.
API-format
GET /previewsamplestatus/report/unstitchedProfiles
Begäran
Följande begäran returnerar rapporten för profiler utan sammanfogning.
curl -X GET \
https://platform.adobe.io/data/core/ups/previewsamplestatus/report/unstitchedProfiles \
-H 'Authorization: Bearer {ACCESS_TOKEN}' \
-H 'x-api-key: {API_KEY}' \
-H 'x-gw-ims-org-id: {ORG_ID}' \
Svar
En slutförd begäran returnerar HTTP-status 200 (OK) och rapporten för icke-sammansatta profiler.
"120days"
- och 7days
-tidsperioder. Den fullständiga rapporten över icke sammansatta profiler innehåller en beskrivning av profilerna för en period på 7, 30, 60, 90 och 120 dagar.{
"data": {
"totalNumberOfProfiles": 63606,
"totalNumberOfEvents": 130977,
"unstitchedProfiles": {
"120days": {
"countOfProfiles": 1644,
"eventsAssociated": 26824,
"nsDistribution": {
"Email": {
"countOfProfiles": 18,
"eventsAssociated": 95
},
"loyal": {
"countOfProfiles": 26,
"eventsAssociated": 71
},
"ECID": {
"countOfProfiles": 1600,
"eventsAssociated": 26658
}
}
},
"7days": {
"countOfProfiles": 1782,
"eventsAssociated": 29151,
"nsDistribution": {
"Email": {
"countOfProfiles": 19,
"eventsAssociated": 97
},
"ECID": {
"countOfProfiles": 1734,
"eventsAssociated": 28591
},
"loyal": {
"countOfProfiles": 29,
"eventsAssociated": 463
}
}
}
}
},
"reportTimestamp": "2025-08-25T22:14:55.186"
}
data
data
innehåller den information som returnerats för rapporten för icke-sammansatta profiler.totalNumberOfProfiles
totalNumberOfEvents
unstitchedProfiles
countOfProfiles
eventsAssociated
nsDistribution
countOfProfiles
för varje identitetsnamnutrymme i nsDistribution
-objektet blir lika med countOfProfiles
för tidsperioden. Samma sak gäller för eventsAssociated
per namnområde och det totala antalet eventsAssociated
per tidsperiod.reportTimestamp
Tolka rapporten över icke sammansatta profiler
Resultaten av rapporten ger insikt i hur många icke-sammansatta och inaktiva profiler din organisation har i sin profilbutik.
Titta på följande utdrag från objektet data
:
"7days": {
"countOfProfiles": 1782,
"eventsAssociated": 29151,
"nsDistribution": {
"Email": {
"countOfProfiles": 19,
"eventsAssociated": 97
},
"ECID": {
"countOfProfiles": 1734,
"eventsAssociated": 28591
},
"loyal": {
"countOfProfiles": 29,
"eventsAssociated": 463
}
}
}
Den här rapporten innehåller följande information:
- Det finns 1 782 profiler som bara innehåller ett profilfragment och som inte har några nya händelser de senaste sju dagarna.
- Det finns 29 151 ExperienceEvents associerade med de 1 782 icke-sammansatta profilerna.
- Det finns 1 734 osydda profiler som innehåller ett enda profilfragment från ECID-identitetsnamnområdet.
- Det finns 28 591 händelser som är associerade med de 1 734 icke-sammansatta profilerna som innehåller ett enda profilfragment från ECID-identitetsnamnområdet.
Nästa steg
Nu när du vet hur du förhandsgranskar exempeldata i profilarkivet och kör flera rapporter på data kan du även använda uppskattnings- och förhandsgranskningsslutpunkterna i segmenteringstjänstens API för att visa sammanfattningsnivåinformation om segmentdefinitionerna. Denna information hjälper er att isolera den förväntade målgruppen. Mer information om hur du arbetar med förhandsvisningar och uppskattningar med segmenterings-API:t finns i förhandsgransknings- och uppskattningsguiden.