Generera överlappningsrapport för datauppsättning
Datamängdsöverlappningsrapporten ger synlighet i kompositionen för din organisations Profile-butik genom att visa de datauppsättningar som bidrar mest till den adresserbara målgruppen (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 er licensanvändning, som att sätta en gräns för vissa data.
I den här självstudien beskrivs de steg som krävs för att generera överlappningsrapporten för datauppsättningen med API:t Real-Time Customer Profile och tolka resultatet för din organisation.
Komma igång
Om du vill använda Adobe Experience Platform API:er måste du först slutföra autentiseringssjälvstudiekursen för att samla in de värden du behöver för de önskade rubrikerna. Mer information om Experience Platform API:er finns i kom igång med API:er för plattformar.
Nödvändiga rubriker för alla API-anrop i den här självstudien är:
Authorization: Bearer {ACCESS_TOKEN}
: RubrikenAuthorization
kräver en åtkomsttoken som föregås av ordetBearer
. Ett nytt åtkomsttokenvärde måste genereras var 24:e timme.x-api-key: {API_KEY}
:API Key
kallas ävenClient ID
och är ett värde som bara behöver genereras en gång.x-gw-ims-org-id: {ORG_ID}
: Organisations-ID:t behöver bara genereras en gång.
När du har slutfört självstudiekursen för autentisering och samlat in värden för de huvuden som behövs kan du börja ringa anrop till Real-Time Customer API.
Generera överlappningsrapport för datauppsättning med kommandoraden
Om du är van vid att använda kommandoraden kan du använda följande cURL-begäran för att generera överlappningsrapporten för datauppsättningen genom att utföra en GET-begäran till /previewsamplestatus/report/dataset/overlap
.
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-04-19 \
-H 'Authorization: Bearer {ACCESS_TOKEN}' \
-H 'x-api-key: {API_KEY}' \
-H 'x-gw-ims-org-id: {ORG_ID}' \
date
date=2024-12-31
Svar
En lyckad begäran returnerar HTTP-status 200 (OK) och datasetet överlappar rapporten. Rapporten innehåller ett data
-objekt som innehåller kommaavgränsade listor med datauppsättningar och deras respektive profilantal. Mer information om hur du läser rapporten finns i avsnittet Tolka datamängden överlappar rapportdata senare i den här självstudien.
{
"data": {
"5d92921872831c163452edc8,5da7292579975918a851db57,5eb2cdc6fa3f9a18a7592a98": 123,
"5d92921872831c163452edc8,5eb2cdc6fa3f9a18a7592a98": 454412,
"5eeda0032af7bb19162172a7": 107
},
"reportTimestamp": "2021-04-19T19:55:31.147"
}
Generera överlappningsrapport för datauppsättning med Postman
Postman är en samarbetsplattform för API-utveckling och är användbart för att visualisera API-anrop. Den kan laddas ned kostnadsfritt från Postman-webbplatsen och erbjuder ett användargränssnitt som är enkelt att använda för att utföra API-anrop. Följande skärmbilder använder Postman gränssnitt.
Begäran
Om du vill begära en överlappande datauppsättningsrapport med Postman utför du följande steg:
-
Använd listrutan och välj GET som begärandetyp.
-
Ange de obligatoriska rubrikerna i kolumnen
KEY
:Authorization
x-api-key
x-gw-ims-org-id
-
Ange de värden som du genererade under autentiseringen i kolumnen
VALUE
och ersätt klammerparenteserna ({{ }}
) och allt innehåll inom klammerparenteserna. -
Ange sökvägen till begäran med eller utan den valfria parametern
date
:https://platform.adobe.io/data/core/ups/previewsamplestatus/report/dataset/overlap
ellerhttps://platform.adobe.io/data/core/ups/previewsamplestatus/report/dataset/overlap?date=YYYY-MM-DD
date
Format: ÅÅÅ-MM-DD. Exempel:
date=2024-12-31
När begärandetypen, rubrikerna, värdena och sökvägen är klara väljer du Skicka för att skicka API-begäran och generera rapporten.
Svar
En lyckad begäran returnerar HTTP-status 200 (OK) och datasetet överlappar rapporten. Rapporten innehåller ett data
-objekt som innehåller kommaavgränsade listor med datauppsättningar och deras respektive profilantal. Mer information om hur du läser rapporten finns i avsnittet om att tolka rapportdata som överlappar datamängder.
Tolka rapportdata som överlappar datamängden interpret-the-report
Den genererade överlappningsrapporten för datauppsättningar innehåller en tidsstämpel som visar rapportens datum och tid och ett dataobjekt som innehåller unika kombinationer av datauppsättnings-ID:n som kommaseparerade listor. I följande avsnitt finns ytterligare information om rapportens komponenter.
Rapporttidsstämpel
reportTimestamp
matchar datumet som anges i API-begäran, eller om inget datum angavs, tidsstämpeln för den senaste rapporten.
Lista över datauppsättnings-ID:n
Objektet data
innehåller unika kombinationer av datauppsättnings-ID:n som kommaavgränsade listor med respektive profilantal för den kombinationen av datauppsättningar.
Ta följande exempel för att tolka rapportens resultat:
"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.
Nästa steg
När du är klar med den här självstudiekursen kan du nu generera en överlappande datauppsättningsrapport med hjälp av kundprofils-API:t i realtid. Om du vill veta mer om hur du arbetar med profildata i både API:t och användargränssnittet i Experience Platform börjar du med att läsa översiktsdokumentationen för profilen.