Aba de integração

Visão geral: Visão geral: o Amplitude, um parceiro integrado da AppsFlyer, fornece análises de produtos para ajudar empresas mobile e web a entender o comportamento do usuário. As equipes de produto, marketing e growth usam o Amplitude para descobrir e compartilhar insights de engajamento, retenção e receita. A integração permite que a AppsFlyer envie dados de eventos-chave para a Amplitude após a instalação, possibilitando uma análise abrangente em nível de usuário.

Há duas versões da integração com a Amplitude:

• Amplitude V1:
  Esta versão usa a API de atribuição da Amplitude. A AppsFlyer envia os dados de instalação coletados após a conclusão da integração. A Amplitude usa o ID do anúncio como identificador e descarta os dados se nenhum evento de usuário correspondente for registrado em 72 horas. Saiba mais
• Amplitude V2 :
  Esta versão usa a API HTTP V2 da Amplitude. A AppsFlyer envia dados de instalações e de eventos in-app após a conclusão da integração. Os identificadores são priorizados (user_id e device_id) e, se a correspondência falhar, um novo usuário é registrado. Saiba mais

Para ativar ou editar a integração:

Pré-requisitos

Antes de começar:

• Entre em contato com a Amplitude para criar uma conta, caso ainda não tenha uma.
• Decida se você configurará a integração com a Amplitude V1 ou V2.
• Evite enviar os mesmos eventos pelo SDK da Amplitude e pela AppsFlyer para impedir a duplicação.
• Consulte o pré-requisito adicional para a integração com a Amplitude V2.

Pré-requisitos adicionais para a integração com a Amplitude V2

A integração V2 exige a configuração de:

• ID do dispositivo da Amplitude
• ID de usuário cliente
• ID da sessão da Amplitude

ID do dispositivo da Amplitude

Para ativar a atribuição em nível de usuário, você deve passar o Device ID da Amplitude para a SDK da AppsFlyer. Esse valor é enviado com cada postback.

AppsFlyerLib.getInstance().setAdditionalData("AmplitudeDeviceId", amplitude.getDeviceId())

[[AppsFlyerLib shared] setAdditionalData:@{@"AmplitudeDeviceId": [[Amplitude instance] getDeviceId]}];

AppsFlyerLib.shared().customData = ["AmplitudeDeviceId": Amplitude.instance().getDeviceId()]

Dictionary<string, string> customData = new Dictionary<string, string>();
customData. Add("AmplitudeDeviceId", Amplitude.getInstance().getDeviceId()); AppsFlyer.setAdditionalData(customData);

appsFlyer.setAdditionalData({"AmplitudeDeviceId": amplitude.getDeviceId()},
(res) => {
//...
}
);

appsFlyer.setAdditionalData({"AmplitudeDeviceId": amplitude.getDeviceId()});

var data = {"AmplitudeDeviceId": amplitude.getDeviceId()};
appsFlyerSdk.setAdditionalData(data);

ID de usuário cliente

Defina o ID de usuário do cliente (CUID). Este é um identificador exclusivo, normalmente gerado e definido
pelo proprietário do aplicativo durante o registro do usuário. Saiba mais

ID da sessão do Amplitude

Defina o ID da sessão do Amplitude e transmita-o para a AppsFlyer. Saiba mais

AppsFlyerLib.getInstance().setAdditionalData("AmplitudeSessionId", amplitude.getSessionId())

[[AppsFlyerLib shared] setAdditionalData:@{@"AmplitudeSessionId": [[Amplitude instance] getSessionId]}];

AppsFlyerLib.shared().customData = ["AmplitudeSessionId": Amplitude.instance().getSessionId()]

Dictionary<string, string> customData = new Dictionary<string, string>();
customData. Add("AmplitudeSessionId", Amplitude.getInstance().getSessionId()); AppsFlyer.setAdditionalData(customData);

appsFlyer.setAdditionalData({"AmplitudeSessionId": amplitude.getSessionId()},
(res) => {
//...
}
);

appsFlyer.setAdditionalData({"AmplitudeSessionId": amplitude.getSessionId()});

var data = {"AmplitudeSessionId": amplitude.getSessionId()};
appsFlyerSdk.setAdditionalData(data);

Configurando o Amplitude

Para ativar ou editar a integração:

1. Para ativar: na AppsFlyer, no menu lateral, selecione Colaborar > Partner Marketplace.

2. Para configurar a integração do Amplitude V1, selecione Amplitude V1 (parceiro de tecnologia).
    

   

   
   Para configurar a integração do Amplitude V2, selecione Amplitude V2 (parceiro de tecnologia).
    

   

3. Depois de selecionar sua versão do Amplitude, clique em Configurar a integração.
    

   

4. Clique em Configurar a integração.
   • Selecione seu aplicativo.

   • Na aba Integração, selecione o aplicativo e clique em Ativar parceiro.
      

     

5. Complete a configuração nas abas restantes:

amplitude-blocked-data.png

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

Ativar parceiro

No primeiro acesso, você precisará habilitar ativar Parceiro para permitir a configuração dos parâmetros da aba de integração. A opção deve permanecer ativada enquanto você trabalhar com o parceiro.
Saiba mais sobre a ativação de parceiros.

Configurações gerais

Compartilhamento avançado de dados

Para compartilhar informações adicionais com o Amplitude, ative o compartilhamento avançado de dados. Quando ativado, o Amplitude recebe os seguintes dados para instalação (e não eventos in-app) mapeados conforme listamos abaixo:

Propriedade do Amplitude	Ponto de dados da AppsFlyer
sub_publisher	af_siteid
network_name	pid
adgroup_name	af_adset
creative_name	af_ad_id
installed_at	install_timestamp
search_term	af_keywords
Canal	af_canal
user_id	af_customer_user_id
af_sub1	af_sub1
af_sub2	af_sub2
af_sub3	af_sub3
af_sub4	af_sub4
af_sub5	af_sub5
app_version	app_version

Centro de dados da UE

Quando o centro de dados do Amplitude na UE está desativado, os postbacks de instalação são enviados para o centro de dados dos EUA.
Para enviar os postbacks ao centro de dados da UE, basta ativá-lo no Amplitude.

Chave da API

O Amplitude se conecta com a AppsFlyer através de uma chave de API exclusiva. Se você ainda não tem essa chave, peça-a ao Amplitude para continuar com a integração ou siga as etapas abaixo.

Obtenção da chave de API do Amplitude

Observação: somente usuários que têm a função de administrador ou gerente no Amplitude podem acessar a chave de API.

1. Faça login na sua conta do Amplitude.

2. No canto superior direito da página, clique no ícone de configurações > configurações da organização.

   

3. Clique em projetos e selecione o projeto desejado.

   

4. Na aba projeto, copie sua chave de API.

   

5. Configure o Amplitude no dashboard da AppsFlyer.

Postbacks padrão

A AppsFlyer pode enviar postbacks automáticos para o Amplitude após uma instalação. Use essa seção para definir a fonte de usuários para a qual os postbacks são enviados. Saiba mais sobre postbacks padrão.

Configurações de eventos in-app

• Insira a chave da API.
• Quando o centro de dados do Amplitude está desativado, os postbacks de eventos in-app são enviadas para o centro de dados dos EUA.
  Para enviar postbacks de eventos in-app para o centro de dados da UE, basta ativá-lo no Amplitude.

Depois de salvar a configuração, a AppsFlyer envia os seguintes dados para o Amplitude:

• Device ID (IDFV/Google Advertising ID)
• Fonte de mídia
• Nome da campanha

O envio do IDFA para dispositivos iOS depende do status do consentimento do usuário na ATT e às configurações de Privacidade Avançada.

Postbacks de eventos in-app

Configure o envio de postbacks de eventos in-app para o Amplitude.

Aba do link de atribuição

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

Custo

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

Aba receita de anúncios

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

Aba permissões

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

Visualização dos dados de atribuição no console do Amplitude

Os dados de atribuição enviados para o Amplitude são exibidos em seus dashboards como eventos e propriedades prefixados com [AppsFlyer]:

Enviando eventos de Amplitude para o AppsFlyer

A integração também permite enviar seus eventos do Amplitude para o AppsFlyer via uma API de servidor para servidor. Veja a documentação da Amplitude sobre como fazer isso.