Caso de uso

O caso de uso abaixo mostra como chamar o workflow com parâmetros em seus workflows.

O objetivo é acionar um workflow de uma chamada de API com parâmetros externos. Esse workflow carregará dados no seu banco de dados a partir de um arquivo e criará um público-alvo associado. Depois que o público-alvo for criado, um segundo workflow será acionado para enviar uma mensagem personalizada com os parâmetros externos definidos na chamada da API.

Para executar esse caso de uso, é necessário executar as ações abaixo:

  1. Faça uma chamada de API para acionar o fluxo de trabalho 1 com parâmetros externos. Consulte Etapa 1: Configurar a chamada da API.
  2. Fluxo de trabalho da build 1: o workflow transferirá um arquivo e o carregará no banco de dados. Em seguida, ele testará se os dados estão vazios ou não e, eventualmente, salvará os perfis em um público-alvo. Por fim, ele acionará o Workflow 2. Consulte Etapa 2: Configurando o Fluxo de Trabalho 1.
  3. Fluxo de trabalho da build 2: o fluxo de trabalho lerá o público criado no fluxo de trabalho 1 e enviará uma mensagem personalizada para os perfis, com um código de segmento personalizado com os parâmetros. Consulte Etapa 3: Configurando o Fluxo de Trabalho 2.

Pré-requisitos

Antes de configurar os workflows, é necessário criar o Workflow 1 e 2 com uma atividade External signal em cada um deles. Dessa forma, você poderá direcionar essas atividades de sinal ao chamar os workflows.

Etapa 1: Configurar a chamada da API

Faça uma chamada de API para acionar o Fluxo de trabalho 1 com parâmetros. Para obter mais informações sobre a sintaxe de chamada de API, consulte a documentação sobre APIs REST do Campaign Standard.

Em nosso caso, queremos chamar o workflow com os parâmetros abaixo:

  • fileToTarget: o nome do arquivo que queremos importar no banco de dados.
  • descontoDesc: a descrição que queremos exibir no delivery do desconto.
-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 } 

Etapa 2: Configurar o fluxo de trabalho 1

O workflow 1 será criado conforme abaixo:

  • External signal atividade : onde os parâmetros externos devem ser declarados para serem usados no workflow.
  • Transfer file atividade : importa o arquivo com o nome definido nos parâmetros.
  • Load file atividade : carrega dados do arquivo importado no banco de dados.
  • Update data atividade : inserir ou atualizar o banco de dados com dados do arquivo importado.
  • Test atividade : verifica se há dados importados.
  • Save audience atividade : se o arquivo contiver dados, salvará os perfis em um público-alvo.
  • End activity atividade : chama Workflow 2 com os parâmetros que você deseja usar dentro dele.

Siga as etapas abaixo para configurar o workflow:

  1. Declarar os parâmetros que foram definidos na chamada da API. Para fazer isso, abra a atividade External signal e adicione os nomes e tipos dos parâmetros.

  2. Adicione uma atividade Transfer file para importar dados para o banco de dados. Para fazer isso, arraste e solte a atividade, abra-a e selecione a guia Protocol.

  3. Selecione a opção Use a dynamic file path e use o parâmetro fileToTarget como o arquivo a ser transferido:

    $(vars/@fileToTarget)
    

  4. Carregue os dados do arquivo no banco de dados.

    Para fazer isso, arraste e solte uma atividade Load file no workflow e configure-a de acordo com suas necessidades.

  5. Insira e atualize o banco de dados com dados do arquivo importado.

    Para fazer isso, arraste e solte uma atividade Update data e selecione a guia Identification para adicionar um critério de reconciliação (no nosso caso, o campo email).

  6. Selecione a guia Fields to update e especifique os campos a serem atualizados no banco de dados (no nosso caso, os campos firstname e email).

  7. Verifique se os dados foram recuperados do arquivo . Para fazer isso, arraste e solte uma atividade Test no workflow e clique no botão Add an element para adicionar uma condição.

  8. Nomeie e defina a condição. No nosso caso, queremos testar se a transição de saída contém dados com a sintaxe abaixo:

    $long(vars/@recCount)>0
    

  9. Se os dados forem recuperados, salve-os em um público-alvo. Para fazer isso, adicione uma atividade Save audience à transição Target que não esteja vazia e depois a abra.

  10. Selecione a opção Use a dynamic label e use o parâmetro fileToTarget como o rótulo do público-alvo:

    $(vars/@fileToTarget)
    

  11. Arraste e solte uma atividade End que chamará o Workflow 2 com parâmetros e depois a abra.

  12. Selecione a guia External signal e especifique o workflow a ser acionado e sua atividade de sinal associada.

  13. Defina os parâmetros que deseja usar no Workflow 2 e seus valores associados.

    Em nosso caso, queremos transmitir os parâmetros originalmente definidos na chamada da API (fileToTarget e discountDesc), e um parâmetro segmentCode adicional com um valor constante ("20% de desconto").

O workflow 1 está configurado, agora você pode criar o Workflow 2. Para obter mais informações, consulte esta seção.

Etapa 3: Configurar o fluxo de trabalho 2

O workflow 2 será criado conforme abaixo:

  • External signal atividade : onde os parâmetros devem ser declarados para serem usados no workflow.
  • Read audience atividade : O lê o público-alvo salvo no Fluxo de trabalho 1.
  • Email delivery atividade : envia uma mensagem recorrente para o público-alvo, personalizado com parâmetros.

Siga as etapas abaixo para configurar o workflow:

  1. Declarar os parâmetros que foram definidos no Fluxo de trabalho 1.

    Para fazer isso, abra a atividade External signal e adicione o nome e o tipo de cada parâmetro definido na atividade End do Workflow 1.

  2. Use o público salvo no Fluxo de trabalho 1. Para fazer isso, arraste e solte uma atividade Read audience no workflow e depois a abra.

  3. Selecione a opção Use a dynamic audience e use o parâmetro fileToTarget como o nome do público-alvo a ser lido:

    $(vars/@fileToTarget)
    

  4. Nomeie a transição de saída de acordo com o parâmetro segmentCode.

    Para fazer isso, selecione a guia Transition e depois a opção Use a dynamic segment code.

  5. Use o parâmetro segmentCode como o nome da transição de saída:

    $(vars/@segmentCode)
    

  6. Arraste e solte uma atividade Email delivery para enviar uma mensagem ao público.

  7. Identifique os parâmetros a serem usados na mensagem para personalizá-la com o parâmetro discountDesc. Para fazer isso, abra as opções avançadas da atividade e adicione o nome e o valor do parâmetro.

  8. Agora você pode configurar a mensagem. Abra a atividade e selecione Recurring email.

  9. Selecione o template a ser usado e defina as propriedades do email de acordo com suas necessidades.

  10. Use o parâmetro discountDesc como um campo de personalização. Para fazer isso, selecione-o na lista de campos de personalização.

  11. Agora você pode concluir a configuração da mensagem e enviá-la como de costume.

Execução dos workflows

Depois que os workflows forem criados, você poderá executá-los. Verifique se os dois fluxos de trabalho foram iniciados antes de executar a chamada da API.

Nesta página

Adobe Summit Banner

A virtual event April 27-28.

Expand your skills and get inspired.

Register for free
Adobe Summit Banner

A virtual event April 27-28.

Expand your skills and get inspired.

Register for free
Adobe Maker Awards Banner

Time to shine!

Apply now for the 2021 Adobe Experience Maker Awards.

Apply now
Adobe Maker Awards Banner

Time to shine!

Apply now for the 2021 Adobe Experience Maker Awards.

Apply now