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 Experience 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 importeras till Experience 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 Experience Platform lagras de i profildatalagret. När inmatningen av poster i profilarkivet ökar eller minskar det totala antalet profiler med mer än 3 %, 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å 3 % har uppnåtts eller inte. Om den har det utlöses ett exempeljobb automatiskt för att uppdatera antalet.
- Om tröskelvärdet på 3 % ökning eller minskning är uppfyllt, körs ett jobb 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 Experience Platform-gränssnittet. 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 visa information om det senaste slutförda exempeljobbet som kördes för din organisation genom att göra en GET-begäran till slutpunkten /previewsamplestatus. Den här rapporten innehåller det totala antalet profiler i exemplet, liksom antalet profiler, eller det totala antalet profiler som din organisation har inom 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 Experience Platform.
API-format
GET /previewsamplestatus
Begäran
| code language-shell |
|---|
|
Svar
Ett lyckat svar returnerar HTTP-status 200 och innehåller information om det senaste slutförda samplingsjobbet som kördes för organisationen.
| note note |
|---|
| NOTE |
I det här exempelsvaret är 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). |
| code language-json |
|---|
|
| 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 12-row-2 | |
|---|---|
| Egenskap | Beskrivning |
numRowsToRead |
Det totala antalet sammanfogade profiler i exemplet. |
sampleJobRunning |
Ett booleskt värde som returnerar 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. |
docCount |
Totalt antal dokument i databasen. |
totalFragmentCount |
Totalt antal profilfragment i profilarkivet. |
lastSuccessfulBatchTimestamp |
Senaste lyckade tidsstämpel för batchimport. |
streamingDriven |
Det här fältet har tagits bort och innehåller ingen betydelse för svaret. |
totalRows |
Totalt antal sammanfogade profiler i Experience Platform, även kallat profilantal. |
lastBatchId |
ID för senaste batchförbrukning. |
status |
Status för senaste prov. |
samplingRatio |
Förhållandet mellan de sammanfogade profiler som du har tagit prov på (numRowsToRead) och det totala antalet sammanfogade profiler (totalRows), uttryckt i procent i decimalformat. |
mergeStrategy |
Sammanfogningsstrategi som används i exemplet. |
lastSampledTimestamp |
Senaste lyckade exempeltidsstämpel. |
Visa profildistribution efter datauppsättning
Du kan se hur profiler distribueras per datauppsättning genom att göra en GET-begäran till slutpunkten /previewsamplestatus/report/dataset.
API-format
GET /previewsamplestatus/report/dataset
GET /previewsamplestatus/report/dataset?{QUERY_PARAMETERS}
datedate=2024-12-31Begäran
I följande begäran används parametern date för att returnera den senaste rapporten för det angivna datumet.
| code language-shell |
|---|
|
Svar
Ett lyckat svar returnerar HTTP-status 200 och innehåller en data-array som innehåller en lista med datauppsättningsobjekt.
| note note |
|---|
| NOTE |
| Följande svar har trunkerats så att tre datauppsättningar visas. |
| code language-json |
|---|
|
| 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 | |
|---|---|
| Egenskap | Beskrivning |
sampleCount |
Det totala antalet sammanfogade profiler i prov med detta datauppsättnings-ID. |
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 |
Det totala antalet sammanfogade profiler med det här datauppsättnings-ID:t. |
fullIDsPercentage |
fullIDsCount som en procentandel av det totala antalet sammanfogade profiler (värdet totalRows som returnerades i den senaste exempelstatusen), uttryckt i decimalformat. |
name |
Namnet på datauppsättningen, som angavs när datauppsättningen skapades. |
description |
Beskrivningen av datauppsättningen, som den angavs när datauppsättningen skapades. |
value |
Datauppsättningens ID. |
streamingIngestionEnabled |
Anger om datauppsättningen är aktiverad för direktuppspelningsinmatning. |
createdUser |
Användar-ID för den användare som skapade datauppsättningen. |
reportTimestamp |
Rapportens tidsstämpel. Om en 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-begäran till slutpunkten /previewsamplestatus/report/namespace om du vill visa uppdelningen efter identitetsnamnområde för alla sammanfogade profiler i din profilbutik. Detta omfattar både de standardidentiteter som tillhandahålls av Adobe och de anpassade identiteter som definieras av din organisation.
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}
dateYYYY-MM-DD.date=2025-6-20Begäran
Följande begäran anger ingen date-parameter och returnerar den senaste rapporten.
| code language-shell |
|---|
|
Svar
Ett lyckat svar returnerar HTTP-status 200 och innehåller en data-array, där individuella objekt innehåller information för varje namnområde. Svaret som visas har trunkerats så att fyra namnutrymmen visas.
| code language-json |
|---|
|
| 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 | |
|---|---|
| Egenskap | Beskrivning |
sampleCount |
Det totala antalet samkörda profiler i namnutrymmet. |
samplePercentage |
sampleCount som en procentandel av de sammanfogade profilerna (värdet numRowsToRead som returnerades i den senaste exempelstatusen), uttryckt i decimalformat. |
reportTimestamp |
Rapportens tidsstämpel. Om en 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 |
Det totala antalet profilfragment i namnutrymmet. |
fullIDsCount |
Det totala antalet sammanfogade profiler i namnutrymmet. |
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 Experience Platform-gränssnittet. Mer information finns i översikten över identitetsnamnet. |
value |
Värdet id för namnutrymmet. Detta kan du hitta när du arbetar med namnutrymmen med hjälp av identitetstjänstens API. |
Lista datauppsättningsstatistik dataset-stats
Du kan generera en rapport som ger statistik om datauppsättningen genom att göra en GET-begäran till slutpunkten /previewsamplestatus/report/dataset_stats.
API-format
GET /previewsamplestatus/report/dataset_stats
Begäran
| code language-shell |
|---|
|
Svar
Ett lyckat svar returnerar HTTP-status 200 med information om datauppsättningens statistik.
| note note |
|---|
| NOTE |
| Följande svar har trunkerats så att tre datauppsättningar visas. |
| code language-json |
|---|
|
| 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 12-row-2 13-row-2 14-row-2 | |
|---|---|
| Egenskap | Beskrivning |
120days |
Antalet poster som kommer att finnas kvar i datauppsättningen efter att data har upphört att gälla i 120 dagar. |
14days |
Antalet poster som kommer att finnas kvar i datauppsättningen efter att data har gått ut i 14 dagar. |
30days |
Antalet poster som kommer att finnas kvar i datauppsättningen efter att data har upphört att gälla i 30 dagar. |
365days |
Antalet poster som kommer att finnas kvar i datauppsättningen efter att data har upphört att gälla i 365 dagar. |
60days |
Antalet poster som kommer att finnas kvar i datauppsättningen efter att data har upphört att gälla i 60 dagar. |
7days |
Antalet poster som kommer att finnas kvar i datauppsättningen efter en dataförfallotid på 7 dagar. |
90days |
Antalet poster som kommer att finnas kvar i datauppsättningen efter att data har upphört att gälla i 90 dagar. |
datasetId |
Datauppsättningens ID. |
datasetType |
Datamängdstypen. Värdet kan vara antingen Profiles eller ExperienceEvents. |
percentEvents |
Procentandel av Experience Events-poster som finns i datauppsättningen. |
percentProfiles |
Profilposter i procent som finns i datauppsättningen. |
profileFragments |
Det totala antalet profilfragment som finns i datauppsättningen. |
records |
Det totala antalet profilposter som har importerats till datauppsättningen. |
totalProfiles |
Det totala antalet profiler som har importerats till datauppsättningen. |
Hämta datauppsättningsstorlek character-count
Du kan använda den här slutpunkten för att hämta datauppsättningens storlek i byte vecka för vecka.
API-format
GET /previewsamplestatus/report/character_count
Begäran
| code language-shell |
|---|
|
Svar
Ett lyckat svar returnerar HTTP-status 200 med information om datauppsättningens storlek under veckorna.
| note note |
|---|
| NOTE |
| Följande svar har trunkerats så att tre datauppsättningar visas. |
| code language-json |
|---|
|
| table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2 5-row-2 | |
|---|---|
| Egenskap | Beskrivning |
datasetId |
Datauppsättningens ID. |
recordType |
Datatypen i datauppsättningen. Posttypen påverkar värdet för variabeln weeks. Värden som stöds är keyvalue och timeseries. |
weeks |
En array som innehåller storleksinformation om datauppsättningen. För datauppsättningar av posttyp keyvalue innehåller detta den senaste veckan samt den totala storleken på datauppsättningen i byte. För datauppsättningar av posttyp timeseries innehåller detta varje vecka från datauppsättningens inmatning till den senaste veckan och den totala storleken på datauppsättningen i byte för varje vecka. |
modelName |
Namnet på datauppsättningens modell. Möjliga värden är _xdm.context.profile och _xdm.context.experienceevent. |
reportTimestamp |
Datum och tid då rapporten skapades. |
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.