Segment mithilfe der Segmentierungsdienst-API erstellen

Dieses Dokument bietet eine Anleitung zum Entwickeln, Testen, Anzeigen und Speichern einer Segmentdefinition unter Verwendung der Adobe Experience Platform Segmentation Service API.

Informationen zum Erstellen von Segmenten mithilfe der Benutzeroberfläche finden Sie in der Handbuch zum Segmentaufbau.

Erste Schritte

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

Die folgenden Abschnitte enthalten zusätzliche Informationen, die Sie kennen müssen, um erfolgreich Aufrufe an die Platform APIs.

Lesen von Beispiel-API-Aufrufen

In diesem Tutorial wird anhand von Beispielen für API-Aufrufe die korrekte Formatierung von Anfragen aufgezeigt. Dazu gehören Pfade, erforderliche Kopfzeilen und ordnungsgemäß formatierte Anfrage-Payloads. Außerdem wird ein Beispiel für eine von der API im JSON-Format zurückgegebene Antwort bereitgestellt. Informationen zu den Konventionen, die in der Dokumentation für Beispiel-API-Aufrufe verwendet werden, finden Sie im Abschnitt zum Lesen von Beispiel-API-Aufrufen im Handbuch zur Fehlerbehebung für Experience Platform

Sammeln von Werten für erforderliche Kopfzeilen

Um Platform-APIs aufzurufen, müssen Sie zunächst das Authentifizierungs-Tutorial abschließen. 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 sind auf bestimmte virtuelle Sandboxes beschränkt. Bei allen Anfragen an Platform-APIs ist eine Kopfzeile erforderlich, die den Namen der Sandbox angibt, in der der Vorgang ausgeführt werden soll:

  • x-sandbox-name: {SANDBOX_NAME}
HINWEIS

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

Bei allen Anfragen mit einer Payload (POST, PUT, PATCH) ist eine zusätzliche Kopfzeile erforderlich:

  • Content-Type: application/json

Segmentdefinition entwickeln

Der erste Schritt in der Segmentierung besteht darin, ein Segment zu definieren, das in einem Konstrukt namens Segmentdefinition dargestellt wird. Eine Segmentdefinition ist ein Objekt, das eine in Profile Query Language (PQL). Dieses Objekt wird auch als PQL-Prädikat bezeichnet. PQL-Prädikate definieren die Regeln für das Segment basierend auf Bedingungen, die sich auf beliebige Daten aus Datensatz oder Zeitreihen beziehen, an die Sie Folgendes übermitteln Real-time Customer Profile. Siehe PQL-Leitfaden für weitere Informationen zum Schreiben von PQL-Abfragen.

Sie können eine neue Segmentdefinition erstellen, indem Sie eine POST anfordern bei /segment/definitions Endpunkt im Segmentation API. Im folgenden Beispiel wird erläutert, wie eine Definitionsanforderung formatiert wird, einschließlich der Informationen, die erforderlich sind, damit ein Segment erfolgreich definiert werden kann.

Eine ausführliche Erläuterung zur Definition eines Segments finden Sie im Entwicklerleitfaden für Segmentdefinition.

Schätzung und Vorschau einer Audience

Wenn Sie Ihre Segmentdefinition entwickeln, können Sie die Tools zur Schätzung und Vorschau innerhalb von Real-time Customer Profile Informationen auf Zusammenfassungsebene der Ansicht, um sicherzustellen, dass Sie die erwartete Audience isolieren. Schätzungen liefern statistische Informationen über eine Segmentdefinition, wie z. B. die erwartete Audience und das Konfidenzintervall. Vorschauen bieten paginierte Listen von qualifizierenden Profilen für eine Segmentdefinition, mit denen Sie die Ergebnisse mit den Erwartungen vergleichen können.

Durch die Schätzung und Vorschau Ihrer Audience können Sie Ihre PQL-Vorhersagen testen und optimieren, bis sie ein erwünschtes Ergebnis liefern und dann in einer aktualisierten Segmentdefinition verwendet werden können.

Es sind zwei Schritte erforderlich, um ein Segment zu Vorschauen oder eine Schätzung Ihres Segments zu erhalten:

  1. Vorschau erstellen
  2. Schätzung der Ansicht oder Vorschau mit der ID des Auftrags der Vorschau

Erstellung von Schätzungen

Datenstichproben werden verwendet, um Segmente zu bewerten und die Anzahl der qualifizierten Profil zu schätzen. Jeden Morgen werden neue Daten in den Speicher geladen (zwischen 12:00 und 2:00 Uhr, d.h. 7:9 Uhr UTC), und alle Segmentierungs-Abfragen werden anhand der Beispieldaten dieses Tages geschätzt. Folglich werden alle neu hinzugefügten oder zusätzlichen Daten am folgenden Tag in Schätzungen berücksichtigt.

Die Stichprobengröße hängt von der Gesamtanzahl der Entitäten in Ihrem Profil-Store ab. Diese Stichprobengrößen sind in der folgenden Tabelle dargestellt:

Einrichtungen im Profil-Store Stichprobengröße
Weniger als 1 Million Vollständiger Datensatz
1 bis 20 Millionen 1 Million
über 20 Millionen 5 % der Gesamtmittel

Schätzungen laufen im Allgemeinen 10-15 Sekunden, beginnend mit einer groben Schätzung und der Verfeinerung, wenn mehr Datensätze gelesen werden.

Vorschau erstellen

Sie können einen neuen Auftrag für die Vorschau erstellen, indem Sie eine POST anfordern an die /preview Endpunkt.

Detaillierte Anweisungen zum Erstellen eines Vorschau-Auftrags finden Sie im Leitfaden zu Vorschauen und Schätzendpunkten.

Ansicht, Schätzung oder Vorschau

Schätzungs- und Vorschau-Prozesse werden asynchron ausgeführt, da verschiedene Abfragen unterschiedliche Zeitspannen benötigen. Sobald eine Abfrage initiiert wurde, können Sie mithilfe von API-Aufrufen den aktuellen Zustand der Schätzung oder Vorschau während des Fortschreitens abrufen (GET).

Verwenden der Segmentation Service API, können Sie den aktuellen Status eines Vorschau-Auftrags anhand seiner ID nachschlagen. Wenn der Status "RESULT_READY" lautet, können Sie die Ergebnisse Ansicht. Um den aktuellen Status eines Vorschau-Auftrags nachzuschlagen, lesen Sie den Abschnitt unter Abrufen eines Vorschau-Auftrags im Handbuch zu Vorschauen und Schätzungen-Endpunkten. Lesen Sie den Abschnitt über, um den aktuellen Status eines schätzungsauftrags nachzuschlagen. Abruf eines Schätzauftrags im Handbuch zu Vorschauen und Schätzungen-Endpunkten.

Nächste Schritte

Sobald Sie Ihre Segmentdefinition entwickelt, getestet und gespeichert haben, können Sie einen Segmentauftrag erstellen, um eine Audience zu erstellen, indem Sie Segmentation Service API. Siehe Tutorial zu Segmentergebnisse bewerten und darauf zugreifen für detaillierte Schritte, wie Sie dies erreichen können.

Auf dieser Seite