Integração com AppsFlyer

Necessária a ajuda do desenvolvedor

Você precisará da ajuda da sua equipe de desenvolvimento para configurar a integração. Por favor, compartilhe este guia com eles.

Visão geral da integração

AppsFlyer é uma plataforma de atribuição móvel e análise de marketing que ajuda você a analisar a aquisição e o engajamento de usuários. Ela fornece dados abrangentes sobre o comportamento do usuário dentro do aplicativo e permite que você rastreie as fontes de aquisição de usuários. Usando as informações obtidas do AppsFlyer, você pode criar campanhas de marketing eficazes no Pushwoosh.

Uma vez que a integração esteja configurada, o AppsFlyer enviará as seguintes informações para o Pushwoosh:

• Comportamento do usuário no aplicativo como Eventos e seus atributos;
• Fontes de aquisição de usuários como os valores da Tag Acquisition Source.

Casos de uso

Usando esses dados, você pode construir segmentos de usuários e criar campanhas precisamente direcionadas e personalizadas no Pushwoosh. Abaixo estão dois exemplos de como aproveitar os dados do AppsFlyer para criar jornadas de cliente eficazes no Pushwoosh.

1. Crie campanhas altamente direcionadas no Pushwoosh usando eventos rastreados pelo AppsFlyer.

Digamos que você tenha um aplicativo de notícias. Você configurou o AppsFlyer para rastrear o evento SubscribedToNews, que é acionado toda vez que um usuário se inscreve em um canal de notícias. Este evento tem o atributo de categoria que indica o tipo de notícia ao qual o usuário se inscreve: política, negócios ou esportes.

O Pushwoosh recebe a informação sobre este evento com seus valores de atributo. Você pode criar três segmentos de usuários com base em três valores possíveis:

Agora você pode criar campanhas direcionadas a usuários que estão interessados em um tipo particular de notícia:

2. Personalize as mensagens com base nos dados de comportamento do usuário do AppsFlyer.

Neste exemplo, usaremos um aplicativo de compras online. Digamos que o AppsFlyer rastreie o evento AddToWishlist que é acionado sempre que um usuário adiciona um item à sua lista de desejos. Este evento tem o atributo item que indica o nome do item adicionado à lista de desejos.

O AppsFlyer envia os dados do evento AddToWishlist para o Pushwoosh, onde você pode personalizar mensagens dependendo das escolhas dos usuários. Por exemplo, você pode criar uma predefinição de push oferecendo um desconto em um item que um usuário adicionou à sua lista de desejos. Em vez do nome do item, adicione um placeholder de Conteúdo Dinâmico com o atributo item:

Se um usuário adicionar um item à sua lista de desejos, ele receberá um push contendo informações sobre ele. Por exemplo, aqueles que selecionarem o iPhone 14 Pro Max verão esta mensagem:

Configurando a integração

Nota

O processo de integração é idêntico para as plataformas Android e iOS.

1. Integre o SDK do Pushwoosh em seu aplicativo, se ainda não o fez. Para instruções mais detalhadas, leia o guia.

Cuidado

Para o funcionamento correto, é necessária a versão 6.5.7 ou posterior do SDK do Pushwoosh para iOS e a versão 6.6.16 ou posterior do SDK do Pushwoosh para Android.

2. Para garantir que os dados corretos sejam enviados ao AppsFlyer, integre este trecho de código em seu código. Certifique-se de que ele seja executado após a inicialização do SDK do Pushwoosh e do SDK do AppsFlyer.

Java

String pwhwid = Pushwoosh.getInstance().getHwid();
String pwuserid = Pushwoosh.getInstance().getUserId();
Map<String, Object> customData = new HashMap<String, Object>();
customData.put("pushwoosh_hwid", pwhwid);
customData.put("pushwoosh_user_id", pwuserid);
AppsFlyerLib.getInstance().setAdditionalData(customData);

Objective-C

NSString *pwhwid = [[Pushwoosh sharedInstance] getHWID];
NSString *pwuserid = [[Pushwoosh sharedInstance] getUserId];
NSDictionary *customData = [[NSDictionary alloc] initWithObjectsAndKeys:pwuserid, @"pushwoosh_user_id", pwhwid, @"pushwoosh_hwid", nil];
[[AppsFlyerLib shared] setAdditionalData:customData];

Perigo

Ao usar valores personalizados de UserID do Pushwoosh para identificar e direcionar usuários, certifique-se de executar o código após chamar o método setUserId() no SDK do Pushwoosh com o valor personalizado.

Rastreie quando o UserID do Pushwoosh muda de acordo com a lógica em seu aplicativo móvel e envie os valores atualizados para o AppsFlyer prontamente. Isso é importante para o mapeamento correto dos dados enviados com os usuários em seu banco de dados do Pushwoosh.

3. Configure a integração do Pushwoosh no AppsFlyer. Para isso, em sua conta do AppsFlyer, vá para Collaborate > Partner Marketplace. Na lista de Parceiros, localize e escolha Pushwoosh.

4. Clique em Set up integration. Em seguida, você será direcionado para a página de configuração da integração. Lá, ative o botão Activate partner.

Nota

Para aplicativos iOS, o Modo de Privacidade Avançada está ativado por padrão, o que permite controlar a disponibilidade de dados de atribuição em nível de usuário através da plataforma AppsFlyer. Embora o AppsFlyer não envie este tipo de dados para o Pushwoosh, manter o botão de Privacidade Avançada ativado pode interferir na transmissão de dados.

Para garantir que o Pushwoosh receba todos os dados, recomendamos desativar o Modo de Privacidade Avançada em App Settings. Fazer isso não comprometerá a privacidade dos dados do usuário. O Pushwoosh se dedica a gerenciar dados de forma segura e responsável, empregando protocolos de segurança padrão da indústria para proteger a confidencialidade.

5. Na seção General settings, insira suas credenciais do Pushwoosh:

• API Access Token. Para obter o token, em sua conta do Pushwoosh, vá para Settings > API Access e copie o código. Você pode saber mais sobre o Token de Acesso à API neste guia.
• Application Code (XXXXX-XXXXX) que você pode encontrar abaixo do nome do seu aplicativo em sua conta do Pushwoosh.

6. Na seção Default postback, selecione All media sources, including organic.

7. Na seção In-app event settings, insira seu Application Code e API Access Token do Pushwoosh.

8. Ative o botão In-app event postback e configure os eventos e dados a serem incluídos nos postbacks enviados ao Pushwoosh.

Escolha um ou mais eventos do AppsFlyer para enviar ao Pushwoosh a partir do menu suspenso e complete os parâmetros necessários.

Parâmetro	Descrição
the mapped to partner event	Embora este campo seja obrigatório, não se preocupe com o que você digita, pois isso não mudará como os eventos são nomeados. O Pushwoosh ainda receberá os eventos com os mesmos nomes que aparecem no AppsFlyer.
for users from	Neste campo, selecione se os postbacks são enviados exclusivamente para usuários atribuídos a este parceiro ou para todas as fontes de mídia, incluindo orgânicas.
including	Escolha como os dados do evento são compartilhados com o Pushwoosh: No values & no revenue: Envie apenas o evento em si, sem quaisquer parâmetros (valores ou receita). Values & no revenue: Envie todos os parâmetros, exceto o valor da receita. Values & revenue: Envie todos os parâmetros do evento, incluindo o valor da receita (se existir no evento). Para receber eventos com atributos adicionais enviados ao Pushwoosh, selecione Values and Revenue.

9. Uma vez que a integração esteja configurada, clique em Save.

Nota

Antes de lançar suas campanhas, certifique-se de testar a integração. Erros frequentemente ocorrem durante a configuração, então um teste rápido ajuda a evitar o desperdício de recursos em campanhas com dados ausentes ou incorretos.