Obtenha dados agregados de custo de marketing, incluindo métricas de performance do LTV (lifetime value) relacionadas a custo, usando a Cost API no nível da conta do canal de mídia.
Visão geral
O ROI360 fornece dados agregados de custo de marketing, incluindo métricas de performance de LTV relacionadas a custo, no nível da conta de anúncios.
As integrações de custo são configuradas em Configurações de custo. Cada integração é conectada a uma conta de canal de mídia e mensura o custo de todos os aplicativos selecionados. Dependendo da ad network, isso pode incluir aplicativos mobile, CTV, PC e console e web. Conecte cada conta de canal de mídia apenas uma vez para ativar o custo para vários aplicativos.
As integrações de custo também podem ser criadas e editadas na aba Custo do Partner Marketplace. Ambos os pontos de entrada geram a mesma integração no nível da conta.
Importante!
O acesso às configurações de custo é controlado de acordo com as permissões de cada função. Se você não conseguir acessar as configurações de custo, peça ao seu administrador que atualize suas permissões na página Gerenciamento do usuário. No caso, você precisa de permissão para gerenciar as conexões de custo.
Criar uma nova integração da Cost API
Toda integração de custos segue as mesmas duas etapas: autenticar com o canal de mídia e, em seguida, nomear a integração e selecionar os aplicativos que ela abrange. Alguns canais de mídia exigem uma etapa adicional para que a AppsFlyer possa associar seus aplicativos aos identificadores usados no sistema deles.
Após a configuração inicial, os dados de custos serão exibidos no dashboard na próxima coleta de dados, programada para ocorrer a cada quatro horas, seis vezes ao dia.
Etapa 1: Forneça as credenciais
- Na AppsFlyer, no menu lateral, selecione Configurações > ROI360 > Configurações de custo.
- Clique em + Nova integração, selecione o canal de mídia e depois clique em Próximo.
- Dependendo do canal de mídia, você verá uma das seguintes opções:
- Login: faça login com sua conta da ad network e conclua o fluxo de autenticação. A AppsFlyer valida a conexão e nomeia a integração com base na conta que você conectou.
- Credenciais: forneça credenciais estáticas e preencha os campos exibidos para esse canal de mídia, por exemplo, nome de usuário e senha ou uma chave da API. Os nomes dos campos variam de acordo com o canal de mídia. As credenciais estáticas não são validadas durante a configuração.
- Renomeie a integração se quiser usar um nome diferente ou mantenha o nome padrão. O nome pode ter no máximo 50 caracteres e funciona como um rótulo para identificar a integração. Isso é importante ao criar mais de uma integração para o mesmo canal de mídia.
Etapa 2: Selecione os aplicativos
Clique em Selecionar aplicativos e escolha os aplicativos contemplados por essa integração. Você pode selecionar qualquer aplicativo ao qual tenha permissão de acesso: mobile, web, CTV ou qualquer outra plataforma usada para executar suas campanhas. Clique em Aplicar e depois em Próximo.
Se o canal de mídia exigir uma etapa adicional, continue para a Etapa 3 abaixo. Caso contrário, clique em Salvar integração.
Etapa 3: Etapas adicionais (apenas para canais de mídia específicos)
Alguns canais de mídia exigem uma etapa adicional depois que você seleciona os aplicativos. Adicione o mapeamento aos nomes de pacote e IDs de bundle ou aos IDs de site.
Mapeie aplicativos para nomes de pacote ou IDs de bundle
Há canais de mídia que identificam aplicativos pelo nome do pacote do Android ou pelo ID de bundle do iOS, por exemplo, a AppLovin.
Como parte da configuração de custo, depois que você selecionar seus aplicativos, insira o nome exato do pacote ou o ID de bundle de cada aplicativo, como aparece no sistema do canal de mídia. Todo aplicativo exige um valor de mapeamento. Clique em Salvar integração.
Mapeie aplicativos para IDs de site
Para canais de mídia que identificam aplicativos por ID de site, por exemplo, a Liftoff.
Depois que você selecionar seus aplicativos, escolha um parâmetro de ID de site padrão. Isso se aplica a todos os aplicativos da integração. Padrões disponíveis:
${APP_ID}${APP_NAME}${APP_ID}_${APP_NAME}${APP_NAME}_${APP_ID}
Para substituir o padrão em um aplicativo específico, selecione um parâmetro diferente no menu suspenso de ID de site desse aplicativo. Use isso quando o ID de site de um aplicativo estiver formatado de maneira diferente no sistema do canal de mídia. Clique em Salvar integração.
Importante!
O mapeamento de ID de site garante que as macros de ID de site do link de atribuição da AppsFlyer correspondam ao valor esperado pelo canal de mídia. Se o seu link de atribuição usar macros diferentes do mapeamento selecionado, os dados de ID de site não serão preenchidos corretamente.
Selecione de qual conta de anúncio você deseja extrair o custo
Em alguns canais de mídia, como o TikTok, um login pode ter acesso a várias contas de anúncio. Depois de fazer login no canal de mídia, você precisa selecionar a conta de anúncio específica.
Editar e excluir uma integração
Isso funciona da mesma forma para todas as integrações, independentemente do ponto de entrada, Configurações de custo ou a aba Custo, que você usou para criá-la.
Editar uma integração de custos
- Na AppsFlyer, no menu lateral, selecione Configurações > ROI360 > Configurações de custo.
- Clique no canal de mídia que você deseja editar.
- Na página do canal de mídia, clique na conta específica que você deseja editar.
- Na aba Aplicativos, clique em Editar para adicionar ou remover aplicativos e, em seguida, salve as alterações.
Os aplicativos adicionados a uma integração que usa uma etapa adicional precisam ser mapeados antes que você possa salvar as alterações. A aba Detalhes da integração mostra as configurações da conexão.
Excluir uma integração de custos
- Na AppsFlyer, no menu lateral, selecione Configurações > ROI360 > Configurações de custo.
- Clique no canal de mídia do qual você deseja excluir.
- Na página do canal de mídia, na coluna Ação, clique no ícone de exclusão da conta específica que você deseja remover.
- Na caixa de diálogo de confirmação, clique em Sim, excluir.
A coleta de dados de custo é interrompida imediatamente. Os dados históricos de custo não são afetados.
Transferir um aplicativo para outra conta
As integrações de custo são desconectadas automaticamente quando um aplicativo é transferido para outra conta.
Ver o status da Cost API
O status da integração de custos é informado em dois níveis.
- Nível do aplicativo: Cada aplicativo incluído em uma integração tem o próprio status. É nesse nível que o status atual da coleta de dados é exibido.
- Nível da conexão: Cada integração mostra um único status, derivado dos status dos aplicativos dentro dela. Quando todos os aplicativos compartilham o mesmo status, a conexão exibe isso. Quando os aplicativos têm status diferentes, a conexão exibe Misto. "Misto" não indica um problema com a conexão em si, mas que os aplicativos não possuem um único status. Abra a integração para ver quais aplicativos foram afetados.
O status está disponível nos seguintes locais:
| Local | Nível |
| Configurações de custo | Nível da conexão e nível do aplicativo |
| Dashboard do status da integração de custo (e receita de anúncios) | Nível do aplicativo, em todos os canais de mídia com integração de custos ativada na sua conta e na conta da agência com a qual você trabalha. O status "Misto" não é exibido. |
| Aba "Custo" | Nível do aplicativo, para um aplicativo e um canal de mídia por vez |
Ver status em "Configurações de custo"
- Na AppsFlyer, no menu lateral, selecione Configurações > ROI360 > Configurações de custo.
- Selecione o canal de mídia relevante. A coluna Status mostra o status no nível da conexão para cada integração.
- Para ver o status no nível do aplicativo, clique na linha da integração que abre a página Integração de custos e veja o status de cada aplicativo na lista.
Ver status na aba "Custo"
Relevante para canais de mídia compatíveis com a obtenção de dados de custo via API. Essa visualização mostra o status do aplicativo selecionado, junto com a última vez em que a AppsFlyer extraiu com sucesso os dados de custo correspondentes.
- Na AppsFlyer, no menu lateral, vá para Colaborar > Integrações ativas.
- Selecione o canal de mídia.
- Na lista de aplicativos acima da barra de abas, selecione o aplicativo com o status dos custos que você deseja consultar.
- Clique na aba Custo para ver o status e o horário da última sincronização.
Tabela de status
A tabela a seguir lista todos os status de integração de custos e o que cada um significa.
| Status | Observações/ação necessária |
| Ativo | A integração está habilitada e conectada com sucesso ao canal de mídia. A AppsFlyer está extraindo dados de custo. |
| Conta de anunciante não ativada | A conta de anúncios conectada não está ativada para a coleta de dados de custo no canal de mídia. Entre em contato com o canal de mídia para habilitar o acesso à API da conta e, em seguida, reconecte a integração. |
| Erro geral | Ocorreu uma falha inesperada durante a extração. A AppsFlyer tentará novamente na próxima extração agendada. Se o status persistir, entre em contato com o suporte da AppsFlyer. |
| Credenciais inválidas | A AppsFlyer não consegue obter dados por meio da API porque as credenciais não são válidas. Reconecte-se usando as credenciais corretas. |
| Credenciais ausentes | Você não configurou as credenciais para essa integração. Adicione as credenciais necessárias em "Configurações de custo" ou na aba "Custo do parceiro". |
| Nenhuma campanha ativa | Geralmente, a integração extrai o custo apenas das campanhas que têm conversões na AppsFlyer. Nessa extração, nenhuma campanha desse tipo foi encontrada durante o período selecionado. Nenhuma ação é necessária. A AppsFlyer informa que essa extração foi bem-sucedida. |
| Sem dados | A API do parceiro respondeu, mas não retornou dados. Isso geralmente acontece porque suas campanhas estão pausadas e não há dados para extrair. Nenhuma ação é necessária, a menos que você espere que as campanhas estejam em execução. Se estiverem, revise a integração. |
| A API do parceiro não está respondendo | O servidor do parceiro integrado não está respondendo à AppsFlyer ou a API do parceiro limitou a taxa da solicitação. A AppsFlyer tenta novamente na próxima extração agendada. Aguarde seis horas. Se o status persistir, entre em contato com o suporte da AppsFlyer. |
| A API do parceiro não está retornando dados para as informações fornecidas. Verifique a configuração | O canal de mídia não retornou dados apesar de haver campanhas ativas (campanhas com conversões na AppsFlyer), o que indica uma configuração incorreta no nível do canal de mídia. Reconecte a conta via OAuth e verifique se a conta de anúncio correta foi selecionada. |
| Aguardando sincronização | A conta ou o aplicativo ainda está sincronizando com a ad network. Aguarde a sincronização ser concluída. |
| Misto | Exibido apenas na página Configurações de custo > Canal de mídia, quando os aplicativos em uma integração têm status diferentes. Abra a página de integração para ver o status de cada aplicativo. Não exibido no dashboard de status. |
Integração de custos e agências
Se um anunciante usar uma agência para gerenciar suas campanhas, recomendados que a agência, e não o anunciante, integre-se aos parceiros relevantes. Caso contrário, se tanto o anunciante como a agência se integrarem a um parceiro usando as mesmas credenciais para o mesmo aplicativo, os dados de custo são duplicados.
Se um anunciante parar de trabalhar com uma agência, os dados de custo ainda serão extraídos se a agência ainda tiver custos configurados para o aplicativo. O anunciante deve pedir à agência para excluir a integração de custos para que esses dados deixem de ser extraídos.
Características e limitações
| Caraterística | Observações |
| Agências | As agências não podem usar as configurações de custo para realizar integrações de custos em vários aplicativos ao mesmo tempo, mas podem usar a aba Custo no Partner Marketplace para fazer isso. |
| Aplicativos futuros herdam automaticamente o recurso de configurações de custo das "Configurações de custo" no nível da conta | Atualmente indisponível. |
| Comportamento dos dados de custo quando o anunciante e a agência se conectam à mesma ad network | Se um anunciante ou uma agência se conectarem à integração de custos para a mesma conta de ad network (exemplo: Google Ads), os dados de custo são extraídos da conta que recebe a atribuição. Exemplo: o anunciante se conecta usando credenciais de anunciante, a agência se conecta usando credenciais de agência e a atribuição é vinculada à conta da agência. Resultado: o ROI360 extrai dados de custo da conexão da agência e a conexão do anunciante aparece como "Sem dados". |
| Desconexão automática da integração de custos do Google | As integrações de custo que apresentam o status "Sem dados" ou "Credenciais inválidas" por mais de 365 dias consecutivos são desconectadas automaticamente. Atualmente, isso se aplica apenas às integrações de custo do Google. |
| Configuração da lista de IDs de anunciante do TikTok | Configure a lista de IDs de anunciante no nível da conta usando apenas IDs conectados ao usuário do TikTok na ad network. Os IDs de anunciante adicionados à lista que não estiverem alinhados com o usuário na ad network não retornam dados de custo. |