Solução de problemas de atividades ativas troubleshoot-mobile-live
As atividades ativas no Adobe Journey Optimizer permitem atualizações dinâmicas e em tempo real nas telas de bloqueio do iOS e nas Ilhas dinâmicas. Eles só podem ser acionados e gerenciados por meio de Campanhas acionadas por API.
Tipos de caso de uso:
- Unitário: direcionado individualmente, transacional (campanhas transacionais acionadas por API)
- Transmissão: entrega em massa direcionada por público-alvo (campanhas de marketing acionadas por API)
Um desafio frequente com as Atividades ativas é quando a chamada da API para acionar ou atualizar uma Atividade ativa retorna uma resposta bem-sucedida (200 OK), mas a Atividade ativa não é exibida ou atualizada no dispositivo do usuário. Essa desconexão entre a confirmação da API e o comportamento real do dispositivo pode ocorrer em vários pontos do pipeline de entrega. Este guia fornece uma abordagem sistemática de solução de problemas para identificar onde o delivery está falhando, examinando cada estágio da validação da solicitação de API à renderização do dispositivo.
Pré-requisitos
Antes de solucionar problemas, verifique se você tem:
-
accordion Configurar uma sessão do Assurance Configure uma sessão do Assurance para capturar eventos do SDK e inspecionar o pipeline de entrega. O Assurance oferece visibilidade sobre:
- Solicitações e respostas do Edge Network
- Eventos de qualificação de perfil
- Registro do token de push
- Eventos de ciclo de vida de atividade ao vivo
Saiba como configurar o Assurance na documentação do Adobe Experience Platform Assurance.
Observação: para o iOS Live Activity, verifique se seu aplicativo está sendo executado em um dispositivo físico iOS (iOS 16.1 ou posterior) ou no Xcode Simulator (iOS 16.1 ou posterior).
-
accordion Coletar detalhes da campanha acionada pela API Navegue até a Campanha acionada pela API no Journey Optimizer e recupere:
- Nome da campanha
- ID da campanha encontrada nas propriedades URL ou campaign
- Versão do Campaign, se aplicável
- Configuração de superfície, superfície de aplicativo do iOS usada para atividade online
-
accordion Coletar informações de solicitação da API Ao fazer a chamada de API para acionar a Atividade online, salve:
- Carga de solicitação de API, incluindo identificadores de perfil e dados de atividade online
- Resposta da API, incluindo código de status, ID da mensagem, ID da solicitação
- Carimbo de data e hora de quando a API foi chamada
- Ponto de extremidade usado, por exemplo,
/campaign/{CAMPAIGN_ID}/execute
-
accordion Identificar o perfil de teste Na solicitação da API, recupere:
- Namespace de perfil, por exemplo, ECID, email, ID do cliente
- ID de perfil usada na chamada de API
Verifique se você pode pesquisar esse perfil no Adobe Experience Platform. Saiba como pesquisar um perfil na documentação do Experience Platform.
-
accordion Informações do dispositivo e do aplicativo Colete o seguinte do seu dispositivo de teste:
- Modelo do dispositivo, por exemplo, iPhone 14 Pro
- Versão do iOS
- Identificador do conjunto de aplicativos
- Token de push de APNs
- Status de conectividade de rede no momento do teste
Cenários comuns
Problemas de perfil ou token de push profile-issue
[Aplica-se a casos de uso unitários e de difusão]{class="badge positive"}
A API retorna HTTP 200, mas a Atividade online não é exibida. Causas comuns:
- O perfil não existe no Adobe Experience Platform.
- O token de push da Atividade online não foi sincronizado com o perfil.
- Os detalhes de push da Atividade online estão sincronizados, mas contêm configurações incorretas, por exemplo,
appIdouattributeTypeincorretos.
Observação para casos de uso de difusão: se alguns perfis no seu público-alvo não tiverem tokens, somente eles não receberão a Atividade online. Obtenha amostras de vários perfis do seu público-alvo para diagnosticar problemas de token. Isso se aplica somente a eventos de início remoto, não a eventos de atualização ou término.
Pré-verificações
-
Requisitos do aplicativo iOS:
- iOS 16.1+
NSSupportsLiveActivitiesdefinido comoYESemInfo.plistActivityAttributesimplementado corretamente.
-
Integração do Mobile SDK:
- Adobe Experience Platform Mobile SDK (mensagens do SDK 5.11.0+)
Messaging.registerLiveActivitiesimplementado e chamado com token de push de Atividade Dinâmica.
Etapas de depuração
-
accordion Verificar se o perfil existe no Adobe Experience Platform - No Journey Optimizer, navegue até Cliente
>Perfis. - Pesquisar usando o namespace e o valor de identidade da solicitação de API.
- Se o perfil não for encontrado, ele não existe ou a assimilação não foi concluída. Crie o perfil ou aguarde a assimilação antes de acionar a atividade Live.
- Se o perfil for encontrado, vá para a etapa 2 abaixo para verificar se o token de push está sincronizado.
- No Journey Optimizer, navegue até Cliente
-
accordion Verifique se o token de push da atividade online está sincronizado Você pode usar o Assurance para verificar o registro do token:
- No Assurance, na lista Eventos, filtre ou pesquise eventos
eventType = "liveActivity.pushToStart". - Selecione o Evento e inspecione a carga.
- Verifique se os valores de token, appId e attributeType estão presentes.
- Confirme se o evento foi enviado com êxito.
Também é possível fazer check-in do perfil do Adobe Experience Platform.
- No Adobe Experience Platform, em seu Perfil, acesse a guia Eventos.
- Pesquisar
liveActivity.pushToStarteventos. - Verifique o carimbo de data e hora e a carga do evento.
Se nenhum evento for encontrado, o aplicativo móvel não está chamando
Messaging.registerLiveActivitycorretamente. Você precisa corrigir a integração do SDK. - No Assurance, na lista Eventos, filtre ou pesquise eventos
-
accordion Validar detalhes do token no perfil -
Em seu Perfil, acesse a guia Atributos.
-
Localizar
liveActivityPushNotificationDetails. -
Verifique a configuração do token:
code language-json { "liveActivityPushNotificationDetails": [ { "appId": "com.example.myapp", "token": "abc123def456...", "platform": "apns", "denylisted": false, "attributeType": "OrderTrackingAttributes", "identity": {} } ] }
Validar cada campo:
table 0-row-3 1-row-3 2-row-3 3-row-3 4-row-3 5-row-3 Campo Requisito Problema comum appIdDeve corresponder exatamente ao identificador de conjunto do iOS Incompatibilidade entre IDs do pacote dev/prod attributeTypeDeve corresponder exatamente ao nome de estrutura Swift ActivityAttributes(diferencia maiúsculas de minúsculas)Erro de digitação ou nome de estrutura incorreto platformDeve ser "apns"ou"apnsSandbox"Valor de plataforma incorreto denylistedDeve ser falseToken marcado como inválido ou usuário recusado tokenToken de push de APNs válido Token expirado ou aplicativo reinstalado Se algum campo estiver incorreto: atualize o aplicativo móvel, registre-se novamente usando
Messaging.registerLiveActivities, aguarde de 5-10 minutos e verifique novamente.Se
liveActivityPushNotificationDetailsestiver ausente: o token ainda não foi sincronizado. Aguarde de 5 a 10 minutos após ver o eventoliveActivity.pushToStartno Assurance. -
Problemas de configuração de campanha e de carga payload-issues
[Aplica-se a casos de uso unitários e de difusão]{class="badge positive"}
O perfil existe com tokens válidos, mas a Atividade online não é exibida. Isso pode ser causado por:
- Configuração de superfície ou canal incorreta.
- Estrutura de carga de API incorreta.
content-stateeattributesnão correspondem à implementação do iOSActivityAttributes.- Obsoleto
timestamp(crítico para atualização/fim).
Observação para casos de uso de difusão: a campanha deve ser Marketing acionado por API (não Transacional). A carga usa audience em vez de profile individual. Consulte esta seção para obter a estrutura de conteúdo específica para difusão e a documentação do Adobe Developer para obter as especificações completas da API.
Pré-verificações
- A campanha é Transacional acionada por API (unitária) ou a opção Marketing acionado por API (difusão) e Alta Taxa de Transferência deve ser não habilitada, pois é incompatível com a Atividade online.
- Verifique se o perfil existe e se os tokens estão sincronizados corretamente usando o cenário acima.
Etapas de depuração
-
accordion Verificar a configuração da superfície de campanha - No Journey Optimizer, abra a Campanha e navegue até o menu Ações.
- Verifique sua configuração de atividade do Live. A superfície deve ser configurada para o aplicativo iOS com um identificador de conjunto que corresponda a
appIdnoliveActivityPushNotificationDetailsdo seu perfil. Por exemplo, se o seu perfil tem"appId": "com.example.myapp", a superfície deve ter como alvo o mesmo aplicativo. - Verifique se o Tipo de atividade na configuração da campanha corresponde exatamente ao
attributeTypenoliveActivityPushNotificationDetailsdo seu perfil. Por exemplo, se o seu perfil tiver"attributeType": "FoodDeliveryLiveActivityAttributes", a campanha deverá especificar esse mesmo tipo de Atividade.
-
accordion Validar estrutura de carga da API Ao executar a campanha via API, verifique se a carga segue a estrutura correta.
Carga unitária:
code language-json { "campaignId": "your-campaign-id", "recipients": [{ "type": "aep", "userId": "user@example.com", "namespace": "email", "context": { "requestPayload": { "aps": { "content-available": 1, "timestamp": 1756984054, "event": "start", "attributes-type": "FoodDeliveryLiveActivityAttributes", "content-state": { ... }, "attributes": { ... } } } } }] }Problemas comuns de carga:
table 0-row-3 1-row-3 2-row-3 3-row-3 4-row-3 5-row-3 6-row-3 Campo Requisito Problema comum attributes-typeDeve corresponder ao tipo de Atividade de campanha e ao perfil attributeTypeIncompatibilidade ou erro de digitação campaignIdDeve corresponder à ID da campanha ativada ID de campanha incorreta ou ausente content-availableDeve ser 1Valor ausente ou incorreto eventDeve ser "start","update"ou"end"Tipo de evento inválido timestampDeve ser sempre o horário atual/mais recente da época do Unix em segundos Uso do carimbo de data e hora antigo/em cache userId/namespaceDeve corresponder a um perfil existente no AEP Incompatibilidade do identificador de perfil Crítico: sempre usar o carimbo de data/hora mais recente
- O campo
timestampdeve sempre ser o horário atual da época Unix (em segundos) no momento em que cada chamada de API é feita. - Isso se aplica a todos os tipos de evento:
start,updatee especialmenteend. - Impacto nas solicitações de atualizações/término: o uso de um carimbo de data/hora obsoleto ou antigo fará com que as solicitações de atualização e término falhem ou sejam ignoradas pelo dispositivo.
- NÃO reutilize carimbos de data/hora de solicitações anteriores ou use valores em cache.
- Gere um carimbo de data e hora novo para cada chamada de API.
Campos opcionais (todos os tipos de evento):
requestId: Identificador exclusivo para rastreamento (recomendado).alert: Objeto comtitleebodypara notificação (útil para chamar atenção para atualizações).
Sobre
dismissal-date:- Campo opcional que contém o tempo da época Unix (segundos).
- Relevante somente quando
event: "end". - Especifica quando a Atividade online deve ser removida automaticamente do dispositivo.
- Se não for fornecido no evento final, a Atividade online permanecerá visível até que o usuário a ignore.
- Deve ser um carimbo de data/hora futuro (posterior a
timestamp).
- O campo
-
accordion Alinhar a carga com a implementação do iOS Verifique se a carga da API corresponde à implementação
ActivityAttributesdo aplicativo iOS. O protocoloLiveActivityAttributesdo Adobe SDK estende o iOSActivityAttributese requer uma propriedadeliveActivityData.Validar o mapeamento:
-
Seu
ActivityAttributesdeve implementar o protocoloLiveActivityAttributesda Adobe. Exemplo:code language-swift struct FoodDeliveryLiveActivityAttributes: LiveActivityAttributes { public struct ContentState: Codable, Hashable { var orderStatus: String var estimatedDeliveryTime: String } // Adobe SDK requirement var liveActivityData: LiveActivityData // Your custom attributes var restaurantName: String }Observe que o campo
liveActivityDataé exigido pelo Adobe SDK e deve ser incluído em todas as implementações. -
A carga da API deve refletir a estrutura do iOS:
code language-json { "aps": { "event": "start", "timestamp": 1756984054, "attributes-type": "FoodDeliveryLiveActivityAttributes", "content-state": { "orderStatus": "Preparing", "estimatedDeliveryTime": "20 mins" }, "attributes": { "liveActivityData": { "liveActivityID": "order-12345" }, "restaurantName": "Pizza Palace" } } }
Lista de verificação de validação:
-
Incluir todos os campos
ContentStateemcontent-state(obrigatório para todos os tipos de evento). -
Incluir todos os campos
LiveActivityAttributesemattributes(somente eventos iniciais), incluindo:liveActivityData(obrigatório; geralmente contémliveActivityIDou identificador semelhante)- Todos os campos personalizados da estrutura
-
Corresponder nomes de campo exatamente (diferencia maiúsculas de minúsculas).
-
Corresponder tipos de dados (String, Int, Bool, objetos aninhados).
-
Preserva a estrutura do objeto aninhado.
Erros comuns:
table 0-row-3 1-row-3 2-row-3 3-row-3 4-row-3 5-row-3 6-row-3 7-row-3 Problema Impacto Correção liveActivityDataausente nos atributosA atividade online não iniciará Sempre incluir objeto liveActivityDatano evento inicialCampo obrigatório ausente no evento de início A atividade online não iniciará Adicionar todos os campos da estrutura do iOS Nome de campo incorreto (erro de digitação/uso de maiúsculas e minúsculas) Campo ignorado ou erro de análise Corresponder exatamente aos nomes de campo do iOS Tipo de dados incorreto Erro de análise Corresponder tipos de dados do iOS Objeto aninhado ausente Dados incompletos Incluir todas as estruturas aninhadas Incluindo attributesem atualização/fimDesnecessário, mas geralmente ignorado Incluir apenas attributesno evento inicialCarimbo de data/hora obsoleto na atualização/término Atualização/fim ignorado pelo dispositivo Sempre gerar carimbo de data/hora novo Para obter mais exemplos, consulte Criar página de atividade ao vivo.
-
-
accordion Testar com o Assurance Verifique a execução da API e o delivery de carga usando o Assurance:
-
Abra sua sessão do Assurance.
-
Execute a chamada de API para acionar a Atividade online.
-
Na Lista de Eventos, verifique se:
- Eventos de execução de campanha.
- Eventos de entrega de Atividade online.
- Eventos de erro de validação de carga.
-
Revise as cargas do evento para verificar:
- A carga foi processada corretamente.
- Não ocorreram erros de validação.
- Atividade Ativa enviada para APNs.
-
Falhas de entrega e análise de erros
[Aplica-se a casos de uso unitários e de difusão]{class="badge positive"}
Nesse cenário, todas as verificações anteriores foram aprovadas:
- O perfil existe com tokens de push válidos da Atividade ao Vivo
- A campanha está configurada corretamente com a carga adequada
- Os tokens de atualização estão sincronizados (somente para eventos de atualização/término, caso de uso unitário)
Mas a Atividade online ainda não é exibida, atualizada ou encerrada conforme esperado. O problema pode estar no nível do sistema de entrega da Adobe ou com o provedor de serviços de notificação por push (APNs).
Observação para casos de uso de difusão: os relatórios mostram as métricas de todos os membros do público-alvo. Alguns perfis podem ter sucesso, enquanto outros falham.
Pré-verificações
-
Cenários Anteriores Validados:
- O perfil existe com o
liveActivityPushNotificationDetailscorreto - A superfície de campanha e o tipo de atividade estão corretos
- A carga da API é válida com o carimbo de data e hora atual
- Os tokens de atualização são sincronizados (para eventos de atualização/término)
- O perfil existe com o
-
Chamada de API Confirmada:
- A chamada de API retornou HTTP 200 (sucesso)
- A ID da campanha e os detalhes do recipient estão corretos
Etapas de depuração
-
accordion Verificar relatórios de campanha -
Navegue até sua Campanha de Atividade ao Vivo.
-
Clique no botão Relatórios.
-
Selecione Exibir relatório de todos os tempos.
-
Analise as seguintes seções:
-
Verifique as métricas Estatísticas de envio para entender o sucesso da entrega:
table 0-row-3 1-row-3 2-row-3 3-row-3 4-row-3 5-row-3 Métrica O que significa O que procurar Direcionado Número de perfis qualificados para o público Deve incluir seu perfil de teste Envios Total de tentativas de notificações por push Deve corresponder às chamadas de API Entregues Entregue com sucesso a dispositivos Compare com Envios para ver a taxa de sucesso Enviar erros Notificações por push que não foram enviadas Números altos Enviar exclusões Perfis excluídos pelo Adobe Journey Optimizer Verifique se o seu perfil foi excluído -
Se Enviar erros > 0, verifique a tabela Motivos de Erro para obter códigos de erro e mensagens específicas:
table 0-row-3 1-row-3 2-row-3 3-row-3 4-row-3 Erro comum Significado Resolução Token inválido O token de push é inválido ou expirou Registrar novamente os tokens de atividade em tempo real do dispositivo Token não encontrado Nenhum token válido associado ao perfil Verificar se liveActivityPushNotificationDetailsexisteAPNs rejeitadas O serviço de Notificação por push do Apple rejeitou o push Verificar certificado APNs, ID do pacote, ambiente Tempo limite de rede Não é possível acessar APNs Problema transitório; repetir a chamada da API -
Se Enviar exclusões > 0, verifique a tabela Motivos excluídos:
table 0-row-3 1-row-3 2-row-3 3-row-3 Exclusão comum Significado Resolução Perfil recusado O usuário recusou as notificações Verificar status de consentimento do perfil Incluir na lista de bloqueios Token alterado Token marcado como inválido Registre o token novamente ou verifique o status do incluo na lista de bloqueios Perfil não qualificado O perfil não atende aos critérios da campanha Revisar regras de público-alvo da campanha
-
Saiba mais na página de relatório de campanha de atividades ao vivo.
-
-
accordion Verificar eventos de feedback da mensagem no perfil -
Navegue até Cliente > Perfis na Journey Optimizer.
-
Procure e abra o perfil.
-
Selecione a guia Eventos.
-
Filtrar ou pesquisar eventos com
eventType = "message.feedback". -
Procure eventos de comentários que correspondam aos tipos
liveActivityIDeeventda sua Atividade Ativa. -
Revise os seguintes campos principais:
table 0-row-3 1-row-3 2-row-3 3-row-3 4-row-3 Campo Valores possíveis O que significa feedbackStatussent,error,denylistResultado da entrega do provedor de serviços serviceProviderapns/apnsSandboxDeve ser APNs para atividades do iOS Live errorCodeCódigo numérico ou nullCódigo de erro específico de APNs em caso de falha errorMessageDescrição de erro ou nullMensagem de erro legível -
Se
feedbackStatus: "error":- Verifique o
errorCodee oerrorMessagequanto a erros de APNs específicos - Erros comuns de APNs incluem token expirado, certificado inválido, ID de pacote incorreta
- Verifique o
-
Se nenhum evento de feedback for encontrado:
- A notificação por push pode não ter sido tentada
- Verifique se o perfil foi excluído nos Relatórios de campanha, conforme detalhado na Etapa 1 acima.
-
-
accordion Verificar a entrega da Atividade online para APNs no Assurance -
Abra a sessão do Assurance. Ela deve estar ativa durante a chamada de API.
-
Execute a chamada de API (start, update ou end).
-
Na Lista de Eventos, procure eventos de entrega de Atividade Ativa.
-
Procure eventos relacionados à entrega por push de APNs.
-
Verifique os seguintes indicadores:
- Solicitação de push para APNs: confirma que a Adobe enviou o push para os servidores da Apple
- Resposta APNs: mostra se APNs aceitaram ou rejeitaram o push
- Status da entrega: indicação de êxito ou falha
-
Se forem encontrados problemas, consulte os seguintes problemas comuns de delivery de APNs:
table 0-row-3 1-row-3 2-row-3 3-row-3 4-row-3 5-row-3 Problema Sintoma no Assurance Resolução Certificado APNs expirado Erro de autenticação Renovar e carregar novo certificado APNs Ambiente errado (desenvolvimento vs. produção) Erro de incompatibilidade de token Verifique se o certificado corresponde ao tipo de build do aplicativo Incompatibilidade de ID do pacote Identificador de conjunto inválido Verificar se a ID do conjunto de certificados corresponde ao aplicativo Token expirado Erro InvalidToken de APNs Registrar tokens de atividade online novamente Limitação de taxa Solicitações demais Reduzir a frequência de chamada da API
-
-
accordion Prosseguir com verificações de diagnóstico adicionais -
Verifique as métricas de ciclo de vida da atividade ativa no Relatório de campanha.
No relatório de campanha, revise a seção Ciclo de vida da atividade em tempo real:
table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2 Métrica O que verificar Início remoto Deve mostrar a contagem de inicializações acionadas por API Atualizações Deve mostrar a contagem de eventos de atualização Término Deve mostrar a contagem de eventos finais Contagem total Volume geral do evento Atividade ativa Se essas métricas forem zero ou não corresponderem às chamadas da API, há um problema de delivery entre o Adobe e os APNs.
-
Se o Adobe mostrar entrega bem-sucedida, mas o dispositivo não mostrar a Atividade ativa:
- Verifique os logs de dispositivo do iOS em busca de erros de atividade online.
- Verifique se o aplicativo está em primeiro ou segundo plano (não finalizado).
- Confirme se o dispositivo tem conectividade de rede.
- Teste em vários dispositivos para descartar problemas específicos do dispositivo.
- Verifique se a versão do iOS é 16.1 ou posterior.
-
-
accordion Escalonamento para o suporte da Adobe Se você concluiu todas as etapas e o problema permanece não resolvido, entre em contato com o Atendimento ao cliente da Adobe com:
Informações necessárias:
-
ID e nome da campanha
-
Namespace e ID do perfil
liveActivityIDda carga da API
-
Carimbos de data e hora de chamadas de API
-
Capturas de tela de:
- Relatórios De Campanha (Estatísticas De Envio, Motivos De Erro, Motivos Excluídos)
- Eventos de Perfil (
liveActivity.updateToken,message.feedback) - Sessão do Assurance mostrando eventos de entrega
-
Carga de solicitação de API concluída
-
Detalhes do certificado APNs (expiração, ambiente, ID do pacote)
-
Cenários específicos unitários
Token de atualização de atividade online não sincronizado token-not-synced
A Atividade Ativa é iniciada com êxito no dispositivo, mas as chamadas de API update ou end subsequentes (retornando HTTP 200) não atualizam ou descartam a Atividade Ativa. Isso ocorre quando o token de atualização da Atividade ao Vivo não é sincronizado corretamente com o sistema da Adobe.
Noções básicas sobre tokens de atualização
Quando uma Atividade online é iniciada em um dispositivo, o iOS gera um token de atualização exclusivo para essa instância específica da Atividade online. Este token é necessário para:
- Envio de atualizações para a atividade online
- Encerrando a atividade ativa remotamente
Cada instância da Atividade ativa tem seu próprio token de atualização exclusivo. O Adobe precisa desse token para fornecer eventos de atualização e término.
Comportamento esperado
Para que os eventos de atualização e término funcionem, o seguinte deve ocorrer:
- A atividade online é iniciada com sucesso no dispositivo.
- O dispositivo gera um token de atualização para essa instância de Atividade online.
- O Mobile SDK captura e envia o token de atualização para a Adobe.
- O token de atualização é sincronizado e armazenado no sistema do Adobe.
- As chamadas de API subsequentes para atualização/fim usam esse token para entrega.
Pré-verificações:
- Permissão de usuário: na primeira vez que uma Atividade online é iniciada em um dispositivo, o iOS exibe um prompt do sistema: "Permitir que o [Nome do aplicativo] forneça atualizações de Atividade online?" O usuário deve tocar em "Permitir" para que os tokens de atualização sejam gerados e sincronizados. Se o usuário tocar em "Não permitir", nenhum token de atualização será criado e as solicitações de atualização/encerramento falharão. Esta é uma permissão única por aplicativo.
- Validação de Perfil e Campanha: Conclua as verificações do Cenário 1 e do Cenário 2 para garantir que o perfil, os tokens e a configuração da campanha estejam corretos.
Etapas de depuração
-
accordion Verificar sincronização do token de atualização no Assurance -
Abra sua sessão do Assurance.
-
Verifique se a sessão estava ativa quando a Atividade online foi iniciada no dispositivo.
-
Filtrar ou pesquisar eventos com
eventType = "liveActivity.updateToken". -
Selecione o evento e inspecione a carga:
- Verifique se o campo
tokencontém uma cadeia de token de atualização válida. - Verifique se
liveActivityIDcorresponde à sua instância da Atividade online. - Confirme se o
activityTypecorresponde ao seuattributes-type.
- Verifique se o campo
-
Se o evento não for encontrado:
- O token de atualização não foi gerado ou capturado pela SDK.
- Verifique se o usuário recebeu permissões de Atividade em tempo real.
- Verifique se a Atividade online foi iniciada com êxito no dispositivo.
- Confirme se o SDK para dispositivos móveis está integrado corretamente para capturar tokens de atualização.
-
Se o evento for encontrado, prossiga para a Etapa 2.
-
-
accordion Verificar token de atualização em eventos de perfil -
Navegue até Cliente > Perfis na Journey Optimizer.
-
Procure e abra o perfil.
-
Selecione a guia Eventos.
-
Procurar
liveActivity.updateTokeneventos. -
Verifique os detalhes do evento:
- Verifique se o carimbo de data e hora é recente (corresponde ao início da atividade online).
- Confirme se
tokeneliveActivityIDestão presentes. - Verifique se
activityTypeestá correto.
-
Se o evento não for encontrado no perfil:
- O evento de token de atualização pode não ter sido assimilado no perfil ainda.
- Aguarde de 5 a 10 minutos e verifique novamente.
- Se ainda estiver ausente após 15 minutos, pode haver um problema de assimilação de evento.
-
Se um evento for encontrado, o token de atualização foi sincronizado. Você pode prosseguir para a Etapa 3.
-
-
accordion Verificar eventos de entrega de atividade online no Assurance -
Na sessão do Assurance, execute uma chamada de API de atualização ou fim.
-
Na Lista de Eventos, procure por eventos de entrega de Atividade Ativa (eventos de push de APNs).
-
Verificar se há eventos que indicam:
- Notificação por push enviada para APNs.
- Resposta de APNs (sucesso ou erro).
- Confirmação de entrega.
-
Se um evento de delivery APNs estiver presente: a notificação por push foi enviada. Se o dispositivo ainda não for atualizado, o problema pode estar no lado do dispositivo (aplicativo que não lida com push, problemas de rede etc.).
-
Se o evento de entrega APNs estiver ausente: o token de atualização pode não estar armazenado ou associado corretamente ao perfil no sistema do Adobe.
-
Se houver eventos de erro: inspecione os detalhes do erro em busca de motivos específicos de falha (token inválido, APNs rejeitados etc.).
-
Cenários específicos de transmissão
Problemas de configuração da campanha de transmissão e de carga broadcast-config
Esta seção aborda cenários de solução de problemas específicos para atividades de transmissão ao vivo, que exigem abordagens de depuração diferentes das campanhas unitárias.
Quando os perfis têm tokens válidos, mas a Atividade online não é exibida, atualizada ou se comporta conforme esperado para membros do público-alvo, o problema normalmente resulta de um dos seguintes:
- A campanha não está configurada como Marketing acionado por API.
- A carga da API usa uma estrutura de difusão incorreta (ausente
audienceouinput-push-channel). - Os campos
content-stateeattributesnão correspondem à implementação do iOSActivityAttributes. - O
input-push-channelnão foi criado corretamente no Portal do Desenvolvedor do Apple.
Este cenário de solução de problemas se aplica a todos os eventos de Atividade online em campanhas de difusão: start, update e end.
Pré-verificações:
-
Tipo de campanha:
- Verifique se a campanha foi criada como Marketing acionado por API (necessário para campanhas com base em transmissão/público-alvo).
- Confirme se um público-alvo está definido na configuração da campanha.
-
Validação de Perfil e Token: exemplifique vários perfis do público-alvo para verificar se eles têm um
liveActivityPushNotificationDetailsválido. Para obter etapas de validação detalhadas, siga o Cenário 1.
Etapas de depuração
-
accordion Verificar a configuração do público-alvo da campanha -
Abra sua Campanha de Marketing Acionado pela API na Journey Optimizer.
-
Navegue até a seção Público-alvo e verifique:
- Um público é selecionado para a campanha.
- A ID de público-alvo corresponde à ID usada na carga da API.
- O público-alvo contém os perfis esperados.
-
Navegue até a seção Ações.
-
Verifique a configuração da atividade online:
- A configuração deve ser definida para o aplicativo iOS com o identificador de pacote correto.
- O tipo de atividade deve corresponder ao
attributes-typena carga da API. Por exemplo, se sua carga contém"attributes-type": "AirplaneTrackingAttributes", a campanha deve especificar esse mesmo tipo de Atividade.
-
-
accordion Validar a estrutura de carga da API de transmissão A estrutura de carga da transmissão é diferente das campanhas unitárias. Verifique se a carga segue o formato de transmissão correto.
Campos obrigatórios para difusão:
code language-json { "campaignId": "878a11d4-b519-47bd-8313-fecfee19857b", "audience": { "id": "8c3dbdea-2957-401f-acf0-3966fba1601e" }, "context": { "requestPayload": { "aps": { "input-push-channel": "FEt0NgvLEfEAAOqA6AXdIQ==", "content-available": 1, "timestamp": 1771829292, "event": "update", "attributes-type": "AirplaneTrackingAttributes", "content-state": { ... }, "attributes": { ... } } } } }Problemas comuns de carga:
table 0-row-3 1-row-3 2-row-3 3-row-3 4-row-3 5-row-3 6-row-3 7-row-3 Campo Requisito Problema comum campaignIdDeve corresponder à ID de campanha de marketing ativada ID de campanha incorreta ou uso da campanha transacional audience.idDeve corresponder a um público-alvo existente no AEP ID de público-alvo ou público-alvo incorreto não existe input-push-channelObrigatório para transmissão - Identificador exclusivo para esta instância de transmissão Ausente ou não corresponde a channelIDemliveActivityDatatimestampDeve ser sempre o horário atual/mais recente da época do Unix em segundos Uso do carimbo de data e hora antigo/em cache eventDeve ser "start","update"ou"end"Tipo de evento inválido attributes-typeDeve corresponder ao tipo de Atividade da campanha Incompatibilidade ou erro de digitação content-availableDeve ser 1Valor ausente ou incorreto Campos críticos específicos da difusão:
-
input-push-channel- Obrigatório para todas as atividades de transmissão ao vivo.
- Atua como um identificador exclusivo para essa instância de transmissão específica.
- Todos os perfis no público-alvo recebem Atividades ativas vinculadas a este canal.
- Deve corresponder a
channelIDemliveActivityData.channelID(consulte a Etapa 3). - Deve ser criado para
appIDno Portal do Desenvolvedor do Apple pelo cliente. - Somente os canais criados para o
appIDespecífico podem ser usados para transmitir a Atividade online no aplicativo.
-
audience.id- Deve fazer referência a um segmento de público-alvo válido criado no Adobe Experience Platform.
- Todos os perfis neste público-alvo são direcionados para a Atividade online.
- O público deve ser ativado e conter perfis com
liveActivityPushNotificationDetailsválido.
Sempre usar o carimbo de data/hora mais recente:
- O campo
timestampdeve ser sempre o tempo da época Unix atual (em segundos) para cada chamada de API. - Este requisito se aplica a todos os tipos de evento:
start,updateeend. - Crítico para atualizações/fim: usar carimbos de data/hora obsoletos faz com que as solicitações de atualização e término falhem.
- Gere um carimbo de data e hora novo para cada chamada de API de transmissão.
Campos opcionais:
dismissal-date: Tempo de época Unix para descarte automático (relevante somente paraendeventos)alert: Objeto comtitleebodypara notificação
Consulte a documentação da API de Mensagens do Adobe Journey Optimizer para obter as especificações completas da API.
-
-
accordion Alinhar o estado do conteúdo, os atributos e o canal de push de entrada com a implementação do iOS Verifique se os campos de carga correspondem à implementação
ActivityAttributesdo aplicativo iOS e seinput-push-channelcorresponde achannelIDemliveActivityData.- Revise sua definição de Atributos da atividade do iOS.
Sua estrutura
ActivityAttributespersonalizada deve implementar o protocoloLiveActivityAttributesda Adobe:code language-swift struct AirplaneTrackingAttributes: LiveActivityAttributes { public struct ContentState: Codable, Hashable { var journeyProgress: Int } // Adobe SDK requirement var liveActivityData: LiveActivityData // Your custom attributes var arrivalAirport: String var departureAirport: String var arrivalTerminal: String }- Mapeie os campos do iOS para a carga da API de transmissão.
Para todos os eventos, inclua
attributesecontent-state:code language-json { "aps": { "input-push-channel": "FEt0NgvLEfEAAOqA6AXdIQ==", "event": "start", "timestamp": 1771829292, "attributes-type": "AirplaneTrackingAttributes", "content-state": { "journeyProgress": 0 }, "attributes": { "arrivalAirport": "DEL", "departureAirport": "MUM", "arrivalTerminal": "T1", "liveActivityData": { "channelID": "FEt0NgvLEfEAAOqA6AXdIQ==" } } } }Crítico:
input-push-channeldeve corresponder achannelID- O valor
input-push-channelna raiz deapsdeve corresponder exatamente achannelIDemliveActivityData. - No exemplo acima, ambos os valores são
"FEt0NgvLEfEAAOqA6AXdIQ==". - Isso vincula a instância de transmissão aos dados da Atividade online.
- Uma incompatibilidade causa falhas de delivery.
Pontos principais de validação:
- Incluir todos os campos
ContentStateemcontent-statepara todos os tipos de evento. - Incluir todos os campos personalizados
LiveActivityAttributesemattributessomente para eventos iniciais. - Para eventos de início,
liveActivityData.channelIDdeve corresponder ainput-push-channel. - Os nomes de campos diferenciam maiúsculas de minúsculas e devem corresponder exatamente.
- Os tipos de dados devem corresponder (String, Int, Bool, objetos aninhados etc.).
- Para eventos de atualização/encerramento, use o mesmo
input-push-channelque o evento inicial original.
Erros comuns:
table 0-row-3 1-row-3 2-row-3 3-row-3 4-row-3 5-row-3 6-row-3 7-row-3 Problema Impacto Correção input-push-channelausenteA transmissão não funcionará Adicionar ID de canal exclusiva para cada transmissão input-push-channelnão corresponde achannelIDA atividade online não iniciará Certifique-se de que ambos os valores sejam idênticos Diferente de input-push-channelpara atualização/fimAtualizar/encerrar não atingirá as atividades online Usar a mesma ID de canal no ciclo de vida liveActivityData.channelIDausenteA atividade ao vivo não será vinculada à transmissão Incluir channelIDem atributos para iniciar eventoCampo obrigatório ausente no evento de início A atividade online não iniciará Adicionar todos os campos da estrutura do iOS Nome de campo incorreto (erro de digitação/uso de maiúsculas e minúsculas) Campo ignorado ou erro de análise Corresponder exatamente aos nomes de campo do iOS Carimbo de data/hora obsoleto na atualização/término Atualização/fim ignorado pelos dispositivos Sempre gerar carimbo de data/hora novo -
accordion Testar com o Assurance Verifique a execução da API e o delivery de carga usando o Assurance:
-
Abra a sessão do Assurance em um dispositivo de teste que faça parte do público-alvo.
-
Execute a chamada de API de transmissão.
-
Na Lista de Eventos, procure:
- Eventos de execução de campanha.
- Eventos de entrega de Atividade online.
- Eventos de erro que indicam falhas de validação de carga.
-
Inspecione as cargas do evento para confirmar:
- A carga foi processada corretamente.
- O
input-push-channelestá presente. - Não ocorreram erros de validação.
- As atividades ativas foram enviadas para APNs para membros do público-alvo.
-
O perfil não está no público-alvo ou no instantâneo de público-alvo obsoleto
Nesse cenário, a campanha e a carga são configuradas corretamente, mas perfis específicos não recebem a Atividade ativa. Isso normalmente ocorre quando:
- O perfil não é um membro do público vinculado à campanha.
- O público-alvo é um público-alvo em lote e contém um instantâneo desatualizado dos dados do perfil.
- Os tokens de Atividade online do perfil foram adicionados recentemente, mas ainda não foram refletidos no instantâneo do público-alvo.
Esse cenário de solução de problemas se aplica especificamente a campanhas de transmissão que usam direcionamento baseado em público-alvo.
Noções básicas sobre a avaliação de público-alvo
O Adobe Experience Platform usa diferentes métodos de avaliação de público-alvo que determinam quando as atualizações de perfil são refletidas no público-alvo:
Pré-verificações:
-
Validação de campanha e carga:
- Conclua as verificações em este cenário para garantir que a campanha e a carga estejam corretas.
- Verifique se o
audience.idna carga da API corresponde à configuração da campanha.
-
Perfil Existe: confirme se o perfil existe no AEP com um
liveActivityPushNotificationDetailsválido.
Etapas de depuração
-
accordion Verificar se o perfil está no público Primeiro, confirme se o perfil que deve receber a Atividade online faz parte do público-alvo.
-
Navegue até Públicos-alvo no Adobe Experience Platform.
-
Procure e abra o público-alvo usando o
audience.idda sua campanha. -
Clique em Procurar ou Perfis de amostra para exibir membros do público-alvo.
-
Procure pelo perfil de teste usando o valor de namespace e identidade.
-
Se o perfil não for encontrado na audiência:
- O perfil não atende aos critérios de público-alvo ou às regras de segmento.
- Revise a definição de público-alvo para entender os requisitos de associação.
- Atualize os dados do perfil ou a definição do público-alvo para incluir o perfil.
- Aguarde a conclusão da avaliação do público-alvo (consulte Etapa 2).
-
Se o perfil for encontrado no público-alvo: Vá para a Etapa 2 para verificar a atualização dos dados.
-
-
accordion Verificar o tipo e a programação da avaliação do público-alvo Identifique se o público-alvo usa avaliação em lote ou por transmissão, pois isso determina a atualização dos dados.
-
Na página Detalhes do público-alvo, verifique o Método de avaliação:
- Lote: avaliado uma vez por dia de acordo com um agendamento.
- Streaming: avaliado em tempo real quando ocorrem atualizações de perfil.
- Edge: avaliado em locais de borda em tempo real.
Siga as etapas apropriadas de solução de problemas com base no método de avaliação:
Se o público-alvo usar a Avaliação em lote:
-
Compreender as limitações de público-alvo em lotes:
- Os públicos-alvo em lote são avaliados uma vez por dia (normalmente durante a noite).
- O instantâneo do público-alvo pode ter até 24 horas.
- Se um perfil registrou tokens de Atividade online recentemente, esses tokens podem não estar no instantâneo atual.
- As atualizações para perfis não serão refletidas até a próxima avaliação do lote.
-
Verificar quando ocorreu a última avaliação:
- Nos detalhes do público, procure pelo carimbo de data e hora Última avaliação.
- Se o
liveActivityPushNotificationDetailsdo perfil foi atualizado após esse carimbo de data/hora, o público-alvo tem dados obsoletos.
-
Resolver dados obsoletos:
-
Opção 1: Aguardar a avaliação agendada do lote
- A próxima avaliação do lote incluirá os dados atualizados do perfil.
- Isso acontece automaticamente uma vez por dia.
- Melhor para cenários não urgentes.
-
Opção 2: acionar avaliação de público-alvo sob demanda
- Navegue até Públicos-alvo no AEP.
- Selecione o público-alvo.
- Clique em Avaliar agora ou Ativar sob demanda.
- Aguarde a conclusão da avaliação (isso pode levar de alguns minutos a horas, dependendo do tamanho do público).
- Verifique se o perfil agora atualizou os dados no instantâneo do público-alvo.
- Tente novamente a chamada da API de transmissão.
-
Se o público-alvo usar a avaliação de Streaming:
-
Entender o comportamento de transmissão de público:
- Os públicos-alvo de transmissão são avaliados em tempo real quando ocorrem atualizações de perfil.
- Novos perfis: qualifique-se logo após a criação se eles atenderem aos critérios de segmento.
- Perfis atualizados: qualifique ou desqualifique logo após ser atualizado.
- Perfis inalterados existentes: não serão reavaliados, a menos que ocorra uma atualização.
-
Identificar o problema:
- Se um perfil já existir e atender aos critérios de segmento, mas nenhuma atualização ocorrer nesse perfil, ele não poderá ser adicionado a um público de transmissão recém-criado.
- O perfil deve receber uma atualização (qualquer alteração de atributo) para acionar a reavaliação.
-
Resolver o problema:
-
Para novos perfis: eles se qualificam automaticamente se os critérios forem atendidos. Nenhuma ação necessária.
-
Para perfis existentes sem atualizações recentes:
- Fazer uma atualização secundária no perfil (por exemplo, atualizar um campo de carimbo de data e hora).
- Isso aciona a avaliação de transmissão e adiciona o perfil ao público-alvo.
- Alternativa: use um público-alvo em lote ou público-alvo de borda para perfis existentes.
-
-