Voorvertoning voorbeeldstatuseindpunt (voorvertoning profiel)
Met Adobe Experience Platform kunt u klantgegevens uit meerdere bronnen invoeren om een robuust, uniform profiel voor elk van uw individuele klanten te maken. Als gegevens in Experience Platform worden ingevoerd, wordt een voorbeeldtaak uitgevoerd om het aantal profielen en andere gegevensgerelateerde gegevens in het realtime-profiel van de klant bij te werken.
De resultaten van deze voorbeeldbaan kunnen worden bekeken gebruikend het /previewsamplestatus eindpunt, deel van Real-Time het Profiel van de Klant API. Dit eindpunt kan ook worden gebruikt om van profieldistributies door zowel dataset als identiteit namespace een lijst te maken, evenals veelvoudige rapporten te produceren om zicht in de samenstelling van de opslag van het Profiel van uw organisatie te bereiken. Deze gids doorloopt de stappen die worden vereist om deze metriek te bekijken gebruikend het /previewsamplestatus API eindpunt.
Aan de slag
Het API eindpunt dat in deze gids wordt gebruikt maakt deel uit van Real-Time Customer Profile API . Alvorens verder te gaan, te herzien gelieve begonnen gids voor verbindingen aan verwante documentatie, een gids aan het lezen van de steekproefAPI vraag in dit document, en belangrijke informatie betreffende vereiste kopballen die nodig zijn om vraag aan om het even welke Experience Platform API met succes te maken.
Profielfragmenten versus samengevoegde profielen
Deze handleiding verwijst naar zowel "profielfragmenten" als "samengevoegde profielen". Het is belangrijk dat u het verschil tussen deze termen begrijpt voordat u verdergaat.
Elk individueel klantprofiel bestaat uit meerdere profielfragmenten die zijn samengevoegd tot één weergave van die klant. Bijvoorbeeld, als een klant met uw merk over verscheidene kanalen in wisselwerking staat, heeft uw organisatie waarschijnlijk veelvoudige profielfragmenten met betrekking tot die enige klant die in veelvoudige datasets verschijnt.
Wanneer profielfragmenten in Experience Platform worden opgenomen, worden ze samengevoegd (op basis van een samenvoegbeleid) om één profiel voor die klant te maken. Daarom is het totale aantal profielfragmenten waarschijnlijk altijd hoger dan het totale aantal samengevoegde profielen, aangezien elk profiel uit veelvoudige fragmenten bestaat.
Meer over profielen en hun rol binnen Experience Platform leren, gelieve te beginnen door het overzicht van het Profiel van de Klant in real time te lezen.
Hoe de voorbeeldtaak wordt geactiveerd
Aangezien gegevens die voor het Profiel van de Klant in real time worden toegelaten in Experience Platform worden opgenomen, wordt het opgeslagen binnen de gegevensopslag van het Profiel. Wanneer de opname van records in het archief Profiel het totale aantal profielen met meer dan 3% verhoogt of verlaagt, wordt een samplingtaak geactiveerd om het aantal bij te werken. De wijze waarop het monster wordt geactiveerd, hangt af van het type inname dat wordt gebruikt:
- Voor het stromen gegevenswerkschema's, wordt een controle gedaan op een uurbasis om te bepalen als de 3% toename of dalingsdrempel is voldaan aan. Als dit het geval is, wordt er automatisch een voorbeeldtaak geactiveerd om de telling bij te werken.
- Voor partijingestie, binnen 15 minuten van met succes het opnemen van een partij in de opslag van het Profiel, als de 3% verhoging of dalingsdrempel wordt ontmoet, wordt een baan in werking gesteld om de telling bij te werken. Met behulp van de profiel-API kunt u een voorvertoning weergeven van de meest recente voorbeeldtaak en de distributie van het lijstprofiel via gegevensset en naamruimte op naam.
Het aantal profielen en de profielen op basis van naamruimtewaarden zijn ook beschikbaar in de sectie Profiles van de gebruikersinterface van Experience Platform. Voor informatie over hoe te om tot de gegevens van het Profiel toegang te hebben gebruikend UI, gelieve de Profile gids UI te bezoeken.
Laatste voorbeeldstatus weergeven view-last-sample-status
U kunt de details voor de laatste succesvolle steekproefbaan bekijken die voor uw organisatie door een verzoek van GET aan het /previewsamplestatus eindpunt werd in werking gesteld. Dit rapport bevat het totale aantal profielen in het voorbeeld, evenals het aantal profielen of het totale aantal profielen dat uw organisatie in Experience Platform heeft.
Het aantal profielen wordt gegenereerd na het samenvoegen van profielfragmenten om één profiel voor elke afzonderlijke klant te vormen. Met andere woorden, wanneer profielfragmenten samen worden samengevoegd, wordt een getal van "1"-profiel geretourneerd omdat ze allemaal verwant zijn aan hetzelfde individu.
Het aantal profielen omvat ook zowel profielen met kenmerken (recordgegevens) als profielen die alleen tijdreeksgegevens (gebeurtenisgegevens) bevatten, zoals Adobe Analytics-profielen. De voorbeeldtaak wordt regelmatig vernieuwd terwijl profielgegevens worden ingevoerd om een up-to-date totaal aantal profielen in Experience Platform te bieden.
API formaat
GET /previewsamplestatus
Verzoek
| code language-shell |
|---|
|
Reactie
Een succesvolle reactie keert status 200 van HTTP terug en omvat de details voor de laatste succesvolle steekproefbaan die voor de organisatie in werking werd gesteld.
| note note |
|---|
| NOTE |
In dit voorbeeld zijn numRowsToRead en totalRows gelijk aan elkaar. Afhankelijk van het aantal profielen dat uw organisatie in Experience Platform heeft, kan dit het geval zijn. Over het algemeen verschillen deze twee getallen echter, waarbij numRowsToRead het laagste getal is omdat het de steekproef vertegenwoordigt als een subset van het totale aantal profielen (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 | |
|---|---|
| Eigenschap | Beschrijving |
numRowsToRead |
Het totale aantal samengevoegde profielen in de steekproef. |
sampleJobRunning |
Een Booleaanse waarde die true retourneert wanneer een voorbeeldtaak wordt uitgevoerd. Hiermee krijgt u transparantie in de latentie die optreedt wanneer een batchbestand wordt geüpload naar het moment dat het daadwerkelijk wordt toegevoegd aan de profielopslag. |
docCount |
Totaal aantal documenten in database. |
totalFragmentCount |
Het totale aantal profielfragmenten in het archief met profielen. |
lastSuccessfulBatchTimestamp |
Tijdstempel voor laatste succes bij het invoeren van batch. |
streamingDriven |
Dit gebied is afgekeurd en bevat geen betekenis aan de reactie. |
totalRows |
Het totale aantal samengevoegde profielen in Experience Platform, ook bekend als het aantal profielen. |
lastBatchId |
Laatste batch-inname-id. |
status |
Status van laatste sample. |
samplingRatio |
Verhouding van samengevoegde profielen (numRowsToRead) tot het totaal van samengevoegde profielen (totalRows), uitgedrukt als een percentage in decimale notatie. |
mergeStrategy |
Samenvoegingsstrategie gebruikt in de steekproef. |
lastSampledTimestamp |
Laatste succesvolle voorbeeld van tijdstempel. |
Profieldistributie per gegevensset weergeven
U kunt de verdeling van profielen door dataset zien door een GET- verzoek aan het /previewsamplestatus/report/dataset eindpunt te doen.
API formaat
GET /previewsamplestatus/report/dataset
GET /previewsamplestatus/report/dataset?{QUERY_PARAMETERS}
datedate=2024-12-31Verzoek
In het volgende verzoek wordt de parameter date gebruikt om het meest recente rapport voor de opgegeven datum te retourneren.
| code language-shell |
|---|
|
Reactie
Een geslaagde reactie retourneert HTTP-status 200 en bevat een data -array die een lijst met gegevenssetobjecten bevat.
| note note |
|---|
| NOTE |
| De volgende getoonde reactie is beknot om drie datasets te tonen. |
| 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 | |
|---|---|
| Eigenschap | Beschrijving |
sampleCount |
Het totale aantal gesamplede profielen met deze gegevensset-id. |
samplePercentage |
sampleCount als percentage van het totale aantal gesamplede profielen (de numRowsToRead waarde zoals teruggekeerd in de laatste steekproefstatus ), die in decimaal formaat wordt uitgedrukt. |
fullIDsCount |
Het totale aantal samengevoegde profielen met deze dataset-id. |
fullIDsPercentage |
fullIDsCount als percentage van het totale aantal samengevoegde profielen (de totalRows waarde zoals teruggekeerd in de laatste steekproefstatus ), die in decimaal formaat wordt uitgedrukt. |
name |
De naam van de dataset, zoals die tijdens de verwezenlijking van dataset wordt verstrekt. |
description |
De beschrijving van de dataset, zoals die tijdens de verwezenlijking van dataset wordt verstrekt. |
value |
De id van de gegevensset. |
streamingIngestionEnabled |
Of de dataset voor het stromen opname wordt toegelaten. |
createdUser |
De gebruikers-id van de gebruiker die de gegevensset heeft gemaakt. |
reportTimestamp |
De tijdstempel van het rapport. Als een parameter date tijdens het verzoek werd verstrekt, is het teruggekeerde rapport voor de verstrekte datum. Als er geen parameter date is opgegeven, wordt het meest recente rapport geretourneerd. |
Profieldistributie weergeven op naamruimte van identiteit
U kunt een GET-aanvraag naar het eindpunt van /previewsamplestatus/report/namespace uitvoeren om de uitsplitsing naar naamruimte van de identiteit weer te geven voor alle samengevoegde profielen in het archief Profiel. Dit geldt zowel voor de standaardidentiteiten die door Adobe worden geleverd als voor de aangepaste identiteiten die door uw organisatie zijn gedefinieerd.
Identiteitsnaamruimten zijn een belangrijk onderdeel van de Adobe Experience Platform Identity Service dat als indicatoren dient voor de context waarop de klantgegevens betrekking hebben. Om meer te leren, begin door het overzicht van identiteitskaart te lezen namespace .
API formaat
GET /previewsamplestatus/report/namespace
GET /previewsamplestatus/report/namespace?{QUERY_PARAMETERS}
dateYYYY-MM-DD.date=2025-6-20Verzoek
In het volgende verzoek wordt geen parameter date opgegeven en wordt het meest recente rapport geretourneerd.
| code language-shell |
|---|
|
Reactie
Een succesvol antwoord retourneert HTTP-status 200 en bevat een data -array, met afzonderlijke objecten die de details voor elke naamruimte bevatten. De getoonde reactie is afgebroken om vier naamruimten te tonen.
| 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 | |
|---|---|
| Eigenschap | Beschrijving |
sampleCount |
Het totale aantal gesamplede profielen in de naamruimte. |
samplePercentage |
sampleCount als percentage gesamplede profielen (de numRowsToRead waarde zoals teruggekeerd in de laatste steekproefstatus ), die in decimaal formaat wordt uitgedrukt. |
reportTimestamp |
De tijdstempel van het rapport. Als een parameter date tijdens het verzoek werd verstrekt, is het teruggekeerde rapport voor de verstrekte datum. Als er geen parameter date is opgegeven, wordt het meest recente rapport geretourneerd. |
fullIDsFragmentCount |
Het totale aantal profielfragmenten in de naamruimte. |
fullIDsCount |
Het totale aantal samengevoegde profielen in de naamruimte. |
fullIDsPercentage |
fullIDsCount als percentage van totaal samengevoegde profielen (de totalRows waarde zoals teruggekeerd in de laatste steekproefstatus ), die in decimaal formaat wordt uitgedrukt. |
code |
De code voor de naamruimte. Dit kan worden gevonden wanneer het werken met namespaces gebruikend de Dienst API van de Identiteit van Adobe Experience Platform en ook bedoeld als Identity symbol in Experience Platform UI. Om meer te leren, bezoek het overzicht van identiteitskaart namespace . |
value |
De id -waarde voor de naamruimte. Dit kan worden gevonden wanneer het werken met namespaces gebruikend de Dienst API van de Identiteit . |
Een lijst maken van de gegevenssetstatistieken dataset-stats
U kunt een rapport produceren dat statistieken over de dataset door een GET- verzoek aan het /previewsamplestatus/report/dataset_stats eindpunt te doen geeft.
API formaat
GET /previewsamplestatus/report/dataset_stats
Verzoek
| code language-shell |
|---|
|
Reactie
Een succesvolle reactie keert status 200 van HTTP met informatie over de statistieken van de dataset terug.
| note note |
|---|
| NOTE |
| De volgende reactie is beknot om drie datasets te tonen. |
| 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 | |
|---|---|
| Eigenschap | Beschrijving |
120days |
Het aantal verslagen die in de dataset na een gegevensvervaldatum van 120 dagen zullen blijven. |
14days |
Het aantal verslagen die in de dataset na een gegevensvervaldatum van 14 dagen zullen blijven. |
30days |
Het aantal verslagen die in de dataset na een gegevensvervaldatum van 30 dagen zullen blijven. |
365days |
Het aantal verslagen die in de dataset na een gegevensvervaldatum van 365 dagen zullen blijven. |
60days |
Het aantal verslagen die in de dataset na een gegevensvervaldatum van 60 dagen zullen blijven. |
7days |
Het aantal verslagen die in de dataset na een gegevensvervaldatum van 7 dagen zullen blijven. |
90days |
Het aantal verslagen die in de dataset na een gegevensvervaldatum van 90 dagen zullen blijven. |
datasetId |
De id van de gegevensset. |
datasetType |
Het gegevenstype van de dataset. Deze waarde kan Profiles of ExperienceEvents zijn. |
percentEvents |
Het percentage van de verslagen van de Gebeurtenissen van de Ervaring die binnen de dataset zijn. |
percentProfiles |
Het percentage van de verslagen van het Profiel die binnen de dataset zijn. |
profileFragments |
Het totale aantal profielfragmenten dat in de dataset bestaat. |
records |
Het totale aantal profielverslagen die in de dataset worden opgenomen. |
totalProfiles |
Het totale aantal profielen dat in de gegevensset wordt opgenomen. |
Hiermee wordt de grootte van de gegevensset opgehaald character-count
U kunt dit eindpunt gebruiken om de grootte van de dataset in bytes op een week-door-week basis te krijgen.
API formaat
GET /previewsamplestatus/report/character_count
Verzoek
| code language-shell |
|---|
|
Reactie
Een succesvolle reactie keert status 200 van HTTP met informatie over de grootte van de dataset door de weken terug.
| note note |
|---|
| NOTE |
| De volgende reactie is beknot om drie datasets te tonen. |
| code language-json |
|---|
|
| table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2 5-row-2 | |
|---|---|
| Eigenschap | Beschrijving |
datasetId |
De id van de gegevensset. |
recordType |
Het type gegevens binnen de dataset. Het recordtype beïnvloedt de waarde van de weeks variabele. Tot de ondersteunde waarden behoren keyvalue en timeseries . |
weeks |
Een serie die de grootteinformatie over de dataset bevat. Voor datasets van recordtype keyvalue, bevat dit de meest recente week evenals de totale grootte van de dataset in bytes. Voor datasets van recordtype timeseries, bevat dit elke week van de opname van de dataset aan de meest recente week en de totale grootte van de dataset in bytes voor elk van die weken. |
modelName |
De naam van het model voor de dataset. Mogelijke waarden zijn _xdm.context.profile en _xdm.context.experienceevent . |
reportTimestamp |
De datum en tijd waarop het rapport is gegenereerd. |
Volgende stappen
Nu u weet hoe te om steekproefgegevens in de opslag van het Profiel voor te vertonen en veelvoudige rapporten over de gegevens in werking te stellen, kunt u de schatting en voorproefpunten van de Dienst API van de Segmentatie ook gebruiken om summiere-vlakke informatie betreffende uw segmentdefinities te bekijken. Deze informatie helpt u ervoor te zorgen dat u uw verwachte publiek isoleert. Om meer over het werken met voorproeven en ramingen te leren die de Segmentatie API gebruiken, gelieve de voorproef en de gids van de schattingseindpunten te bezoeken.