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

Verwenden von Adobe Experience Platform-Daten aep-data

AVAILABILITY
Diese Funktion steht derzeit allen Kunden als eingeschränkte Verfügbarkeitsversion zur Verfügung.

Mit Journey Optimizer können Sie Daten aus Adobe Experience Platform-Daten mit Personalisierungs- und Entscheidungsfunktionen nutzen. Dazu müssen datensatzbasierte Datensätze, die für die Lookup-Personalisierung erforderlich sind, zunächst für den Lookup-Service aktiviert werden, wie unten beschrieben.

Wichtige Informationen

Leitplanken und Richtlinien guidelines

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

  • Datensätze, die für die Suche aktiviert sind, sollten keine personenbezogenen Daten enthalten.
  • Datensätze, die für die Suche aktiviert und in der Personalisierung verwendet werden, sind nicht vor dem Löschen geschützt. Sie müssen den Überblick darüber behalten, welche Datensätze für die Personalisierung verwendet werden, um sicherzustellen, dass sie nicht gelöscht oder entfernt werden.
  • Datensätze müssen mit einem Schema verknüpft sein, das NICHT vom Typ „Profil“ oder „Ereignis“ ist.
  • Schemata müssen eine primäre Identität aufweisen. Für die Suche kann nur ein einziger Primärschlüssel verwendet werden.

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 jederzeit für die Suche konfiguriert werden können. Diese Begrenzung gilt für die Gesamtzahl der kombinierten Lookup-Datensätze in Produktions- und Entwicklungs-Sandboxes innerhalb der Kundeninstanz.
Anzahl der Datensätze
Bis zu 2 Millionen Datensätze pro Datensatz
Maximal zulässige Anzahl von Datensätzen in einem einzelnen Datensatz, berechnet als Gesamtanzahl aller Batches innerhalb dieses Datensatzes.
Datensatzgröße
Bis zu 2 KB pro Datensatz
Standardmäßig unterstützte maximale Datensatzgröß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 Datensatzanzahl und der Datensatzgröße sind unabhängige Leitplanken - beide müssen erfüllt sein.
Aktualisierungen der Datensatzfrequenz
Bis zu 5 Aktualisierungen pro Tag pro Datensatz
Maximal zulässige Häufigkeit von Aktualisierungsvorgängen für einen einzelnen Datensatz pro Tag.
NOTE
Wenn über die oben aufgeführten Leitplanken hinaus zusätzliche Volumes benötigt werden, wenden Sie sich an den Adobe-Support.

Weitere Überlegungen zur Leistung

Die folgenden Empfehlungen geben Hinweise, wie Sie Verzögerungen bei der Zustellbarkeit vermeiden können:

Hinweis
Empfohlenes Limit
Beschreibung
Attribute pro Suche
Bis zu 20
Anzahl der pro Datensatz in einer einzigen Suchaktivität abgerufenen Datenfelder.
Aktivitäten nachschlagen
Bis zu 5 pro Journey
Jede Journey kann bis zu 5 verschiedene Lookup-Aktivitäten enthalten. Bei jeder Suche kann ein anderer Datensatz ausgewählt werden.

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 Datensatz 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.

NOTE
Es wird empfohlen, den Datensatz NICHT auch für das Profil zu aktivieren, da dies zu einer Erhöhung der Profilreichhaltigkeit führen kann und nicht erforderlich ist, um die Suchen durchzuführen.

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 Lookup-Schlü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:

  • URL ist https://platform.adobe.io/data/core/entity/lookup/dataSets/${DATASET_ID}/${ACTION}
  • Die Datensatz-ID ist der Datensatz, für den Sie aktivieren möchten.
  • Aktion ist „Aktivieren“ ODER „Deaktivieren“.
  • Das Zugriffstoken kann über die Entwicklerkonsole abgerufen werden.
  • Der API-Schlüssel kann über die Entwicklerkonsole abgerufen werden.
  • Die IMS-Organisations-ID ist Ihre Adobe-Organisation.
  • Sandbox-Name ist der Name der Sandbox, in der sich der Datensatz befindet (d. h. Produktion, Entwicklung usw.).
NOTE
Wenn beim Versuch, einen API-Aufruf zum Aktivieren von Datensätzen durchzuführen, der unten stehende Fehler auftritt, entfernen Sie die Adobe Journey Optimizer-APIs aus Ihrem Entwicklerkonsolen-Projekt und fügen Sie sie dann erneut hinzu:
"error_code": "403003",
"message": "Api Key is invalid"

Datensatzüberwachung

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

Diese Prozessanzeige hilft zu verstehen, wenn neue Datenstapel im Lookup-Service verfügbar sind.

Nächste Schritte

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

recommendation-more-help
b22c9c5d-9208-48f4-b874-1cefb8df4d76