DokumentationWorkfrontAnvändarhandbok om Workfront

Adobe Target moduler

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

Skapat för:

  • Användare

I ett Adobe Workfront Fusion-scenario kan du automatisera arbetsflöden som använder Adobe Target samt ansluta det till flera tredjepartsprogram och -tjänster. Med modulerna Adobe Target kan du skapa, skapa, läsa, uppdatera eller ta bort poster, lista alla poster av en viss typ, söka efter poster baserat på villkor som du anger eller utföra ett anpassat API-anrop till API:t Adobe Target .

Om du behöver instruktioner om hur du skapar ett scenario kan du läsa Skapa ett scenario.

Mer information om moduler finns i Moduler i Adobe Workfront Fusion.

Åtkomstkrav

Du måste ha följande åtkomst för att kunna använda funktionerna i den här artikeln:

Adobe Workfront plan*
Pro eller högre
Adobe Workfront licens*
Plan, Work
Adobe Workfront Fusion licens**

Aktuellt licenskrav: Inget Workfront Fusion-licenskrav.

eller

Gammalt licenskrav: Workfront Fusion för Automatisering och integrering av arbetet

Produkt

Aktuellt produktkrav: Om du har planen Select eller Prime Adobe Workfront måste din organisation köpa både Adobe Workfront Fusion och Adobe Workfront för att kunna använda de funktioner som beskrivs i den här artikeln. Workfront Fusion ingår i planen Ultimate Workfront.

eller

Äldre produktkrav: Din organisation måste köpa Adobe Workfront Fusion och Adobe Workfront för att kunna använda de funktioner som beskrivs i den här artikeln.

Kontakta Workfront-administratören om du vill ta reda på vilken plan, licenstyp eller åtkomst du har.

Mer information om Adobe Workfront Fusion licenser finns i Adobe Workfront Fusion licenser.

Förutsättningar

Innan du kan använda Adobe Target-anslutningen måste du se till att följande krav uppfylls:

  • Du måste ha ett aktivt Adobe Target-konto.

Adobe Target API-information

Adobe Target Connector använder följande:

API-tagg
v1.7.33

Skapa en anslutning till Adobe Target

IMPORTANT
Anslutningar som skapas efter den 3 juni 2024 kräver en Adobe Target Server-till-server-anslutning.
  • Befintliga anslutningar till tjänstkonton fortsätter att fungera till januari 2025. Du måste ersätta dina tjänstkontoanslutningar med Adobe Target Server-till-server-anslutningar senast i januari 2024.
  • Du måste vara utvecklare för att din organisation ska kunna skapa en Adobe Target Server-till-server-anslutning. Utvecklarrollen anges i Adobe Admin Console.

Så här skapar du en anslutning för dina Adobe Target-moduler:

  1. Klicka på Add bredvid rutan Anslutning.

  2. Fyll i följande fält:

    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 Ange ett namn för anslutningen.
    Connection type

    Ange om du skapar en anslutning till ett tjänstkonto eller en anslutning från Adobe Target Server till server.

    VIKTIGT: Anslutningar som skapats efter 3 juni 2024 kräver en Adobe Target Server-till-server-anslutning. Befintliga anslutningar till tjänstkonton fortsätter att fungera till januari 2025. Du måste ersätta dina tjänstkontoanslutningar med Adobe Target Server-till-server-anslutningar senast i januari 2024.
    Environment Ange om du ansluter till en produktionsmiljö eller icke-produktionsmiljö.
    Type Ange om du ansluter till ett tjänstkonto eller ett personligt konto.
    Client ID Ange ditt klient-ID för Adobe. Detta finns i avsnittet Credentials details i Adobe Developer Console.
    Client Secret Ange din Adobe-klienthemlighet. Detta finns i avsnittet Credentials details i Adobe Developer Console.
    Technical account ID Ange ditt tekniska konto-ID för Adobe. Detta finns i avsnittet Credentials details i Adobe Developer Console.
    Organization ID Ange ditt organisations-ID för Adobe. Detta finns i avsnittet Credentials details i Adobe Developer Console.
    Tenant

    Logga in på Adobe Experience Cloud, öppna Target och klicka på Target-kortet för att hitta din klient. Använd det klient-ID som anges i URL-underdomänen.

    Om din URL när du är inloggad på Adobe Target till exempel är <https://mycompany.experiencecloud.adobe.com/...> är ditt klient-ID"mincompany".
    Meta Scopes Ange ent_marketing_sdk
    Private key

    Ange den privata nyckel som skapades när dina autentiseringsuppgifter skapades i Adobe Developer Console.

    Så här extraherar du din privata nyckel eller ditt certifikat:

    1. Klicka på Extract.

    2. Välj vilken typ av fil du extraherar.

    3. Markera filen som innehåller den privata nyckeln eller certifikatet.

    4. Ange lösenordet för filen.

    5. Klicka på Save för att extrahera filen och återgå till anslutningsinställningarna.

  3. Klicka på Continue för att spara anslutningen och återgå till modulen.

Adobe Target-moduler och deras fält

När du konfigurerar Adobe Target moduler visar Workfront Fusion fälten som listas nedan. Dessutom kan ytterligare Adobe Target fält visas, beroende på faktorer som din åtkomstnivå i appen eller tjänsten. En rubrik med fet stil i en modul visar ett obligatoriskt fält.

Om du ser kartknappen ovanför ett fält eller en funktion kan du använda den för att ange variabler och funktioner för det fältet. Mer information finns i Mappa information från en modul till en annan i Adobe Workfront Fusion.

Åtgärder

Create a record

Denna åtgärdsmodul skapar en AB- eller XT-aktivitet, ett erbjudande eller en målgrupp.

Connection
Instruktioner om hur du skapar en anslutning till Adobe Target finns i Skapa en anslutning till Adobe Target i den här artikeln.
Record type

Välj den typ av post som du vill skapa.

XT Activity fields
Name
Ange eller mappa ett namn för aktiviteten. Namnet får innehålla högst 250 tecken.
Options

För varje alternativ som du vill lägga till i aktiviteten klickar du på Add item och fyller i följande fält:

  • Option local ID

    Ange eller mappa en sträng som ska användas för att spåra alternativet mellan API-begäranden.

  • Name

    Ange eller mappa ett namn för alternativet. Namnet får innehålla högst 250 tecken.

  • Offer ID

  • Markera eller mappa erbjudandet som är kopplat till alternativet.

Locations

För varje Mbox som du vill lägga till i aktiviteten klickar du på Add item och fyller i följande fält:

  • Audience IDs

    För varje målgrupp som du vill lägga till i rutan klickar du på Add item och väljer publikens ID.

  • Location local ID

    Ange eller mappa en sträng som ska användas för att spåra platsen mellan API-begäranden.

  • Name

    Ange eller mappa ett namn för platsen. Namnet får innehålla högst 250 tecken.

Experiences

En lista över platser på sidan där innehållserbjudandet levereras. En plats innehåller följande:

  • Experience local ID

    Ange eller mappa upplevelsens ID

  • Name

    Ange eller mappa namnet på upplevelsen

  • Audience IDs

    För varje publik som du vill se upplevelsen klickar du på Add item och anger publikens ID.

  • Visitor Percentage

    Ange eller mappa den procentandel besökare som tilldelats upplevelsen

Metrics
Third Party ID
Ange eller mappa ett ID för att identifiera aktiviteten. Du kan välja detta ID. Detta ID får inte vara samma som en annan aktivitet och får inte vara längre än 250 tecken.
Starts at
Ange eller mappa datumet och tiden för att starta aktiviteten i formatet YYYY-MM-DD hh:mm:ss.z.
Ends at
Ange eller mappa datum och tid för att avsluta aktiviteten i formatet YYYY-MM-DD hh:mm:ss.z.
State

Ange eller mappa aktivitetens tillstånd.

  • Approved

  • Deactivated

  • Paused

  • Saved

  • Deleted

Priority
Ange ett tal som definierar aktivitetens prioritet. Högre tal har högre prioritet. Värdet måste vara mellan 0 och 999. Standardvärdet är 5.
Auto-allocate traffic

Aktivera det här alternativet om du vill allokera trafik automatiskt. Automatisk allokering skickar mer trafik till en mer framgångsrik upplevelse.

Välj eller mappa utvärderingskriterierna för att bedöma vilken upplevelse som blir mest framgångsrik.

Workspace
Ange eller mappa arbetsytan som aktiviteten är kopplad till
Property IDs
För varje egenskap som du vill lägga till i aktiviteten klickar du på Add item och markerar eller mappar egenskapens ID.
Reporting audiences

För varje rapportpublik som du vill lägga till i aktiviteten klickar du på Add item och anger följande information:

  • Reporting Audience local ID

    Ange eller mappa en sträng som ska användas för att spåra rapportens målgrupp över API-begäranden.

  • Audience ID

    Ange eller mappa segmentet som ska användas vid rapportering

  • Metric local ID

    Ange eller mappa en sträng som ska användas för att spåra mätvärden över API-begäranden.

Erbjudandefält
Name
Ange eller mappa ett namn för aktiviteten. Namnet får innehålla högst 250 tecken.
Content
Ange eller mappa innehållet i erbjudandet som ska visas för användaren.
Workspace
Ange eller mappa ID:t för den arbetsyta som är associerad med erbjudandet. Om inget anges kopplas erbjudandet till kontots standardarbetsyta. Den här funktionen gäller endast för Target Premium-konton.
Workspace
Ange eller mappa det datum och den tidpunkt då erbjudandet ändrades.

Make a custom API call

Den här modulen gör ett anpassat API-anrop till API:t Adobe Target.

Connection
Instruktioner om hur du skapar en anslutning till Adobe Target finns i Skapa en anslutning till Adobe Target i den här artikeln.
Target Bas-URL
Ange eller mappa din Target-bas-URL.
Path
Ange en relativ sökväg till {baseURL}/
Method
Välj den HTTP-förfrågningsmetod som du behöver för att konfigurera API-anropet. Mer information finns i Metoder för HTTP-begäran i Adobe Workfront Fusion.
Headers

Lägg till rubrikerna för begäran i form av ett standard-JSON-objekt.

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

Workfront Fusion lägger automatiskt till auktoriseringsrubriker och x-api-key-rubriker.

Query String
Ange frågesträngen för begäran.
Body

Lägg till brödinnehållet för API-anropet i form av ett standard-JSON-objekt.

Obs!

När du använder villkorssatser som if i JSON placerar du citattecknen utanför villkorssatsen.

Delete a record

Den här åtgärdsmodulen tar bort en enstaka AB-aktivitet, XT-aktivitet, erbjudande eller publik.

Connection
Instruktioner om hur du skapar en anslutning till Adobe Target finns i Skapa en anslutning till Adobe Target i den här artikeln.
Record type
Välj den typ av post som du vill ta bort.
Record ID
Ange eller mappa ID:t för den post som du vill ta bort.

Read a record

Den här åtgärdsmodulen hämtar data för en aktivitet, ett erbjudande, en målgrupp, en egenskap eller en rapport.

Connection
Instruktioner om hur du skapar en anslutning till Adobe Target finns i Skapa en anslutning till Adobe Target i den här artikeln.
Record type
Välj den typ av post som du vill läsa.
Record ID
Ange eller mappa ID:t för den post som du vill läsa.

Update a record

Den här åtgärdsmodulen uppdaterar en post i Target.

Connection
Instruktioner om hur du skapar en anslutning till Adobe Target finns i Skapa en anslutning till Adobe Target i den här artikeln.
Record type
Välj den typ av post som du vill uppdatera.
Field names

Markera de fält som du vill uppdatera. Fälten visas nedan.

Mer information om fält finns i Adobe Target API-dokumentationen.

Sökningar

Get records

Den här sökmodulen hämtar en lista med poster av den valda typen.

Connection
Instruktioner om hur du skapar en anslutning till Adobe Target finns i Skapa en anslutning till Adobe Target i den här artikeln.
Record type
Välj den typ av post som du vill uppdatera.
Sort by
För varje fält som du vill sortera efter klickar du på Add item och väljer fältet och om de returnerade resultaten ska vara stigande eller fallande.
Starts At

Ange det tidigaste datum som du vill hämta poster för.

En lista över vilka datum- och tidsformat som stöds finns i Typtvång i Adobe Workfront Fusion.

Ends At

Ange det senaste datum som du vill hämta poster för.

En lista över vilka datum- och tidsformat som stöds finns i Typtvång i Adobe Workfront Fusion.

Den här sökmodulen söker efter aktiviteter, erbjudanden eller målgrupper baserat på kriterier som du anger.

Connection
Instruktioner om hur du skapar en anslutning till Adobe Target finns i Skapa en anslutning till Adobe Target i den här artikeln.
Record type
Välj den typ av post som du vill uppdatera.
Sort by
För varje fält som du vill sortera efter klickar du på Add item och väljer fältet och om de returnerade resultaten ska vara stigande eller fallande.
Search criteria
För varje regel som du vill ställa in markerar du fältet, operatorn och värdet. Klicka på Add AND rule om du vill skapa ytterligare regler.
Offset

Ange numret på det första svar som du vill att modulen ska returnera. Det första returnerade svaret har förskjutningen 0. Använd det här fältet i kombination med fältet Maximum number of returned results för att numrera svaren.

Om du till exempel vill se den tredje sidan med svar anger du Offset till 20 och Maximum number of returned resultat till 10 när varje sida har tio svar.

Limit

Ange eller mappa det maximala antal poster som du vill att modulen ska returnera under varje körningscykel för scenario. Använd det här fältet i kombination med fältet Offset för att numrera svaren.

Om du till exempel vill se den tredje sidan med svar anger du Offset till 20 och Maximum number of returned resultat till 10 när varje sida har tio svar.

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