Configuração do SDK Amazon

​

Visão geral

​

Requisitos

• Seu aplicativo deve ser distribuído na Amazon AppStore
• Dispositivo ou emulador Android 7.0+
• Aplicativo e plataforma OneSignal configurados

​

Configure seu app e plataforma OneSignal

Instruções passo a passo para configurar seu app OneSignal.

Você pode gerenciar múltiplas plataformas (iOS, Android, Huawei, Amazon, Web) sob um único app OneSignal.

1

Crie ou selecione seu app

• Para adicionar plataformas a um app existente, vá para Settings > Push & In-App no dashboard OneSignal.
• Para começar do zero, clique em New App/Website e siga as instruções.

Exemplo mostrando criação de um novo app.

2

Configure e ative uma plataforma

• Escolha um nome claro e reconhecível para seu app e organização.
• Selecione a(s) plataforma(s) que você quer configurar (iOS, Android, etc.).
• Clique em Next: Configure Your Platform.

Exemplo configurando seu primeiro app OneSignal, org e canal.

3

Configure credenciais da plataforma

Siga as instruções baseadas nas suas plataformas:

• Android: Configure Credenciais Firebase
• iOS: Token p8 (Recomendado) ou Certificado p12
• Amazon: Gere API Key
• Huawei: Autorize OneSignal

Clique em Save & Continue após inserir suas credenciais.

4

Escolha o SDK alvo

Selecione o SDK que corresponde à sua plataforma de desenvolvimento (por exemplo, iOS, Android, React Native, Unity), depois clique em Save & Continue.

Selecione qual SDK você está usando para navegar à documentação.

5

Instale o SDK e salve seu App ID

Uma vez que sua plataforma está configurada, seu OneSignal App ID será exibido. Copie e salve este ID—você precisará dele ao instalar e inicializar o SDK.Se estiver colaborando com outros, use o botão Invite para adicionar desenvolvedores ou membros da equipe, depois clique em Done para completar a configuração.

Salve seu App ID e convide membros adicionais da equipe.

Uma vez completo, siga o guia de instalação do SDK para sua plataforma selecionada para finalizar a integração OneSignal.

​

Configuração

​

Atualizar AndroidManifest.xml

<manifest xmlns:android="http://schemas.android.com/apk/res/android"
    xmlns:amazon="http://schemas.amazon.com/apk/res/android"
    package="com.onesignal.example"
    android:versionCode="1"
    android:versionName="1.0" >

<uses-permission android:name="com.amazon.device.messaging.permission.RECEIVE" />
<permission
  android:name="COM.YOUR.PACKAGE_NAME.permission.RECEIVE_ADM_MESSAGE"
  android:protectionLevel="signature"
/>
<uses-permission android:name="COM.YOUR.PACKAGE_NAME.permission.RECEIVE_ADM_MESSAGE" />

<application ....>
  <amazon:enable-feature android:name="com.amazon.device.messaging"
                         android:required="false"/>
  <service android:name="com.onesignal.notifications.services.ADMMessageHandler"
           android:exported="false" />
  <service android:name="com.onesignal.notifications.services.ADMMessageHandlerJob"
           android:permission="android.permission.BIND_JOB_SERVICE"
           android:exported="false" />
  <receiver android:name="com.onesignal.notifications.receivers.ADMMessageReceiver"
           android:permission="com.amazon.device.messaging.permission.SEND"
            android:exported="true" >
    <intent-filter>
      <action android:name="com.amazon.device.messaging.intent.REGISTRATION" />
      <action android:name="com.amazon.device.messaging.intent.RECEIVE" />
      <category android:name="COM.YOUR.PACKAGE_NAME" />
    </intent-filter>
  </receiver>

</application>

​

Arquivo de chave API da Amazon

Chave API da Amazon

Variante de Compilação

​

Testando a integração do OneSignal SDK

​

Verifique inscrições mobile

1

Inicie seu app em um dispositivo de teste.

O prompt de permissão push nativo deve aparecer automaticamente se você adicionou o método requestPermission durante a inicialização.

Prompts de permissão push iOS e Android

2

Verifique seu dashboard OneSignal

Antes de aceitar o prompt, verifique o dashboard OneSignal:

• Vá para Audience > Subscriptions.
• Você deve ver uma nova entrada com o status “Never Subscribed”.

Dashboard mostrando inscrição com status 'Never Subscribed'

3

Retorne ao app e toque em Allow no prompt.

4

Atualize a página de Subscription do dashboard OneSignal.

O status da inscrição deve agora mostrar Subscribed.

Dashboard mostrando inscrição com status 'Subscribed'

Você criou com sucesso uma inscrição mobile. Inscrições mobile são criadas quando usuários abrem seu app pela primeira vez em um dispositivo ou se eles desinstalam e reinstalam seu app no mesmo dispositivo.

​

Configure inscrições de teste

1

Adicione a Test Subscriptions.

No dashboard, próximo à inscrição, clique no botão Options (três pontos) e selecione Add to Test Subscriptions.

Adicionando um dispositivo a Test Subscriptions

2

Nomeie sua inscrição.

Nomeie a inscrição para que você possa identificar facilmente seu dispositivo depois na aba Test Subscriptions.

Dashboard mostrando o campo 'Name your subscription'

3

Crie um segmento de usuários de teste.

Vá para Audience > Segments > New Segment.

4

Nomeie o segmento.

Nomeie o segmento Test Users (o nome é importante porque será usado depois).

5

Adicione o filtro Test Users e clique em Create Segment.

Criando um segmento 'Test Users' com o filtro Test Users

Você criou com sucesso um segmento de usuários de teste. Agora podemos testar enviar mensagens para este dispositivo individual e grupos de usuários de teste.

​

Envie push de teste via API

1

Obtenha seu App API Key e App ID.

No seu dashboard OneSignal, vá para Settings > Keys & IDs.

2

Atualize o código fornecido.

Substitua YOUR_APP_API_KEY e YOUR_APP_ID no código abaixo com suas chaves reais. Este código usa o segmento Test Users que criamos anteriormente.

Copy

Ask AI

curl -X \
POST --url 'https://api.onesignal.com/notifications' \
 --header 'content-type: application/json; charset=utf-8' \
 --header 'authorization: Key YOUR_APP_API_KEY' \
 --data \
 '{
  "app_id": "YOUR_APP_ID",
  "target_channel": "push",
  "name": "Testing basic setup",
  "headings": {
  	"en": "👋"
  },
  "contents": {
    "en": "Hello world!"
  },
  "included_segments": [
    "Test Users"
  ],
  "ios_attachments": {
    "onesignal_logo": "https://avatars.githubusercontent.com/u/11823027?s=200&v=4"
  },
  "big_picture": "https://avatars.githubusercontent.com/u/11823027?s=200&v=4"
}'

3

Execute o código.

Execute o código no seu terminal.

4

Verifique imagens e entrega confirmada.

Se todos os passos de configuração foram completados com sucesso, as inscrições de teste devem receber uma notificação com uma imagem incluída:

Notificação push com imagem no iOS e Android

Imagens aparecerão pequenas na visualização de notificação recolhida. Expanda a notificação para ver a imagem completa.

5

Verifique por entrega confirmada.

No seu dashboard, vá para Delivery > Sent Messages, depois clique na mensagem para ver as estatísticas.Você deve ver a estatística confirmed, significando que o dispositivo recebeu o push.

Estatísticas de entrega mostrando entrega confirmada

Se você está em um plano Professional ou superior, role para Audience Activity para ver confirmação a nível de inscrição:

Entrega confirmada a nível de dispositivo em Audience Activity

Você enviou com sucesso uma notificação via nossa API para um segmento.

• Não recebeu imagem? Sua Notification Service Extension pode estar faltando.
• Sem entrega confirmada? Revise o guia de solução de problemas aqui.
• Tendo problemas? Copie e cole a requisição da api e um log do início ao fim do lançamento do app em um arquivo .txt. Depois compartilhe ambos com support@onesignal.com.

​

Envie uma mensagem in-app

1

Feche ou coloque em background seu app no dispositivo.

Isso é porque usuários devem atender aos critérios de público in-app antes que uma nova sessão inicie. No OneSignal, uma nova sessão inicia quando o usuário abre seu app depois de ter estado em background ou fechado por pelo menos 30 segundos. Para mais detalhes, veja nosso guia sobre como mensagens in-app são exibidas.

2

Crie uma mensagem in-app.

• No seu dashboard OneSignal, navegue para Messages > In-App > New In-App.
• Encontre e selecione a mensagem Welcome.
• Defina seu Público como o segmento Test Users que usamos anteriormente.

Direcionando o segmento 'Test Users' com uma mensagem in-app

3

Personalize o conteúdo da mensagem se desejar.

Exemplo de personalização da mensagem Welcome in-app

4

Defina Trigger como 'On app open'.

5

Agende frequência.

Em Schedule > How often do you want to show this message? selecione Every time trigger conditions are satisfied.

Opções de agendamento de mensagem in-app

6

Torne a mensagem ativa.

Clique em Make Message Live para que fique disponível para seus Test Users cada vez que eles abrem o app.

7

Abra o app e veja a mensagem.

Depois que a mensagem in-app estiver ativa, abra seu app. Você deve vê-la exibida:

Mensagem in-app Welcome mostrada em dispositivos

Não está vendo a mensagem?

• Inicie uma nova sessão
  • Você deve fechar ou colocar em background o app por pelo menos 30 segundos antes de reabrir. Isso garante que uma nova sessão seja iniciada.
  • Para mais, veja como mensagens in-app são exibidas.
• Ainda no segmento Test Users?
  • Se você reinstalou ou trocou de dispositivo, adicione novamente o dispositivo a Test Subscriptions e confirme que ele faz parte do segmento Test Users.
• Tendo problemas?
  • Siga Obtendo um Debug Log enquanto reproduz os passos acima. Isso gerará logging adicional que você pode compartilhar com support@onesignal.com e nós ajudaremos a investigar o que está acontecendo.

​

Identificação de usuário

​

Atribua External ID

​

Adicione data tags

Um perfil de usuário no OneSignal com uma tag chamada "current_level" definida como "6"

Editor de segmento mostrando um segmento direcionado a usuários com um valor current_level maior que 4 e menor que 10

Captura de tela mostrando uma notificação push direcionada ao segmento Nível 5-10 com uma mensagem personalizada

A notificação push é recebida em um dispositivo iOS e Android com o conteúdo personalizado

​

Adicione inscrições de email e/ou SMS

• Use o método addEmail para criar inscrições de email.
• Use o método addSms para criar inscrições de SMS.

Um perfil de usuário com inscrições push, email e SMS unificadas por External ID

​

Privacidade e consentimento do usuário

• setConsentRequired(true): Previne coleta de dados até que consentimento seja dado.
• setConsentGiven(true): Habilita coleta de dados uma vez que consentimento é concedido.

• Dados coletados pelo SDK
• Tratamento de dados pessoais

​

Solicite permissões push

​

Escute eventos de push, usuário e in-app

​

Eventos de notificação push

• addClickListener(): Detecte quando uma notificação é tocada. Útil para Deep Linking.
• addForegroundLifecycleListener(): Controle como notificações se comportam em foreground.

​

Mudanças de estado do usuário

• addObserver() para estado do usuário: Detecte quando o External ID é definido.
• addPermissionObserver(): Rastreie a interação específica do usuário com o prompt de permissão push nativo.
• addObserver() para inscrição push: Rastreie quando o status de inscrição push muda.

​

Eventos de mensagem in-app

• addClickListener(): Lide com ações de clique in-app. Ideal para deep linking ou rastreamento de eventos.
• addLifecycleListener(): Rastreie o ciclo de vida completo de mensagens in-app (exibida, clicada, descartada, etc.).

​

Configuração avançada e capacidades

• 🔁 Migrando para OneSignal de outro serviço
• 🌍 Rastreamento de localização
• 🔗 Deep Linking
• 🔌 Integrações
• 🧩 Mobile Service Extensions
• 🛎️ Botões de ação
• 🌐 Mensagens multilíngues
• 🛡️ Verificação de Identidade
• 📊 Custom Outcomes
• 📲 Live Activities

​

Configuração e referência do Mobile SDK