DokumentationDokumentation om Campaign Standard

Användningsfall use-case

Last update: Fri Dec 29 2023 00:00:00 GMT+0000 (Coordinated Universal Time)

Skapat för:

  • Intermediate
  • Developer

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. Anropa ett API 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 är anpassad efter 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 Standard 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 vi vill visa 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 de externa parametrarna 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. Öppna External signal lägger du sedan till parameternamn och typer.

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

  3. Välj Use a dynamic file path kan du sedan använda fileToTarget -parameter som filen 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 -aktiviteten 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 väljer du Identification för att lägga till ett avstämningsvillkor (i vårt fall e-post fält).

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

  7. Kontrollera om data har hämtats från filen. Det gör du genom att dra och släppa en Test till arbetsflödet och klicka sedan på 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. Lägg till en Save audience till Målet är inte tomt och sedan öppna den.

  10. Välj Use a dynamic label kan du sedan använda fileToTarget som publikens etikett:

    code language-none 
    $(vars/@fileToTarget)

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

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

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

    I det här fallet vill vi skicka de parametrar som ursprungligen definierades i API-anropet (fileToTarget och rabattDesc) och 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 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.

    Öppna External signal lägger sedan till namn och typ för varje parameter som definieras i End aktivitet 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 till arbetsflödet och öppna det.

  3. Välj Use a dynamic audience kan du sedan använda fileToTarget parameter som namnet på målgruppen som ska läsas:

    code language-none 
    $(vars/@fileToTarget)

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

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

  5. Använd segmentCode parameter som namnet 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 rabattDesc parameter. 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 Recurring email.

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

  10. Använd rabattDesc parameter som ett personaliseringsfä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