How can we help?

Integração do OneSignal com a AppsFlyer

  • Atualizado

Em resumo: o OneSignal é o provedor líder de mercado de notificações push e mensagens in-app, oferecendo suporte a mais de 1 milhão de desenvolvedores e profissionais de marketing com uma plataforma de engajamento de primeira linha.

onesignal-logo-stack__3_.png

O OneSignal entrega 8 bilhões de mensagens todos os dias em todo o mundo. Com tecnologia de arquitetura superior e uma plataforma fácil de usar, o OneSignal entrega mensagens mais rapidamente, com mais eficiência e em maior escala do que qualquer outra solução no mundo. Saiba mais em onesignal.com

 Importante!

Algumas fontes de mídiarestringem o compartilhamento de dados com terceiros. Portanto, os postbacks de eventos restritos não serão enviados para esse parceiro, independentemente da configuração de envio de postbacks.

Configurando o OneSignal

A integração com o OneSignal inclui inserir algumas linhas de código no SDK da AppsFlyer no seu aplicativo e, em seguida, ativar a integração na AppsFlyer.

Configurar o SDK da AppsFlyer

Ao usar o Android, a integração com o OneSignal exige que o OneSignal Player ID (identificador exclusivo de usuário do OneSignal) seja preenchido no SDK Android da AppsFlyer. Esse parâmetro é enviado com cada postback e permite a identificação de cada usuário.

Para configurar o SDK Android da AppsFlyer:

  1. Certifique-se de que a versão do SDK que você usa seja 2.3.1.18 ou superior.
  2. Insira as linhas de código a seguir no código do seu aplicativo – depois que o SDK do OneSignal for iniciado e antes do código de inicialização do SDK da AppsFlyer.
    • Para dispositivos Android que usam a versão 3.x.x do OneSignal SDK:

      OSPermissionSubscriptionState status = OneSignal.getPermissionSubscriptionState();
      
                String deviceId = status.getSubscriptionStatus().getUserId();
      
                  customData.put("onesignalCustomerId", deviceId);
    • SDK do Unity:

      var status = OneSignal.GetPermissionSubscriptionState();
      
                String deviceId = status.subscriptionStatus.userId;
      
                  customData.put("onesignalCustomerId", deviceId);
    • Para dispositivos Android que usam o OneSignal Native SDK versão 4+:

      OSDeviceState device = OneSignal.getDeviceState();
      
                String deviceId = device.getUserId();
      
                  customData.put("onesignalCustomerId", deviceId);

Para configurar o SDK iOS da AppsFlyer:

  1. Certifique-se de que a versão do SDK que você usa seja 2.3.1.18 ou superior.
  2. Insira as linhas de código a seguir no código do seu aplicativo – depois que o SDK do OneSignal for iniciado e antes do código de inicialização do SDK da AppsFlyer.
    • Para dispositivos iOS que usam a versão 2.x.x do OneSignal SDK:

      Swift Objective-C
      let status: OSPermissionSubscriptionState = OneSignal.getPermissionSubscriptionState()
      if let deviceId = status.subscriptionStatus.userId{
          customData.put("onesignalCustomerId", deviceId);
      
    • Para dispositivos iOS que usam o SDK nativo do OneSignal versão 3+:

      Swift Objective-C
      if let deviceState = OneSignal.getDeviceState() {
          let deviceId = deviceState.userId
          customData.put("onesignalCustomerId", deviceId);
      

Pré-requisito: antes de configurar a integração, certifique-se de entrar em contato com o parceiro e abrir uma conta com ele. Antes de criar uma integração, certifique-se de entrar em contato com o parceiro e abrir uma conta com ele.

Para ativar a integração:

  1. Para ativar: na AppsFlyer, no menu lateral, selecione Colaborar > Partner Marketplace.
    Para editar: Na AppsFlyer, vá para o menu lateral e selecione Colaborar > Integrações ativas.
  2. Selecione o aplicativo correspondente. 
  3. Clique em Configurar a integração.
  4. Na aba Integração, selecione o aplicativo e ative a opção Ativar parceiro.
     Observação: essa opção deve permanecer habilitada (ativada) enquanto você trabalhar com o parceiro. Saiba mais sobre a ativação de parceiros.
  5. Complete a configuração utilizando as abas relevantes, conforme descrito abaixo:

Aba Integração

onesignal-integration-tab.png
A aba Integração está dividida em diferentes seções, conforme descrito abaixo.

Ativar parceiro

Deve permanecer ativado enquanto você trabalhar com o parceiro.
Saiba mais sobre a ativação de parceiros.

Configurações gerais

OneSignal AppID

Para conectar sua conta do OneSignal ao AppsFlyer, insira o ID do seu aplicativo no campo OneSignal AppID .
O ID do seu aplicativo do OneSignal está disponível na plataforma do OneSignal em Configurações > Chaves & IDs.

onesignal-app-id-en_us.png

Postbacks padrão

onesignal-default-postbacks_en-us.png

A AppsFlyer pode enviar postbacks automáticos para o OneSignal após instalações de usuário. Use esta seção para definir a fonte dos usuários para a qual os postbacks são enviados para cada evento.
Saiba mais sobre postbacks padrão.

Para enviar postbacks ao OneSignal para qualquer usuário que fizer download do aplicativo, selecione Todos os canais de mídia, incluindo orgânicos.

Para concluir a configuração da integração, clique em Salvar integração.

Embora todos os eventos sejam enviados pela AppsFlyer, as instalações orgânicas não são contabilizadas pelo OneSignal e, portanto, são ignoradas pela API do OneSignal.

Depois de salvar a configuração, a AppsFlyer envia os seguintes dados ao OneSignal para cada instalação orgânica e não orgânica:

  • Canal de mídia
  • Campaign name
  • ID de dispositivo
  • ID do anúncio

Separador de Links de Atribuição

Os links de atribuição não estão disponíveis para o Amplitude.

Aba de Custos

Os dados de custo não se aplicam à integração com este parceiro.

Receita de anúncios

A receita de anúncios não se aplica à integração com este parceiro.

Aba permissões

As permissões não estão disponíveis para este parceiro.

Ver dados de atribuição do usuário no OneSignal

Você pode visualizar a atribuição no Editor de Segmentos nas tags do OneSignal, tanto no nível do dispositivo individual quanto ao criar um segmento para usar em uma campanha.

onesignal-view-attribution_en-us.png

This article was translated using AI and may contain errors. For the most accurate information, please refer to the English version using the language selector.


Share article: