DokumentationJourney OptimizerHandbuch für Journey Optimizer

[Eingeschränkte Verfügbarkeit]{class="badge informative"}

Verwenden von Adobe Experience Platform-Daten aep-data

Letzte Aktualisierung: 16. September 2026

Erstellt für:

  • Fortgeschritten
  • Entwicklerin/Entwickler

Auf dieser Seite: Aktivieren Sie eintragsbasierte Adobe Experience Platform-Datensätze für die Suche, damit Sie die Personalisierung, Entscheidungsfindung und Journey-Orchestrierung mit Referenz- und Transaktionsdaten anreichern können, die zur Laufzeit in Journey Optimizer abgerufen werden.

style
shade-box

Mit Journey Optimizer können Sie Daten aus Adobe Experience Platform mit Funktionen für Personalisierung, Entscheidungsfindung und Journey-Orchestrierung nutzen. Hierzu müssen auf Einträgen basierende Datensätze, die für die Personalisierung der Suche erforderlich sind, zunächst wie nachfolgend beschrieben für den Suchdienst aktiviert werden.

NOTE
Die Funktion zur Datensuche ist nur eingeschränkt verfügbar und steht allen Journey Optimizer-Kunden zur Verfügung.

Weitere Informationen darüber, wie Sie auf Datensätze zugreifen und damit arbeiten, finden Sie in diesem Abschnitt: Erste Schritte mit Datensätzen

Wichtige Informationen

Leitlinien und Richtlinien guidelines

Bevor Sie beginnen, lesen Sie sich die folgenden Einschränkungen und Richtlinien durch:

  • Keine personenbezogenen Daten in Datensätzen: Für die Suche aktivierte Datensätze sollten keine personenbezogenen Daten (PII) enthalten.

  • Löschrisiko: In der Personalisierung verwendete Datensätze sind nicht vor dem Löschen geschützt. Sie müssen verfolgen, welche Datensätze verwendet werden, um sicherzustellen, dass sie nicht entfernt werden.

  • Schematyp: Datensätze müssen mit einem Schema verknüpft sein, das NICHT vom Typ „Profil“ oder „Ereignis“ ist.

  • Ständig aktivierte Suchoption: Vermeiden Sie die wiederholte Aktivierung und Deaktivierung von Datensätzen. Dies kann zu unerwartetem Indizierungsverhalten führen. Es empfiehlt sich, den Datensatz so lange aktiviert zu lassen, wie Sie ihn für Suchen verwenden möchten.

  • Edge-Aktivierungsregion: Lookup-fähige Datensätze sind für die eingehende Edge-basierte Aktivierung nur in der Region verfügbar, in der sich die Sandbox des Datensatzes befindet (z. B. NLD2 oder VA7). Die Sandbox-Region wird in der Benutzeroberfläche neben dem Sandbox-Namen angezeigt.

  • Löschen eines Daten-Batches: Wenn Sie einen Batch von Daten aus Ihrem Datensatz entfernen, werden alle übereinstimmenden Schlüssel vollständig aus dem Suchdienst entfernt. Beispiel:

    Batch 1: Sku1, Sku2, Sku3
    Batch 2: Sku1, Sku2, Sku3, Sku4, Sku5, Sku6
    Batch 3: Sku7, Sku8, Sku9, Sku10

    Wenn Sie Batch 1 löschen, werden Sku1, Sku2 und Sku3 aus dem Suchspeicher entfernt. Die resultierenden Suchdaten enthalten dann: Sku4, Sku5, Sku6, Sku7, Sku8, Sku9, Sku10.

Berechtigung für den Suchdienst

Funktionskomponente
Beschränkungen
Anmerkungen
Datensätze für die Suche aktiviert
Max. 10 pro Organisation
Maximale Anzahl von Datensätzen, die zu einem Zeitpunkt für die Suche konfiguriert werden können. Diese Begrenzung gilt für die Gesamtzahl der kombinierten Suchdatensätze in Produktions- und Entwicklungs-Sandboxes innerhalb der Kundeninstanz.
Anzahl der Datensatzeinträge
Bis zu 2 Millionen Einträge pro Datensatz
Maximal zulässige Anzahl von Einträgen in einem einzelnen Datensatz, berechnet als Gesamtanzahl aller Batches innerhalb dieses Datensatzes.
Eintragsgröße
Bis zu 2 KB pro Eintrag
Standardmäßig unterstützte maximale Eintragsgröße.
Datensatzgröße
Bis zu 4 GB
Maximale Größe eines einzelnen Datensatzes, nicht die kombinierte Größe aller Datensätze in einer Sandbox. Die Begrenzung der Eintragsanzahl und der Datensatzgröße sind unabhängige Schutzmechanismen – beide müssen erfüllt sein.
Aktualisierungen der Datensatzfrequenz
Bis zu 5 Aktualisierungen pro Tag und Datensatz
Maximal zulässige Häufigkeit von Aktualisierungsvorgängen für einen einzelnen Datensatz pro Tag.
NOTE
Wenn über die oben aufgeführten Schutzmechanismen hinaus zusätzliche Volumen benötigt werden, wenden Sie sich an den Adobe-Support.

Aktivieren eines Datensatzes für Datensuchen enable

Um Daten aus Ihrem Datensatz für die Personalisierung nutzen zu können, müssen Sie den Datensatz für die Suche aktivieren.

Voraussetzungen prerequisites-enable

Das mit Ihrem Datensatz verknüpfte Schema, das Sie für die Suche aktivieren möchten, muss vom Typ „Eintrag“ sein. Das Schema darf NICHT der Profil- oder Ereignisklasse angehören.

Beispiel

Für das Schema muss eine primäre Identität definiert sein.

Beispiel

Wenn noch kein benutzerdefinierter Namespace definiert wurde, stellen Sie sicher, dass die Identität eine Nicht-Personen-Kennung ist.

Beispiel

Aktivieren des Datensatzes für die Suche in der Oberfläche zur Datensatzverwaltung

Verwenden Sie in der Benutzeroberfläche zur Datensatzverwaltung den Umschalter, um den Datensatz für die Suche zu aktivieren.

API-Methode

Befolgen Sie die Anweisungen in dieser Dokumentation, um Ihre Umgebung für das Senden von API-Befehlen zu konfigurieren.

Voraussetzungen

  • Für das Entwicklerprojekt müssen die Adobe Journey Optimizer- und Adobe Experience Platform-APIs zum Projekt hinzugefügt werden.

  • Sie müssen über die Berechtigung zum Verwalten von Datensätzen als Teil Ihrer Rolle verfügen.

  • Das Schema, auf dem der Datensatz basiert, muss eine primäre Identität enthalten, die als Suchschlüssel fungieren kann.

API-Aufrufstruktur

curl -s -XPATCH "https://platform.adobe.io/data/core/entity/lookup/dataSets/${DATASET_ID}/${ACTION}" \ -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}"

Dabei gilt:

  • Die URL lautet https://platform.adobe.io/data/core/entity/lookup/dataSets/${DATASET_ID}/${ACTION}
  • „Dataset ID“ ist der Datensatz, den Sie aktivieren möchten.
  • „Action“ ist „Aktivieren“ ODER „Deaktivieren“.
  • „Access token“ kann aus der Developer Console abgerufen werden.
  • „API Key“ kann aus der Developer Console abgerufen werden.
  • „IMS Org ID“ ist Ihre Adobe-Organisation.
  • „Sandbox Name“ ist der Name der Sandbox, in der sich der Datensatz befindet (d. h. prod, dev usw.).
NOTE
Wenn beim Durchführen eines API-Aufrufs zum Aktivieren von Datensätzen der folgende Fehler auftritt, versuchen Sie, die Adobe Journey Optimizer-APIs aus Ihrem Developer Console-Projekt zu entfernen und sie dann erneut hinzuzufügen.
"error_code": "403003",
"message": "Api Key is invalid"

Datensatz-Monitoring

Sobald ein Datensatz für die Suche aktiviert wurde, können Sie den Status der Aufnahme in den Suchdienst überprüfen, indem Sie das Menü Monitoring aufrufen und die Registerkarte Journey Optimizer auswählen.

Diese Prozessanzeige hilft zu verstehen, wenn neue Daten-Batches im Suchdienst verfügbar sind.

Nächste Schritte

Nachdem ein Datensatz mithilfe eines API-Aufrufs für die Suche aktiviert wurde, können Sie seine Daten mit Journey Optimizer-Funktionen zur Personalisierung und Entscheidungsfindung verwenden. Weitere Informationen finden Sie in den folgenden Abschnitten:

AI Knowledge Reference

This section contains structured knowledge intended to support interpretation, retrieval, and question answering related to this topic.

For complete understanding, this information should be combined with the documentation on this page. Neither source is intended to stand alone; the page describes the feature, while this section provides additional context that helps disambiguate terminology, intent, applicability, and constraints.

  • TL;DR: This page explains how to enable record-based Adobe Experience Platform datasets for the lookup service so their data can enrich personalization, Decisioning, and journey orchestration at runtime, including the entitlement guardrails.

Intents:

  • Enable a record-based dataset for lookup using the dataset management toggle or the API.
  • Meet the prerequisites (record-type schema, primary identity, non-person namespace).
  • Review the lookup entitlement limits before designing a lookup strategy.
  • Monitor lookup ingestion status.
  • Use enabled data with personalization, Decisioning, and journey orchestration.

Glossary:

  • Lookup service: the service that retrieves record-based dataset data at runtime for personalization, Decisioning, and journey orchestration (product-specific)
  • Lookup dataset: a record-based dataset enabled for lookup (product-specific)
  • Primary identity (lookup key): the identity, required on the schema, that acts as the lookup key (product-specific)
  • Record-type schema: the required schema type for lookup — a schema that is NOT of Profile or Event class
  • Edge activation region: the region (for example, NLD2 or VA7) where the dataset’s sandbox resides, for inbound edge-based activation (product-specific)

Guardrails:

  • Enabled Lookup Datasets: maximum 10 per organization, combined across production and development sandboxes (default; if additional volumes are needed, contact your Adobe representative).
  • Dataset Record Count: up to 2 million records per dataset, counted as the total across all batches (default; raisable by contacting your Adobe representative).
  • Record Size: up to 2 KB per record (default maximum record size supported).
  • Dataset Size: up to 4 GB per individual dataset; the record count and dataset size limits are independent guardrails and both must be satisfied (default; raisable by contacting your Adobe representative).
  • Dataset Frequency Updates: up to 5 updates per day per dataset (default; raisable by contacting your Adobe representative).
  • Datasets enabled for lookup should not contain any Personally Identifiable Information (PII).
  • Datasets used in personalization are not protected from deletion; keep track of which datasets are in use.
  • The schema must be record-type (NOT of Profile or Event class) and must have a primary identity defined; if a custom namespace is not defined, the identity must be a non-person identifier.
  • Keep the lookup toggle on; repeatedly turning datasets on and off can lead to unexpected indexing behavior.
  • Datasets enabled for lookup are available for inbound edge-based activation only in the region where the dataset’s sandbox resides.
  • Removing a batch of data completely removes all matching keys from the lookup service.
  • The data lookup capability is in Limited Availability.

Terminology:

  • Canonical name: lookup service — variants: data lookup, enable for lookup
  • API ACTION values: enable OR disable
  • Do not confuse: a “lookup dataset” (record-type, NOT Profile or Event, not stored on the profile) ≠ a profile or event dataset (Profile or Event class)
  • Do not confuse: enabling a dataset for “lookup” ≠ enabling a dataset for “Profile”

FAQ:

  • Q: What schema type is required for a lookup dataset? — A record-type schema that is NOT of Profile or Event class, with a primary identity defined that can act as the lookup key.
  • Q: How many datasets can I enable for lookup? — Up to 10 per organization, combined across production and development sandboxes; contact your Adobe representative for more.
  • Q: What are the record and size limits? — Up to 2 million records and 4 GB per dataset, up to 2 KB per record, and up to 5 updates per day per dataset; the record count and dataset size are independent guardrails that must both be satisfied.
  • Q: Can lookup datasets contain PII? — No; datasets enabled for lookup should not contain any Personally Identifiable Information.
  • Q: What happens if I delete a batch of data? — All matching keys in that batch are completely removed from the lookup service.
  • Q: Should I toggle lookup on and off frequently? — No; repeatedly turning datasets on and off can lead to unexpected indexing behavior, so keep the toggle on while the dataset is in use.
recommendation-more-help
journey-optimizer-help