Gebruiksscenario use-case
Het onderstaande gebruiksgeval laat zien hoe u een workflow met parameters in uw workflows kunt aanroepen.
Het doel is een workflow te activeren vanaf een API-aanroep met externe parameters. Deze workflow laadt gegevens uit een bestand in uw database en maakt een gekoppeld publiek. Zodra het publiek is gecreeerd, zal een tweede werkschema worden teweeggebracht om een bericht te verzenden dat met de externe parameters wordt gepersonaliseerd die in de API vraag worden bepaald.
Voor dit gebruik moet u de volgende handelingen uitvoeren:
- maak een API vraag om Werkschema 1 met externe parameters teweeg te brengen. Zie Stap 1: Het vormen van de API vraag .
- bouwt Werkschema 1: het werkschema zal een dossier overbrengen en het in het gegevensbestand laden. Vervolgens wordt getest of de gegevens leeg zijn of niet en worden de profielen uiteindelijk in een publiek opgeslagen. Tot slot zal het Werkschema 2 teweegbrengen. Zie Stap 2: Het vormen Workflow 1 .
- bouwt Werkschema 2: het werkschema zal het publiek lezen dat in Werkschema 1 is gecreeerd, dan verzend een gepersonaliseerd bericht naar de profielen, met een segmentcode die met de parameters wordt aangepast. Zie Stap 3: Het vormen Workflow 2 .
Vereisten prerequisites
Voordat u de workflows configureert, moet u eerst de workflows 1 en 2 maken met een External signal -activiteit in elk van deze workflows. Deze manier, zult u deze signaalactiviteiten kunnen richten wanneer het roepen van de werkschema's.
Stap 1: De API-aanroep configureren step-1--configuring-the-api-call
Maak een API vraag om Werkstroom 1 met parameters teweeg te brengen. Voor meer op de API vraagsyntaxis, verwijs naar de documentatie van Campaign Standard REST APIs .
In ons geval willen we de workflow met de volgende parameters bellen:
- fileToTarget: de naam van het dossier dat wij in het gegevensbestand willen invoeren.
- discontoDesc: de beschrijving die wij in de levering voor de korting willen tonen.
-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 }
Stap 2: Workflow 1 configureren step-2--configuring-workflow-1
Workflow 1 wordt als volgt samengesteld:
- External signal -activiteit: waar de externe parameters moeten worden gedeclareerd om binnen de workflow te worden gebruikt.
- Transfer file -activiteit: importeert het bestand met de naam die in de parameters is gedefinieerd.
- Load file activiteit: laadt gegevens uit het geïmporteerde bestand in de database.
- Update data -activiteit: voeg de database in of werk deze bij met gegevens uit het geïmporteerde bestand.
- Test activiteit: hiermee wordt gecontroleerd of er gegevens zijn geïmporteerd.
- Save audience -activiteit: als het bestand gegevens bevat, worden de profielen opgeslagen in een publiek.
- End activity activiteit: roept Werkstroom 2 met de parameters aan u binnen het wilt gebruiken.
Voer de onderstaande stappen uit om de workflow te configureren:
-
Declareer de parameters die in de API vraag zijn bepaald. Hiertoe opent u de External signal -activiteit en voegt u de namen en typen van de parameters toe.
-
Voeg een Transfer file -activiteit toe om gegevens in de database te importeren. U doet dit door de activiteit te slepen en neer te zetten, deze te openen en vervolgens het tabblad Protocol te selecteren.
-
Selecteer de Use a dynamic file path optie, dan gebruik de fileToTarget parameter als over te brengen dossier:
code language-none $(vars/@fileToTarget)
-
Laad de gegevens uit het bestand in de database.
Hiervoor sleept u een Load file -activiteit naar de workflow en configureert u deze op basis van uw behoeften.
-
De database invoegen en bijwerken met gegevens uit het geïmporteerde bestand.
Om dit te doen, sleep en laat vallen een Update data activiteit, dan selecteren het Identification lusje om een verzoeningscriteria (in ons geval het e-mail gebied) toe te voegen.
-
Selecteer het Fields to update lusje, dan specificeer de gebieden in het gegevensbestand (in ons geval de eerste naam en e-mail gebieden) bij te werken.
-
Controleer of gegevens uit het bestand zijn opgehaald. Hiervoor sleept u een Test -activiteit naar de workflow en klikt u op de knop Add an element om een voorwaarde toe te voegen.
-
Geef de voorwaarde een naam en definieer deze. In ons geval, willen wij testen of bevat de uitgaande overgang gegevens met de syntaxis hieronder:
code language-none $long(vars/@recCount)>0
-
Als gegevens worden opgehaald, slaat u deze op in een publiek. Om dit te doen, voeg a Save audience activiteit aan het niet lege Doel overgang toe, dan open het.
-
Selecteer de Use a dynamic label optie, dan gebruik de fileToTarget parameter als etiket van het publiek:
code language-none $(vars/@fileToTarget)
-
Sleep een End -activiteit die Workflow 2 aanroept met parameters en open deze vervolgens.
-
Selecteer het tabblad External signal en geef vervolgens de workflow op die moet worden geactiveerd en de bijbehorende signaalactiviteit.
-
Bepaal de parameters die u binnen Werkschema 2 en hun bijbehorende waarden wilt gebruiken.
In ons geval, willen wij de parameters die oorspronkelijk in de API vraag (worden bepaald fileToTarget en discontoDesc), en een extra segmentCode parameter met een constante waarde ("20% korting") overgaan.
Werkschema 1 wordt gevormd, kunt u Werkschema 2 nu bouwen. Raadpleeg deze sectie voor meer informatie.
Stap 3: Workflow 2 configureren step-3--configuring-workflow-2
Workflow 2 wordt als volgt samengesteld:
- External signal activiteit: waar de parameters moeten worden gedeclareerd om binnen de workflow te worden gebruikt.
- Read audience activity: leest het publiek dat is opgeslagen in Workflow 1.
- Email delivery activiteit: verzendt een terugkerend bericht naar het gerichte publiek, gepersonaliseerd met parameters.
Voer de onderstaande stappen uit om de workflow te configureren:
-
Declareer de parameters die in Werkschema 1 zijn bepaald.
Hiertoe opent u de External signal -activiteit en voegt u vervolgens de naam en het type van elke parameter toe die is gedefinieerd in de End -activiteit van Workflow 1.
-
Gebruik het publiek dat in Werkstroom 1 is opgeslagen. Hiervoor sleept u een Read audience -activiteit naar de workflow en opent u deze.
-
Selecteer de Use a dynamic audience optie, dan gebruik de fileToTarget parameter als naam van het te lezen publiek:
code language-none $(vars/@fileToTarget)
-
Noem de uitgaande overgang volgens de segmentCode parameter.
Selecteer hiervoor de tab Transition en vervolgens de optie Use a dynamic segment code .
-
Gebruik de segmentCode parameter als naam van de uitgaande overgang:
code language-none $(vars/@segmentCode)
-
Sleep een Email delivery -activiteit om een bericht naar het publiek te verzenden.
-
Identificeer de parameters in het bericht te gebruiken om het met de te personaliseren discontoDesc parameter. Hiervoor opent u de geavanceerde opties van de activiteit en voegt u vervolgens de parameternaam en -waarde toe.
-
U kunt het bericht nu vormen. Open de activiteit en selecteer vervolgens Recurring email .
-
Selecteer de sjabloon die u wilt gebruiken en definieer de e-maileigenschappen naar wens.
-
Gebruik de discontoDesc parameter als verpersoonlijkingsgebied. Selecteer dit in de lijst met personalisatievelden.
-
U kunt nu klaar zijn met het configureren van het bericht en het vervolgens op de gebruikelijke manier verzenden.
Workflows uitvoeren executing-the-workflows
Nadat de workflows zijn samengesteld, kunt u deze uitvoeren. Zorg ervoor dat de twee workflows zijn gestart voordat u de API-aanroep uitvoert.