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}: Rubriken Authorization kräver en åtkomsttoken som föregås av ordet Bearer. Ett nytt åtkomsttokenvärde måste genereras var 24:e timme.
  • x-api-key: {API_KEY}: API Key kallas även Client 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}' \
Parameter
Beskrivning
date
Ange datumet för rapporten som ska returneras. Om flera rapporter kördes på datumet returneras den senaste rapporten för det datumet. Om det inte finns någon rapport för det angivna datumet returneras ett HTTP-statusfel 404 (Hittades inte). Om inget datum anges returneras den senaste rapporten. Format: ÅÅÅ-MM-DD. Exempel: 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
    eller
    https://platform.adobe.io/data/core/ups/previewsamplestatus/report/dataset/overlap?date=YYYY-MM-DD

Parameter
Beskrivning
date
Ange datumet för rapporten som ska returneras. Om flera rapporter kördes på datumet returneras den senaste rapporten för det datumet. Om det inte finns någon rapport för det angivna datumet returneras ett HTTP-statusfel 404 (Hittades inte). Om inget datum anges returneras den senaste rapporten.
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.

NOTE
Summan av alla profilantal som är associerade med varje rad i dataset överlappningsrapport ska vara lika med det totala antalet profiler i organisationen.

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 och 5eb2cdc6fa3f9a18a7592a98.
  • 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.

recommendation-more-help
54550d5b-f1a1-4065-a394-eb0f23a2c38b