Segmentergebnisse auswerten und darauf zugreifen

Dieses Dokument bietet eine Anleitung zum Evaluieren von Segmenten und zum Zugriff auf Segmentergebnisse mit dem Segmentation API.

Erste Schritte

Dieses Lernprogramm erfordert ein Verständnis der verschiedenen Adobe Experience Platform-Dienste, die beim Erstellen von Audiencen-Segmenten erforderlich sind. Bevor Sie mit diesem Tutorial beginnen, lesen Sie bitte die Dokumentation für die folgenden Dienste:

  • Real-time Customer Profile: Bietet ein einheitliches, kundenspezifisches Profil in Echtzeit, das auf aggregierten Daten aus mehreren Quellen basiert.
  • Adobe Experience Platform Segmentation Service: Ermöglicht Ihnen das Erstellen von Segmenten für Audiencen aus Real-time Customer Profile Daten.
  • Experience Data Model (XDM): Das standardisierte Framework, mit dem Plattform Kundenerlebnisdaten organisiert.
  • Sandboxen: Experience Platform bietet virtuelle Sandboxes, die eine einzelne Platform Instanz in separate virtuelle Umgebung unterteilen, um Anwendungen für digitale Erlebnisse zu entwickeln und weiterzuentwickeln.

Erforderliche Kopfzeilen

Für dieses Lernprogramm müssen Sie außerdem das Authentifizierungstreffen abgeschlossen haben, um erfolgreich Aufrufe an Platform-APIs durchführen zu können. Durch Abschluss des Authentifizierungs-Tutorials werden die Werte für die einzelnen erforderlichen Header in allen Experience Platform-API-Aufrufen bereitgestellt, wie unten dargestellt:

  • Authorization: Bearer {ACCESS_TOKEN}
  • x-api-key: {API_KEY}
  • x-gw-ims-org-id: {IMS_ORG}

Alle Ressourcen in Experience Platform werden zu bestimmten virtuellen Sandboxen isoliert. Anforderungen an Platform-APIs erfordern einen Header, der den Namen der Sandbox angibt, in der der Vorgang ausgeführt wird in:

  • x-sandbox-name: {SANDBOX_NAME}
HINWEIS

Weitere Informationen zu Sandboxen in Platform finden Sie in der Sandbox-Übersichtsdokumentation.

Für alle POST-, PUT- und PATCH-Anforderungen ist ein zusätzlicher Header erforderlich:

  • Content-Type: application/json

Bewerten eines Segments

Nachdem Sie Ihre Segmentdefinition entwickelt, getestet und gespeichert haben, können Sie das Segment entweder durch eine geplante Auswertung oder eine On-Demand-Auswertung bewerten.

Die geplante Auswertung (auch als "geplante Segmentierung"bezeichnet) ermöglicht es Ihnen, einen wiederkehrenden Zeitplan für die Ausführung eines Exportauftrags zu einem bestimmten Zeitpunkt zu erstellen, während bei der On-Demand- Auswertung ein Segmentauftrag erstellt wird, um die Audience sofort zu erstellen. Die Schritte für die einzelnen Schritte sind nachfolgend beschrieben.

Wenn Sie das Tutorial Segmentierung mit der Segmentierungs-API noch nicht abgeschlossen haben oder eine Segmentdefinition mit Segmentaufbau erstellt haben, führen Sie dies bitte aus, bevor Sie mit diesem Tutorial fortfahren.

Geplante Evaluierung

Durch die geplante Auswertung kann Ihr IMS-Org einen wiederkehrenden Zeitplan erstellen, um Exportaufträge automatisch auszuführen.

HINWEIS

Geplante Evaluierung kann für Sandboxen mit maximal fünf (5) Zusammenführungsrichtlinien für XDM Individual Profile aktiviert werden. Wenn Ihr Unternehmen über mehr als fünf Zusammenführungsrichtlinien für XDM Individual Profile in einer einzelnen Sandbox-Umgebung verfügt, können Sie keine geplante Auswertung verwenden.

Zeitplan erstellen

Wenn Sie eine POST-Anfrage an den /config/schedules-Endpunkt senden, können Sie einen Zeitplan erstellen und die genaue Zeit einschließen, zu der der Zeitplan ausgelöst werden soll.

Ausführlichere Informationen zur Verwendung dieses Endpunktes finden Sie im Endpunktleitfaden für Zeitpläne

Zeitplan aktivieren

Standardmäßig ist ein Zeitplan bei der Erstellung inaktiv, es sei denn, die state-Eigenschaft ist im Text der POST-Anfrage (Erstellen) auf active gesetzt. Sie können einen Zeitplan aktivieren (setzen Sie state auf active), indem Sie eine PATCH-Anfrage an den /config/schedules-Endpunkt senden und die Kennung des Zeitplans in den Pfad einschließen.

Ausführlichere Informationen zur Verwendung dieses Endpunktes finden Sie im Endpunktleitfaden für Zeitpläne

Zeitplanaktualisierung

Die Zeitplanung kann aktualisiert werden, indem eine PATCH an den /config/schedules-Endpunkt angefordert wird und die ID des Zeitplans in den Pfad aufgenommen wird.

Ausführlichere Informationen zur Verwendung dieses Endpunktes finden Sie im Endpunktleitfaden für Zeitpläne

On-Demand-Bewertung

Mit der On-Demand-Auswertung können Sie einen Segmentauftrag erstellen, um bei Bedarf ein Audiencen-Segment zu generieren. Im Gegensatz zur geplanten Auswertung erfolgt dies nur auf Anfrage und nicht wiederholt.

Erstellen eines Segmentauftrags

Ein Segmentauftrag ist ein asynchroner Vorgang, bei dem ein neues Zielgruppensegment erstellt wird. Es verweist auf eine Segmentdefinition sowie auf alle Zusammenführungsrichtlinien, die steuern, wie Real-time Customer Profile überlappende Attribute über Ihre Profil-Fragmente hinweg zusammenführt. Nach erfolgreichem Abschluss eines Segmentauftrags können Sie verschiedene Informationen über das Segment sammeln, z. B. Fehler, die bei der Verarbeitung aufgetreten sind, oder die endgültige Größe Ihrer Zielgruppe.

Sie können einen neuen Segmentauftrag erstellen, indem Sie eine POST an den /segment/jobs-Endpunkt in der Real-time Customer Profile-API anfordern.

Detailliertere Informationen zur Verwendung dieses Endpunkts finden Sie im Endpunkt Segmentaufträge

Status des Segmentauftrags suchen

Sie können das id für einen bestimmten Segmentauftrag verwenden, um eine Suchanfrage (GET) auszuführen, um den aktuellen Auftragsstatus Ansicht.

Detailliertere Informationen zur Verwendung dieses Endpunkts finden Sie im Endpunkt Segmentaufträge

Segmentergebnisse interpretieren

Wenn Segmentaufträge erfolgreich ausgeführt werden, wird die Zuordnung segmentMembership für jedes Profil im Segment aktualisiert. segmentMembership speichert auch alle vorab ausgewerteten Audiencen, die in eingegliedert werden, Platformsodass eine Integration mit anderen Lösungen wie Adobe Audience Manager.

Das folgende Beispiel zeigt, wie das segmentMembership-Attribut für jeden einzelnen Profil-Datensatz aussieht:

{
  "segmentMembership": {
    "UPS": {
      "04a81716-43d6-4e7a-a49c-f1d8b3129ba9": {
        "timestamp": "2018-04-26T15:52:25+00:00",
        "status": "existing"
      },
      "53cba6b2-a23b-454a-8069-fc41308f1c0f": {
        "lastQualificationTime": "2018-04-26T15:52:25+00:00",
        "status": "realized"
      }
    },
    "Email": {
      "abcd@adobe.com": {
        "lastQualificationTime": "2017-09-26T15:52:25+00:00",
        "status": "exited"
      }
    }
  }
}
Eigenschaft Beschreibung
lastQualificationTime Der Zeitstempel, zu dem die Zusicherung der Segmentmitgliedschaft erfolgte und das Profil das Segment ein- oder ausstieg.
status Der Status der Segmentbeteiligung als Teil der aktuellen Anforderung. muss einem der folgenden bekannten Werte entsprechen:
  • existing: Die Entität befindet sich weiterhin im Segment.
  • realized: Entität tritt in das Segment ein.
  • exited: Entität beendet das Segment.

Zugriff auf Segmentergebnisse

Auf die Ergebnisse eines Segmentauftrags kann auf zwei Arten zugegriffen werden: Sie können auf einzelne Profil zugreifen oder eine ganze Audience in einen Datensatz exportieren.

Die folgenden Abschnitte beschreiben diese Optionen detaillierter.

Profil nachschlagen

Wenn Sie das spezifische Profil kennen, auf das Sie zugreifen möchten, können Sie dies mit der API Real-time Customer Profile tun. Die vollständigen Schritte zum Zugriff auf einzelne Profil finden Sie im Lehrgang Echtzeit-Kundendaten über das Profil-API aufrufen.

Segment exportieren

Nachdem ein Segmentierungsauftrag erfolgreich abgeschlossen wurde (der Wert des status-Attributs lautet „SUCCEEDED“ (GELUNGEN)), können Sie Ihre Zielgruppe in einen Datensatz exportieren. In diesem Datensatz ist die Zielgruppe zugänglich und bearbeitbar.

Die folgenden Schritte sind erforderlich, um Ihre Audience zu exportieren:

Zielgruppen-Dataset erstellen

Beim Exportieren einer Audience muss zunächst ein Zielgruppe-Datensatz erstellt werden. Es ist wichtig, dass der Datensatz korrekt konfiguriert wird, um sicherzustellen, dass der Export erfolgreich ist.

Eine der wichtigsten Überlegungen ist das Schema, auf dem der Datensatz basiert (schemaRef.id in der unten stehenden API-Musteranforderung). Um ein Segment zu exportieren, muss der Datensatz auf dem XDM Individual Profile Union Schema (https://ns.adobe.com/xdm/context/profile__union) basieren. Ein Vereinigung-Schema ist ein systemgeneriertes, schreibgeschütztes Schema, das die Felder von Schemas, die dieselbe Klasse besitzen, Aggregat gibt, in diesem Fall die XDM-Klasse Individuelles Profil. Weitere Informationen zu Schemas der Vereinigung Ansicht finden Sie im Abschnitt Kundenkonto in Echtzeit im Schema Registry Developer Guide.

Es gibt zwei Möglichkeiten, den erforderlichen Datensatz zu erstellen:

  • Verwenden von APIs: Die in diesem Lernprogramm beschriebenen Schritte beschreiben, wie ein Datensatz erstellt wird, der auf die XDM Individual Profile Union Schema Verwendung der Catalog API verweist.
  • Verwenden der Benutzeroberfläche: Um mithilfe der Adobe Experience Platform Benutzeroberfläche einen Datensatz zu erstellen, der auf das Schema "Vereinigung"verweist, führen Sie die Schritte im UI- Lernprogramm aus und kehren Sie dann zu diesem Lernprogramm zurück, um die Schritte zum Generieren von Profilen für die Audience fortzusetzen.

Wenn Sie bereits über einen kompatiblen Datensatz verfügen und dessen ID kennen, können Sie direkt mit dem Schritt für Generieren von Profilen der Audience fortfahren.

API-Format

POST /dataSets

Anfrage

Mit der folgenden Anforderung wird ein neuer Datensatz erstellt, der Konfigurationsparameter in der Nutzlast bereitstellt.

curl -X POST \
  https://platform.adobe.io/data/foundation/catalog/dataSets \
  -H 'Content-Type: application/json' \
  -H 'Authorization: Bearer {ACCESS_TOKEN}' \
  -H 'x-api-key: {API_KEY}' \
  -H 'x-gw-ims-org-id: {IMS_ORG}' \
  -H 'x-sandbox-name: {SANDBOX_NAME}' \
  -d '{
    "name": "Segment Export",
    "schemaRef": {
        "id": "https://ns.adobe.com/xdm/context/profile__union",
        "contentType": "application/vnd.adobe.xed+json;version=1"
    },
    "fileDescription": {
        "persisted": true,
        "containerFormat": "parquet",
        "format": "parquet"
    }
}'
Eigenschaft Beschreibung
name Ein beschreibender Name für den Datensatz.
schemaRef.id Die ID der Vereinigung-Ansicht (Schema), der der Datensatz zugeordnet werden soll.
fileDescription.persisted Ein boolescher Wert, der bei Festlegung auf true den Datenbestand in der Ansicht "Vereinigung"beibehalten kann.

Antwort

Eine erfolgreiche Antwort gibt ein Array zurück, das die schreibgeschützte, systemgenerierte eindeutige ID des neu erstellten Datensatzes enthält. Für den erfolgreichen Export von Audiencen-Mitgliedern ist eine ordnungsgemäß konfigurierte Dataset-ID erforderlich.

[
  "@/datasets/5b020a27e7040801dedba61b"
] 

Generieren von Profilen für Audiencen-Mitglieder

Nachdem Sie über einen Datensatz mit Vereinigung-Speicherung verfügen, können Sie einen Exportauftrag erstellen, um die Audiencen im Datensatz zu erhalten, indem Sie eine POST an den /export/jobs-Endpunkt in der Real-time Customer Profile-API anfordern und die Datensatzkennnummer und Segmentinformationen für die zu exportierenden Segmente angeben.

Ausführlichere Informationen zur Verwendung dieses Endpunkts finden Sie im Endpunktleitfaden Exportaufträge

Überwachung des Exportfortschritts

Bei der Verarbeitung eines Exportauftrags können Sie dessen Status überwachen, indem Sie eine GET an den Endpunkt /export/jobs und das id des Exportauftrags im Pfad anfordern. Der Exportauftrag ist abgeschlossen, sobald das Feld status den Wert "SUCCEEDED"zurückgibt.

Ausführlichere Informationen zur Verwendung dieses Endpunkts finden Sie im Endpunktleitfaden Exportaufträge

Nächste Schritte

Nach erfolgreichem Abschluss des Exports sind Ihre Daten im Ordner Data Lake in Experience Platform verfügbar. Verwenden Sie dann Data Access API, um mit dem mit dem Export verknüpften batchId auf die Daten zuzugreifen. Je nach Größe des Segments können die Daten in Blöcken vorliegen und der Stapel kann aus mehreren Dateien bestehen.

Eine schrittweise Anleitung zum Verwenden der Data Access-API zum Zugriff auf und Herunterladen von Stapeldateien finden Sie im Lernprogramm zum Datenzugriff.

Sie können auch mit Adobe Experience Platform Query Service auf erfolgreich exportierte Segmentdaten zugreifen. Mithilfe der Benutzeroberfläche oder RESTful-API können Sie Query Service Abfragen für Daten innerhalb von Data Lake schreiben, überprüfen und ausführen.

Weitere Informationen zur Abfrage von Audiencen finden Sie in der Dokumentation zu Query Service.

Auf dieser Seite

Adobe Summit Banner

A virtual event April 27-28.

Expand your skills and get inspired.

Register for free
Adobe Summit Banner

A virtual event April 27-28.

Expand your skills and get inspired.

Register for free
Adobe Maker Awards Banner

Time to shine!

Apply now for the 2021 Adobe Experience Maker Awards.

Apply now
Adobe Maker Awards Banner

Time to shine!

Apply now for the 2021 Adobe Experience Maker Awards.

Apply now