Solução de problemas de atividades ao vivo troubleshoot-mobile-live

A visualização Atividades ativas no Adobe Experience Platform Assurance valida a configuração do aplicativo, inspeciona eventos de atividade e permite iniciar, atualizar ou encerrar atividades remotamente de uma sessão de teste.

Exigências

Três guias

Início, atualização e término do Assurance

Iniciar Atividade Dinâmica. abre uma caixa de diálogo para escolher o tipo de atividade registrada, escolher Unitário ou Transmissão, inserir uma ID de canal de transmissão (somente difusão) e editar uma carga JSON do APS pré-preenchida. O botão está desativado ou retorna um erro se os requisitos de configuração de token de push-to-start, versão do iOS ou canal não forem atendidos.

Enviar Atualização. na guia Visão geral de uma atividade existente, o envia um evento Atualizar (enviar novo conteúdo) ou Encerrar. Para unitário, o plug-in usa o token de atualização da atividade automaticamente. Para transmissão, ele direciona todos os dispositivos inscritos na mesma ID de canal de transmissão. As cargas devem ser um JSON válido e corresponder ao esquema de atributo da atividade; caso contrário, a solicitação será rejeitada.

Consulte a documentação do Adobe Experience Platform Assurance para obter as etapas de configuração e conexão da sessão.

Navegue até a Campanha acionada pela API no Journey Optimizer e recupere:

• Nome e ID da campanha
• Versão do Campaign (se aplicável)
• Tipo de campanha: Transacional (unitário) ou Marketing (difusão)
• Configuração de superfície: a superfície do aplicativo iOS usada para a atividade Live
• Tipo de atividade: o nome de estrutura AttributeType configurado na campanha

Ao fazer a chamada de API para acionar a atividade Live, salve:

• Carga de solicitação de API, incluindo identificadores de perfil e dados de atividade em tempo real
• 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

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.

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

1. No Journey Optimizer, navegue até Cliente > Perfis.
2. Pesquisar usando o namespace e o valor de identidade da solicitação de API.
3. 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.
4. Se o perfil for encontrado, vá para a etapa 2 abaixo para verificar se o token de push está sincronizado.

Você pode usar o Assurance para verificar o registro do token:

1. No Assurance, na lista Eventos, filtre ou pesquise eventos eventType = "liveActivity.pushToStart".
2. Selecione o Evento e inspecione a carga.
3. Verifique se os valores de token, appId e attributeType estão presentes.
4. Confirme se o evento foi enviado com êxito.

Também é possível fazer check-in do perfil do Adobe Experience Platform.

1. No Adobe Experience Platform, em seu Perfil, acesse a guia Eventos.
2. Pesquisar liveActivity.pushToStart eventos.
3. 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.registerLiveActivity corretamente. Você precisa corrigir a integração do SDK.

1. Em seu Perfil, acesse a guia Atributos.

2. Localizar liveActivityPushNotificationDetails.

3. 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:

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 liveActivityPushNotificationDetails estiver ausente: o token ainda não foi sincronizado. Aguarde de 5 a 10 minutos após ver o evento liveActivity.pushToStart no Assurance.

1. No Journey Optimizer, abra a Campanha e navegue até o menu Ações.
2. 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 appId no liveActivityPushNotificationDetails do seu perfil. Por exemplo, se o seu perfil tem "appId": "com.example.myapp", a superfície deve ter como alvo o mesmo aplicativo.
3. Verifique se o Tipo de atividade na configuração da campanha corresponde exatamente ao attributeType no liveActivityPushNotificationDetails do seu perfil. Por exemplo, se o seu perfil tiver "attributeType": "FoodDeliveryLiveActivityAttributes", a campanha deverá especificar esse mesmo tipo de Atividade.

Ao executar a campanha via API, verifique se a carga segue a estrutura correta.

Carga unitária:

{
   "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:

Crítico: sempre usar o carimbo de data/hora mais recente

• O campo timestamp deve 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, update e 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 com title e body para 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 quandoevent: "end".
• Especifica quando a atividade Live 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).

Verifique se a carga da API corresponde à implementação ActivityAttributes do aplicativo iOS. O protocolo LiveActivityAttributes do Adobe SDK estende o iOS ActivityAttributes e requer uma propriedade liveActivityData.

Validar o mapeamento:

1. Seu ActivityAttributes deve implementar o protocolo LiveActivityAttributes da 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.

2. 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 ContentState em content-state (obrigatório para todos os tipos de evento).

• Incluir todos os campos LiveActivityAttributes em attributes (somente eventos iniciais), incluindo:

  • liveActivityData (obrigatório; geralmente contém liveActivityID ou 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:

Para obter mais exemplos, consulte Criar página de atividade ao vivo.

Verifique a execução da API e o delivery de carga usando o Assurance:

1. Abra sua sessão do Assurance.

2. Execute a chamada de API para acionar a atividade Live.

3. Na Lista de Eventos, verifique se:

   • Eventos de execução de campanha.
   • Eventos de entrega de atividades online.
   • Eventos de erro de validação de carga.

4. Revise as cargas do evento para verificar:

   • A carga foi processada corretamente.
   • Não ocorreram erros de validação.
   • A atividade online foi enviada para APNs.

1. Navegue até a Campanha de atividade ao vivo.

2. Clique no botão Relatórios.

3. Selecione Exibir relatório de todos os tempos.

4. Analise as seguintes seções:

   1. 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

   2. 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 ao vivo do dispositivo
      Token não encontrado	Nenhum token válido associado ao perfil	Verificar se liveActivityPushNotificationDetails existe
      APNs 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

   3. 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
      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.

1. Navegue até Cliente > Perfis na Journey Optimizer.

2. Procure e abra o perfil.

3. Selecione a guia Eventos.

4. Filtrar ou pesquisar eventos com eventType = "message.feedback".

5. Procure eventos de feedback que correspondam aos tipos liveActivityID e event da atividade Ativa.

6. 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
   feedbackStatus	sent, error, denylist	Resultado da entrega do provedor de serviços
   serviceProvider	apns/apnsSandbox	Deve ser APNs para atividades do iOS Live
   errorCode	Código numérico ou null	Código de erro específico de APNs em caso de falha
   errorMessage	Descrição de erro ou null	Mensagem de erro legível

7. Se feedbackStatus: "error":

   • Verifique o errorCode e o errorMessage quanto a erros de APNs específicos
   • Erros comuns de APNs incluem token expirado, certificado inválido, ID de pacote incorreta

8. 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.

1. Abra a sessão do Assurance. Ela deve estar ativa durante a chamada de API.

2. Execute a chamada de API (start, update ou end).

3. Na Lista de Eventos, procure por eventos de entrega de atividades online.

4. Procure eventos relacionados à entrega por push de APNs.

5. 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

6. 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 ao vivo novamente
   Limitação de taxa	Solicitações demais	Reduzir a frequência de chamada da API

1. Verifique as métricas de ciclo de vida de atividade Ativo 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 de 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.

2. Se o Adobe mostrar entrega bem-sucedida, mas o dispositivo não mostrar a atividade Live:

   • Verifique se há erros de atividade ao vivo nos logs de dispositivos do iOS.
   • 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.

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
• liveActivityID da 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)

1. Abra sua sessão do Assurance.

2. Verifique se a sessão estava ativa quando a atividade Live foi iniciada no dispositivo.

3. Filtrar ou pesquisar eventos com eventType = "liveActivity.updateToken".

4. Selecione o evento e inspecione a carga:

   • Verifique se o campo token contém uma cadeia de token de atualização válida.
   • Verifique se o liveActivityID corresponde à sua instância de atividade do Live.
   • Confirme se o activityType corresponde ao seu attributes-type.

5. 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 Live foi iniciada com êxito no dispositivo.
   • Confirme se o SDK para dispositivos móveis está integrado corretamente para capturar tokens de atualização.

6. Se o evento for encontrado, prossiga para a Etapa 2.

1. Navegue até Cliente > Perfis na Journey Optimizer.

2. Procure e abra o perfil.

3. Selecione a guia Eventos.

4. Procurar liveActivity.updateToken eventos.

5. Verifique os detalhes do evento:

   • Verifique se o carimbo de data e hora é recente (corresponde ao início da atividade online).
   • Confirme se token e liveActivityID estão presentes.
   • Verifique se activityType está correto.

6. 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.

7. Se um evento for encontrado, o token de atualização foi sincronizado. Você pode prosseguir para a Etapa 3.

1. Na sessão do Assurance, execute uma chamada de API de atualização ou fim.

2. Na Lista de Eventos, procure por eventos de entrega de atividade (eventos de push APNs).

3. Verificar se há eventos que indicam:

   • Notificação por push enviada para APNs.
   • Resposta de APNs (sucesso ou erro).
   • Confirmação de entrega.

4. 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.).

5. 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.

6. Se houver eventos de erro: inspecione os detalhes do erro em busca de motivos específicos de falha (token inválido, APNs rejeitados etc.).

1. Abra sua Campanha de Marketing Acionado pela API na Journey Optimizer.

2. 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.

3. Navegue até a seção Ações.

4. 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-type na carga da API. Por exemplo, se sua carga contém "attributes-type": "AirplaneTrackingAttributes", a campanha deve especificar esse mesmo tipo de Atividade.

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:

{
   "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:

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 ao vivo vinculadas a este canal.
  • Deve corresponder a channelID em liveActivityData.channelID (consulte a Etapa 3).
  • Deve ser criado para appID no Portal do Desenvolvedor do Apple pelo cliente.
  • Somente os canais criados para o appID específico podem ser usados para transmitir a atividade em tempo real nesse 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 Live.
  • O público deve ser ativado e conter perfis com liveActivityPushNotificationDetails válido.

Sempre usar o carimbo de data/hora mais recente:

• O campo timestamp deve 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, update e end.
• 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 para end eventos)
• alert: Objeto com title e body para notificação

Consulte a documentação da API de Mensagens do Adobe Journey Optimizer para obter as especificações completas da API.

Verifique se os campos de carga correspondem à implementação ActivityAttributes do aplicativo iOS e se input-push-channel corresponde a channelID em liveActivityData.

1. Revise sua definição de Atributos da atividade do iOS.

Sua estrutura ActivityAttributes personalizada deve implementar o protocolo LiveActivityAttributes da Adobe:

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
}

1. Mapeie os campos do iOS para a carga da API de transmissão.

Para todos os eventos, inclua attributes e content-state:

      {
      "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-channel deve corresponder achannelID

• O valor input-push-channel na raiz de aps deve corresponder exatamente a channelID em liveActivityData.
• No exemplo acima, ambos os valores são "FEt0NgvLEfEAAOqA6AXdIQ==".
• Isso vincula a instância de transmissão aos dados de atividade Live.
• Uma incompatibilidade causa falhas de delivery.

Pontos principais de validação:

• Incluir todos os campos ContentState em content-state para todos os tipos de evento.
• Incluir todos os campos personalizados LiveActivityAttributes em attributes somente para eventos iniciais.
• Para eventos de início, liveActivityData.channelID deve corresponder a input-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-channel que o evento inicial original.

Erros comuns:

Verifique a execução da API e o delivery de carga usando o Assurance:

1. Abra a sessão do Assurance em um dispositivo de teste que faça parte do público-alvo.

2. Execute a chamada de API de transmissão.

3. Na Lista de Eventos, procure:

   • Eventos de execução de campanha.
   • Eventos de entrega de atividades online.
   • Eventos de erro que indicam falhas de validação de carga.

4. Inspecione as cargas do evento para confirmar:

   • A carga foi processada corretamente.
   • O input-push-channel está presente.
   • Não ocorreram erros de validação.
   • As atividades ativas foram enviadas para APNs para membros do público-alvo.

Primeiro, confirme se o perfil que deve receber a atividade Live faz parte do público-alvo.

1. Navegue até Públicos-alvo no Adobe Experience Platform.

2. Procure e abra o público-alvo usando o audience.id da sua campanha.

3. Clique em Procurar ou Perfis de amostra para exibir membros do público-alvo.

4. Procure pelo perfil de teste usando o valor de namespace e identidade.

5. 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).

6. Se o perfil for encontrado no público-alvo: Vá para a Etapa 2 para verificar a atualização dos dados.

Identifique se o público-alvo usa avaliação em lote ou por transmissão, pois isso determina a atualização dos dados.

1. 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:

1. 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 ao vivo 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.

2. Verificar quando ocorreu a última avaliação:

   • Nos detalhes do público, procure pelo carimbo de data e hora Última avaliação.
   • Se o liveActivityPushNotificationDetails do perfil foi atualizado após esse carimbo de data/hora, o público-alvo tem dados obsoletos.

3. Resolver dados obsoletos:

   1. 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.

   2. Opção 2: acionar avaliação de público-alvo sob demanda

      1. Navegue até Públicos-alvo no AEP.
      2. Selecione o público-alvo.
      3. Clique em Avaliar agora ou Ativar sob demanda.
      4. Aguarde a conclusão da avaliação (isso pode levar de alguns minutos a horas, dependendo do tamanho do público).
      5. Verifique se o perfil agora atualizou os dados no instantâneo do público-alvo.
      6. Tente novamente a chamada da API de transmissão.

Se o público-alvo usar a avaliação de Streaming:

1. 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.

2. 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.

3. 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.