Mensagens no aplicativo

Essas informações ajudam você a usar mensagens no aplicativo em seus aplicativos iOS.

Para usar mensagens no aplicativo, você deve ter o SDK versão 4.2 ou posterior.

Algumas informações para lembrar:

  • As mensagens e as regras que definem quando as mensagens são exibidas são criadas no Adobe Mobile Services. Para obter mais informações, consulte Criar uma mensagem no aplicativo.

  • As atualizações descritas nesta seção devem ser feitas no SDK para exibir mensagens no aplicativo.

    DICA

    É possível concluir essas etapas, mesmo que não tenha mensagens definidas. Depois de definir as mensagens, elas são entregues de forma dinâmica ao seu aplicativo e exibidas sem atualização da loja de aplicativos.

Ativar mensagens no aplicativo

  1. Adicione a biblioteca ao projeto e implemente o ciclo de vida.

    Para obter mais informações, consulte Adicionar o SDK e o arquivo de configuração ao seu projeto em Implementação principal e ciclo de vida.

  2. Importe a biblioteca:

    #import "ADBMobile.h"
    
  3. Verifique se o arquivo ADBMobileConfig.json contém as configurações exigidas para mensagens no aplicativo.

  4. Para que as mensagens no aplicativo sejam atualizadas dinamicamente na inicialização, o objeto remotes deve estar presente e configurado corretamente:

    "messages": [ 
        { 
            "messageId": "de45c43c-37bf-441f-8cbd-cc3ba3469ebe", 
            "template": "fullscreen", 
            "showOffline": false, 
            "showRule": "always", 
            "endDate": 2524730400, 
            "startDate": 0, 
            "audiences": [], 
            "triggers": [], 
            "payload": { // contents change depending on template 
                "html": "<html>html code goes here</html>" 
            }, 
        }, 
        … 
    ] 
    "remotes" : { 
        "analytics.poi": "https://assets.adobedtm.com/…/yourfile.json", 
        "messages": "https://assets.adobedtm.com/…/yourfile.json" 
    }
    
    DICA

    messages ou remotes são obrigatórios.

    Se esses objetos não estiverem configurados, baixe um arquivo ADBMobileConfig.json atualizado do Adobe Mobile Services. Para obter mais informações, consulte Implementação principal e ciclo de vida.

Rastreamento de mensagens no aplicativo

Os SDKs do iOS Mobile Services rastreiam as seguintes métricas para as mensagens no aplicativo:

  • Para mensagens no aplicativo com estilo de tela cheia e de alerta:

    • Impressões: quando o usuário aciona uma mensagem no aplicativo.
    • Click-throughs: quando o usuário pressiona o botão Click-through.
    • Cancelamentos: quando o usuário pressiona o botão Cancelar.
  • Para mensagens no aplicativo personalizadas em tela inteira, o conteúdo HTML na mensagem precisa incluir o código correto para notificar ao rastreamento de SDK sobre os seguintes botões:

    • Exemplo de rastreamento de click-through (redirecionamento): adbinapp://confirm/?url=https://www.yoursite.com
    • Exemplo de rastreamento de cancelamento (fechar): adbinapp://cancel
  • Em notificações locais (remotas):

    • Impressões: quando o usuário aciona a notificação.
    • Abrir: quando o usuário abre o aplicativo pela notificação.

    Este é um exemplo de como incluir o rastreamento aberto:

    - (BOOL) application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions { 
      // handle local notification click-throughs for iOS 10 and older 
      NSDictionary *localNotificationDictionary = launchOptions[UIApplicationLaunchOptionsLocalNotificationKey]; 
      if ([localNotificationDictionary isKindOfClass:[NSDictionary class]]) { 
           [ADBMobile trackLocalNotificationClickThrough:localNotificationDictionary]; 
      } 
    } 
    - (void) application:(UIApplication *)application didReceiveLocalNotification:(UILocalNotification *)notification { 
       [ADBMobile trackLocalNotificationClickThrough:notification.userInfo]; 
    }
    

Imagem de fallback local

Ao criar uma mensagem de tela cheia no Adobe Mobile Services, você pode especificar uma imagem de fallback. Se a mensagem não conseguir recuperar a imagem desejada da Web, o SDK tentará carregar a imagem com o mesmo nome do pacote de aplicativos. Dessa forma, você poderá exibir sua mensagem na forma original, mesmo se o usuário estiver offline ou se a imagem predeterminada for inacessível.

O nome do ativo de imagem de fallback é especificado ao configurar a mensagem no Adobe Mobile Services.

IMPORTANTE

É necessário garantir que o recurso especificado esteja disponível.

Nesta página