How can we help?

Integração da Kahuna com a AppsFlyer

  • Atualizado

Em resumo: a Kahuna, um parceiro integrado da AppsFlyer, dedica-se a capacitar empresas a crescer e prosperar na era mobile. Oferecemos um novo nível de engajamento autêntico entre marcas e seus clientes, onde quer que eles estejam — na web, no e-mail, no mobile, nos canais sociais — por meio de comunicação personalizada em escala. Com tecnologia de big data e machine learning, ajudamos a criar experiências encantadoras para cada cliente com a mensagem perfeita, entregue no canal certo, no momento exato.

 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.

Siga as instruções abaixo para configurar a integração com a Kahuna:

1. Requisitos mínimos - AppsFlyer SDK:

  • Android – versão 2.3.1.18 e superior
  • iOS – versão 3.3.3 e superior

2. A integração com a Kahuna exige que o Device ID da Kahuna (identificador exclusivo do usuário da Kahuna) seja preenchido no SDK da AppsFlyer. Esse parâmetro é enviado com cada postback e permite a identificação de cada usuário. Para fazer isso, você deve inserir as seguintes strings no código do seu aplicativo:

 Observação importante

Verifique se as linhas de código foram inseridas no local correto – depois que o SDK da Kahuna for iniciado e antes que os métodos appsflyer.sendtracking (Android) / trackAppLaunch (iOS) sejam chamados.

Para AndroidPara iOS
HashMap<String, Object> customData = new HashMap<String,Object>();
String deviceId = Kahuna.getInstance().getKahunaDeviceId();
customData .put("customData", deviceId);
AppsFlyerLib.setAdditionalData(customData);

Configuração da Kahuna

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. Na aba Integração, habilite Ativar parceiro.
    Para editar: Na AppsFlyer, vá para o menu lateral e selecione Colaborar > Integrações ativas.
  2. Selecione o aplicativo correspondente. 
  3. Na aba Integração selecione Ativar parceiro.
  4. No Primeira visita Aqui, você precisará ativar Ativar parceiro para habilitar a configuração dos parâmetros de integração. Essa opção deve permanecer ativada enquanto você trabalhar com o parceiro.
    Para obter mais detalhes sobre a ativação do parceiro, clique aqui.
  5. Complete a configuração utilizando as abas relevantes, conforme descrito abaixo. Para obter uma descrição detalhada do header da Janela de Configuração de Parceiros, clique aqui.

A janela de configuração da Kahuna usa apenas a aba integração.

Aba Integração

A aba Integração está dividida em diferentes seções, conforme descrito abaixo.

Ativar parceiro

Em sua primeira visita, você terá que selecionar as seguintes opções. Clique no botão ativar parceiro para permitir a configuração dos parâmetros na aba de integração. Essa opção deve permanecer ativada enquanto você trabalhar com o parceiro.
Para obter mais detalhes sobre a ativação do parceiro, clique aqui.

Configurações gerais

Chave secreta da Kahuna, Staging e Production

A Kahuna se conecta com a AppsFlyer por meio de uma chave secreta exclusiva. Se você ainda não tiver essa chave, deverá obtê-la com a Kahuna para continuar com a integração ou seguir as etapas abaixo.

Como obter a chave secreta da Kahuna

1. Faça login na sua conta da Kahuna

2. Clique no ícone do usuário e selecione Settings no canto direito do menu do dashboard

3. Copie a chave secreta da Kahuna:

4. Selecione APIs & Integrations– nesta página, você pode encontrar os parâmetros:

  • Insira a Master Key da Kahuna obtida no console da Kahuna (consulte a Seção 3)
  • Se você quiser enviar os eventos para o ambiente Sandbox da Kahuna, insira a letra S no campo Staging (consulte “Teste com o Sandbox da Kahuna”)
  • Para o ambiente de Production, insira a letra P no campo Production
  • Se você inserir ambos, os eventos serão enviados para a produção
  • Clique em Salvar.

Postbacks padrão

O AppsFlyer pode enviar postbacks automáticos para instalações de usuários do Kahuna. Use esta seção para definir o envio desses postbacks.

Swrve_msc_new_4.png

Selecione Eventos atribuídos a qualquer parceiro ou orgânico para enviar postbacks ao Kahuna para qualquer usuário que faça o download do aplicativo.

Clique em Guardar.

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

  • Kahuna Dev_ID
  • Media Source
  • Código do país
  • Versão do sistema operativo

Separador de Links de Atribuição

Links de atribuição não estão disponíveis para Kahuna.

Aba de Custos

Os dados de custo não são compatíveis com a integração desse parceiro.

Receita de anúncios

A receita de anúncios não é compatível com a integração desse parceiro.

Aba permissões

Permissões não estão disponíveis para Kahuna.

Ver dados de atribuição de usuário no Kahuna

Os eventos de instalação podem ser visualizados como Newbies no dashboard principal do Kahuna.

Você pode pesquisar um usuário específico ou acessar "Top People" na navegação do lado esquerdo.

Selecionar um dos usuários abre o Mini Profile, onde você pode ver o evento de instalação "af_install" na seção Top Events:

Teste no sandbox

Se você ainda não lançou seu aplicativo na loja de aplicativos e quer testar a integração no ambiente Sandbox do Kahuna, siga estas etapas:

1. Ao configurar o Kahuna no AppsFlyer, insira "s" na caixa de texto Staging

2. Verifique se você adicionou o código ao seu aplicativo para integrar os SDKs do AppsFlyer e do Kahuna, conforme descrito nas seções acima

3. Você deve obter o Advertising ID do seu dispositivo de teste (você pode encontrar o Advertising ID instalando o aplicativo no seu dispositivo e consultando os logs)

4. Peça ao AppsFlyer para incluir seu Advertising ID na allowlist

5. Desinstale o aplicativo do seu dispositivo

6. Configure esta URL com seus dados (nome do pacote do aplicativo, Advertising ID e nome da campanha... não inclua os colchetes) - https://app.appsflyer.com/[APP PACKAGE NAME]?pid=[SOMETHING]&advertising_id=[DEVICE’S ADVERTISING ID]

7. Acesse essa URL; você poderá ver isto:

8. Instale o aplicativo no seu dispositivo

9. Acesse o dashboard do Kahuna e pesquise o usuário (você pode ativar a depuração do Kahuna e consultar os logs para obter o ID exclusivo do dispositivo do Kahuna para esse usuário.. “dev_id”... ou, se o seu aplicativo exigir login e você passar credenciais para o Kahuna, também poderá pesquisar por essa credencial). Depois de encontrar o usuário, você deverá ver um evento “af_install” para esse usuário.

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: