Acionar campanhas orquestradas usando um sinal trigger-signal
Você pode acionar uma campanha Orquestrada enviando um sinal a ela em vez de executá-la de acordo com um agendamento. O sinal é enviado por uma chamada de API de um sistema ou aplicativo externo. Ao usar um sinal, você pode passar parâmetros. Eles são então disponibilizados na campanha orquestrada como variáveis de evento no contexto de execução — para uso em direcionamento, condições ou expressões.
Processo completo para acionar uma campanha orquestrada usando um sinal:
orchestrated-campaign.publish). Consulte Permissões internas.Programar a campanha para ser acionada por um sinal configure-signal
Para definir uma campanha orquestrada para iniciar em um sinal em vez de um agendamento, siga estas etapas:
-
Abra a campanha Orquestrada que deseja acionar usando um sinal.
-
Abra a configuração do cronograma. Saiba como agendar uma campanha orquestrada.
-
Selecione Acionado por um sinal para que a campanha aguarde um sinal em vez de ser executada de acordo com um agendamento.
Adicionar parâmetros para a carga útil do sinal (opcional) parameters
Você pode passar parâmetros no sinal de acionador e usá-los em sua campanha no contexto de execução, por exemplo, em direcionamento, condições ou expressões. Primeiro, defina cada parâmetro nas configurações de agendamento e passe o respectivo valor ao chamar a API de acionador.
-
Abra o agendador de campanhas e selecione Adicionar parâmetro.
-
Defina o nome de cada parâmetro e o tipo de dados que serão enviados na carga do sinal. Você também pode fornecer Valores de teste que serão usados quando você acionar a campanha no modo de teste. Saiba como testar uma campanha acionada.
Criar e testar a campanha build-and-test
Crie a campanha na tela e, opcionalmente, teste-a no rascunho acionando o sinal pela API antes de publicar.
-
Adicione e conecte atividades (público-alvo, direcionamento, deliveries) na tela. Saiba como orquestrar as atividades da campanha
-
Se você tiver definido parâmetros no sinal, é possível conectá-los à lógica da tela (por exemplo, em condições ou direcionamento). Neste exemplo, o parâmetro "channel" é usado como uma condição em uma atividade Test.
Para usar um parâmetro de sinal no editor de expressão (por exemplo, para criar uma consulta em uma atividade Criar público), digite
$(vars/@<parameterName>)no campo de expressão. Substitua<parameterName>pelo nome de parâmetro definido no agendador; por exemplo,$(vars/@channel). Saiba como trabalhar com o editor de expressão. -
Abra o agendador de campanha, selecione Copiar solicitação de API e escolha o formato (cURL ou Solicitação HTTP).
As informações copiadas incluem a ID da campanha orquestrada, o nome da sandbox, a ID da organização e os valores de teste dos parâmetros, se você tiver adicionado alguns.
accordion Exemplo de solicitação de cURL com um parâmetro e um valor de teste code language-bash POST https://platform.adobe.io/ajo/campaign-orchestration/orchestratedCampaigns/1c7529c7-7a8c-491a-a2c6-3d8131d2e17d/trigger Headers: Authorization: Bearer ## Access token ## Content-Type: application/json x-api-key: ## Provide API Key here ## x-api-version: 1 x-gw-ims-org-id: 123456ABCDEFG@LumaOrg x-sandbox-name: prod Body: { "variables": { "channel": "sms" } } -
Clique em Iniciar para iniciar a campanha.
-
Envie a chamada de API de acionador usando a solicitação de amostra copiada do scheduler.
Quando estiver satisfeito com os resultados do teste, publique a campanha.
Publicar e acionar a campanha publish
Depois de criar e testar a campanha, publique a campanha para que ela possa ser acionada pelo seu aplicativo.
-
Clique em Publicar na tela da campanha. A campanha deve ser publicada antes de ser acionada a partir de um sistema externo. Saiba mais sobre como iniciar e monitorar a campanha.
-
Abra o agendador de campanha, selecione Copiar solicitação de API e escolha o formato (cURL ou Solicitação HTTP).
As informações copiadas incluem a ID da campanha orquestrada, o nome da sandbox, a ID da organização e os parâmetros se você tiver adicionado alguns.
-
Chame a API de acionador do seu sistema.
note important IMPORTANT Para uma campanha orquestrada ao vivo, uma proteção de limitação impõe um intervalo mínimo de uma hora entre duas execuções de acionador de API. Se você chamar a API novamente antes que esse intervalo tenha decorrido, a API retornará o erro HTTP 429 (muitas solicitações). Essa proteção não é aplicada quando você aciona uma versão de rascunho para testá-la. Se você adicionou parâmetros à carga do sinal, os valores transmitidos na chamada de API serão expostos como variáveis de evento da campanha quando a campanha for executada. Para inspecioná-los, abra os logs de campanha na barra de ferramentas da tela de campanha. Na guia Tasks, identifique a tarefa correspondente ao sinal e clique no ícone de lápis para acessar as variáveis de evento relacionadas. Saiba como acessar logs e tarefas.
