DokumentationCampaignDokumentation om Campaign Standard

Användningsfall use-case

Last update: Fri Jul 19 2024 00:00:00 GMT+0000 (Coordinated Universal Time)
  • Ämnen:

Skapat för:

  • Mellanliggande
  • Utvecklare

I exemplet nedan visas hur du anropar arbetsflöden med parametrar i dina arbetsflöden.

Målet är att utlösa ett arbetsflöde från ett API-anrop med externa parametrar. Det här arbetsflödet läser in data i databasen från en fil och skapar en associerad målgrupp. När målgruppen har skapats aktiveras ett andra arbetsflöde för att skicka ett meddelande som är anpassat med de externa parametrar som definierats i API-anropet.

För att kunna utföra det här användningsfallet måste du utföra åtgärderna nedan:

  1. Gör ett API-anrop för att utlösa arbetsflöde 1 med externa parametrar. Se Steg 1: Konfigurera API-anropet.
  2. Bygg arbetsflöde 1: arbetsflödet överför en fil och läser in den i databasen. Sedan testas om data är tomma eller inte och slutligen sparas profilerna i en målgrupp. Slutligen utlöses arbetsflöde 2. Se Steg 2: Konfigurera arbetsflöde 1.
  3. Bygg arbetsflöde 2: Arbetsflödet läser målgruppen som har skapats i arbetsflöde 1 och skickar sedan ett anpassat meddelande till profilerna, med en segmentkod som har anpassats med parametrarna. Se Steg 3: Konfigurera arbetsflöde 2.

Förhandskrav prerequisites

Innan du konfigurerar arbetsflödena måste du skapa arbetsflödet 1 och 2 med en External signal-aktivitet i var och en av dem. På så sätt kan du rikta in dig på de här signalaktiviteterna när du anropar arbetsflödena.

Steg 1: Konfigurera API-anropet step-1--configuring-the-api-call

Gör ett API-anrop för att utlösa arbetsflöde 1 med parametrar. Mer information om API-anropssyntaxen finns i Campaign Standardens REST API:er-dokumentation.

I det här fallet vill vi anropa arbetsflödet med följande parametrar:

  • fileToTarget: namnet på filen som ska importeras till databasen.
  • rabattDesc: den beskrivning som ska visas i rabattleveransen.
-X POST https://mc.adobe.io/<ORGANIZATION>/campaign/<TRIGGER_URL>
-H 'Authorization: Bearer <ACCESS_TOKEN>'
-H 'Cache-Control: no-cache'
-H 'X-Api-Key: <API_KEY>'
-H 'Content-Type: application/json;charset=utf-8'
-H 'Content-Length:79'
-i
-d {
-d "source:":"API",
-d "parameters":{
-d "fileToTarget":"profile.txt",
-d "discountDesc":"Running shoes"
-d }

Steg 2: Konfigurera arbetsflöde 1 step-2--configuring-workflow-1

Arbetsflöde 1 byggs enligt nedan:

  • External signal-aktivitet: där externa parametrar måste deklareras för att kunna användas i arbetsflödet.
  • Transfer file-aktivitet: importerar filen med det namn som definieras i parametrarna.
  • Load file-aktivitet: läser in data från den importerade filen till databasen.
  • Update data-aktivitet: infoga eller uppdatera databasen med data från den importerade filen.
  • Test-aktivitet: kontrollerar om det finns importerade data.
  • Save audience-aktivitet: om filen innehåller data sparar profilerna i en målgrupp.
  • End activity aktivitet: anropar arbetsflöde 2 med de parametrar som du vill använda i det.

Konfigurera arbetsflödet genom att följa stegen nedan:

  1. Deklarera de parametrar som har definierats i API-anropet. Det gör du genom att öppna aktiviteten External signal och sedan lägga till parameternamn och typer.

  2. Lägg till en Transfer file-aktivitet för att importera data till databasen.Det gör du genom att dra och släppa aktiviteten, öppna den och sedan välja fliken Protocol.

  3. Välj alternativet Use a dynamic file path och använd sedan parametern fileToTarget som den fil som ska överföras:

    code language-none 
    $(vars/@fileToTarget)

  4. Läs in data från filen i databasen.

    Det gör du genom att dra och släppa en Load file-aktivitet i arbetsflödet och sedan konfigurera den efter dina behov.

  5. Infoga och uppdatera databasen med data från den importerade filen.

    Det gör du genom att dra och släppa en Update data-aktivitet och sedan välja fliken Identification för att lägga till ett avstämningsvillkor (i vårt fall fältet email).

  6. Välj fliken Fields to update och ange sedan de fält som ska uppdateras i databasen (i vårt fall fälten förnamn och e-post).

  7. Kontrollera om data har hämtats från filen. Det gör du genom att dra och släppa en Test-aktivitet i arbetsflödet och sedan klicka på knappen Add an element för att lägga till ett villkor.

  8. Namnge och definiera villkoret. I det här fallet vill vi testa om den utgående övergången innehåller data med syntaxen nedan:

    code language-none 
    $long(vars/@recCount)>0

  9. Om data hämtas sparar du dem i en målgrupp. Det gör du genom att lägga till en Save audience-aktivitet i övergången Mål är inte tom och sedan öppna den.

  10. Välj alternativet Use a dynamic label och använd sedan parametern fileToTarget som etikett för målgruppen:

    code language-none 
    $(vars/@fileToTarget)

  11. Dra och släpp en End-aktivitet som anropar arbetsflöde 2 med parametrar och öppna den.

  12. Välj fliken External signal och ange sedan arbetsflödet som ska utlösas och dess associerade signalaktivitet.

  13. Definiera de parametrar som du vill använda i arbetsflöde 2 och deras associerade värden.

    I vårt fall vill vi skicka de parametrar som ursprungligen definierades i API-anropet (fileToTarget och rabattDesc) och en ytterligare segmentCode -parameter med ett konstant värde ("20 % rabatt").

Arbetsflöde 1 är konfigurerat och du kan nu skapa arbetsflöde 2. Mer information om detta finns i det här avsnittet.

Steg 3: Konfigurera arbetsflöde 2 step-3--configuring-workflow-2

Arbetsflöde 2 byggs enligt nedan:

  • External signal-aktivitet: där parametrarna måste deklareras för att kunna användas i arbetsflödet.
  • Read audience-aktivitet: läser målgruppen som har sparats i arbetsflöde 1.
  • Email delivery-aktivitet: skickar ett återkommande meddelande till målgruppen, anpassat med parametrar.

Konfigurera arbetsflödet genom att följa stegen nedan:

  1. Deklarera parametrarna som har definierats i Arbetsflöde 1.

    Det gör du genom att öppna aktiviteten External signal och sedan lägga till namn och typ för varje parameter som definieras i aktiviteten End i arbetsflöde 1.

  2. Använd målgruppen som har sparats i arbetsflöde 1. Det gör du genom att dra och släppa en Read audience-aktivitet i arbetsflödet och sedan öppna den.

  3. Välj alternativet Use a dynamic audience och använd sedan parametern fileToTarget som namn på målgruppen som ska läsas:

    code language-none 
    $(vars/@fileToTarget)

  4. Namnge den utgående övergången enligt parametern segmentCode.

    Om du vill göra det väljer du fliken Transition och sedan alternativet Use a dynamic segment code.

  5. Använd parametern segmentCode som namn på den utgående övergången:

    code language-none 
    $(vars/@segmentCode)

  6. Dra och släpp en Email delivery-aktivitet för att skicka ett meddelande till målgruppen.

  7. Identifiera de parametrar som ska användas i meddelandet för att anpassa det med parametern rabattDesc . Det gör du genom att öppna aktivitetens avancerade alternativ och sedan lägga till parameternamnet och värdet.

  8. Du kan nu konfigurera meddelandet. Öppna aktiviteten och välj sedan Recurring email.

  9. Välj den mall som ska användas och definiera sedan e-postegenskaperna efter dina behov.

  10. Använd parametern rabattDesc som ett anpassningsfält. Det gör du genom att välja det i listan med anpassningsfält.

  11. Nu kan du slutföra konfigurationen av meddelandet och sedan skicka det som vanligt.

Köra arbetsflöden executing-the-workflows

När arbetsflödena har skapats kan du köra dem. Kontrollera att de två arbetsflödena har startats innan du utför API-anropet.

recommendation-more-help
3ef63344-7f3d-48f9-85ed-02bf569c4fff