Genereer het overlappingsrapport voor de gegevensset

Het rapport van de overlapping van datasets verstrekt zicht in de samenstelling van de Profile opslag van uw organisatie door de datasets bloot te stellen die het meest aan uw adresseerbare publiek (profielen) bijdragen.

Dit rapport biedt niet alleen inzichten in uw gegevens, maar kan u ook helpen bij het nemen van acties om uw licentiegebruik te optimaliseren, zoals het instellen van een limiet voor de levensduur van bepaalde gegevens.

In deze zelfstudie worden de stappen beschreven die nodig zijn om het rapport voor de overlapping van gegevenssets te genereren met de API Real-Time Customer Profile en de resultaten voor uw organisatie te interpreteren.

Aan de slag

Om Adobe Experience Platform APIs te gebruiken, moet u het authentificatieleerprogrammaeerst voltooien om de waarden te verzamelen die u voor de vereiste kopballen nodig hebt. Meer over Experience Platform APIs leren, gelieve te verwijzen naar begonnen wordt met de documentatie van Platform APIs.

De vereiste kopballen voor alle API vraag in dit leerprogramma zijn:

  • Authorization: Bearer {ACCESS_TOKEN}: Voor de Authorization -header is een toegangstoken vereist, voorafgegaan door het woord Bearer . Elke 24 uur moet een nieuwe toegangstoken-waarde worden gegenereerd.
  • x-api-key: {API_KEY}: De API Key wordt ook wel een Client ID -waarde genoemd en is een waarde die slechts eenmaal hoeft te worden gegenereerd.
  • x-gw-ims-org-id: {ORG_ID}: De organisatie-id hoeft slechts eenmaal te worden gegenereerd.

Na de voltooiing van de authentificatiezelfstudie en het verzamelen van de waarden voor de vereiste kopballen, bent u bereid beginnen het maken van vraag aan Real-Time Klant API.

Gegevenssetoverlapping genereren met gebruik van de opdrachtregel

Als u vertrouwd bent met het gebruiken van de bevellijn, kunt u het volgende cURL- verzoek gebruiken om het rapport van de datasetoverlapping te produceren door een verzoek van de GET aan /previewsamplestatus/report/dataset/overlap uit te voeren.

Verzoek

In het volgende verzoek wordt de parameter date gebruikt om het meest recente rapport voor de opgegeven datum te retourneren.

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
Beschrijving
date
Geef de datum op van het rapport dat moet worden geretourneerd. Als er meerdere rapporten op de datum werden uitgevoerd, wordt het meest recente rapport voor die datum geretourneerd. Wanneer een rapport niet bestaat voor de opgegeven datum, wordt een HTTP status 404 (Not Found)-fout geretourneerd. Als er geen datum is opgegeven, wordt het meest recente rapport geretourneerd. Indeling: JJJ-MM-DD. Voorbeeld: date=2024-12-31

Reactie

Een succesvol verzoek keert HTTP status 200 (OK) en de dataset overlappen rapport terug. Het rapport bevat een data -object, dat door komma's gescheiden lijsten met gegevenssets en hun respectievelijke aantal profielen bevat. Voor details op hoe te om het rapport te lezen, zie de sectie over het interpreteren van de dataset overlappen rapportgegevenslater in dit leerprogramma.

{
    "data": {
        "5d92921872831c163452edc8,5da7292579975918a851db57,5eb2cdc6fa3f9a18a7592a98": 123,
        "5d92921872831c163452edc8,5eb2cdc6fa3f9a18a7592a98": 454412,
        "5eeda0032af7bb19162172a7": 107
    },
    "reportTimestamp": "2021-04-19T19:55:31.147"
}

Rapport voor overlapping van gegevenssets genereren met Postman

Postman is een samenwerkingsplatform voor API-ontwikkeling en is handig voor het visualiseren van API-aanroepen. Het kan gratis van de website van Postmanworden gedownload en verstrekt gemakkelijk om UI voor het uitvoeren van API vraag te gebruiken. In de volgende schermafbeeldingen wordt de Postman-interface gebruikt.

Verzoek

Voer de volgende stappen uit om het rapport voor gegevenssetoverlapping met Postman aan te vragen:

  • Selecteer GET als aanvraagtype met behulp van het vervolgkeuzemenu.

  • Voer de vereiste kopteksten in de kolom KEY in:

    • Authorization
    • x-api-key
    • x-gw-ims-org-id
  • Voer in de kolom VALUE de waarden in die u tijdens de verificatie hebt gegenereerd en vervang de accolades ( {{ }} ) en eventuele inhoud binnen de accolades.

  • Voer het aanvraagpad in met of zonder de optionele parameter date :
    https://platform.adobe.io/data/core/ups/previewsamplestatus/report/dataset/overlap
    of
    https://platform.adobe.io/data/core/ups/previewsamplestatus/report/dataset/overlap?date=YYYY-MM-DD

Parameter
Beschrijving
date
Geef de datum op van het rapport dat moet worden geretourneerd. Als er meerdere rapporten op de datum werden uitgevoerd, wordt het meest recente rapport voor die datum geretourneerd. Wanneer een rapport niet bestaat voor de opgegeven datum, wordt een HTTP status 404 (Not Found)-fout geretourneerd. Als er geen datum is opgegeven, wordt het meest recente rapport geretourneerd.
Formaat: JJJ-MM-DD. Voorbeeld: date=2024-12-31

Nadat het verzoektype, de kopballen, de waarden, en de weg volledig zijn, verzenden de uitgezochte ​om het API verzoek te verzenden en het rapport te produceren.

Reactie

Een succesvol verzoek keert HTTP status 200 (OK) en de dataset overlappen rapport terug. Het rapport bevat een data -object, dat door komma's gescheiden lijsten met gegevenssets en hun respectievelijke aantal profielen bevat. Voor details op hoe te om het rapport te lezen, zie de sectie over het interpreteren van de dataset overlappen rapportgegevens.

Interpreteer de gegevens van het datasetoverlapping rapport interpret-the-report

Het gegenereerde rapport voor de overlapping van gegevenssets bevat een tijdstempel met de datum en tijd van het rapport en een gegevensobject met unieke combinaties van id's voor gegevenssets als door komma's gescheiden lijsten. De volgende secties verstrekken extra informatie betreffende de componenten van het rapport.

Tijdstempel rapporteren

De reportTimestamp komt overeen met de datum die is opgegeven in de API-aanvraag of, als er geen datum is opgegeven, met de tijdstempel van het meest recente rapport.

Lijst met gegevensset-id's

Het data -object bevat unieke combinaties van id's van gegevenssets als door komma's gescheiden lijsten met het respectievelijke aantal profielen voor die combinatie van gegevenssets.

NOTE
De som van alle profieltellingen verbonden aan elke rij van de datasetoverlapping rapport zou het totale aantal profielen in uw organisatie moeten gelijk stellen.

Om de resultaten van het rapport te interpreteren, overweeg het volgende voorbeeld:

  "5d92921872831c163452edc8,5da7292579975918a851db57,5eb2cdc6fa3f9a18a7592a98": 123,
  "5d92921872831c163452edc8,5eb2cdc6fa3f9a18a7592a98": 454412,
  "5eeda0032af7bb19162172a7": 107

Dit rapport bevat de volgende informatie:

  • Er zijn 123 profielen die bestaan uit gegevens die afkomstig zijn uit de volgende datasets: 5d92921872831c163452edc8, 5da7292579975918a851db57, 5eb2cdc6fa3f9a18a7592a98 .
  • Er zijn 454.412 profielen die bestaan uit gegevens die afkomstig zijn uit deze twee gegevenssets: 5d92921872831c163452edc8 en 5eb2cdc6fa3f9a18a7592a98 .
  • Er zijn 107 profielen die slechts van gegevens van dataset 5eeda0032af7bb19162172a7 worden samengesteld.
  • Er zijn in totaal 454.642 profielen in de organisatie.

Volgende stappen

Na het voltooien van deze zelfstudie kunt u nu het rapport voor de overlapping van gegevenssets genereren met behulp van de Real-Time Customer Profile API. Meer over het werken met de gegevens van het Profiel in zowel API als Experience Platform UI leren, gelieve te beginnen door de het overzichtsdocumentatie van het Profielte lezen.

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