Erstellen eines Berichts zur Datensatzüberschneidung

Der Bericht zur Datensatzüberschneidung bietet Einblick in die Zusammensetzung des Profile-Stores Ihres Unternehmens, indem er die Datensätze verfügbar macht, die am meisten zu Ihrer adressierbaren Zielgruppe (Profile) beitragen.

Dieser Bericht bietet nicht nur Einblicke in Ihre Daten, sondern ermöglicht Ihnen auch Maßnahmen zur Optimierung Ihrer Lizenznutzung, z. B. die Festlegung einer Beschränkung der Lebensdauer bestimmter Daten.

In diesem Tutorial werden die Schritte beschrieben, die zum Generieren des Berichts zur Datensatzüberlappung mithilfe der Real-Time Customer Profile -API und zur Interpretation der Ergebnisse für Ihre Organisation erforderlich sind.

Erste Schritte

Um Adobe Experience Platform-APIs verwenden zu können, müssen Sie zunächst das Authentifizierungs-Tutorial abschließen, um die Werte zu erfassen, die Sie für die erforderlichen Kopfzeilen benötigen. Weitere Informationen zu Experience Platform-APIs finden Sie in der Dokumentation Erste Schritte mit Platform-APIs .

Die erforderlichen Kopfzeilen für alle API-Aufrufe in diesem Tutorial sind:

Nachdem Sie das Authentifizierungs-Tutorial abgeschlossen und die Werte für die erforderlichen Kopfzeilen erfasst haben, können Sie mit dem Aufrufen der Echtzeit-Kunden-API beginnen.

Bericht zur Datensatzüberschneidung über die Befehlszeile erstellen

Wenn Sie mit der Verwendung der Befehlszeile vertraut sind, können Sie die folgende cURL-Anfrage verwenden, um den Bericht zur Datensatzüberlappung zu generieren, indem Sie eine GET-Anfrage an /previewsamplestatus/report/dataset/overlap ausführen.

Anfrage

Die folgende Anfrage verwendet den Parameter date , um den letzten Bericht für das angegebene Datum zurückzugeben.

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}' \

Antwort

Eine erfolgreiche Anfrage gibt den HTTP-Status 200 (OK) und den Bericht zur Datensatzüberlappung zurück. Der Bericht enthält ein data -Objekt, das kommagetrennte Listen mit Datensätzen und deren jeweiligen Profilzählern enthält. Weitere Informationen zum Lesen des Berichts finden Sie im Abschnitt zum Interpretieren der Berichtdaten zur Datensatzüberlappung später in diesem Tutorial.

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

Bericht zur Datensatzüberschneidung mit Postman generieren

Postman ist eine kollaborative Plattform für die API-Entwicklung und eignet sich für die Visualisierung von API-Aufrufen. Es kann kostenlos von der Postman-Website heruntergeladen werden und bietet eine benutzerfreundliche Benutzeroberfläche für die Ausführung von API-Aufrufen. Die folgenden Screenshots verwenden die Postman-Benutzeroberfläche.

Anfrage

Um den Bericht zur Datensatzüberschneidung mit Postman anzufordern, führen Sie die folgenden Schritte aus:

Nachdem der Anfragetyp, die Kopfzeilen, Werte und der Pfad abgeschlossen sind, wählen Sie Senden aus, um die API-Anfrage zu senden und den Bericht zu generieren.

Antwort

Eine erfolgreiche Anfrage gibt den HTTP-Status 200 (OK) und den Bericht zur Datensatzüberlappung zurück. Der Bericht enthält ein data -Objekt, das kommagetrennte Listen mit Datensätzen und deren jeweiligen Profilzählern enthält. Weitere Informationen zum Lesen des Berichts finden Sie im Abschnitt zum Interpretieren der Berichtdaten zur Datensatzüberlappung.

Interpretieren der Berichtsdaten zu Datensatzüberschneidungen interpret-the-report

Der Bericht zur generierten Datensatzüberschneidung bietet einen Zeitstempel, der das Datum und die Uhrzeit des Berichts sowie ein Datenobjekt anzeigt, das eindeutige Kombinationen aus Datensatz-IDs als kommagetrennte Listen enthält. Die folgenden Abschnitte enthalten zusätzliche Informationen zu den Komponenten des Berichts.

Zeitstempel des Berichts

Die reportTimestamp entspricht dem in der API-Anfrage angegebenen Datum oder, falls kein Datum angegeben wurde, dem Zeitstempel des letzten Berichts.

Liste der Datensatz-IDs

Das Objekt data enthält eindeutige Kombinationen aus Datensatz-IDs als kommagetrennte Listen mit der entsprechenden Profilanzahl für diese Kombination von Datensätzen.

Um die Ergebnisse des Berichts zu interpretieren, sehen Sie sich folgendes Beispiel an:

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

Dieser Bericht enthält die folgenden Informationen:

Nächste Schritte

Nach Abschluss dieses Tutorials können Sie jetzt den Bericht zur Datensatzüberlappung mithilfe der Echtzeit-Kundenprofil-API generieren. Um mehr über die Arbeit mit Profildaten sowohl in der API als auch in der Experience Platform-Benutzeroberfläche zu erfahren, lesen Sie zunächst die Dokumentation zur Profilübersicht.