Benutzerdefinierte Personalisierungsverbindung custom-personalization-connection
Ziel-Änderungsprotokoll changelog
Übersicht overview
Richten Sie dieses Ziel ein, damit externe Personalisierungsplattformen, Content-Management-Systeme, Anzeigen-Server und andere Anwendungen, die auf Kunden-Websites ausgeführt werden, Zielgruppeninformationen von Adobe Experience Platform abrufen können.
Voraussetzungen prerequisites
Dieses Ziel erfordert je nach Implementierung eine der folgenden Datenerfassungsmethoden:
- Verwenden Sie die Adobe Experience Platform Web SDK, wenn Sie Daten von Ihrer Website erfassen möchten.
- Verwenden Sie die Adobe Experience Platform MobileSDK, wenn Sie Daten von Ihrer Mobile App erfassen möchten.
- Verwenden Sie die Edge Network-ServerAPI, wenn Sie Web SDK oder Mobile SDK nicht verwenden oder das Benutzererlebnis anhand von Profilattributen personalisieren möchten.
Unterstützte Zielgruppen supported-audiences
In diesem Abschnitt wird beschrieben, welche Arten von Zielgruppen Sie an dieses Ziel exportieren können.
Exporttyp und -häufigkeit export-type-frequency
Herstellen einer Verbindung mit der Datenbank connect
Um eine Verbindung mit diesem Ziel herzustellen, gehen Sie wie im Abschnitt Tutorial zur Zielkonfiguration beschrieben vor.
Verbindungsparameter parameters
Beim Einrichten dieses Ziels müssen Sie die folgenden Informationen angeben:
- Name: Geben Sie den gewünschten Namen für das Ziel ein.
- Beschreibung: Geben Sie eine Beschreibung für das Ziel ein. Hier können Sie beispielsweise erwähnen, für welche Kampagne Sie dieses Ziel verwenden. Dieses Feld ist optional.
- Integrationsalias: Dieser Wert wird als JSON-Objektname an das Experience Platform Web SDK gesendet.
- Datenstrom-ID: Dadurch wird bestimmt, in welchen Datenerfassungsdatenstrom die Zielgruppen in der Antwort auf die Seite aufgenommen werden. Das Dropdown-Menü enthält nur Datenströme, für die die Zielkonfiguration aktiviert ist. Weitere Details finden Sie unter Konfigurieren eines Datenstroms.
Aktivieren von Warnhinweisen enable-alerts
Sie können Warnhinweise aktivieren, um Benachrichtigungen zum Status des Datenflusses zu Ihrem Ziel zu erhalten. Wählen Sie einen Warnhinweis aus der zu abonnierenden Liste aus, um Benachrichtigungen über den Status Ihres Datenflusses zu erhalten. Weitere Informationen zu Warnhinweisen finden Sie im Handbuch zum Abonnieren von Zielwarnhinweisen über die Benutzeroberfläche.
Wenn Sie alle Details für Ihre Zielverbindung eingegeben haben, klicken Sie auf Weiter.
Aktivieren von Zielgruppen für dieses Ziel activate
Anweisungen Aktivieren von Zielgruppen für dieses Ziel finden Sie unterAktivieren von Profilen und Zielgruppen für Edge-Personalisierungsziele“.
Exportierte Daten exported-data
Wenn Sie Tags in Adobe Experience Platform zum Bereitstellen des Experience Platform Web SDK verwenden, nutzen Sie die Funktion send event complete, damit Ihre Aktion mit benutzerdefiniertem Code über eine event.destinations
-Variable verfügt, mit der Sie die exportierten Daten anzeigen können.
Hier finden Sie einen Beispielwert für die event.destinations
-Variable:
[
{
"type":"profileLookup",
"destinationId":"7bb4cb8d-8c2e-4450-871d-b7824f547111",
"alias":"personalizationAlias",
"segments":[
{
"id":"399eb3e7-3d50-47d3-ad30-a5ad99e8ab77"
},
{
"id":"499eb3e7-3d50-47d3-ad30-a5ad99e8ab77"
}
]
}
]
Wenn Sie „Tags nicht zum BereitstellenExperience Platform Web SDK verwenden, verwenden Sie Befehlsantworten um die exportierten Daten anzuzeigen.
Die JSON-Antwort von Adobe Experience Platform kann analysiert werden, um den entsprechenden Integrationsalias des Programms zu finden, das Sie mit Adobe Experience Platform integrieren. Die Zielgruppen-IDs können als Zielgruppenbestimmungsparameter in den Code des Programms übergeben werden. Nachfolgend finden Sie ein Beispiel dafür, wie dies spezifisch für die Zielantwort aussehen würde.
alloy("sendEvent", {
"renderDecisions": true,
"xdm": {
"commerce": {
"order": {
"purchaseID": "a8g784hjq1mnp3",
"purchaseOrderNumber": "VAU3123",
"currencyCode": "USD",
"priceTotal": 999.98
}
}
}
}).then(function(result) {
if(result.destinations) { // Looking to see if the destination results are there
// Get the destination with a particular alias
var personalizationDestinations = result.destinations.filter(x => x.alias == "personalizationAlias")
if(personalizationDestinations.length > 0) {
// Code to pass the audience IDs into the system that corresponds to personalizationAlias
}
var adServerDestinations = result.destinations.filter(x => x.alias == "adServerAlias")
if(adServerDestinations.length > 0) {
// Code to pass the audience IDs into the system that corresponds to adServerAlias
}
}
})
.catch(function(error) {
// Tracking the event failed.
});
Beispielantwort für Benutzerdefinierte Personalization mit Attributen
Bei Verwendung von Benutzerdefinierter Personalization mit) sieht die API-Antwort ähnlich wie im folgenden Beispiel aus.
Der Unterschied zwischen Benutzerdefinierter Personalization mit) und benutzerdefinierter Personalization besteht darin, dass der attributes
-Abschnitt in die API-Antwort aufgenommen wird.
[
{
"type": "profileLookup",
"destinationId": "7bb4cb8d-8c2e-4450-871d-b7824f547130",
"alias": "personalizationAlias",
"attributes": {
"countryCode": {
"value" : "DE"
},
"membershipStatus": {
"value" : "PREMIUM"
}
},
"segments": [
{
"id": "399eb3e7-3d50-47d3-ad30-a5ad99e8ab77"
},
{
"id": "499eb3e7-3d50-47d3-ad30-a5ad99e8ab77"
}
]
}
]
Datennutzung und -Governance data-usage-governance
Alle Adobe Experience Platform-Ziele sind bei der Verarbeitung Ihrer Daten mit Datennutzungsrichtlinien konform. Ausführliche Informationen darüber, wie Adobe Experience Platform Data Governance erzwingt, finden Sie unter Data Governance - Übersicht.