DocumentatieWorkfrontHandleiding voor Workfront

Adobe Target Modules

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

Gemaakt voor:

  • Gebruiker

In een Adobe Workfront Fusion -scenario kunt u workflows automatiseren die Adobe Target gebruiken en deze koppelen aan meerdere toepassingen en services van derden. Met Adobe Target -modules kunt u records maken, lezen, bijwerken of verwijderen, alle records van een bepaald type weergeven, zoekrecords weergeven op basis van criteria die u opgeeft, of een aangepaste API-aanroep naar de Adobe Target API uitvoeren.

Als u instructies bij het creëren van een scenario nodig hebt, zie een scenariocreëren.

Voor informatie over modules, zie Modules in Adobe Workfront Fusion.

Toegangsvereisten

U moet de volgende toegang hebben om de functionaliteit in dit artikel te kunnen gebruiken:

Adobe Workfront plan*
Pro of hoger
Adobe Workfront licentie*
Plan, Work
Adobe Workfront Fusion licentie**

Huidige licentievereiste: geen Workfront Fusion licentievereiste.

of

Vereiste voor oudere licenties: Workfront Fusion voor werkautomatisering en integratie

Product

Huidige productvereiste: als u het abonnement Select of Prime Adobe Workfront hebt, moet uw organisatie Adobe Workfront Fusion en Adobe Workfront aanschaffen om de in dit artikel beschreven functionaliteit te kunnen gebruiken. Workfront Fusion wordt opgenomen in het Ultimate Workfront -abonnement.

of

Vereiste verouderd product: uw organisatie moet Adobe Workfront Fusion en Adobe Workfront aanschaffen om de in dit artikel beschreven functionaliteit te kunnen gebruiken.

Neem contact op met de Workfront -beheerder als u wilt weten welk abonnement, licentietype of toegang u hebt.

Voor informatie over Adobe Workfront Fusion vergunningen, zie Adobe Workfront Fusion vergunningen.

Vereisten

Voordat u de Adobe Target -connector kunt gebruiken, moet u controleren of aan de volgende voorwaarden is voldaan:

  • U moet een actieve Adobe Target account hebben.

Adobe Target API-informatie

De Adobe Target-connector gebruikt het volgende:

API-tag
v1.7.3

Verbinding maken met Adobe Target

IMPORTANT
Voor verbindingen die na 3 juni 2024 worden gemaakt, is een Adobe Target Server-naar-server verbinding vereist.
  • De bestaande verbindingen van de Rekening van de Dienst zullen tot Januari 2025 blijven werken. U moet uw verbindingen van de Rekening van de Dienst met server-aan-server van Adobe Target tegen Januari 2024 vervangen.
  • U moet een ontwikkelaar voor uw organisatie zijn om een server-aan-server verbinding van Adobe Target tot stand te brengen. De rol van ontwikkelaar wordt ingesteld in de Adobe Admin Console.

Verbinding maken voor uw Adobe Target -modules:

  1. Klik op Add naast het vak Verbinding.

  2. Vul de volgende velden in:

    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 Voer een naam in voor deze verbinding.
    Connection type

    Selecteer of u een verbinding van de Rekening van de Dienst of een server-aan-server verbinding van Adobe Target creeert.

    BELANGRIJK : De verbindingen die na 3 Juni, 2024 worden gecreeerd vereisen een server-aan-server verbinding van Adobe Target. De bestaande verbindingen van de Rekening van de Dienst zullen tot Januari 2025 blijven werken. U moet uw verbindingen van de Rekening van de Dienst met server-aan-server van Adobe Target tegen Januari 2024 vervangen.
    Environment Selecteer of u verbinding maakt met een productie- of niet-productieomgeving.
    Type Selecteer of u verbinding maakt met een serviceaccount of een persoonlijke account.
    Client ID Voer uw Adobe client-id in. Dit vindt u in de sectie Credentials details van Adobe Developer Console .
    Client Secret Voer uw Adobe clientgeheim in. Dit vindt u in de sectie Credentials details van Adobe Developer Console .
    Technical account ID Voer uw Adobe technische account-id in. Dit vindt u in de sectie Credentials details van Adobe Developer Console .
    Organization ID Voer uw Adobe Organisatie-id in. Dit vindt u in de sectie Credentials details van Adobe Developer Console .
    Tenant

    Als u de huurder wilt zoeken, meldt u zich aan bij de Adobe Experience Cloud , opent u Target en klikt u op de Target -kaart. Gebruik de waarde van de huurder-id zoals vermeld in het URL-subdomein.

    Als uw URL bij het aanmelden bij Adobe Target bijvoorbeeld <https://mycompany.experiencecloud.adobe.com/...> is, is de id van uw huurder "mijn bedrijf".
    Meta Scopes Enter ent_marketing_sdk
    Private key

    Voer de persoonlijke sleutel in die is gegenereerd toen uw referenties werden gemaakt in de Adobe Developer Console .

    Uw persoonlijke sleutel of certificaat uitnemen:

    1. Klik op Extract.

    2. Selecteer het type bestand dat u extraheert.

    3. Selecteer het bestand dat de persoonlijke sleutel of het certificaat bevat.

    4. Voer het wachtwoord voor het bestand in.

    5. Klik op Save om het bestand uit te pakken en terug te keren naar de verbindingsinstelling.

  3. Klik op Continue om de verbinding op te slaan en terug te keren naar de module.

Adobe Target modules en hun velden

Wanneer u Adobe Target modules configureert, geeft Workfront Fusion de onderstaande velden weer. Daarnaast kunnen aanvullende Adobe Target -velden worden weergegeven, afhankelijk van factoren zoals uw toegangsniveau in de app of service. Een bolde titel in een module wijst op een vereist gebied.

Als u de kaartknoop boven een gebied of een functie ziet, kunt u het gebruiken om variabelen en functies voor dat gebied te plaatsen. Voor meer informatie, zie informatie van de Kaart van één module aan een andere in Adobe Workfront Fusion.

Handelingen

Create a record

Deze actiemodule leidt tot een activiteit AB of XT, een aanbieding, of een publiek.

Connection
Zie Verbinding maken met Adobe Target in dit artikel voor instructies over het maken van een verbinding met Adobe Target .
Record type

Selecteer het type record dat u wilt maken.

XT-activiteitvelden
Name
Voer een naam voor deze activiteit in of wijs een naam toe. De naam mag uit maximaal 250 tekens bestaan.
Options

Voor elke optie die u aan de activiteit wilt toevoegen, klik Add item en vul de volgende gebieden in:

  • Option local ID

    Voer een tekenreeks in of wijs een tekenreeks toe die moet worden gebruikt om de optie bij te houden voor verschillende API-aanvragen.

  • Name

    Voer een naam voor de optie in of wijs een naam toe. De naam mag niet meer dan 250 tekens bevatten.

  • Offer ID

  • Selecteer of wijs het Voorstel toe verbonden aan de optie.

Locations

Voor elke box die u aan de activiteit wilt toevoegen, klik Add item en vul de volgende gebieden in:

  • Audience IDs

    Voor elk publiek dat u aan Mbox wilt toevoegen, klik Add item en selecteer identiteitskaart van de Publiek

  • Location local ID

    Voer een tekenreeks in of wijs een tekenreeks toe die moet worden gebruikt om de locatie in API-verzoeken bij te houden.

  • Name

    Voer een naam voor de locatie in of wijs een naam toe. De naam mag niet meer dan 250 tekens bevatten.

Experiences

Een lijst met locaties op de pagina waar het inhoudsaanbod wordt weergegeven. Een locatie bevat het volgende:

  • Experience local ID

    Voer de id van de ervaring in of wijs deze toe

  • Name

    Voer de naam van de ervaring in of wijs deze toe

  • Audience IDs

    Voor elk publiek dat u de ervaring wilt zien, klik Add item en ga identiteitskaart van de Publiek in.

  • Visitor Percentage

    Voer het percentage bezoekers dat aan de ervaring is toegewezen in of wijs dit percentage toe

Metrics
Third Party ID
Voer een id in of wijs deze toe om deze activiteit te identificeren. U kunt deze id kiezen. Deze id mag niet hetzelfde zijn als een andere activiteit en mag uit maximaal 250 tekens bestaan.
Starts at
Voer de datum en tijd in of wijs de datum en tijd toe waarop de activiteit moet worden gestart in de notatie YYYY-MM-DD hh:mm:ss.z .
Ends at
Voer de datum en tijd in of wijs de datum en tijd toe om de activiteit te beëindigen in de notatie YYYY-MM-DD hh:mm:ss.z .
State

Voer de status van de activiteit in of wijs deze toe.

  • Approved

  • Deactivated

  • Paused

  • Saved

  • Deleted

Priority
Voer een getal in dat de prioriteit van de activiteit definieert. Hogere getallen hebben een hogere prioriteit. Deze waarde moet liggen tussen 0 en 999. De standaardwaarde is 5.
Auto-allocate traffic

Schakel deze optie in om automatisch verkeer toe te wijzen. De auto-toewijst verzendt meer verkeer naar de succesvolere ervaring.

Selecteer of kaart de evaluatiecriteria aan om te beoordelen welke ervaring succesvoller is.

Workspace
Voer de werkruimte in die aan de activiteit is gekoppeld of wijs deze toe
Property IDs
Voor elke eigenschap die u aan de activiteit wilt toevoegen, klikt u op Add item en selecteert of wijst u de id van de eigenschap toe.
Reporting audiences

Voor elk rapporterend publiek dat u aan de activiteit wilt toevoegen, klik Add item en ga de volgende informatie in:

  • Reporting Audience local ID

    Ga of kaart een koord in dat moet worden gebruikt om het Publiek van de Rapportering over API verzoeken te volgen.

  • Audience ID

    Typ of wijs het segment toe dat u wilt gebruiken voor de rapportage

  • Metric local ID

    Voer een tekenreeks in of wijs een tekenreeks toe die moet worden gebruikt om de metrische gegevens in API-verzoeken bij te houden.

Velden aanbieden
Name
Voer een naam voor deze activiteit in of wijs een naam toe. De naam mag uit maximaal 250 tekens bestaan.
Content
Voer de inhoud van het aanbod in of wijs deze toe aan de gebruiker.
Workspace
Voer de id van de werkruimte die aan de aanbieding is gekoppeld in of wijs deze toe. Als deze optie leeg blijft, wordt de aanbieding gekoppeld aan de standaardwerkruimte van de account. Deze functionaliteit is alleen van toepassing op Target Premium-accounts.
Workspace
Voer de datum en het tijdstip in waarop deze aanbieding is gewijzigd of wijs de datum en tijd toe.

Make a custom API call

Deze module maakt een aangepaste API-aanroep naar de Adobe Target API.

Connection
Zie Verbinding maken met Adobe Target in dit artikel voor instructies over het maken van een verbinding met Adobe Target .
Target Basis-URL
Voer de basis-URL van Target in of wijs deze toe.
Path
Een pad invoeren ten opzichte van {baseURL}/
Method
Selecteer de HTTP- verzoekmethode u de API vraag moet vormen. Zie HTTP-aanvraagmethoden in Adobe Workfront Fusion voor meer informatie.
Headers

Voeg de kopteksten van het verzoek toe in de vorm van een standaard JSON-object.

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

Workfront Fusion Hiermee worden automatisch machtigingsheaders en x-api-sleutelkoppen toegevoegd.

Query String
Voer de queryreeks voor de aanvraag in.
Body

Voeg de inhoud van de hoofdtekst voor de API-aanroep toe in de vorm van een standaard JSON-object.

Opmerking:

Wanneer u voorwaardelijke instructies gebruikt, zoals if in uw JSON, plaatst u de aanhalingstekens buiten de voorwaardelijke instructie.

Delete a record

Deze actiemodule schrapt één enkele activiteit van AB, activiteit XT, Aanbieding, of Publiek.

Connection
Zie Verbinding maken met Adobe Target in dit artikel voor instructies over het maken van een verbinding met Adobe Target .
Record type
Selecteer het type record dat u wilt verwijderen.
Record ID
Voer de id in van de record die u wilt verwijderen of wijs deze toe.

Read a record

Deze actiemodule wint gegevens voor één enkele Activiteit, Aanbieding, Publiek, Bezit, of Rapport terug.

Connection
Zie Verbinding maken met Adobe Target in dit artikel voor instructies over het maken van een verbinding met Adobe Target .
Record type
Selecteer het type record dat u wilt lezen.
Record ID
Voer de id in van de record die u wilt lezen of wijs deze toe.

Update a record

Deze actiemodule werkt een record bij in Doel.

Connection
Zie Verbinding maken met Adobe Target in dit artikel voor instructies over het maken van een verbinding met Adobe Target .
Record type
Selecteer het type record dat u wilt bijwerken.
Field names

Selecteer de velden die u wilt bijwerken. De velden worden hieronder weergegeven.

Voor details op gebieden, zie de documentatie van Adobe Target API.

Zoekopdrachten

Get records

Deze zoekmodule haalt een lijst met records van het geselecteerde type op.

Connection
Zie Verbinding maken met Adobe Target in dit artikel voor instructies over het maken van een verbinding met Adobe Target .
Record type
Selecteer het type record dat u wilt bijwerken.
Sort by
Klik voor elk veld waarop u wilt sorteren op Add item en selecteer het veld en geef aan of de geretourneerde resultaten oplopend of aflopend moeten zijn.
Starts At

Voer de vroegste datum in waarvoor u records wilt ophalen.

Voor een lijst van gesteunde datum en tijdformaten, zie Druk van het Type in Adobe Workfront Fusion.

Ends At

Voer de laatste datum in waarvoor u records wilt ophalen.

Voor een lijst van gesteunde datum en tijdformaten, zie Druk van het Type in Adobe Workfront Fusion.

Deze zoekmodule zoekt naar Activiteiten, Aanbiedingen of Soorten publiek op basis van criteria die u opgeeft.

Connection
Zie Verbinding maken met Adobe Target in dit artikel voor instructies over het maken van een verbinding met Adobe Target .
Record type
Selecteer het type record dat u wilt bijwerken.
Sort by
Klik voor elk veld waarop u wilt sorteren op Add item en selecteer het veld en geef aan of de geretourneerde resultaten oplopend of aflopend moeten zijn.
Search criteria
Selecteer voor elke regel die u wilt instellen het veld, de operator en de waarde. Klik op Add AND rule om extra regels te maken.
Offset

Voer het nummer in van de eerste reactie die de module moet retourneren. De eerste geretourneerde reactie heeft een verschuiving van 0 . Gebruik dit veld in combinatie met het veld Maximum number of returned results om de reacties te pagineren.

Als u bijvoorbeeld de derde pagina met reacties wilt weergeven, stelt u Offset in op 20 en Maximum number of returned op 10 als elke pagina tien reacties heeft.

Limit

Ga of kaart het maximumaantal verslagen in u de module tijdens elke cyclus van de scenariouitvoering wilt terugkeren. Gebruik dit veld in combinatie met het veld Offset om de reacties te pagineren.

Als u bijvoorbeeld de derde pagina met reacties wilt weergeven, stelt u Offset in op 20 en Maximum number of returned op 10 als elke pagina tien reacties heeft.

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