Genereer het overlappingsrapport voor de gegevensset
Het rapport van de datasetoverlapping verstrekt zicht in de samenstelling van uw organisatie Profile opslag 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 overlappende rapport voor de gegevensset te genereren met behulp van Real-Time Customer Profile API en interpreteer de resultaten voor uw organisatie.
Aan de slag
Als u Adobe Experience Platform API's wilt gebruiken, moet u eerst de verificatiezelfstudie om de waarden te verzamelen die u voor de vereiste kopballen nodig hebt. Raadpleeg voor meer informatie over Experience Platform-API's de aan de slag met Platform APIs documentatie.
De vereiste kopballen voor alle API vraag in dit leerprogramma zijn:
Authorization: Bearer {ACCESS_TOKEN}
: DeAuthorization
header vereist een toegangstoken die wordt voorafgegaan door het woordBearer
. Elke 24 uur moet een nieuwe toegangstoken-waarde worden gegenereerd.x-api-key: {API_KEY}
: DeAPI Key
ook bekend als aClient ID
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 uit te voeren om /previewsamplestatus/report/dataset/overlap
.
Verzoek
In het volgende verzoek wordt het date
parameter om het meest recente rapport voor de gespecificeerde datum terug te keren.
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
Antwoord
Een succesvol verzoek keert HTTP status 200 (OK) en de dataset overlappen rapport terug. Het verslag bevat een data
object, met door komma's gescheiden lijsten met gegevenssets en het respectievelijke aantal profielen. Voor meer informatie over het lezen van het rapport raadpleegt u de sectie over het interpreteren van de dataset overlappen rapportgegevens later in deze zelfstudie.
{
"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 worden gedownload vanaf het tabblad Postman-website en biedt een gebruiksvriendelijke gebruikersinterface voor het uitvoeren van API-aanroepen. 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 het dialoogvenster
KEY
kolom:Authorization
x-api-key
x-gw-ims-org-id
-
Voer de waarden die u tijdens de verificatie hebt gegenereerd in het dialoogvenster
VALUE
kolom, accolades vervangen ({{ }}
) en alle inhoud binnen de accolades. -
Voer het aanvraagpad in met of zonder de optionele
date
parameter:https://platform.adobe.io/data/core/ups/previewsamplestatus/report/dataset/overlap
ofhttps://platform.adobe.io/data/core/ups/previewsamplestatus/report/dataset/overlap?date=YYYY-MM-DD
date
Indeling: YYYY-MM-DD. Voorbeeld:
date=2024-12-31
Nadat het aanvraagtype, de kopteksten, de waarden, en de weg volledig zijn, uitgezocht Verzenden om de API-aanvraag te verzenden en het rapport te genereren.
Antwoord
Een succesvol verzoek keert HTTP status 200 (OK) en de dataset overlappen rapport terug. Het verslag bevat een data
object, met door komma's gescheiden lijsten met gegevenssets en het respectievelijke aantal profielen. Voor meer informatie over het lezen van het rapport raadpleegt u 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
De data
Het object bevat unieke combinaties van id's van gegevenssets als door komma's gescheiden lijsten met het respectieve aantal profielen voor die combinatie van gegevenssets.
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 van gegevens uit de volgende datasets worden samengesteld:
5d92921872831c163452edc8
,5da7292579975918a851db57
,5eb2cdc6fa3f9a18a7592a98
. - Er zijn 454.412 profielen samengesteld uit gegevens die uit deze twee datasets komen:
5d92921872831c163452edc8
en5eb2cdc6fa3f9a18a7592a98
. - Er zijn 107 profielen die slechts van gegevens van dataset worden samengesteld
5eeda0032af7bb19162172a7
. - 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. Als u meer wilt weten over het werken met profielgegevens in zowel de API als de interface van het Experience Platform, leest u eerst de Profieloverzicht, documentatie.