Documentatie Campaign Documentatie voor Campaign Standard

Gebruiksscenario use-case

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

Onderwerpen:

Gemaakt voor:

tussenpersoon
Ontwikkelaar

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:

Een API-aanroep maken om Werkstroom 1 met externe parameters teweeg te brengen. Zie Stap 1: De API-aanroep configureren.
Workflow 1 samenstellen: de workflow zal een bestand overbrengen en in de database 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: Workflow 1 configureren.
Workflow 2 samenstellen: de workflow leest het publiek dat in workflow 1 is gemaakt en stuurt vervolgens een gepersonaliseerd bericht naar de profielen met een segmentcode die met de parameters is aangepast. Zie Stap 3: Workflow 2 configureren.

Vereisten prerequisites

Voordat u de workflows configureert, moet u eerst de workflows 1 en 2 maken met een External signal in elk van hen. 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. Raadpleeg voor meer informatie over de API-aanroepsyntaxis de Documentatie voor REST API's van Campaign Standard.

In ons geval willen we de workflow met de volgende parameters bellen:

fileToTarget: de naam van het bestand dat we in de database willen importeren.
discontoDesc: de beschrijving die we in de levering voor de korting willen weergeven.

-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: waarbij de externe parameters moeten worden gedeclareerd om binnen de werkstroom 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 of werk de database bij met gegevens uit het geïmporteerde bestand.
Test activiteit: controleert of er gegevens zijn geïmporteerd.
Save audience activiteit: als het bestand gegevens bevat, worden de profielen in een publiek opgeslagen.
End activity activiteit: roept Werkschema 2 met de parameters die 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. Open hiertoe de External signal en voeg vervolgens de namen en typen van de parameters toe.
Voeg een Transfer file activiteit om gegevens in het gegevensbestand in te voeren. Om dit te doen, sleep en laat vallen de activiteit, open het, dan selecteer Protocol tab.

Selecteer de Use a dynamic file path en gebruikt u vervolgens de fileToTarget parameter als het over te dragen bestand:

code language-none
`$(vars/@fileToTarget)`

Laad de gegevens uit het bestand in de database.

Sleep een Load file activiteit in het werkschema, dan vorm het op uw behoeften.
De database invoegen en bijwerken met gegevens uit het geïmporteerde bestand.

U doet dit door een Update data activiteit, dan selecteer Identification tab om een verzoeningscriterium toe te voegen (in ons geval email veld).
Selecteer de Fields to update en geeft u vervolgens de velden op die u wilt bijwerken in de database (in ons geval de firstname en email velden).
Controleer of gegevens uit het bestand zijn opgehaald. Sleep een Test in de workflow en klik vervolgens op 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. Hiervoor voegt u een Save audience aan de Doel is niet leeg openen.

Selecteer de Use a dynamic label en gebruikt u vervolgens de fileToTarget parameter als label van het publiek:

code language-none
`$(vars/@fileToTarget)`

Sleep een End activiteit die Werkschema 2 met parameters zal roepen, dan het openen.
Selecteer de External signal en geeft u 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 we de parameters doorgeven die oorspronkelijk in de API-aanroep zijn gedefinieerd (fileToTarget en discontoDesc) en een aanvullende segmentCode parameter met een constante waarde ("20% korting").

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 werkstroom te worden gebruikt.
Read audience activiteit: leest het publiek 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.

Open hiertoe de External signal activiteit, dan voeg de naam en het type van elke parameter toe die in End activiteit van Workflow 1.
Gebruik het publiek dat in Werkstroom 1 is opgeslagen. Sleep een Read audience in de werkstroom te openen en vervolgens te openen.

Selecteer de Use a dynamic audience en gebruikt u vervolgens de fileToTarget parameter als de naam van het publiek dat moet worden gelezen:

code language-none
`$(vars/@fileToTarget)`

Geef de uitgaande overgang een naam op basis van de segmentCode parameter.

Selecteer de optie Transition en vervolgens de Use a dynamic segment code -optie.

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 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 Recurring email.
Selecteer de sjabloon die u wilt gebruiken en definieer de e-maileigenschappen naar wens.
Gebruik de discontoDesc parameter als een 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.