Benutzerdefinierte Personalisierungsverbindung custom-personalization-connection

Ziel-Änderungsprotokoll changelog

Veröffentlichungsmonat
Art der Aktualisierung
Beschreibung
Mai 2023
Funktions- und Dokumentationsaktualisierung
Ab Mai 2023 wird die Benutzerdefinierte Personalisierung Verbindungsunterstützung attributbasierte Personalisierung und ist allgemein für alle Kunden verfügbar.
IMPORTANT
Profilattribute können vertrauliche Daten enthalten. Zum Schutz dieser Daten müssen Sie die Variable Edge Network Server-API bei der Konfiguration der Benutzerdefinierte Personalisierung Ziel für attributbasierte Personalisierung. Alle Server-API-Aufrufe müssen in einem authentifizierter Kontext.
Wenn Sie bereits Web SDK oder Mobile SDK für Ihre Integration verwenden, können Sie Attribute über die Server-API abrufen, indem Sie eine serverseitige Integration hinzufügen.
Wenn Sie die obigen Anforderungen nicht erfüllen, basiert die Personalisierung nur auf der Zielgruppenmitgliedschaft.

Ü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, Zielgruppendaten aus Adobe Experience Platform abrufen können.

Voraussetzungen prerequisites

Diese Integration basiert auf dem Adobe Experience Platform Web SDK oder Adobe Experience Platform Mobile SDK. Sie müssen eines dieser SDKs verwenden, um dieses Ziel verwenden zu können.

IMPORTANT
Lesen Sie vor der Erstellung einer benutzerdefinierten Personalisierungsverbindung das Handbuch zum Aktivieren von Zielgruppendaten für Edge-Personalisierungsziele. In dieser Anleitung werden die erforderlichen Konfigurationsschritte für die Anwendungsfälle der Personalisierung derselben Seite und der nächsten Seite für mehrere Experience Platform-Komponenten erläutert.

Unterstützte Zielgruppen supported-audiences

In diesem Abschnitt wird beschrieben, welche Zielgruppentypen Sie an dieses Ziel exportieren können.

Audience Origin
Unterstützt
Beschreibung
Segmentation Service
Über die Experience Platform generierte Zielgruppen Segmentierungsdienst.
Benutzerdefinierte Uploads
Zielgruppen, die aus CSV-Dateien in Experience Platform importiert werden.

Exporttyp und -häufigkeit export-type-frequency

Element
Typ
Anmerkungen
Exporttyp
Profile request
Sie fordern alle Zielgruppen an, die im benutzerdefinierten Personalisierungsziel für ein einzelnes Profil zugeordnet sind. Für verschiedene Adobe-Datenerfassungsdatenströme können verschiedene benutzerdefinierte Personalisierungsziele eingerichtet werden.
Exporthäufigkeit
Streaming
Streaming-Ziele sind „immer verfügbare“ API-basierte Verbindungen. Sobald ein Profil in Experience Platform auf der Grundlage einer Zielgruppenauswertung aktualisiert wird, sendet der Connector das Update nachgelagert an die Zielplattform. Lesen Sie mehr über Streaming-Ziele.

Herstellen einer Verbindung mit der Datenbank connect

IMPORTANT
Um eine Verbindung zum Ziel herzustellen, benötigen Sie die Ziele anzeigen und Ziele verwalten Zugriffssteuerungsberechtigungen. Lesen Sie die Übersicht über die Zugriffskontrolle oder wenden Sie sich an Ihren Produktadministrator, um die erforderlichen Berechtigungen zu erhalten.

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.
  • Datenspeicher-ID: Dadurch wird bestimmt, in welchem Datenerfassungsdatenstrom die Zielgruppen in die 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

IMPORTANT
Um Daten zu aktivieren, benötigen Sie die Ziele anzeigen, Ziele aktivieren, Anzeigen von Profilen, und Segmente anzeigen Zugriffssteuerungsberechtigungen. Lesen Sie die Übersicht über die Zugriffssteuerung oder wenden Sie sich an Ihre Produktadmins, um die erforderlichen Berechtigungen zu erhalten.

Lesen Edge-Personalisierungsziele für Profile und Zielgruppen aktivieren für Anweisungen zum Aktivieren von Zielgruppen für dieses Ziel.

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 die Tags Verwenden Sie zum Bereitstellen des Experience Platform Web SDK 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 Targeting-Parameter in den Code der Anwendung ü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 Personalisierung mit Attributen

Bei Verwendung von Benutzerdefinierte Personalisierung mit Attributen, sieht die API-Antwort ähnlich wie im folgenden Beispiel aus.

Der Unterschied zwischen Benutzerdefinierte Personalisierung mit Attributen und Benutzerdefinierte Personalisierung ist die Aufnahme der attributes in der API-Antwort.

[
    {
        "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.

recommendation-more-help
7f4d1967-bf93-4dba-9789-bb6b505339d6