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