Adobe Target Module

In einem Adobe Workfront Fusion Szenario können Sie Workflows automatisieren, die Adobe Target verwenden, und sie mit mehreren Anwendungen und Services von Drittanbietern verbinden. Mit Adobe Target-Modulen können Sie Datensätze erstellen, lesen, aktualisieren oder löschen, alle Datensätze eines bestimmten Typs auflisten, Datensätze anhand von von Ihnen angegebenen Kriterien suchen oder einen benutzerdefinierten API-Aufruf an die Adobe Target-API durchführen.

Anweisungen zum Erstellen eines Szenarios finden Sie in den Artikeln unter Szenario erstellen: Artikelindex.

Informationen zu Modulen finden Sie in den Artikeln unter Module: Artikelindex.

Zugriffsanforderungen

Sie müssen über folgenden Zugriff verfügen, um die Funktion in diesem Artikel verwenden zu können:

Adobe Workfront Plan*
Pro oder höher
Adobe Workfront Lizenz*
Plan, Work
Adobe Workfront Fusion Lizenz **

Aktuelle Lizenzanforderung: Keine Workfront Fusion.

Oder

Legacy-Lizenzanforderung: Workfront Fusion für Arbeitsautomatisierung und -integration

Produkt

Aktuelle Produktanforderung: Wenn Sie über den Select oder Prime Adobe Workfront verfügen, muss Ihr Unternehmen Adobe Workfront Fusion kaufen und Adobe Workfront, die in diesem Artikel beschriebenen Funktionen zu verwenden. Workfront Fusion ist im Ultimate Workfront enthalten.

Oder

Legacy-Produktanforderung: Ihr Unternehmen muss Adobe Workfront Fusion erwerben und Adobe Workfront, die in diesem Artikel beschriebenen Funktionen zu verwenden.

Wenden Sie sich an Ihren Workfront, um herauszufinden, über welchen Plan, welchen Lizenztyp oder welchen Zugriff Sie verfügen.

Informationen zu Adobe Workfront Fusion finden Sie unter Adobe Workfront Fusion Lizenzen.

Voraussetzungen

Bevor Sie den Adobe Target-Connector verwenden können, müssen Sie sicherstellen, dass die folgenden Voraussetzungen erfüllt sind:

  • Sie müssen über ein aktives Adobe Target verfügen.

Adobe Target-API-Informationen

Der Adobe Target-Connector verwendet Folgendes:

API-Tag
v1.7.33

Erstellen einer Verbindung zu Adobe Target

IMPORTANT
Verbindungen, die nach dem 3. Juni 2024 erstellt wurden, erfordern eine Adobe Target-Server-zu-Server-Verbindung.
  • Vorhandene Service-Kontoverbindungen funktionieren weiterhin bis Januar 2025. Sie müssen Ihre Service-Kontoverbindungen bis Januar 2024 durch Adobe Target Server-zu-Server-Verbindungen ersetzen.
  • Sie müssen Entwickler für Ihr Unternehmen sein, um eine Adobe Target-Server-zu-Server-Verbindung erstellen zu können. Die Entwicklerrolle ist in der Adobe Admin Console festgelegt.

So erstellen Sie eine Verbindung für Ihre Adobe Target:

  1. Klicken Sie Add neben dem Feld Verbindung .

  2. Füllen Sie die folgenden Felder aus:

    table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2 5-row-2 6-row-2 7-row-2 8-row-2 9-row-2 10-row-2 layout-auto html-authored no-header
    Connection name Geben Sie einen Namen für diese Verbindung ein.
    Connection type

    Wählen Sie aus, ob Sie eine Service-Konto- oder eine Adobe Target-Server-zu-Server-Verbindung erstellen.

    WICHTIG: Verbindungen, die nach dem 3. Juni 2024 erstellt wurden, erfordern eine Adobe Target-Server-zu-Server-Verbindung. Vorhandene Service-Kontoverbindungen funktionieren weiterhin bis Januar 2025. Sie müssen Ihre Service-Kontoverbindungen bis Januar 2024 durch Adobe Target Server-zu-Server-Verbindungen ersetzen.

    Environment Wählen Sie aus, ob Sie eine Verbindung zu einer Produktions- oder Nicht-Produktionsumgebung herstellen.
    Type Wählen Sie aus, ob Sie eine Verbindung zu einem Service-Konto oder einem persönlichen Konto herstellen möchten.
    Client ID Geben Sie Ihre Adobe-Client-ID ein. Diese finden Sie im Credentials details Abschnitt der Adobe Developer Console.
    Client Secret Geben Sie Ihr Adobe-Client-Geheimnis ein. Diese finden Sie im Credentials details Abschnitt der Adobe Developer Console.
    Technical account ID Geben Sie die ID Ihres Adobe technischen Kontos ein. Diese finden Sie im Credentials details Abschnitt der Adobe Developer Console.
    Organization ID Geben Sie Ihre Adobe Organisations-ID ein. Diese finden Sie im Credentials details Abschnitt der Adobe Developer Console.
    Tenant

    Um Ihren Mandanten zu finden, melden Sie sich bei der Adobe Experience Cloud an, öffnen Sie Target und klicken Sie auf die Target. Verwenden Sie den Mandanten-ID-Wert, wie in der URL-Subdomain angegeben.

    Wenn beispielsweise Ihre URL bei der Anmeldung bei Adobe Target <https://mycompany.experiencecloud.adobe.com/...> ist, lautet Ihre Mandanten-ID „mycompany“.

    Meta Scopes ent_marketing_sdk eingeben
    Private key

    Geben Sie den privaten Schlüssel ein, der bei der Erstellung Ihrer Anmeldeinformationen im Adobe Developer Console generiert wurde.

    So extrahieren Sie Ihren privaten Schlüssel oder Ihr Zertifikat:

    1. Klicken Sie auf Extract.

    2. Wählen Sie den zu extrahierenden Dateityp aus.

    3. Wählen Sie die Datei aus, die den privaten Schlüssel oder das Zertifikat enthält.

    4. Geben Sie das Kennwort für die Datei ein.

    5. Klicken Sie auf Save , um die Datei zu extrahieren und zur Verbindungseinrichtung zurückzukehren.

  3. Klicken Sie auf Continue , um die Verbindung zu speichern und zum Modul zurückzukehren.

Adobe Target Module und ihre Felder

Beim Konfigurieren Adobe Target Module zeigt Workfront Fusion die unten aufgeführten Felder an. Darüber hinaus können abhängig von Faktoren wie Ihrer Zugriffsebene in der App oder dem Service weitere Adobe Target angezeigt werden. Ein fett gedruckter Titel in einem Modul gibt ein erforderliches Feld an.

Wenn die Zuordnungsschaltfläche über einem Feld oder einer Funktion angezeigt wird, können Sie damit Variablen und Funktionen für dieses Feld festlegen. Weitere Informationen finden Sie unter Zuordnen von Informationen von einem Modul zu einem anderen.

Umschalter für Zuordnung

Aktionen

Create a record

Dieses Aktionsmodul erstellt eine AB- oder XT-Aktivität, ein Angebot oder eine Zielgruppe.

Connection
Anweisungen zum Erstellen einer Verbindung zu Adobe Target finden Sie unter Erstellen einer Verbindung zu Adobe Target in diesem Artikel.
Record type

Wählen Sie den Typ des Datensatzes aus, den Sie erstellen möchten.

XT-Aktivitätsfelder
Name
Geben Sie einen Namen für diese Aktivität ein oder mappen Sie ihn. Der Name darf nicht länger 250 Zeichen sein.
Options

Klicken Sie für jede Option, die Sie der Aktivität hinzufügen möchten, auf Add item und füllen Sie die folgenden Felder aus:

  • Option local ID

    Geben Sie eine Zeichenfolge ein, die verwendet werden soll, um die Option über API-Anfragen hinweg zu verfolgen, oder ordnen Sie sie zu.

  • Name

    Geben Sie einen Namen für die Option ein oder mappen Sie ihn. Der Name darf nicht länger 250 Zeichen sein.

  • Offer ID

  • Wählen Sie das mit der Option verknüpfte Angebot aus oder ordnen Sie es zu.

Locations

Klicken Sie für jede Mbox, die Sie der Aktivität hinzufügen möchten, auf Add item und füllen Sie die folgenden Felder aus:

  • Audience IDs

    Klicken Sie für jede Zielgruppe, die Sie der Mbox hinzufügen möchten, auf Add item und wählen Sie die Zielgruppen-ID aus.

  • Location local ID

    Geben Sie eine Zeichenfolge ein, die verwendet werden soll, um den Speicherort über API-Anfragen hinweg zu verfolgen, oder ordnen Sie sie zu.

  • Name

    Geben Sie einen Namen für den Speicherort ein oder mappen Sie ihn. Der Name darf nicht länger 250 Zeichen sein.

Experiences

Eine Liste der Stellen auf der Seite, an denen das Inhaltsangebot bereitgestellt wird. Ein Speicherort enthält Folgendes:

  • Experience local ID

    ID des Erlebnisses eingeben oder zuordnen

  • Name

    Namen des Erlebnisses eingeben oder zuordnen

  • Audience IDs

    Klicken Sie für jede Zielgruppe, die Sie sehen möchten, auf Add item und geben Sie die Zielgruppen-ID ein.

  • Visitor Percentage

    Geben Sie den Prozentsatz der Besucher ein, der dem Erlebnis zugeordnet ist, oder ordnen Sie ihn zu

Metrics
Third Party ID
Geben Sie eine ID ein, um diese Aktivität zu identifizieren, oder mappen Sie sie. Sie können diese ID auswählen. Diese ID darf nicht mit einer anderen Aktivität identisch sein und darf nicht länger 250 Zeichen sein.
Starts at
Geben Sie Datum und Uhrzeit für den Beginn der Aktivität im YYYY-MM-DD hh:mm:ss.z Format ein oder mappen Sie sie.
Ends at
Geben Sie das Datum und die Uhrzeit für das Ende der Aktivität im Format YYYY-MM-DD hh:mm:ss.z ein oder mappen Sie sie.
State

Geben Sie den Status der Aktivität ein oder mappen Sie ihn.

  • Approved

  • Deactivated

  • Paused

  • Saved

  • Deleted

Priority
Geben Sie eine Zahl ein, die die Priorität der Aktivität definiert. Höhere Zahlen haben eine höhere Priorität. Dieser Wert muss zwischen 0 und 999 liegen. Der Standardwert ist 5.
Auto-allocate traffic

Aktivieren Sie diese Option, um Traffic automatisch zuzuordnen. Durch die automatische Zuordnung wird mehr Traffic an das erfolgreichere Erlebnis gesendet.

Wählen Sie die Bewertungskriterien aus oder ordnen Sie sie zu, um zu beurteilen, welches Erlebnis erfolgreicher ist.

Workspace
Den Arbeitsbereich eingeben oder zuordnen, mit dem die Aktivität verknüpft ist
Property IDs
Klicken Sie für jede Eigenschaft, die Sie der Aktivität hinzufügen möchten, auf Add item und wählen Sie die ID der Eigenschaft aus oder ordnen Sie sie zu.
Reporting audiences

Klicken Sie für jede Reporting-Zielgruppe, die Sie der Aktivität hinzufügen möchten, auf Add item und geben Sie die folgenden Informationen ein:

  • Reporting Audience local ID

    Geben Sie eine Zeichenfolge ein, die zur Verfolgung der Reporting-Zielgruppe über API-Anfragen hinweg verwendet werden soll, oder ordnen Sie sie zu.

  • Audience ID

    Segment eingeben oder zuordnen, das im Reporting verwendet werden soll

  • Metric local ID

    Geben Sie eine Zeichenfolge ein, die zur Verfolgung der Metrik über API-Anfragen hinweg verwendet werden soll, oder ordnen Sie sie zu.

Angebotsfelder
Name
Geben Sie einen Namen für diese Aktivität ein oder mappen Sie ihn. Der Name darf nicht länger 250 Zeichen sein.
Content
Geben Sie den Inhalt des Angebots ein, das dem Benutzer angezeigt werden soll, oder ordnen Sie ihn zu.
Workspace
Geben Sie die ID des mit dem Angebot verknüpften Arbeitsbereichs ein oder mappen Sie sie. Wenn das Feld leer gelassen wird, wird das Angebot mit dem Standardarbeitsbereich des Kontos verknüpft. Diese Funktion gilt nur für Target Premium-Konten.
Workspace
Geben Sie das Datum und die Uhrzeit der Änderung dieses Angebots ein oder mappen Sie sie.

Make a custom API call

Dieses Modul führt einen benutzerdefinierten API-Aufruf an die Adobe Target-API durch.

Connection
Anweisungen zum Erstellen einer Verbindung zu Adobe Target finden Sie unter Erstellen einer Verbindung zu Adobe Target in diesem Artikel.
Target Basis-URL
Geben Sie Ihre Target-Basis-URL ein oder mappen Sie sie.
Path
Pfad relativ zu {baseURL}/ eingeben
Method
Wählen Sie die HTTP-Anfragemethode aus, die Sie zum Konfigurieren des API-Aufrufs benötigen. Weitere Informationen finden Sie unter HTTP-Anfragemethoden.
Headers

Fügen Sie die Header der Anfrage in Form eines standardmäßigen JSON-Objekts hinzu.

Beispiel: {"Content-type":"application/json"}

Workfront Fusion Fügt automatisch Autorisierungs- und X-API-Schlüssel-Header hinzu.

Query String
Geben Sie die Abfragezeichenfolge der Anfrage ein.
Body

Fügen Sie den Hauptteil des Inhalts für den API-Aufruf in Form eines standardmäßigen JSON-Objekts hinzu.

Hinweis:

Wenn Sie bedingte Anweisungen wie if in Ihrer JSON-Datei verwenden, setzen Sie die Anführungszeichen außerhalb der bedingten Anweisung.

Delete a record

Dieses Aktionsmodul löscht eine einzelne AB-Aktivität, XT-Aktivität, ein einzelnes Angebot oder eine einzelne Audience.

Connection
Anweisungen zum Erstellen einer Verbindung zu Adobe Target finden Sie unter Erstellen einer Verbindung zu Adobe Target in diesem Artikel.
Record type
Wählen Sie den Typ des Datensatzes aus, den Sie löschen möchten.
Record ID
Geben Sie die ID des Datensatzes ein, den Sie löschen möchten, oder mappen Sie sie.

Read a record

Dieses Aktionsmodul ruft Daten für eine einzelne Aktivität, ein einzelnes Angebot, eine einzelne Zielgruppe, eine einzelne Eigenschaft oder einen einzelnen Bericht ab.

Connection
Anweisungen zum Erstellen einer Verbindung zu Adobe Target finden Sie unter Erstellen einer Verbindung zu Adobe Target in diesem Artikel.
Record type
Wählen Sie den Datensatztyp aus, den Sie lesen möchten.
Record ID
Geben Sie die ID des Datensatzes ein, den Sie lesen möchten, oder mappen Sie sie.

Update a record

Dieses Aktionsmodul aktualisiert einen Datensatz in Target.

Connection
Anweisungen zum Erstellen einer Verbindung zu Adobe Target finden Sie unter Erstellen einer Verbindung zu Adobe Target in diesem Artikel.
Record type
Wählen Sie den Typ des Datensatzes aus, den Sie aktualisieren möchten.
Field names

Wählen Sie die Felder aus, die Sie aktualisieren möchten. Die Felder werden unten angezeigt.

Weitere Informationen zu Feldern finden Sie unter Adobe Target-API-Dokumentation.

Suchvorgänge

Get records

Dieses Suchmodul ruft eine Liste von Datensätzen des ausgewählten Typs ab.

Connection
Anweisungen zum Erstellen einer Verbindung zu Adobe Target finden Sie unter Erstellen einer Verbindung zu Adobe Target in diesem Artikel.
Record type
Wählen Sie den Typ des Datensatzes aus, den Sie aktualisieren möchten.
Sort by
Klicken Sie für jedes Feld, nach dem Sie sortieren möchten, auf Add item und wählen Sie das Feld aus und geben Sie an, ob die zurückgegebenen Ergebnisse aufsteigend oder absteigend sein sollen.
Starts At

Geben Sie das früheste Datum ein, für das Sie Datensätze abrufen möchten.

Eine Liste der unterstützten Datums- und Zeitformate finden Sie unter Typzwang in Adobe Workfront Fusion.

Ends At

Geben Sie das letzte Datum ein, für das Sie Datensätze abrufen möchten.

Eine Liste der unterstützten Datums- und Zeitformate finden Sie unter Typzwang in Adobe Workfront Fusion.

Dieses Suchmodul sucht anhand der von Ihnen angegebenen Kriterien nach Aktivitäten, Angeboten oder Zielgruppen.

Connection
Anweisungen zum Erstellen einer Verbindung zu Adobe Target finden Sie unter Erstellen einer Verbindung zu Adobe Target in diesem Artikel.
Record type
Wählen Sie den Typ des Datensatzes aus, den Sie aktualisieren möchten.
Sort by
Klicken Sie für jedes Feld, nach dem Sie sortieren möchten, auf Add item und wählen Sie das Feld aus und geben Sie an, ob die zurückgegebenen Ergebnisse aufsteigend oder absteigend sein sollen.
Search criteria
Wählen Sie für jede Regel, die Sie einrichten möchten, das Feld, den Operator und den Wert aus. Klicken Sie auf Add AND rule , um zusätzliche Regeln zu erstellen.
Offset

Geben Sie die Nummer der ersten Antwort ein, die das Modul zurückgeben soll. Die erste zurückgegebene Antwort hat einen Offset von 0. Verwenden Sie dieses Feld in Kombination mit dem Feld Maximum number of returned results , um die Antworten zu paginieren.

Um beispielsweise die dritte Seite mit Antworten anzuzeigen, wenn jede Seite zehn Antworten enthält, setzen Sie Offset auf 20 und Maximum number of returned die Ergebnisse auf 10.

Limit

Geben Sie die maximale Anzahl von Datensätzen ein, die das Modul während jedes Szenario-Ausführungszyklus zurückgeben soll, oder mappen Sie sie. Verwenden Sie dieses Feld in Kombination mit dem Feld Offset , um die Antworten zu paginieren.

Um beispielsweise die dritte Seite mit Antworten anzuzeigen, wenn jede Seite zehn Antworten enthält, setzen Sie Offset auf 20 und Maximum number of returned die Ergebnisse auf 10.

recommendation-more-help
7e1891ad-4d59-4355-88ab-a2e62ed7d1a3