Zur Überprüfung eines in der Destination SDK erstellten produktisierten Ziels übermitteln

Übersicht

WICHTIG
  • Der hier dokumentierte Prozess ist nur für Partner erforderlich, die produktierte (öffentliche) Ziele übermitteln. Wenn Sie ein privates Ziel für Ihre eigene Verwendung erstellen, müssen Sie diese Materialien nicht produzieren und mit Adobe teilen.

  • Die standardmäßige Antwortzeit von Adobe zur Überprüfung von Ziel-Veröffentlichungsanforderungen beträgt fünf Werktage.

  • Wenn das Adobe-Team nach der ersten Übermittlung darum bittet, Ihre Konfigurationen zu aktualisieren, müssen Sie nach der Aktualisierung eine weitere Ziel-Veröffentlichungsanforderung senden.

  • Selbst wenn Ihr Ziel im Experience Platform-Katalog aktiv ist, müssen Sie, wenn Sie Ihre Konfigurationen aktualisieren müssen, eine neue Ziel-Veröffentlichungsanforderung senden, damit die Aktualisierungen in den Konfigurationen angezeigt werden.

Bevor Ihr Ziel im Experience Platform-Zielkatalog veröffentlicht werden kann, müssen Sie Adobe bestimmte Informationen über das Ziel und die von Ihnen durchgeführten Tests zukommen lassen, um sicherzustellen, dass die Anwender beim Aktivieren von Daten auf Ihrer Plattform die bestmöglichen Ergebnisse erzielen.

Auf dieser Seite sind alle Informationen aufgeführt, die Sie angeben müssen, wenn Sie ein mit dem Adobe Experience Platform Destination SDK erstelltes Ziel übermitteln oder aktualisieren. Um ein Ziel in Adobe Experience Platform erfolgreich zu übermitteln, senden Sie eine E-Mail an aepdestsdk@adobe.com, die folgende Informationen enthält:

  • Eine Beschreibung der Anwendungsfälle, die Ihr Ziel löst. Dies ist nur erforderlich, wenn Sie eine neue Zielkonfiguration übermitteln.
  • Eine Beschreibung des Grundes für die Zielübermittlung. Dies ist nur erforderlich, wenn Sie eine vorhandene Zielkonfiguration aktualisieren.
  • Testergebnisse nach Verwendung des Destination API-Endpunkts zum Ausführen eines HTTP-Aufrufs an Ihr Ziel. Geben Sie an Adobe einen API-Aufruf für Ihren Ziel-Endpunkt und die API-Antwort weiter, die Sie von Ihrem Ziel-Endpunkt erhalten haben.
  • Zusätzliche Anforderungen für dateibasierte Ziele:
    • Geben Sie nach Verwendung der Test-API eine Anfrage und ein Antwort-Beispiel für Testen Ihres dateibasierten Ziels mit Beispielprofilen.
    • Fügen Sie eine Beispieldatei an, die von Ihrem Ziel generiert und an Ihren Speicherort exportiert wurde.
    • Senden Sie eine Form des Nachweises, dass Sie die exportierte Datei erfolgreich vom Speicherort in Ihr System aufgenommen haben.
  • Nachweis, dass Sie eine Anfrage zur Veröffentlichung eines Ziels für Ihr Ziel mithilfe der Zielveröffentlichungs-API übermittelt haben.
  • Eine Dokumentation-PR (Pull-Anforderung) entsprechend den Anweisungen im Abschnitt Self-Service-Dokumentationsprozess.
  • Eine Grafikdatei, die als Logo für Ihre Zielkarte im Zielkatalog von Experience Platform angezeigt werden soll.

Detaillierte Informationen zu den einzelnen Elementen finden Sie in den folgenden Abschnitten:

Beschreibung der Anwendungsfälle

Geben Sie eine Beschreibung der Anwendungsfälle an, die Ihr Ziel für Experience Platform-Kunden löst. Ihre Beschreibungen können Anwendungsfällen von vorhandenen Partnern ähneln:

  • Pinterest: Erstellen Sie Zielgruppen aus Ihren Kundenlisten, Personen, die Ihre Site besucht haben, oder Personen, die bereits mit Ihren Inhalten in Pinterest interagiert haben.
  • Yahoo Data X: DataX-APIs sind für Advertiser verfügbar, die eine bestimmte Zielgruppen-Gruppe ansprechen möchten, die von E-Mail-Adressen in Verizon Media (VMG) abgeleitet wurde. Diese können schnell ein neues Segment erstellen und die gewünschte Zielgruppe mithilfe der API von VMGs nahezu in Echtzeit übertragen.

Grund für die Aktualisierung

HINWEIS

Dieser Abschnitt ist nur erforderlich, wenn Sie eine vorhandene Konfiguration aktualisieren.

Geben Sie eine kurze Beschreibung des Problems, das Ihre Übermittlung für das vorhandene Ziel löst. Beispielsweise könnte Ihre Übermittlung den Namen, die Beschreibung und das Logo Ihres Ziels aktualisieren, wenn Sie von der Beta-Version zur allgemeinen Verfügbarkeit wechseln. Oder Ihre Übermittlung kann einen Fehler beheben, der in Ihrer Zielkonfiguration gefunden wurde.

Testergebnisse nach Verwendung der Test-Ziel-API

Stellen Sie Testergebnisse bereit, nachdem Sie den Endpunkt Test-Ziel-API verwendet haben, um einen HTTP-Aufruf an Ihr Ziel durchzuführen. Dazu gehören:

  • Die vollständige API-Anfrage (Kopfzeilen und Hauptteil), die mithilfe der Test-API an Ihren Ziel-Endpunkt gesendet wurde.
  • Die API-Antwort, die von Ihrem Ziel-Endpunkt empfangen wurde.

Ihre Anfrage und Antwort können beispielsweise in etwa wie folgt aussehen:

Anfrage

curl --location --request POST 'https://platform.adobe.io/data/core/activation/authoring/testing/destinationInstance/3e0ac39c-ef14-4101-9fd9-cf0909814510' \
--header 'Content-Type: application/json' \
--header 'Accept: application/json' \
--header 'x-api-key: {API_KEY}' \
--header 'Authorization: Bearer {ACCESS_TOKEN}' \
--header 'x-gw-ims-org-id: {ORG_ID}' \
--header 'x-sandbox-name: {SANDBOX_NAME}' \
--data-raw '{
   "profiles":[
      {
         "segmentMembership":{
            "ups":{
               "374a9a6c-c719-4cdb-a660-155a2838e6d6":{
                  "lastQualificationTime":"2021-05-13T12:16:27.248585Z",
                  "status":"realized"
               },
               "896f8776-9498-47b4-b994-51cb3f61c2c5":{
                  "lastQualificationTime":"2021-05-13T12:16:27.248605Z",
                  "status":"realized"
               }
            }
         },
         "identityMap":{
            "Email":[
               {
                  "id":"Email-iIyJc"
               }
            ],
            "IDFA":[
               {
                  "id":"IDFA-viPAW"
               }
            ],
            "GAID":[
               {
                  "id":"GAID-Bc6LE"
               }
            ],
            "Email_LC_SHA256":[
               {
                  "id":"Email_LC_SHA256-gEOdj"
               }
            ]
         },
         "attributes":{
            "key":{
               "value":"string"
            }
         }
      }
   ]
}'

Antwort

{
   "results":[
      {
         "aggregationKey":{
            "destinationInstanceId":"string",
            "segmentId":"string",
            "segmentStatus":"realized",
            "identityNamespaces":[
               [
                  "email",
                  "phone"
               ]
            ]
         },
         "httpCalls":[
            {
               "traceId":"a06fec2d-a886-4219-8975-4e4b7ed26539",
               "request":{
                  "body":"{ \"attributes\": [  { \"external_id\": \"external_id-h29Fq\"  , \"AdobeExperiencePlatformSegments\": { \"add\": [  \"Nirvana fans\" ,  \"RHCP fans\"   ], \"remove\": [  ] }  ,  \"key\":  \"string\"    }  ] }",
                  "headers":[
                     {
                        "Content-Type":"application/json"
                     }
                  ],
                  "method":"POST",
                  "uri":"https://api.moviestar.com/users/track"
               },
               "response":{
                  "body":"{\"status\": \"success\"}",
                  "code":"200",
                  "headers":[
                     {
                        "Connection":"keep-alive"
                     },
                     {
                        "Content-Type":"application/json"
                     },
                     {
                        "Server":"nginx"
                     },
                     {
                        "Vary":"Origin,Accept-Encoding"
                     },
                     {
                        "transfer-encoding":"chunked"
                     }
                  ]
               }
            }
         ]
      }
   ],
   "inputProfiles":[
      {
         "segmentMembership":{
            "ups":{
               "03fb9938-8537-4b4c-87f9-9c4d413a0ee5":{
                  "lastQualificationTime":"2021-06-17T12:25:12.872039Z",
                  "status":"realized"
               },
               "27e05542-d6a3-46c7-9c8e-d59d50229530":{
                  "lastQualificationTime":"2021-06-17T12:25:12.872042Z",
                  "status":"realized"
               }
            }
         },
         "personalEmail":{
            "address":"john.smith@abc.com"
         },
         "identityMap":{
            "Email":[
               {
                  "id":"Email-iIyJc"
               }
            ],
            "IDFA":[
               {
                  "id":"IDFA-viPAW"
               }
            ],
            "GAID":[
               {
                  "id":"GAID-Bc6LE"
               }
            ],
            "Email_LC_SHA256":[
               {
                  "id":"Email_LC_SHA256-gEOdj"
               }
            ]
         },
         "person":{
            "name":{
               "firstName":"string"
            }
         }
      }
   ]
}

Zusätzliche Anforderungen für dateibasierte Ziele

Bei dateibasierten Zielen müssen Sie einen zusätzlichen Nachweis darüber erbringen, dass Sie Ihr Ziel korrekt eingerichtet haben. Stellen Sie sicher, dass Sie die folgenden Elemente einschließen:

API-Antwort testen

Schließen Sie eine Anfrage und ein Antwort-Beispiel ein, nachdem Sie die Test-API verwendet haben, um Testen Ihres dateibasierten Ziels mit Beispielprofilen.

Exportierte Datei anhängen

In Einsendenummer, fügen Sie eine CSV-Datei an, die von dem von Ihnen eingerichteten Ziel in Ihren Speicherort exportiert wurde.

Nachweis der erfolgreichen Aufnahme

Schließlich müssen Sie eine Form des Nachweises vorlegen, dass die Daten nach dem Export in den von Ihnen angegebenen Speicherort erfolgreich in Ihr System aufgenommen wurden. Bitte geben Sie eine der folgenden Informationen an:

  • Screenshots oder ein kurzes Screenshot-Video, in dem Sie die Datei manuell vom Speicherort abrufen und in Ihr System aufnehmen.
  • Screenshots oder ein kurzes Screenshot-Video, in dem die Benutzeroberfläche Ihres Systems bestätigt, dass der von Experience Platform generierte Dateiname erfolgreich in Ihr System aufgenommen wurde.
  • Loggen Sie Zeilen aus Ihrem System ein, die die Adobe entweder mit dem Dateinamen oder mit den von der Experience Platform generierten Daten korrelieren kann.

Nachweis, dass Sie eine Zielveröffentlichungsanfrage übermittelt haben

Nachdem Sie Ihr Ziel erfolgreich getestet haben, müssen Sie die Zielveröffentlichungs-API verwenden, um das Ziel zur Überprüfung und Veröffentlichung an Adobe zu übermitteln.

Geben Sie die ID der Veröffentlichungsanfrage für Ihr Ziel an. Weitere Informationen zum Abrufen der Veröffentlichungsanfragen-ID finden Sie unter Auflisten der Veröffentlichungsanfragen für Ziele.

Zieldokumentations-PR (Pull-Anfrage) für produktbezogene Integrationen

Wenn Sie ein unabhängiger Software-Anbieter (ISV) oder Systemintegrator (SI) sind und eine produktive Integration, müssen Sie die Self-Service-Dokumentationsprozess , um eine Produktdokumentationsseite für Ihr Ziel zu erstellen. Stellen Sie als Teil des Übermittlungsprozesses die Pull-Anfrage (PR) für Ihre Zieldokumentation bereit.

Der Zielkatalog enthält ein Logo für jede Zielkarte. Fügen Sie in Ihrer E-Mail zur Übermittlung ein Bild mit dem Logo für Ihr Ziel ein.

Die Bildanforderungen sind:

  • Format: SVG
  • Größe: weniger als 2 MB

Herunterladen einer Beispiel-E-Mail

Laden Sie hier eine Beispiel-E-Mail mit allen Informationen herunter, die Sie Adobe zur Verfügung stellen müssen.

Auf dieser Seite