Mensagem no app

Saiba mais sobre mensagens no app e como configurá-las para o Braze SDK.

Pré-requisitos

Antes de poder usar esse recurso, você precisará integrar o Android Braze SDK. Você também precisará ativar mensagens no app.

Tipos de mensagens

android

O Braze oferece vários tipos de mensagens no app padrão, cada uma personalizável com mensagens, imagens, ícones Font Awesome, ações de clique, análises de dados, esquemas de cores e muito mais.

Seu comportamento básico e suas características são definidos pela IInAppMessage em uma subclasse chamada InAppMessageBase. IInAppMessage também inclui uma subinterface, IInAppMessageImmersiveque permite adicionar botões de fechar, de ação de clique e de análise de dados ao seu app.

important:

Lembre-se de que as mensagens no app que contêm botões incluirão a mensagem clickAction na carga útil final se a ação de clique for adicionada antes da adição do texto do botão.

slideup As mensagens no app são assim chamadas porque “deslizam para cima” ou “deslizam para baixo” a partir da parte superior ou inferior da tela. Eles cobrem uma pequena parte da tela e fornecem um recurso de envio de mensagens eficaz e não intrusivo.

O objeto de mensagem no app slideup estende InAppMessageBase.

Uma mensagem no app que desliza da parte inferior da tela do telefone exibindo "Os seres humanos são complicados. O engajamento personalizado não deveria ser." Em segundo plano, a mesma mensagem no app exibida no canto inferior direito de uma página da Internet.

modal As mensagens no app aparecem no centro da tela e são emolduradas por um painel translúcido. Úteis para o envio de mensagens mais críticas, eles podem ser equipados com dois botões de ação por clique e com análise de dados ativada.

Esse tipo de mensagem é uma subclasse de InAppMessageImmersiveBaseuma classe abstrata que implementa IInAppMessageImmersive, dando-lhe a opção de adicionar funcionalidade personalizada às mensagens no app geradas localmente.

Uma mensagem modal no app no centro da tela do telefone exibindo "Os seres humanos são complicados. O engajamento personalizado não deveria ser." No plano de fundo está a mesma mensagem no app exibida no centro de uma página da Internet.

full As mensagens no app são úteis para maximizar o conteúdo e o impacto da sua comunicação com o usuário. A metade superior de uma mensagem no app full contém uma imagem, e a metade inferior exibe texto e até dois botões de ação de clique e de análise de dados.

Esse tipo de mensagem estende InAppMessageImmersiveBasedando-lhe a opção de adicionar funcionalidade personalizada às mensagens no app geradas localmente.

Uma mensagem no app de tela cheia exibida em toda a tela do telefone mostrando: "Os humanos são complicados." O engajamento personalizado não deveria ser." No plano de fundo está a mesma mensagem no app exibida em grande parte no centro de uma página da Internet.

HTML As mensagens no app são úteis para criar conteúdo totalmente personalizado para o usuário. O conteúdo HTML definido pelo usuário da mensagem no app é exibido em WebView e pode, opcionalmente, conter outros conteúdos avançados, como imagens e fontes, permitindo controle total sobre a aparência e a funcionalidade da mensagem.

Esse tipo de mensagem implementa IInAppMessageHtmlque é uma subclasse de IInAppMessage.

As mensagens no app do Android suportam uma interface JavaScript brazeBridge para chamar métodos no Braze Android SDK a partir do seu HTML; consulte nossa página de ponte JavaScript para obter mais detalhes.

Uma mensagem no app em HTML com um carrossel de conteúdo e botões interativos.

important:

Atualmente, não oferecemos suporte à exibição de mensagens no app em HTML personalizado em um iFrame nas plataformas iOS e Android.

tip:

Você também pode definir exibições personalizadas de mensagens no app para o seu aplicativo. Para obter um passo a passo completo, consulte Configuração de fábricas personalizadas.

Ativação de mensagens no app

Etapa 1: Registrar `BrazeInAppMessageManager`

A exibição de mensagens no app é gerenciada pela classe BrazeInAppMessageManager. Todas as atividades do seu app devem ser registradas no site BrazeInAppMessageManager para permitir que ele adicione visualizações de mensagens no app à hierarquia de visualizações. Há duas maneiras de fazer isso:

automaticamente
manualmente

A integração do retorno de chamada do ciclo de vida da atividade lida automaticamente com o registro de mensagens no app; não é necessária nenhuma integração extra. Este é o método recomendado para lidar com o registro de mensagens no app.

warning:

Se você estiver usando retorno de chamada do ciclo de vida da atividade para registro automático, não complete esta etapa.

Em seu Application.onCreate(), chame ensureSubscribedToInAppMessageEvents():

java
kotlin

BrazeInAppMessageManager.getInstance().ensureSubscribedToInAppMessageEvents(context);

BrazeInAppMessageManager.getInstance().ensureSubscribedToInAppMessageEvents(context)

Em cada atividade onde mensagens no app podem ser exibidas, chame registerInAppMessageManager() no onResume() dessa atividade:

java
kotlin

@Override
public void onResume() {
  super.onResume();
  // Registers the BrazeInAppMessageManager for the current Activity. This Activity will now listen for
  // in-app messages from Braze.
  BrazeInAppMessageManager.getInstance().registerInAppMessageManager(activity);
}

public override fun onResume() {
  super.onResume()
  // Registers the BrazeInAppMessageManager for the current Activity. This Activity will now listen for
  // in-app messages from Braze.
  BrazeInAppMessageManager.getInstance().registerInAppMessageManager(this)
}

Em cada atividade onde registerInAppMessageManager() foi chamado, chame unregisterInAppMessageManager() no onPause() dessa atividade:

java
kotlin

@Override
public void onPause() {
  super.onPause();
  // Unregisters the BrazeInAppMessageManager for the current Activity.
  BrazeInAppMessageManager.getInstance().unregisterInAppMessageManager(activity);
}

public override fun onPause() {
  super.onPause()
  // Unregisters the BrazeInAppMessageManager.
  BrazeInAppMessageManager.getInstance().unregisterInAppMessageManager(this)
}

Etapa 2: Atualize a lista de bloqueio do gerente (opcional)

Em sua integração, você pode exigir que determinadas atividades em seu app não mostrem mensagens no app. A integração do retorno de chamada do ciclo de vida da atividade oferece uma maneira fácil de fazer isso.

O código de exemplo a seguir adiciona duas atividades à lista de bloqueio de registro de mensagens no app: SplashActivity e SettingsActivity.

java
kotlin

public class MyApplication extends Application {
  @Override
  public void onCreate() {
    super.onCreate();
    Set<Class> inAppMessageBlocklist = new HashSet<>();
    inAppMessageBlocklist.add(SplashActivity.class);
    inAppMessageBlocklist.add(SettingsActivity.class);
    registerActivityLifecycleCallbacks(new BrazeActivityLifecycleCallbackListener(inAppMessageBlocklist));
  }
}

class MyApplication : Application() {
  override fun onCreate() {
    super.onCreate()
    val inAppMessageBlocklist = HashSet<Class<*>>()
    inAppMessageBlocklist.add(SplashActivity::class.java)
    inAppMessageBlocklist.add(SettingsActivity::class.java)
    registerActivityLifecycleCallbacks(BrazeActivityLifecycleCallbackListener(inAppMessageBlocklist))
  }
}

Pré-requisitos

Antes de usar este recurso, você precisará integrar o SDK Swift Braze. Você também precisará ativar as mensagens no app.

Tipos de mensagens

swift

Cada tipo de mensagem no app é altamente personalizável em termos de conteúdo, imagens, ícones, ações de clique, análise de dados, exibição e entrega. Eles são tipos enumerados de Braze.InAppMessage, que define o comportamento básico e as características de todas as mensagens no app. Para obter a lista completa de propriedades e uso de mensagens no app, consulte a classeInAppMessage .

Estes são os tipos de mensagens no app disponíveis no Braze e como eles serão exibidos para os usuários finais.

Slideup As mensagens no app recebem esse nome porque “deslizam para cima” ou “deslizam para baixo” a partir da parte superior ou inferior da tela. Eles cobrem uma pequena parte da tela e fornecem um recurso de envio de mensagens eficaz e não intrusivo.

Uma mensagem no app em slideup na parte inferior e superior da tela do telefone.

Modal As mensagens no app aparecem no centro da tela e são emolduradas por um painel translúcido. Úteis para o envio de mensagens mais críticas, eles podem ser equipados com até dois botões ativados por análise de dados.

Uma mensagem modal no app no centro da tela do telefone.

Modal Image As mensagens no app aparecem no centro da tela e são emolduradas por um painel translúcido. Essas mensagens são semelhantes ao tipo Modal, mas sem cabeçalho ou texto de mensagem. Úteis para o envio de mensagens mais críticas, eles podem ser equipados com até dois botões ativados por análise de dados.

Uma mensagem no app com imagem modal no centro da tela do telefone.

Full As mensagens no app são úteis para maximizar o conteúdo e o impacto da sua comunicação com o usuário. A metade superior de uma mensagem no app Full contém uma imagem, e a metade inferior exibe texto e até dois botões de análise de dados.

Uma mensagem no app em tela cheia exibida em toda a tela do telefone.

Full Image As mensagens no app são semelhantes às mensagens no app Full, exceto pelo fato de não terem cabeçalho ou texto de mensagem. Esse tipo de mensagem é útil para maximizar o conteúdo e o impacto da sua comunicação com o usuário. Uma mensagem no app Full Image contém uma imagem que abrange toda a tela, com a opção de exibir até dois botões de análise de dados ativados.

Uma mensagem no app com imagem em tela cheia exibida em toda a tela do telefone.

HTML As mensagens no app são úteis para criar conteúdo totalmente personalizado para o usuário. HTML definido pelo usuário O conteúdo completo da mensagem no app é exibido em WKWebViewe pode, opcionalmente, conter outros conteúdos avançados, como imagens e fontes, permitindo controle total sobre a aparência e a funcionalidade da mensagem.

As mensagens no app do iOS suportam uma interface JavaScript brazeBridge para chamar métodos no Braze Web SDK a partir do seu HTML; consulte nossas práticas recomendadas para obter mais detalhes.

O exemplo a seguir mostra uma mensagem no app paginada em HTML Full:

Uma mensagem no app em HTML com um carrossel de conteúdo e botões interativos.

Note que atualmente não oferecemos suporte à exibição de mensagens no app em HTML personalizado em um iFrame nas plataformas iOS e Android.

Control As mensagens no app não contêm um componente de interface do usuário e são usadas principalmente para fins de análise de dados. Esse tipo é usado para verificar o recebimento de uma mensagem no app enviada a um grupo de controle.

Para obter mais detalhes sobre a seleção inteligente e os grupos de controle, consulte Seleção inteligente.

Ativação de mensagens no app

Etapa 1: Criar uma implementação de `BrazeInAppMessagePresenter`

Para permitir que o Braze exiba mensagens no app, crie uma implementação do protocolo BrazeInAppMessagePresenter e atribua-o ao inAppMessagePresenter opcional em sua instância do Braze. Você também pode usar o apresentador padrão do Braze UI instanciando um objeto BrazeInAppMessageUI.

Será necessário importar a biblioteca BrazeUI para acessar a classe BrazeInAppMessageUI.

swift
objective c

AppDelegate.braze?.inAppMessagePresenter = BrazeInAppMessageUI()

AppDelegate.braze.inAppMessagePresenter = [[BrazeInAppMessageUI alloc] init];

Etapa 2: Manusear gatilhos não correspondentes

Implementar BrazeDelegate.(_:noMatchingTriggerForEvent) na classe BrazeDelegate relevante. Quando o Braze não conseguir encontrar um disparador correspondente para um determinado evento, ele chamará esse método automaticamente.

Prerequisites

Before you can use this feature, you’ll need to integrate the Web Braze SDK. Entretanto, não é necessária nenhuma configuração adicional.

Tipos de mensagens

Todas as mensagens no app herdam seu protótipo de InAppMessage, que define o comportamento básico e as características de todas as mensagens no app. As subclasses prototípicas são SlideUpMessage, ModalMessage, FullScreenMessage, e HtmlMessage.

Cada tipo de mensagem no app é personalizável em termos de conteúdo, imagens, ícones, ações de clique, análise de dados, exibição e entrega.

As mensagens no app SlideUp têm esse nome porque, nas plataformas móveis, elas tradicionalmente “deslizam para cima” ou “deslizam para baixo” do topo ou da parte inferior da tela. No Braze Web SDK, essas mensagens são exibidas mais como uma notificação no estilo Growl ou Toast para alinhar com o paradigma dominante da web. Eles cobrem uma pequena parte da tela e fornecem um recurso de envio de mensagens eficaz e não intrusivo.

Modal As mensagens no app aparecem no centro da tela e são emolduradas por um painel translúcido. Úteis para o envio de mensagens mais críticas, eles podem ser capacitados com até dois botões de ação por clique e de análise de dados.

Full As mensagens no app são úteis para maximizar o conteúdo e o impacto da sua comunicação com o usuário. Em janelas de navegador estreitas (por exemplo, na web móvel), mensagem no app full ocupam toda a janela do navegador. Em janelas de navegador maiores, mensagens no app full aparecem de forma semelhante a mensagens no app modal. A metade superior de uma mensagem no app full contém uma imagem, e a metade inferior permite até oito linhas de texto, bem como até dois botões com ação de clique e habilitados para análise de dados.

HTML As mensagens no app são úteis para criar conteúdo totalmente personalizado para o usuário. O conteúdo HTML definido pelo usuário é exibido em um iFrame e pode conter conteúdos avançados, como imagens, fontes, vídeos e elementos interativos, permitindo controle total sobre a aparência e a funcionalidade da mensagem. Esses suportam uma interface JavaScript brazeBridge para chamar métodos no Braze Web SDK de dentro do HTML. Para saber mais, consulte nossas práticas recomendadas.

important:

Para ativar mensagens no app HTML através do Web SDK, você deve fornecer a opção de inicialização allowUserSuppliedJavascript para a Braze, por exemplo, braze.initialize('YOUR-API_KEY', {allowUserSuppliedJavascript: true}). Isto é por razões de segurança. Mensagens HTML no app podem executar JavaScript, então exigimos que um mantenedor do site as ative.

O exemplo a seguir mostra uma mensagem no app HTML paginada:

Uma mensagem no app em HTML com um carrossel de conteúdo e botões interativos.

Pré-requisitos

Antes de poder usar esse recurso, você precisará integrar o Android Braze SDK.

About TV and OTT support

The Android Braze SDK natively supports displaying in-app messages on OTT devices like Android TV or Fire Stick. However, there’s some key differences between native Android and OTT in-app messages. For OTT devices:

In-app messages that require touch mode, such as slideup, are disabled on OTT.
The currently selected or focused item, such as a button or close button, will be highlighted.
Body clicks on the in-app message itself, such as not on a button, are not supported.

Prerequisites

Before you can use this feature, you’ll need to integrate the Cordova Braze SDK.

important:

Lembre-se de que as mensagens no app que contêm botões incluirão a mensagem clickAction na carga útil final se a ação de clique for adicionada antes da adição do texto do botão.

O objeto de mensagem no app slideup estende InAppMessageBase.

Esse tipo de mensagem estende InAppMessageImmersiveBasedando-lhe a opção de adicionar funcionalidade personalizada às mensagens no app geradas localmente.

Esse tipo de mensagem implementa IInAppMessageHtmlque é uma subclasse de IInAppMessage.

Uma mensagem no app em HTML com um carrossel de conteúdo e botões interativos.

important:

Atualmente, não oferecemos suporte à exibição de mensagens no app em HTML personalizado em um iFrame nas plataformas iOS e Android.

tip:

Você também pode definir exibições personalizadas de mensagens no app para o seu aplicativo. Para obter um passo a passo completo, consulte Configuração de fábricas personalizadas.

Estes são os tipos de mensagens no app disponíveis no Braze e como eles serão exibidos para os usuários finais.

Uma mensagem no app em slideup na parte inferior e superior da tela do telefone.

Uma mensagem modal no app no centro da tela do telefone.

Uma mensagem no app com imagem modal no centro da tela do telefone.

Uma mensagem no app em tela cheia exibida em toda a tela do telefone.

Uma mensagem no app com imagem em tela cheia exibida em toda a tela do telefone.

O exemplo a seguir mostra uma mensagem no app paginada em HTML Full:

Uma mensagem no app em HTML com um carrossel de conteúdo e botões interativos.

Note que atualmente não oferecemos suporte à exibição de mensagens no app em HTML personalizado em um iFrame nas plataformas iOS e Android.

Para obter mais detalhes sobre a seleção inteligente e os grupos de controle, consulte Seleção inteligente.

Pré-requisitos

Antes de poder usar esse recurso, você precisará integrar o Flutter Braze SDK.

Tipos de mensagens

android
swift

important:

Lembre-se de que as mensagens no app que contêm botões incluirão a mensagem clickAction na carga útil final se a ação de clique for adicionada antes da adição do texto do botão.

O objeto de mensagem no app slideup estende InAppMessageBase.

Esse tipo de mensagem estende InAppMessageImmersiveBasedando-lhe a opção de adicionar funcionalidade personalizada às mensagens no app geradas localmente.

Esse tipo de mensagem implementa IInAppMessageHtmlque é uma subclasse de IInAppMessage.

Uma mensagem no app em HTML com um carrossel de conteúdo e botões interativos.

important:

Atualmente, não oferecemos suporte à exibição de mensagens no app em HTML personalizado em um iFrame nas plataformas iOS e Android.

tip:

Você também pode definir exibições personalizadas de mensagens no app para o seu aplicativo. Para obter um passo a passo completo, consulte Configuração de fábricas personalizadas.

Estes são os tipos de mensagens no app disponíveis no Braze e como eles serão exibidos para os usuários finais.

Uma mensagem no app em slideup na parte inferior e superior da tela do telefone.

Uma mensagem modal no app no centro da tela do telefone.

Uma mensagem no app com imagem modal no centro da tela do telefone.

Uma mensagem no app em tela cheia exibida em toda a tela do telefone.

Uma mensagem no app com imagem em tela cheia exibida em toda a tela do telefone.

O exemplo a seguir mostra uma mensagem no app paginada em HTML Full:

Uma mensagem no app em HTML com um carrossel de conteúdo e botões interativos.

Note que atualmente não oferecemos suporte à exibição de mensagens no app em HTML personalizado em um iFrame nas plataformas iOS e Android.

Para obter mais detalhes sobre a seleção inteligente e os grupos de controle, consulte Seleção inteligente.

Prerequisites

Before you can use this feature, you’ll need to integrate the React Native Braze SDK.

Tipos de mensagens

android
swift

important:

Lembre-se de que as mensagens no app que contêm botões incluirão a mensagem clickAction na carga útil final se a ação de clique for adicionada antes da adição do texto do botão.

O objeto de mensagem no app slideup estende InAppMessageBase.

Esse tipo de mensagem estende InAppMessageImmersiveBasedando-lhe a opção de adicionar funcionalidade personalizada às mensagens no app geradas localmente.

Esse tipo de mensagem implementa IInAppMessageHtmlque é uma subclasse de IInAppMessage.

Uma mensagem no app em HTML com um carrossel de conteúdo e botões interativos.

important:

Atualmente, não oferecemos suporte à exibição de mensagens no app em HTML personalizado em um iFrame nas plataformas iOS e Android.

tip:

Você também pode definir exibições personalizadas de mensagens no app para o seu aplicativo. Para obter um passo a passo completo, consulte Configuração de fábricas personalizadas.

Estes são os tipos de mensagens no app disponíveis no Braze e como eles serão exibidos para os usuários finais.

Uma mensagem no app em slideup na parte inferior e superior da tela do telefone.

Uma mensagem modal no app no centro da tela do telefone.

Uma mensagem no app com imagem modal no centro da tela do telefone.

Uma mensagem no app em tela cheia exibida em toda a tela do telefone.

Uma mensagem no app com imagem em tela cheia exibida em toda a tela do telefone.

O exemplo a seguir mostra uma mensagem no app paginada em HTML Full:

Uma mensagem no app em HTML com um carrossel de conteúdo e botões interativos.

Note que atualmente não oferecemos suporte à exibição de mensagens no app em HTML personalizado em um iFrame nas plataformas iOS e Android.

Para obter mais detalhes sobre a seleção inteligente e os grupos de controle, consulte Seleção inteligente.

Modelo de dados

O modelo de mensagem no app está disponível no SDK do React Native. Braze tem quatro tipos de mensagem no app que compartilham o mesmo modelo de dados: slideup, modal, full e HTML full.

Mensagens

O modelo de mensagem no app fornece a base para todas as mensagens no app.

Propriedade Descrição

inAppMessageJsonString A representação JSON da mensagem.

message O texto da mensagem.

header O cabeçalho da mensagem.

uri O URI associado à ação de clique do botão.

imageUrl A URL da imagem da mensagem.

zippedAssetsUrl Os ativos compactados preparados para exibir conteúdo HTML.

useWebView Indica se a ação de clique do botão deve redirecionar usando uma visualização da web.

duration A duração de exibição da mensagem.

clickAction O tipo de ação de clique do botão. Os tipos são: URI, e NONE.

dismissType O tipo de fechamento da mensagem. Os dois tipos são: SWIPE e AUTO_DISMISS.

messageType O tipo de mensagem no app suportado pelo SDK. Os quatro tipos são: SLIDEUP, MODAL, FULL e HTML_FULL.

extras O dicionário de extras da mensagem. Valor padrão: [:].

buttons A lista de botões na mensagem no app.

toString() A mensagem como uma string de representação.

Para uma referência completa do modelo de mensagem no app, consulte a documentação para Android e para iOS.

Botões

Botões podem ser adicionados às mensagens no app para realizar ações e registrar análise de dados. O modelo de botão fornece a base para todos os botões de mensagem no app.

Propriedade Descrição

text O texto no botão.

uri O URI associado à ação de clique do botão.

useWebView Indica se a ação de clique do botão deve redirecionar usando uma visualização da web.

clickAction O tipo de ação de clique processada quando o usuário clica no botão. Os tipos são: URI, e NONE.

id O ID do botão na mensagem.

toString() A representação do botão como uma string.

Para uma referência completa do modelo de botão, consulte a documentação para Android e para iOS.

Prerequisites

Before you can use this feature, you’ll need to integrate the Roku Braze SDK. Além disso, as mensagens no app só serão enviadas para dispositivos Roku que estejam executando a versão mínima suportada do SDK:

Roku: 0.1.2+

Tipos de mensagens

android
swift

important:

Lembre-se de que as mensagens no app que contêm botões incluirão a mensagem clickAction na carga útil final se a ação de clique for adicionada antes da adição do texto do botão.

O objeto de mensagem no app slideup estende InAppMessageBase.

Esse tipo de mensagem estende InAppMessageImmersiveBasedando-lhe a opção de adicionar funcionalidade personalizada às mensagens no app geradas localmente.

Esse tipo de mensagem implementa IInAppMessageHtmlque é uma subclasse de IInAppMessage.

Uma mensagem no app em HTML com um carrossel de conteúdo e botões interativos.

important:

Atualmente, não oferecemos suporte à exibição de mensagens no app em HTML personalizado em um iFrame nas plataformas iOS e Android.

tip:

Você também pode definir exibições personalizadas de mensagens no app para o seu aplicativo. Para obter um passo a passo completo, consulte Configuração de fábricas personalizadas.

Estes são os tipos de mensagens no app disponíveis no Braze e como eles serão exibidos para os usuários finais.

Uma mensagem no app em slideup na parte inferior e superior da tela do telefone.

Uma mensagem modal no app no centro da tela do telefone.

Uma mensagem no app com imagem modal no centro da tela do telefone.

Uma mensagem no app em tela cheia exibida em toda a tela do telefone.

Uma mensagem no app com imagem em tela cheia exibida em toda a tela do telefone.

O exemplo a seguir mostra uma mensagem no app paginada em HTML Full:

Uma mensagem no app em HTML com um carrossel de conteúdo e botões interativos.

Note que atualmente não oferecemos suporte à exibição de mensagens no app em HTML personalizado em um iFrame nas plataformas iOS e Android.

Para obter mais detalhes sobre a seleção inteligente e os grupos de controle, consulte Seleção inteligente.

Ativação de mensagens no app

Etapa 1: Adicionar um observador

Para processar mensagens no app, você pode adicionar um observador em BrazeTask.BrazeInAppMessage:

m.BrazeTask.observeField("BrazeInAppMessage", "onInAppMessageReceived")

Etapa 2: Acesso a mensagens disparadas

Então, dentro do seu manipulador, você tem acesso à mensagem no app mais alta que suas campanhas dispararam:

sub onInAppMessageReceived()
  in_app_message = m.BrazeTask.BrazeInAppMessage
  ...
end sub

Campos de mensagens

Manuseio

A seguir estão listados os campos que você precisará para gerenciar suas mensagens no app:

Campos Descrição

buttons Lista de botões (pode ser uma lista vazia).

click_action "URI" ou "NONE". Use este campo para indicar se a mensagem no app deve abrir um link URI ou fechar a mensagem quando clicado. Quando não houver botões, isso deve acontecer quando o usuário clicar em “OK” quando a mensagem no app for exibida.

dismiss_type "AUTO_DISMISS" ou "SWIPE". Use este campo para indicar se sua mensagem no app será automaticamente descartada ou se exigirá um deslize para ser descartada.

display_delay Quanto tempo (segundos) esperar até exibir a mensagem no app.

duration Por quanto tempo (milissegundos) a mensagem deve ser exibida quando dismiss_type é configurado para "AUTO_DISMISS".

extras Pares chave-valor.

header O texto do cabeçalho.

id O ID usado para registrar impressões ou cliques.

image_url URL da imagem da mensagem no app.

message Texto do corpo da mensagem.

uri Seus usuários de URI serão enviados com base no seu click_action. Este campo deve ser incluído quando click_action é "URI".

important:

Para mensagens no app contendo botões, a mensagem click_action também será incluída na carga útil final se a ação de clique for adicionada antes de adicionar o texto do botão.

Estilo

Existem também vários campos de estilo que você pode escolher usar no dashboard:

Campos Descrição

bg_color Cor de fundo.

close_button_color Cor do botão de fechar.

frame_color A cor da sobreposição da tela de fundo.

header_text_color Cor do texto do cabeçalho.

message_text_color Cor do texto da mensagem.

text_align “INÍCIO”, “CENTRO” ou “FIM”. Seu alinhamento de texto selecionado.

Alternativamente, você poderia implementar a mensagem no app e estilizar dentro do seu aplicativo Roku usando uma paleta padrão:

Botões

Campos Descrição

click_action "URI" ou "NONE". Use este campo para indicar se a mensagem no app deve abrir um link URI ou fechar a mensagem quando clicado.

id O valor de ID do próprio botão.

text O texto a ser exibido no botão.

uri Seus usuários de URI serão enviados com base no seu click_action. Este campo deve ser incluído quando click_action é "URI".

important:

Keep in mind, you’ll need to implement your own custom UI since in-app messaging is supported via headless UI using the Swift SDK—which does not include any default UI or views for tvOS.

Pré-requisitos

Antes de usar este recurso, você precisará integrar o SDK Swift Braze.

Enabling in-app messages

Step 1: Create a new iOS app

In Braze, select Settings > App Settings, then select Add App. Enter a name for your tvOS app, select iOS—not tvOS—then select Add App.

ALT_TEXT.

warning:

If you select the tvOS checkbox, you will not be able to customize in-app messages for tvOS.

Step 2: Get your app’s API key

In your app settings, select your new tvOS app then take note of your app’s API key. You’ll use this key to configure your app in Xcode.

ALT_TEXT

Step 3: Integrate BrazeKit

Use your app’s API key to integrate the Braze Swift SDK into your tvOS project in Xcode. You only need to integrate BrazeKit from the Braze Swift SDK.

Step 4: Create your custom UI

Because Braze doesn’t provide a default UI for in-app messages on tvOS, you’ll need to customize it yourself. For a full walkthrough, see our step-by-step tutorial: Customizing in-app messages for tvOS. For a sample project, see Braze Swift SDK samples.

Pré-requisitos

Antes de poder usar esse recurso, você precisará integrar o Unity Braze SDK.

Tipos de mensagens

android
swift

important:

Lembre-se de que as mensagens no app que contêm botões incluirão a mensagem clickAction na carga útil final se a ação de clique for adicionada antes da adição do texto do botão.

O objeto de mensagem no app slideup estende InAppMessageBase.

Esse tipo de mensagem estende InAppMessageImmersiveBasedando-lhe a opção de adicionar funcionalidade personalizada às mensagens no app geradas localmente.

Esse tipo de mensagem implementa IInAppMessageHtmlque é uma subclasse de IInAppMessage.

Uma mensagem no app em HTML com um carrossel de conteúdo e botões interativos.

important:

Atualmente, não oferecemos suporte à exibição de mensagens no app em HTML personalizado em um iFrame nas plataformas iOS e Android.

tip:

Você também pode definir exibições personalizadas de mensagens no app para o seu aplicativo. Para obter um passo a passo completo, consulte Configuração de fábricas personalizadas.

Estes são os tipos de mensagens no app disponíveis no Braze e como eles serão exibidos para os usuários finais.

Uma mensagem no app em slideup na parte inferior e superior da tela do telefone.

Uma mensagem modal no app no centro da tela do telefone.

Uma mensagem no app com imagem modal no centro da tela do telefone.

Uma mensagem no app em tela cheia exibida em toda a tela do telefone.

Uma mensagem no app com imagem em tela cheia exibida em toda a tela do telefone.

O exemplo a seguir mostra uma mensagem no app paginada em HTML Full:

Uma mensagem no app em HTML com um carrossel de conteúdo e botões interativos.

Note que atualmente não oferecemos suporte à exibição de mensagens no app em HTML personalizado em um iFrame nas plataformas iOS e Android.

Para obter mais detalhes sobre a seleção inteligente e os grupos de controle, consulte Seleção inteligente.

Pré-requisitos

Antes de poder usar este recurso, você precisará integrar o SDK do Xamarin Braze.

Tipos de mensagens

android
swift

important:

Lembre-se de que as mensagens no app que contêm botões incluirão a mensagem clickAction na carga útil final se a ação de clique for adicionada antes da adição do texto do botão.

O objeto de mensagem no app slideup estende InAppMessageBase.

Esse tipo de mensagem estende InAppMessageImmersiveBasedando-lhe a opção de adicionar funcionalidade personalizada às mensagens no app geradas localmente.

Esse tipo de mensagem implementa IInAppMessageHtmlque é uma subclasse de IInAppMessage.

Uma mensagem no app em HTML com um carrossel de conteúdo e botões interativos.

important:

Atualmente, não oferecemos suporte à exibição de mensagens no app em HTML personalizado em um iFrame nas plataformas iOS e Android.

tip:

Você também pode definir exibições personalizadas de mensagens no app para o seu aplicativo. Para obter um passo a passo completo, consulte Configuração de fábricas personalizadas.

Estes são os tipos de mensagens no app disponíveis no Braze e como eles serão exibidos para os usuários finais.

Uma mensagem no app em slideup na parte inferior e superior da tela do telefone.

Uma mensagem modal no app no centro da tela do telefone.

Uma mensagem no app com imagem modal no centro da tela do telefone.

Uma mensagem no app em tela cheia exibida em toda a tela do telefone.

Uma mensagem no app com imagem em tela cheia exibida em toda a tela do telefone.

O exemplo a seguir mostra uma mensagem no app paginada em HTML Full:

Uma mensagem no app em HTML com um carrossel de conteúdo e botões interativos.

Note que atualmente não oferecemos suporte à exibição de mensagens no app em HTML personalizado em um iFrame nas plataformas iOS e Android.

Para obter mais detalhes sobre a seleção inteligente e os grupos de controle, consulte Seleção inteligente.

Editar esta página no GitHub

New Stuff!

Mensagem no app

Pré-requisitos

Tipos de mensagens

Ativação de mensagens no app

Etapa 1: Registrar BrazeInAppMessageManager

Etapa 2: Atualize a lista de bloqueio do gerente (opcional)

Pré-requisitos

Tipos de mensagens

Ativação de mensagens no app

Etapa 1: Criar uma implementação de BrazeInAppMessagePresenter

Etapa 2: Manusear gatilhos não correspondentes

Prerequisites

Tipos de mensagens

Pré-requisitos

About TV and OTT support

Prerequisites

Tipos de mensagens

Pré-requisitos

Tipos de mensagens

Prerequisites

Tipos de mensagens

Modelo de dados

Mensagens

Botões

Prerequisites

Tipos de mensagens

Ativação de mensagens no app

Etapa 1: Adicionar um observador

Etapa 2: Acesso a mensagens disparadas

Campos de mensagens

Manuseio

Estilo

Botões

Pré-requisitos

Enabling in-app messages

Step 1: Create a new iOS app

Step 2: Get your app’s API key

Step 3: Integrate BrazeKit

Step 4: Create your custom UI

Pré-requisitos

Tipos de mensagens

Pré-requisitos

Tipos de mensagens

Etapa 1: Registrar `BrazeInAppMessageManager`

Etapa 1: Criar uma implementação de `BrazeInAppMessagePresenter`