DokumentationWorkfrontWorkfront-Handbuch

Adobe Target Module

Last update: Thu Nov 21 2024 00:00:00 GMT+0000 (Coordinated Universal Time)
  • Themen:

Erstellt für:

  • Benutzende

In einem Adobe Workfront Fusion -Szenario können Sie Workflows automatisieren, die Adobe Target verwenden, und sie mit mehreren Anwendungen und Diensten von Drittanbietern verbinden. Adobe Target -Module ermöglichen es Ihnen, Datensätze eines bestimmten Typs aufzulisten, zu erstellen, zu lesen, zu aktualisieren oder zu löschen, Suchdatensätze nach von Ihnen festgelegten Kriterien aufzulisten oder einen benutzerdefinierten API-Aufruf an die Adobe Target -API durchzuführen.

Wenn Sie Anweisungen zum Erstellen eines Szenarios benötigen, finden Sie weitere Informationen unter Erstellen eines Szenarios.

Weitere Informationen zu Modulen finden Sie unter Module in Adobe Workfront Fusion.

Zugriffsanforderungen

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

Adobe Workfront plan*
Pro oder höher
Adobe Workfront license*
Plan, Arbeit
Adobe Workfront Fusion license**

Aktuelle Lizenzanforderungen: Keine Workfront Fusion Lizenzanforderungen.

Oder

Alte Lizenzanforderung: Workfront Fusion für die Arbeitsautomatisierung und -integration

Produkt

Aktuelle Produktanforderung: Wenn Sie über den Select- oder Prime Adobe Workfront-Plan verfügen, muss Ihr Unternehmen Adobe Workfront Fusion sowie Adobe Workfront erwerben, um die in diesem Artikel beschriebene Funktionalität nutzen zu können. Workfront Fusion ist im Ultimate Workfront-Plan enthalten.

Oder

Alte Produktanforderung: Ihr Unternehmen muss Adobe Workfront Fusion sowie Adobe Workfront erwerben, um die in diesem Artikel beschriebenen Funktionen nutzen zu können.

Wenden Sie sich an Ihren Workfront -Administrator, um zu erfahren, welchen Plan, welchen Lizenztyp oder welchen Zugriff Sie haben.

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

Voraussetzungen

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

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

Adobe Target-API-Informationen

Der Adobe Target-Connector verwendet Folgendes:

API-Tag
v1.7.33

Erstellen einer Verbindung zu Adobe Target

IMPORTANT
Nach dem 3. Juni 2024 erstellte Verbindungen erfordern eine Adobe Target-Server-zu-Server-Verbindung.
  • Die bestehenden Dienstkontoverbindungen funktionieren bis Januar 2025 weiterhin. Sie müssen Ihre Dienstkontoverbindungen bis Januar 2024 durch Adobe Target-Server-zu-Server-Verbindungen ersetzen.
  • Sie müssen Entwickler sein, damit Ihr Unternehmen eine Server-zu-Server-Verbindung mit Adobe Target herstellen kann. Die Entwicklerrolle wird in der Adobe Admin Console festgelegt.

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

  1. Klicken Sie neben dem Feld Verbindung auf Hinzufügen .

  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
    Verbindungsname Geben Sie einen Namen für diese Verbindung ein.
    Verbindungstyp

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

    WICHTIG: Verbindungen, die nach dem 3. Juni 2024 erstellt wurden, erfordern eine Adobe Target-Server-zu-Server-Verbindung. Die bestehenden Dienstkontoverbindungen funktionieren bis Januar 2025 weiterhin. Sie müssen Ihre Dienstkontoverbindungen bis Januar 2024 durch Adobe Target-Server-zu-Server-Verbindungen ersetzen.
    Umgebung Wählen Sie aus, ob Sie eine Verbindung zu einer Produktions- oder Nicht-Produktionsumgebung herstellen möchten.
    Typ Wählen Sie aus, ob Sie eine Verbindung zu einem Dienstkonto oder einem persönlichen Konto herstellen möchten.
    Client-ID Geben Sie Ihre Adobe Client-ID ein. Dies finden Sie im Abschnitt Anmeldeinformationen des Abschnitts Adobe Developer Console.
    Client Secret Geben Sie Ihr Adobe Client-Geheimnis ein. Dies finden Sie im Abschnitt Anmeldeinformationen des Abschnitts Adobe Developer Console.
    ID des technischen Kontos Geben Sie Ihre Adobe ID des technischen Kontos ein. Dies finden Sie im Abschnitt Anmeldeinformationen des Abschnitts Adobe Developer Console.
    Organisations-ID Geben Sie Ihre Adobe Organisations-ID ein. Dies finden Sie im Abschnitt Anmeldeinformationen des Abschnitts Adobe Developer Console.
    Mandant

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

    Wenn Ihre URL beispielsweise bei Adobe Target den Wert <https://mycompany.experiencecloud.adobe.com/...> aufweist, lautet die Mandantenkennung "mycompany".
    Meta Scopes ent_marketing_sdk eingeben
    Privater Schlüssel

    Geben Sie den privaten Schlüssel ein, der beim Erstellen Ihrer Anmeldedaten in der 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 Dateityp aus, den Sie extrahieren.

    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 Weiter , um die Verbindung zu speichern und zum Modul zurückzukehren.

Adobe Target Module und ihre Felder

Wenn Sie Adobe Target -Module konfigurieren, 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 im Dienst zusätzliche Adobe Target -Felder angezeigt werden. Ein fett hervorgehobener Titel in einem Modul zeigt ein erforderliches Feld an.

Wenn Sie die Zuordnungsschaltfläche über einem Feld oder einer Funktion sehen, können Sie damit Variablen und Funktionen für dieses Feld festlegen. Weitere Informationen finden Sie unter Informationen von einem Modul einem anderen zuordnen in Adobe Workfront Fusion.

Aktionen

Erstellen eines Datensatzes

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

Verbindung
Anweisungen zum Erstellen einer Verbindung zu Adobe Target finden Sie in diesem Artikel unter Erstellen einer Verbindung zu Adobe Target .
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 ordnen Sie ihn zu. Der Name darf maximal 250 Zeichen lang sein.
Optionen

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

  • Option local ID

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

  • Name

    Geben Sie einen Namen für die Option ein oder ordnen Sie ihn zu. Der Name darf maximal 250 Zeichen lang sein.

  • Angebots-ID

  • Wählen Sie die der Option zugeordnete Angebot aus oder ordnen Sie sie zu.

Standorte

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

  • Zielgruppen-IDs

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

  • Ortskennung

    Geben Sie eine Zeichenfolge ein oder ordnen Sie sie zu, um den Standort über API-Anfragen hinweg zu verfolgen.

  • Name

    Geben Sie einen Namen für den Standort ein oder ordnen Sie ihn zu. Der Name darf maximal 250 Zeichen lang sein.

Erlebnisse

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

  • Experience Local ID

    Kennungen des Erlebnisses eingeben oder zuordnen

  • Name

    Erlebnisname eingeben oder zuordnen

  • Audience IDs

    Klicken Sie für jede Zielgruppe, die das Erlebnis anzeigen soll, auf "Element hinzufügen"und geben Sie die Zielgruppen-ID ein.

  • Besucherprozentsatz

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

Metriken
Drittanbieter-ID
Geben Sie eine ID ein oder ordnen Sie sie zu, um diese Aktivität zu identifizieren. Sie können diese ID auswählen. Diese ID darf nicht mit einer anderen Aktivität übereinstimmen und darf nicht mehr als 250 Zeichen umfassen.
Beginnt am
Geben Sie Datum und Uhrzeit für den Start der Aktivität im Format YYYY-MM-DD hh:mm:ss.z ein oder ordnen Sie sie zu.
Endet am
Geben Sie Datum und Uhrzeit ein oder ordnen Sie sie dem Ende der Aktivität im Format YYYY-MM-DD hh:mm:ss.z zu.
State

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

  • Genehmigt

  • Deaktiviert

  • Paused

  • gespeichert

  • gelöscht

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

Aktivieren Sie diese Option, um Traffic automatisch zuzuweisen. Die automatische Zuordnung sendet mehr Traffic an das erfolgreichere Erlebnis.

Wählen Sie die Bewertungskriterien aus oder ordnen Sie sie zu, anhand derer beurteilt werden soll, welches Erlebnis erfolgreicher ist.

Workspace
Arbeitsbereich eingeben oder zuordnen, dem die Aktivität zugeordnet ist
Eigenschaften-IDs
Klicken Sie für jede Eigenschaft, die Sie der Aktivität hinzufügen möchten, auf Element hinzufügen und wählen Sie die ID der Eigenschaft aus oder ordnen Sie sie zu.
Berichterstellungszielgruppen

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

  • Lokale ID der Berichterstellungszielgruppe

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

  • Zielgruppen-ID

    Eingeben oder Zuordnen des Segments für die Berichterstellung

  • Metrik, lokale ID

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

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

Erstellen eines benutzerdefinierten API-Aufrufs

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

Verbindung
Anweisungen zum Erstellen einer Verbindung zu Adobe Target finden Sie in diesem Artikel unter Erstellen einer Verbindung zu Adobe Target .
Target Basis-URL
Geben Sie Ihre Basis-URL für Target ein oder ordnen Sie sie zu.
Path
Geben Sie einen Pfad relativ zu {baseURL}/ ein.
Methode
Wählen Sie die HTTP-Anfragemethode aus, die Sie zum Konfigurieren des API-Aufrufs benötigen. Weitere Informationen finden Sie unter HTTP-Anforderungsmethoden in Adobe Workfront Fusion.
Header

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-Header und x-api-key-Header hinzu.

Abfragezeichenfolge
Geben Sie die Abfragezeichenfolge der Anfrage ein.
Body

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

Hinweis:

Bei Verwendung von bedingten Anweisungen wie if in Ihrer JSON platzieren Sie die Anführungszeichen außerhalb der bedingten Anweisung.

Datensatz löschen

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

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

Datensatz lesen

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

Verbindung
Anweisungen zum Erstellen einer Verbindung zu Adobe Target finden Sie in diesem Artikel unter Erstellen einer Verbindung zu Adobe Target .
Record Type
Wählen Sie den Typ des Datensatzes aus, den Sie lesen möchten.
Datensatz-ID
Geben Sie die Kennung des Datensatzes ein, den Sie lesen möchten, oder ordnen Sie sie zu.

Datensatz aktualisieren

Dieses Aktionsmodul aktualisiert einen Datensatz in Target.

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

Wählen Sie die zu aktualisierenden Felder aus. Die Felder werden unten angezeigt.

Weitere Informationen zu Feldern finden Sie in der Dokumentation zur Adobe Target-API .

Suchvorgänge

Abrufen von Datensätzen

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

Verbindung
Anweisungen zum Erstellen einer Verbindung zu Adobe Target finden Sie in diesem Artikel unter Erstellen einer Verbindung zu Adobe Target .
Record Type
Wählen Sie den Typ des Datensatzes aus, den Sie aktualisieren möchten.
Sortieren nach
Klicken Sie für jedes Feld, nach dem Sie sortieren möchten, auf "Element hinzufügen"und wählen Sie das Feld aus und ob die zurückgegebenen Ergebnisse auf- oder absteigend sein sollen.
startet am

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

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

endet am

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

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

Suche

Dieses Suchmodul sucht nach Aktivitäten, Angeboten oder Zielgruppen basierend auf von Ihnen festgelegten Kriterien.

Verbindung
Anweisungen zum Erstellen einer Verbindung zu Adobe Target finden Sie in diesem Artikel unter Erstellen einer Verbindung zu Adobe Target .
Record Type
Wählen Sie den Typ des Datensatzes aus, den Sie aktualisieren möchten.
Sortieren nach
Klicken Sie für jedes Feld, nach dem Sie sortieren möchten, auf "Element hinzufügen"und wählen Sie das Feld aus und ob die zurückgegebenen Ergebnisse auf- oder absteigend sein sollen.
Suchkriterien
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 den Versatz 0. Verwenden Sie dieses Feld in Kombination mit dem Feld Maximale Anzahl an zurückgegebenen Ergebnissen , um die Antworten zu paginieren.

Um beispielsweise die dritte Antwortseite anzuzeigen, wenn jede Seite zehn Antworten enthält, setzen Sie Offset auf 20 und Maximale Anzahl der zurückgegebenen Ergebnisse auf 10.

Limit

Geben Sie die maximale Anzahl von Datensätzen ein oder ordnen Sie sie zu, die das Modul während der verschiedenen Ausführungszyklen eines Szenarios zurückgeben soll. Verwenden Sie dieses Feld in Kombination mit dem Feld Offset , um die Antworten zu paginieren.

Um beispielsweise die dritte Antwortseite anzuzeigen, wenn jede Seite zehn Antworten enthält, setzen Sie Offset auf 20 und Maximale Anzahl der zurückgegebenen Ergebnisse auf 10.

recommendation-more-help
5f00cc6b-2202-40d6-bcd0-3ee0c2316b43