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