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

Übersicht overview

IMPORTANT
  • Der hier dokumentierte Prozess ist nur für Partner erforderlich, die produktierte (öffentliche) Ziele übermitteln. Wenn Sie ein privates Ziel für Ihren eigenen Gebrauch erstellen, müssen Sie diese Materialien nicht herstellen und mit Adobe teilen.

  • Die standardmäßige Antwortzeit von Adobe zur Überprüfung des Ziels 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 live 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.

  • Die Zeitleiste der Überprüfung und die erforderlichen Artefakte sind für neue Ziele und vorhandene Ziele, die Sie aktualisieren, identisch.

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 die 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 Beispiel für eine Antwort an Testen Sie Ihr dateibasiertes Ziel 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-Anfrage) entsprechend den Anweisungen, die im Self-Service-Dokumentationsprozess beschrieben sind.

  • 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 use-case-description

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 Audiences 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 Zielgruppe mit E-Mail-Adressen in Verizon Media (VMG) ansprechen möchten, um schnell eine neue Zielgruppe zu erstellen und die gewünschte Zielgruppe mithilfe der nahezu Echtzeit-API von VMG zu übertragen.

Grund für die Aktualisierung reason-for-update

NOTE
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 testing-api-response

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 additional-file-based-destination-requirements

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 testing-api-response-file-based

Schließen Sie eine Anfrage und ein Beispiel für eine Antwort ein, nachdem Sie die Test-API verwendet haben, um Ihr dateibasiertes Ziel mit Beispielprofilen zu testen🔗.

Exportierte Datei anhängen attach-exported-file

Hängen Sie in Ihrer Sende-E-Mail eine CSV-Datei an, die von dem von Ihnen eingerichteten Ziel an Ihren Speicherort exportiert wurde.

Nachweis der erfolgreichen Aufnahme proof-of-successful-ingestion

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 Adobe entweder mit dem Dateinamen oder mit den von Experience Platform generierten Daten korrelieren kann.

Nachweis, dass Sie eine Zielveröffentlichungsanfrage übermittelt haben destination-publishing-request-proof

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. Informationen zum Abrufen der Veröffentlichungsanfrage-ID finden Sie unter Abrufen von Ziel-Veröffentlichungsanforderungen.

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

Wenn Sie ein unabhängiger Software-Anbieter (ISV) oder Systemintegrator (SI) sind und eine produktierte Integration erstellen, müssen Sie den Self-Service-Dokumentationsprozess verwenden, 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 download-sample-email

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

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