2.3.6 Ziele SDK
Einrichten des Adobe I/O-Projekts
In dieser Übung verwenden Sie Adobe I/O erneut, um die APIs von Adobe Experience Platform abzufragen. Wenn Sie Ihr Adobe I/O-Projekt noch nicht konfiguriert haben, gehen Sie zurück zu Übung 3 in Modul 2.1 und folgen Sie dort den Anweisungen.
Authentifizierung bei Adobe I/O
In dieser Übung verwenden Sie Postman erneut, um die APIs von Adobe Experience Platform abzufragen. Wenn Sie Ihr Postman-Programm noch nicht konfiguriert haben, gehen Sie zurück zu Übung 3 in Modul 2.1 und folgen Sie dort den Anweisungen.
Endpunkt und Format definieren
Für diese Übung benötigen Sie einen Endpunkt, der so konfiguriert werden muss, dass das Qualifizierungsereignis an diesen Endpunkt gestreamt werden kann, wenn eine Zielgruppe qualifiziert ist. In dieser Übung verwenden Sie einen Beispielendpunkt mit https://pipedream.com/requestbin. Wechseln Sie zu https://pipedream.com/requestbin, erstellen Sie ein Konto und dann einen Arbeitsbereich. Nachdem der Arbeitsbereich erstellt wurde, sehen Sie etwas Ähnliches.
Klicken Sie Kopieren, um die URL zu kopieren. Sie müssen diese URL in der nächsten Übung angeben. Die URL in diesem Beispiel lautet https://eodts05snjmjz67.m.pipedream.net.
Für das Format verwenden wir eine Standardvorlage, die Zielgruppenqualifikationen oder -aufhebungen zusammen mit Metadaten wie Kundenkennungen streamt. Vorlagen können so angepasst werden, dass sie den Erwartungen bestimmter Endpunkte entsprechen. In dieser Übung verwenden wir jedoch eine Standardvorlage erneut, was zu einer Payload wie dieser führt, die an den Endpunkt gestreamt wird.
{
"profiles": [
{
"identities": [
{
"type": "ecid",
"id": "64626768309422151580190219823409897678"
}
],
"AdobeExperiencePlatformSegments": {
"add": [
"f58c723c-f1e5-40dd-8c79-7bb4ab47f041"
],
"remove": []
}
}
]
}
Erstellen einer Server- und Vorlagenkonfiguration
Der erste Schritt zum Erstellen eines eigenen Ziels in Adobe Experience Platform besteht darin, eine Server- und Vorlagenkonfiguration mit Postman zu erstellen.
Öffnen Sie dazu Ihre Postman-Anwendung und navigieren Sie zu Zielerstellungs-API, zu Zielserver und Vorlagen und klicken Sie auf , um die Anfrage zu öffnen POST - Erstellen einer Zielserverkonfiguration.
Sie werden es dann sehen. Unter Headers müssen Sie den Wert für den Schlüssel x-sandbox-name manuell aktualisieren und auf --aepSandboxName-- setzen. Wählen Sie den Wert {{SANDBOX_NAME}}.
Ersetzen Sie sie durch --aepSandboxName--.
Gehen Sie dann zu Body. Wählen Sie die {{body}} Platzhalter aus.
Jetzt müssen Sie den Platzhalter {{body}} durch den folgenden Code ersetzen:
{
"name": "Custom HTTP Destination",
"destinationServerType": "URL_BASED",
"urlBasedDestination": {
"url": {
"templatingStrategy": "PEBBLE_V1",
"value": "yourURL"
}
},
"httpTemplate": {
"httpMethod": "POST",
"requestBody": {
"templatingStrategy": "PEBBLE_V1",
"value": "{\n \"profiles\": [\n {%- for profile in input.profiles %}\n {\n \"identities\": [\n {%- for idMapEntry in profile.identityMap -%}\n {%- set namespace = idMapEntry.key -%}\n {%- for identity in idMapEntry.value %}\n {\n \"type\": \"{{ namespace }}\",\n \"id\": \"{{ identity.id }}\"\n }{%- if not loop.last -%},{%- endif -%}\n {%- endfor -%}{%- if not loop.last -%},{%- endif -%}\n {% endfor %}\n ],\n \"AdobeExperiencePlatformSegments\": {\n \"add\": [\n {%- for segment in profile.segmentMembership.ups | added %}\n \"{{ segment.key }}\"{%- if not loop.last -%},{%- endif -%}\n {% endfor %}\n ],\n \"remove\": [\n {#- Alternative syntax for filtering segments by status: -#}\n {% for segment in removedSegments(profile.segmentMembership.ups) %}\n \"{{ segment.key }}\"{%- if not loop.last -%},{%- endif -%}\n {% endfor %}\n ]\n }\n }{%- if not loop.last -%},{%- endif -%}\n {% endfor %}\n ]\n}"
},
"contentType": "application/json"
}
}
Nach dem Einfügen des obigen Codes müssen Sie das Feld urlBasedDestination.url.value manuell aktualisieren und es auf die URL des Webhooks festlegen, den Sie im vorherigen Schritt erstellt haben, der in diesem Beispiel https://eodts05snjmjz67.m.pipedream.net wurde.
Nach der Aktualisierung des Felds urlBasedDestination.url.value sollte es wie folgt aussehen. Klicken Sie auf Senden.
access_token. Um einen gültigen access_token abzurufen, führen Sie die Anfrage POST - Zugriffs-Token abrufen in der Sammlung Adobe IO - OAuth aus.Nachdem Sie auf Senden geklickt haben, wird Ihre Server-Vorlage erstellt und als Teil der Antwort wird ein Feld mit dem Namen instanceId angezeigt. Schreibe es auf, da du es im nächsten Schritt benötigst. In diesem Beispiel lautet die instanceId52482c90-8a1e-42fc-b729-7f0252e5cebd.
Erstellen der Zielkonfiguration
Gehen Sie in Postman unter Zielerstellungs-) zu Zielkonfigurationen und klicken Sie darauf, um die Anfrage zu öffnen POST - Zielkonfiguration erstellen. Sie werden es dann sehen. Unter Headers müssen Sie den Wert für den Schlüssel x-sandbox-name manuell aktualisieren und auf --aepSandboxName-- setzen. Wählen Sie den Wert {{SANDBOX_NAME}} aus und ersetzen Sie ihn durch --aepSandboxName--.
Gehen Sie dann zu Body. Wählen Sie die {{body}} Platzhalter aus.
Jetzt müssen Sie den Platzhalter {{body}} durch den folgenden Code ersetzen:
{
"name": "--aepUserLdap-- - Webhook",
"description": "Exports segment qualifications and identities to a custom webhook via Destination SDK.",
"status": "TEST",
"customerAuthenticationConfigurations": [
{
"authType": "BEARER"
}
],
"customerDataFields": [
{
"name": "endpointsInstance",
"type": "string",
"title": "Select Endpoint",
"description": "We could manage several instances across the globe for REST endpoints that our customers are provisioned for. Select your endpoint in the dropdown list.",
"isRequired": true,
"enum": [
"US",
"EU",
"APAC",
"NZ"
]
}
],
"uiAttributes": {
"documentationLink": "https://experienceleague.adobe.com/docs/experience-platform/destinations/home.html?lang=de",
"category": "streaming",
"connectionType": "Server-to-server",
"frequency": "Streaming"
},
"identityNamespaces": {
"ecid": {
"acceptsAttributes": true,
"acceptsCustomNamespaces": false
}
},
"segmentMappingConfig": {
"mapExperiencePlatformSegmentName": true,
"mapExperiencePlatformSegmentId": true,
"mapUserInput": false
},
"aggregation": {
"aggregationType": "BEST_EFFORT",
"bestEffortAggregation": {
"maxUsersPerRequest": "1000",
"splitUserById": false
}
},
"schemaConfig": {
"profileRequired": false,
"segmentRequired": true,
"identityRequired": true
},
"destinationDelivery": [
{
"authenticationRule": "NONE",
"destinationServerId": "yourTemplateInstanceID"
}
]
}
Nach dem Einfügen des obigen Codes müssen Sie das Feld "" manuell aktualisieren. destinationServerId festgelegt und auf die instanceId der Ziel-Server-Vorlage festgelegt werden muss, die Sie im vorherigen Schritt erstellt haben, der in diesem Beispiel 52482c90-8a1e-42fc-b729-7f0252e5cebd wurde. Klicken Sie anschließend auf Senden.
Sie werden dann diese Antwort sehen.
Ihr Ziel wird jetzt in Adobe Experience Platform erstellt. Lassen Sie uns hingehen und es überprüfen.
Zu Adobe Experience Platform. Nach dem Login landen Sie auf der Homepage von Adobe Experience Platform.
Bevor Sie fortfahren, müssen Sie eine Sandbox“. Die auszuwählende Sandbox hat den Namen --aepSandboxName--. Nach Auswahl der entsprechenden Sandbox wird der Bildschirm geändert und Sie befinden sich nun in Ihrer dedizierten Sandbox.
Gehen Sie im linken Menü zu Ziele, klicken Sie auf Katalog und blättern Sie nach unten zur Kategorie Streaming. Ihr Ziel ist jetzt dort verfügbar.
Verknüpfen Ihrer Audience mit Ihrem Ziel
Klicken unter > Katalog auf Einrichten auf Ihrem Ziel, um Zielgruppen zu Ihrem neuen Ziel hinzuzufügen.
Geben Sie einen zufälligen Wert für das Bearer-Token ein, z. B 1234. Klicken Sie Mit Ziel verbinden.
Sie werden es dann sehen. Verwenden Sie --aepUserLdap-- - Webhook als Namen für Ihr Ziel. Wählen Sie einen Endpunkt Ihrer Wahl aus, in diesem Beispiel EU. Klicken Sie auf Weiter.
Sie können optional eine Data-Governance-Richtlinie auswählen. Klicken Sie auf Weiter.
Wählen Sie die zuvor erstellte Zielgruppe mit dem Namen --aepUserLdap-- - Interest in Galaxy S24 aus. Klicken Sie auf Weiter.
Sie werden es dann sehen. Stellen Sie sicher, dass Sie die --aepTenantId--.identification.core.ecid SOURCE der Identity: ecid zuordnen. Klicken Sie auf Weiter.
Klicken Sie auf Fertigstellen.
Ihr Ziel ist jetzt live, neue Zielgruppenqualifikationen werden jetzt an Ihren benutzerdefinierten Webhook gestreamt.
Testen der Zielgruppenaktivierung
Navigieren Sie zu https://dsn.adobe.com. Nachdem Sie sich mit Ihrer Adobe ID angemeldet haben, sehen Sie Folgendes. Klicken Sie auf die 3 Punkte … in Ihrem Website-Projekt und dann auf Ausführen, um es zu öffnen.
Anschließend wird Ihre Demo-Website geöffnet. Wählen Sie die URL aus und kopieren Sie sie in die Zwischenablage.
Öffnen Sie ein neues Inkognito-Browser-Fenster.
Fügen Sie die URL Ihrer Demo-Website ein, die Sie im vorherigen Schritt kopiert haben. Sie werden dann aufgefordert, sich mit Ihrer Adobe ID anzumelden.
Wählen Sie Ihren Kontotyp aus und schließen Sie den Anmeldevorgang ab.
Ihre Website wird dann in einem Inkognito-Browser-Fenster geladen. Für jede Übung müssen Sie ein neues Inkognito-Browser-Fenster verwenden, um Ihre Demo-Website-URL zu laden.
In diesem Beispiel möchten Sie einer bestimmten Kundin oder einem bestimmten Kunden antworten, die bzw. der sich ein bestimmtes Produkt ansieht.
Gehen Sie auf der Citi Signal-Homepage zu Telefone & Geräte und klicken Sie auf das Produkt Galaxy S24.
Die Produktseite für Galaxy S24 wurde jetzt angezeigt, sodass sich Ihre Zielgruppe in den nächsten Minuten für Ihr Profil qualifiziert.
Wenn Sie den Profil-Viewer öffnen und zu Zielgruppen wechseln, sehen Sie, dass die Zielgruppe qualifiziert ist.
Gehen Sie nun zurück zu Ihrem geöffneten Webhook auf https://eodts05snjmjz67.m.pipedream.net, wo eine neue eingehende Anfrage angezeigt werden sollte, die von Adobe Experience Platform stammt und das Zielgruppen-Qualifizierungsereignis enthält.
Nächste Schritte
Wechseln Sie zu Zusammenfassung und Vorteile
Kehren Sie zu Real-Time CDP - Zielgruppe aufbauen und Maßnahmen ergreifen
Zurück zu Alle Module