Benutzerdefinierte Personalization-Verbindung custom-personalization-connection

Ziel-Änderungsprotokoll changelog

Verwenden Sie dieses Änderungsprotokoll, um Aktualisierungen am benutzerdefinierten Personalization-Ziel zu verfolgen.

Überblick 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:

Unterstützte Zielgruppen supported-audiences

In der folgenden Tabelle sind die Zielgruppentypen aufgeführt, die Sie an dieses Ziel exportieren können.

Unterstützte Zielgruppen nach Zielgruppen-Datentyp:

Exporttyp und -häufigkeit export-type-frequency

Die folgende Tabelle beschreibt den Exporttyp und die Häufigkeit für dieses Ziel.

Herstellen einer Verbindung mit dem Ziel 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:

Aktivieren von Warnhinweisen enable-alerts

Aktivieren Sie Warnhinweise, um Benachrichtigungen zum Status Ihres Datenflusses zu diesem 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 mit dem Eingeben der Details für Ihre Zielverbindung fertig sind, wählen Sie Next aus.

Aktivieren von Zielgruppen für dieses Ziel activate

Anweisungen ​ Aktivieren von Zielgruppen für dieses Ziel finden Sie unter „Aktivieren von Profilen ​ Zielgruppen für Edge-Personalisierungsziele“.

Exportierte Daten exported-data

Wenn Sie „Tags ​ Adobe Experience Platform" zum Bereitstellen ​ Experience Platform Web SDK verwenden, verwenden Sie die Funktion send event complete. Ihre Aktion mit benutzerdefiniertem Code verfügt über eine event.destinations Variable, 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 Bereitstellen ​ Experience Platform Web SDK verwenden, verwenden Sie Befehlsantworten um die exportierten Daten anzuzeigen.

Analysieren Sie die JSON-Antwort von Adobe Experience Platform, um den Integrationsalias des Programms zu finden, das Sie mit Adobe Experience Platform integrieren. Übergeben Sie die Zielgruppen-IDs als Targeting-Parameter in den Code des Programms. Nachfolgend finden Sie ein Beispiel dafür, wie dies spezifisch für die Zielantwort aussieht.

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 example-response-attributes

Bei Verwendung von Custom Personalization With Attributes sieht die API-Antwort ähnlich wie im folgenden Beispiel aus.

Der Unterschied zwischen Custom Personalization With Attributes und Custom Personalization besteht in der Aufnahme des attributes Abschnitts in die 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.