YourDestination connection your-destination

Wenn Sie diese Vorlage durchlaufen, ersetzen oder löschen Sie alle kursiv gedruckten Absätze (beginnend mit dieser).

Aktualisieren Sie zunächst die Metadaten (Titel und Beschreibung) oben auf der Seite. Bitte ignorieren Sie alle UICONTROL Instanzen auf dieser Seite. Dies ist ein Tag, das unseren maschinellen Übersetzungsprozessen hilft, die Seite korrekt in die verschiedenen Sprachen zu übersetzen, die wir unterstützen. Wir fügen Ihrer Dokumentation Tags hinzu, nachdem Sie sie gesendet haben.

IMPORTANT
  • Füllen Sie alle Abschnitte in dieser Vorlage in der Reihenfolge aus, in der sie in der Vorlage beschrieben sind.
  • Diese Vorlage wird aufgrund des Partner-Feedbacks gelegentlich aktualisiert. Bevor Sie mit der Erstellung der Dokumentation für Ihr Ziel beginnen, stellen Sie sicher, dass Sie die aktuelle Version der Vorlage heruntergeladen haben.

Übersicht overview

Bieten Sie einen kurzen Überblick über Ihr Unternehmen, einschließlich des Werts, den es Kunden bietet. Fügen Sie einen Link zu Ihrer Homepage für die Produktdokumentation hinzu, um ihn weiter zu lesen.

IMPORTANT
Dieser Ziel-Connector und die Dokumentationsseite werden vom YourDestination-Team erstellt und gepflegt. Bei Fragen oder Aktualisierungsanfragen wenden Sie sich bitte direkt an Link oder E-Mail-Adresse einfügen, an die Sie zur Aktualisierung gelangen können, z. B. support@YourDestination.com.

Anwendungsfälle use-cases

Um Ihnen zu helfen, besser zu verstehen, wie und wann Sie das Ziel YourDestination verwenden sollten, finden Sie hier Beispielanwendungsfälle, die Adobe Experience Platform-Kunden mit diesem Ziel lösen können.

Anwendungsfall 1 use-case-1

Für mobile Messaging-Plattformen:

Eine Heimmiet- und Verkaufsplattform möchte mobile Benachrichtigungen an die Android- und iOS-Geräte von Kunden senden, um ihnen mitzuteilen, dass es 100 aktualisierte Listen in dem Bereich gibt, in dem sie zuvor nach einer Vermietung gesucht haben.

Anwendungsfall 2 use-case-2

Für soziale Netzwerkplattformen:

Eine Sportbekleidungsmarke möchte bestehende Kunden über ihre Social-Media-Konten erreichen. Die Bekleidungsmarke kann E-Mail-Adressen aus ihrem eigenen CRM-System in Adobe Experience Platform erfassen, Zielgruppen aus ihren eigenen Offline-Daten erstellen und diese Zielgruppen an YourDestination senden, um Anzeigen in den Social-Media-Feeds ihrer Kunden anzuzeigen.

Voraussetzungen prerequisites

Fügen Sie in diesem Abschnitt Informationen zu allen Elementen hinzu, die Kunden beachten müssen, bevor sie mit der Einrichtung des Ziels in der Adobe Experience Platform-Benutzeroberfläche beginnen. Dies kann ungefähr sein:

  • muss einer Zulassungsliste hinzugefügt werden
  • Anforderungen für E-Mail-Hashing
  • alle Kontospezifikationen auf Ihrer Seite
  • Abrufen eines API-Schlüssels für die Verbindung mit Ihrer Plattform

Sie können eine Verknüpfung zu Ihrer relevanten Dokumentation herstellen, wenn dies für Kunden nützlich wäre.

Unterstützte Identitäten supported-identities

Fügen Sie in diesem Abschnitt Informationen zu den von Ihrem Ziel unterstützten Identitäten hinzu. Wir haben die Tabelle mit einigen Standardwerten vorausgefüllt. Löschen Sie die Werte, die nicht auf Ihr Ziel zutreffen, und/oder fügen Sie Werte hinzu, die nicht vorausgefüllt sind.

YourDestination unterstützt die Aktivierung von Identitäten, die in der folgenden Tabelle beschrieben sind. Erhalten Sie weitere Informationen zu Identitäten.

Ziel-Identität
Beschreibung
Zu beachten
GAID
GOOGLE ADVERTISING ID
Wählen Sie die GAID-Zielidentität aus, wenn Ihre Quellidentität ein GAID-Namespace ist.
IDFA
Apple ID für Advertiser
Wählen Sie die IDFA-Zielidentität aus, wenn Ihre Quellidentität ein IDFA-Namespace ist.
ECID
Experience Cloud ID
Ein Namespace, der die ECID darstellt. Dieser Namespace kann auch durch die folgenden Aliase referenziert werden: „Adobe Marketing Cloud ID“, „Adobe Experience Cloud ID“, „Adobe Experience Platform ID“. Weitere Informationen finden Sie im folgenden Dokument unter ECID .
phone_sha256
Telefonnummern, die mit dem SHA256-Algorithmus gehasht wurden
Es werden sowohl einfache als auch SHA256-Hash-Telefonnummern von Adobe Experience Platform unterstützt. Wenn Ihr Quellfeld ungehashte Attribute enthält, überprüfen Sie die Option Umwandlung anwenden, damit Platform die Daten bei Aktivierung automatisch hasht.
email_lc_sha256
E-Mail-Adressen, die mit dem SHA-256-Algorithmus gehasht wurden
Es werden sowohl Nur-Text- als auch SHA256-Hash-E-Mail-Adressen von Adobe Experience Platform unterstützt. Wenn Ihr Quellfeld ungehashte Attribute enthält, überprüfen Sie die Option Umwandlung anwenden, damit Platform die Daten bei Aktivierung automatisch hasht.
extern_id
Benutzerdefinierte Benutzer-IDs
Wählen Sie diese Zielidentität aus, wenn Ihre Quellidentität ein benutzerdefinierter Namespace ist.

Unterstützte Zielgruppen supported-audiences

Fügen Sie in diesem Abschnitt Informationen zu den von Ihrem Ziel unterstützten Zielgruppen hinzu. Wir haben die Tabelle mit einigen Standardwerten vorausgefüllt. Verwenden Sie die Zeichen und X, um zu kennzeichnen, ob Ihr Zielgruppentyp von diesem Ziel unterstützt wird.

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

Audience Origin
Unterstützt
Beschreibung
Segmentation Service
Zielgruppen, die durch den Experience Platform Segmentierungsdienst generiert wurden.
Benutzerdefinierte Uploads
X
Zielgruppen, die aus CSV-Dateien in Experience Platform importiert werden.

Exporttyp und -häufigkeit export-type-frequency

Behalten Sie in der Tabelle nur die Zeilen bei, die Ihrem Ziel entsprechen. Sie sollten eine Zeile für den Exporttyp und eine Zeile für die Exporthäufigkeit haben. Löschen Sie die Werte, die nicht auf Ihr Ziel zutreffen.

Beziehen Sie sich auf die folgende Tabelle, um Informationen zu Typ und Häufigkeit des Zielexports zu erhalten.

Element
Typ
Anmerkungen
Exporttyp
Zielgruppenexport
Sie exportieren alle Mitglieder einer Zielgruppe mit den IDs (Name, Telefonnummer oder andere), die im Ziel YourDestination verwendet werden.
Exporttyp
Profilbasiert
Sie exportieren alle Mitglieder einer Zielgruppe zusammen mit den gewünschten Schemafeldern (z. B. E-Mail-Adresse, Telefonnummer, Nachname), wie im Bildschirm Profilattribute auswählen des Zielaktivierungs-Workflows ausgewählt.
Exporttyp
Datensatzexport
Sie exportieren Rohdatensätze, die nicht nach Zielgruppeninteressen oder Qualifikationen gruppiert oder strukturiert sind.
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.
Exporthäufigkeit
Batch
Batch-Ziele exportieren Dateien in Schritten von drei, sechs, acht, zwölf oder vierundzwanzig Stunden auf nachgelagerte Plattformen. Weitere Informationen finden Sie unter Batch-Datei-basierte Ziele.

Herstellen einer Verbindung mit dem Ziel connect

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

Um eine Verbindung mit diesem Ziel herzustellen, gehen Sie wie im Tutorial zur Zielkonfiguration beschrieben vor. Füllen Sie im Workflow zum Konfigurieren des Ziels die Felder aus, die in den beiden folgenden Abschnitten aufgeführt sind.

Beim Ziel authentifizieren authenticate

Fügen Sie die Felder hinzu, die Kunden bei der Authentifizierung für Ihr Ziel ausfüllen müssen. Diese Felder sind zielspezifisch und hängen von Ihrer Konfiguration in Destination SDK ab. Die Felder Ihres Ziels entsprechen möglicherweise nicht den unten aufgeführten. Bitte fügen Sie auch einen Screenshot hinzu, der dem unten gezeigten Beispiel-Screenshot ähnelt.

Um sich beim Ziel zu authentifizieren, füllen Sie die erforderlichen Felder aus und klicken Sie auf Mit Ziel verbinden.

Beispiel-Screenshot, der zeigt, wie die Authentifizierung für das Ziel erfolgt

  • Bearer-Token: Füllen Sie das Bearer-Token aus, um sich beim Ziel zu authentifizieren.

Ausfüllen der Zieldetails destination-details

Fügen Sie die Felder hinzu, die Kunden beim Konfigurieren eines neuen Ziels ausfüllen müssen. Diese Felder sind zielspezifisch und hängen von Ihrer Konfiguration in Destination SDK ab. Die Felder Ihres Ziels entsprechen möglicherweise nicht den unten aufgeführten. Bitte fügen Sie auch einen Screenshot hinzu, der dem unten gezeigten Beispiel-Screenshot ähnelt.

Füllen Sie die folgenden erforderlichen und optionalen Felder aus, um Details für das Ziel zu konfigurieren. Ein Sternchen neben einem Feld in der Benutzeroberfläche zeigt an, dass das Feld erforderlich ist.

Beispiel-Screenshot, der zeigt, wie Details für Ihr Ziel ausgefüllt werden

  • Name: Ein Name, durch den Sie dieses Ziel in Zukunft erkennen können.
  • Beschreibung: Eine Beschreibung, die Ihnen hilft, dieses Ziel in Zukunft zu identifizieren.
  • Konto-ID: Ihre IhrZiel Konto-ID.

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 Warnhinweisen zu Zielen ü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 Zugriffssteuerungsberechtigungen Ziele anzeigen, Ziele aktivieren, Profile anzeigen und Segmente anzeigen .Lesen Sie die Übersicht über die Zugriffssteuerung oder wenden Sie sich an Ihre Produktadmins, um die erforderlichen Berechtigungen zu erhalten.
  • Um identities zu exportieren, benötigen Sie die Zugriffssteuerungsberechtigung Identitätsdiagramm anzeigen 🔗.
    Wählen Sie den im Workflow hervorgehobenen Identitäts-Namespace aus, um Zielgruppen für Ziele zu aktivieren. {width="100" modal="regular"}

Löschen Sie entsprechend - Wenn Sie ein neues Streaming-Ziel dokumentieren, behalten Sie den ersten Absatz unten bei. Wenn Sie ein neues dateibasiertes Ziel dokumentieren, behalten Sie den zweiten Absatz bei. Wenn Sie ein Ziel dokumentieren, das Datensätze exportiert, behalten Sie den dritten Absatz bei.

Anweisungen zum Aktivieren von Zielgruppen für dieses Ziel finden Sie unter Aktivieren von Profilen und Zielgruppen für Streaming-Zielgruppen-Exportziele.

Anweisungen zum Aktivieren von Zielgruppen für dieses Ziel finden Sie unter Aktivieren von Zielgruppendaten für Batch-Profil-Exportziele.

Ausführliche Anweisungen zum Exportieren von Datensätzen an dieses Ziel finden Sie unter (Beta) Exportieren von Datensätzen.

Zuordnen von Attributen und Identitäten map

Fügen Sie im Schritt Zuordnung des Aktivierungs-Workflows Informationen zu unterstützten Zuordnungen zwischen Quell- und Zielfeldern hinzu. Ihr Ziel unterstützt möglicherweise das Exportieren von Profilattributen, Identitäts-Namespaces oder beidem. Einige Felder sind möglicherweise Pflichtfelder. Zielattribute können vordefiniert oder benutzerdefiniert sein. Machen Sie sich mit den wichtigen Einschränkungen vertraut und verwenden Sie Beispiele, vorzugsweise mit Screenshots. Zwei Beispiele für Zielseiten, die Sie als Referenz verwenden können:

Exportierte Daten/Datenexport validieren exported-data

Fügen Sie einen Absatz darüber hinzu, wie Daten an Ihr Ziel exportiert werden. Dadurch kann der Kunde sicherstellen, dass er korrekt in Ihr Ziel integriert ist. Sie können beispielsweise eine JSON-Beispieldatei wie die unten stehende bereitstellen. Sie können auch Screenshots und Informationen aus der Benutzeroberfläche Ihres Ziels bereitstellen, die zeigen, wie Kunden erwarten sollten, dass Zielgruppen in die Zielplattform gelangen.

{
  "person": {
    "email": "yourstruly@adobe.com"
  },
  "segmentMembership": {
    "ups": {
      "7841ba61-23c1-4bb3-a495-00d3g5fe1e93": {
        "lastQualificationTime": "2020-05-25T21:24:39Z",
        "status": "exited"
      },
      "59bd2fkd-3c48-4b18-bf56-4f5c5e6967ae": {
        "lastQualificationTime": "2020-05-25T23:37:33Z",
        "status": "realized"
      }
    }
  },
  "identityMap": {
    "ecid": [
      {
        "id": "14575006536349286404619648085736425115"
      },
      {
        "id": "66478888669296734530114754794777368480"
      }
    ],
    "email_lc_sha256": [
      {
        "id": "655332b5fa2aea4498bf7a290cff017cb4"
      },
      {
        "id": "66baf76ef9de8b42df8903f00e0e3dc0b7"
      }
    ]
  }
}

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.

Zusätzliche Ressourcen additional-resources

Sie können weitere Links zu Ihrer Produktdokumentation oder anderen Ressourcen bereitstellen, die Sie für wichtig halten, damit der Kunde erfolgreich ist.

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