DocumentaçãoJourney OptimizerGuia do Journey Optimizer

Criar uma Atividade em tempo real create-mobile-live

Última atualização: 7 de setembro de 2026

Criado para:

  • Iniciante
  • Usuário

Nesta página: crie uma campanha acionada por API no Journey Optimizer para que você possa iniciar, atualizar e encerrar atividades online remotamente para usuários individuais ou públicos.

style
shade-box

Após definir a configuração móvel e implementar o Adobe Experience Platform mobile SDK, você pode começar a criar sua atividade Live no Journey Optimizer:

  1. Acesse o menu Campanhas e clique em Criar campanha.

  2. Selecione o tipo de campanha API acionada.

    • Selecione Marketing acionado por API para campanhas baseadas em público-alvo

    • Selecione Transacional acionado por API para campanhas individuais.

    note important
    IMPORTANT
    Observe que para a Transacional acionada por API, a opção Alta Taxa de Transferência não deve estar habilitada.

  3. Na seção Propriedades, edite o Título e a Descrição da sua campanha.

  4. Na seção Actions, escolha Atividade online e selecione ou crie uma nova configuração.

    Saiba mais sobre a configuração de atividade do Live em esta página.

  5. Clique em Criar experimento para começar a configurar seu experimento de conteúdo e criar tratamentos para medir seu desempenho e identificar a melhor opção para seu público-alvo. Saiba mais

  6. Na guia Público, escolha seu Tipo de identidade Saiba mais.

    note
    NOTE
    Para campanhas de Marketing acionado por API, você pode selecionar um público existente que atue como a primeira segmentação antes de verificar a assinatura de channelID APNs da carga da API.

  7. As campanhas são projetadas para serem executadas em uma data específica ou em uma frequência recorrente. Saiba como configurar o Cronograma da sua campanha no nesta seção.

  8. Após a configuração, clique em Revisar para ativar e em Ativar.

  9. Depois que a campanha for ativada, use a cURL request fornecida como um modelo para acionar os eventos de início, atualização ou término da atividade do Live. Atualize o payload de amostra com seus dados específicos antes da execução.

    Copie também os identificadores da ID da campanha para incluir em sua carga.

    ➡️ Consulte a Documentação de Campanhas acionadas por API para obter os requisitos de autenticação, incluindo tokens OAuth e chaves de API.

    accordion
    Exemplo de carga para casos de uso unitários (campanha transacional acionada por API)

    Este exemplo de conteúdo é para campanhas individuais que usam o tipo de campanha Transacional acionado por API. Observe que a maioria dos campos do exemplo de carga a seguir são obrigatórios, somente requestId, dismissal-date e alert são opcionais.

    code language-json 
    {
    "requestId": "your-request-id",
    "campaignId": "your-campaign-id",
    "recipients": [
{
    "type": "aep",
    "userId": "testemail@gmail.com",
    "namespace": "email",
    "context": {
     "requestPayload": {
    "aps": {
    "content-available": 1,
    "timestamp": 1756984054,              // current epoch time
    "dismissal-date": 1756984084,         // optional – auto remove when event="end"
    "event": "update",                    // start | update | end

    // Fields from FoodDeliveryLiveActivityAttributes
    "content-state": {
      "orderStatus": "Delivered"
    },

    "attributes-type": "FoodDeliveryLiveActivityAttributes",
    "attributes": {
      "restaurantName": "Pizza",
      "liveActivityData": {
        "liveActivityID": "orderId1"       // customer reference ID
      }
    },

    "alert": {
      "title": "Order Delivered!",
      "body": "Your pizza has arrived."
    }
  }
}
}
}
]
}
    accordion
    Exemplo de uma carga para casos de uso de transmissão (campanha de marketing acionada por API)

    Este exemplo de conteúdo é para campanhas baseadas em público usando o tipo de campanha Marketing acionado por API.

    code language-json 
    {
    "requestId": "123400000",
    "campaignId": "d32e6f6c-56df-4a98-a2c0-6db6008f8f32",
    "audience": {
        "id": "508f9416-52d0-4898-ba47-08baaa22e9c7"
    },
    "context": {
        "requestPayload": {
            "aps": {
                "input-push-channel": "V+8UslywEfAAAOq9SbTrLg==",  //apns-channel-id
                "content-available": 1,
                "timestamp": 1770808339,
                "event": "update",   // start | update | end

                // Fields from GameScoreLiveActivityAttributes
                "content-state": {
                    "homeTeamScore": 33,
                    "awayTeamScore": 49,
                    "statusText": "Wingdom keeps scoring!"
                },
                "attributes-type": "GameScoreLiveActivityAttributes",
                "attributes": {
                    "liveActivityData": {
                        "channelID": "V+8UslywEfAAAOq9SbTrLg=="   //apns-channel-id, must match the "input-push-channel" value
                    }
                },
                "alert": {
                    "title": "This is the title for game",
                    "body": "This is the body for body"
                }
            }
        }
    }
}

Depois de projetar sua atividade Live, você pode acompanhar a medição do impacto da atividade Live com relatórios internos.

TIP
Se a sua atividade do Live não estiver aparecendo ou sendo atualizada conforme esperado, consulte Solucionar problemas de atividades do Live para obter uma orientação passo a passo sobre depuração.

Adicionar dados personalizados com metadados de execução metadata

AVAILABILITY
executionMetadata está disponível somente para campanhas Transacionais acionadas por API.

Anexe seus próprios dados personalizados a um perfil, como uma ID de pedido, uma camada de fidelidade ou um código de região, usando o campo executionMetadata opcional. A Journey Optimizer armazena esses dados junto com a execução para que você possa recuperá-los posteriormente do seu conjunto de dados de comentários de atividades em tempo real e fazer a correspondência dos resultados da entrega com seus próprios registros comerciais.

Para enviar esses dados por meio da API, consulte a Referência da API de mensagens para o campo executionMetadata. Para ler os valores novamente no dispositivo, consulte o guia do Mobile SDK sobre como receber metadados de execução do acionador de API.

Para adicionar dados personalizados com metadados de execução:

  • Adicionar executionMetadata a um perfil, próximo a userId e namespace. Somente chaves de sequência de caracteres e valores de sequência de caracteres são aceitos. Converta qualquer valor que não seja de sequência de caracteres em uma sequência de caracteres antes de enviá-lo.

  • Os valores são registrados exatamente como enviados. executionMetadata não oferece suporte a expressões de personalização, portanto, qualquer expressão {{...}} é tratada como texto literal em vez de resolvida. Você sempre deve enviar valores finais e literais.

  • Cada perfil pode carregar até 50 pares de chave/valor, com um limite de tamanho combinado de 2 KB para todas as chaves e valores. Os metadados que excedem esse limite são descartados, mas a atividade Live ainda é entregue. Limite o conteúdo às informações necessárias para fins de relatório.

Exemplo de JSON

Neste exemplo, orderId, tier, restaurant e region são seus próprios valores. Depois que a atividade Live for acionada, você poderá lê-las no conjunto de dados de feedback para vincular o delivery ao registro do seu pedido.

code language-json 
{
    "requestId": "your-request-id",
    "campaignId": "your-campaign-id",
    "recipients": [
        {
            "type": "aep",
            "userId": "testemail@gmail.com",
            "namespace": "email",
            "executionMetadata": {
                "orderId": "A-123",
                "tier": "gold",
                "restaurant": "PizzaPlace",
                "region": "EU"
            },
            "context": {
                "requestPayload": {
                    "aps": {
                        "content-available": 1,
                        "timestamp": 1756984054,
                        "dismissal-date": 1756984084,
                        "event": "update",
                        "content-state": {
                            "orderStatus": "Delivered"
                        },
                        "attributes-type": "FoodDeliveryLiveActivityAttributes",
                        "attributes": {
                            "restaurantName": "PizzaPlace",
                            "liveActivityData": {
                                "liveActivityID": "orderId1"
                            }
                        },
                        "alert": {
                            "title": "Order Delivered!",
                            "body": "Your pizza has arrived."
                        }
                    }
                }
            }
        }
    ]
}

Vídeo tutorial

Descubra como configurar as atividades em tempo real do iOS com o Adobe Journey Optimizer para fornecer atualizações avançadas em tempo real na Tela de bloqueio do iPhone e no Dynamic Island.

https://video.tv.adobe.com/v/3479869?captions=por_br&learn=on
recommendation-more-help
journey-optimizer-help