Configure a ROI360 cost API para mensurar dados de custo

Resumo: Obtenha dados agregados de custo de marketing (incluindo métricas de performance de LTV relacionadas com custo) usando a Cost API a nível de conta no aplicativo ou canal de mídia.

Resumo

O ROI360 fornece mensuração de custo tanto a nível de aplicativo quanto de conta, permitindo que stakeholders analisem a granularidade dos gastos por aplicativo individual ou em toda a conta do canal de mídia.

As integrações de custo são gerenciadas em dois locais diferentes, dependendo do canal de mídia:

  • Integrações em nível de conta são gerenciadas nas configurações de custo. Essas integrações são configuradas no nível da conta de anúncios. Consulte a lista de ad networks disponíveis.
  • Integrações em nível de aplicativo são gerenciadas na aba de custo. Essas integrações são configuradas separadamente para cada aplicativo. Se um canal de mídia não estiver disponível nas configurações de custo, configure sua integração na aba custo no nível do aplicativo.

Atenção

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 para atualizar suas permissões na página de gestão de usuários. No caso, você precisa de permissão para gerenciar conexões de custo.

Ativar a Cost API

Você pode ativar a integração de custos de duas formas: a partir do aplicativo ou da conta.

Ativar integração de custo a partir do aplicativo (aba de custo)

Para configurar uma conexão de custo para um aplicativo individual, siga essas etapas:

  1. Na AppsFlyer, no menu lateral, selecione Colaborar > Integrações ativas e selecione o parceiro.
  2. Clique em gerenciar integração.
  3. Abra a aba de custo do parceiro integrado
  4. Ative obter dados de custo. Os requisitos para conectar-se ao parceiro são exibidos.
  5. Configure e autentique a integração com o parceiro. O método de autenticação depende do canal de mídia. Veja os métodos de integração de custo abaixo.
  6. Se a configuração de custo do parceiro incluir o mapeamento de site ID, selecione a configuração desejada no menu suspenso. Veja mapeamento de site ID abaixo.
  7. Clique em salvar custo.
    • Os dados de custo começarão a aparecer nos dashboards dentro de 5 a 6 horas.
    • A AppsFlyer coleta dados do parceiro 6 vezes por dia, em média de uma vez a cada quatro horas. 
    • O conta do canal de mídia na seção configurações de custo é atualizada de acordo com a alteração feita no nível do aplicativo na aba de custo.

Ativar integração de custo a partir da conta (configurações de custo)

Você precisa conectar cada conta de canal de mídia pelo menos uma vez para ativar o custo para vários ou para todos os aplicativos na sua conta da AppsFlyer.

Para ativar a integração de custo no nível da conta, siga essas etapas:

  1. Na AppsFlyer, no menu lateral, abra Configurações > ROI360 > Configurações de custo.
  2. Selecione o canal de mídia que deve obter dados de custo e, em seguida, clique em próximo.
  3. Configure e autentique a integração de custos com o canal de mídia. O método de autenticação depende do canal de mídia. Veja os métodos de integração de custo abaixo.
  4. Insira (ou personalize) o nome da integração de custo.
  5. Selecione os aplicativos a serem incluídos na integração de custo.
  6. Clique em salvar integração.
    • Os dados de custo começarão a aparecer nos dashboards dentro de 5 a 6 horas.
    • A AppsFlyer coleta dados do parceiro 6 vezes por dia, em média de uma vez a cada quatro horas.
    • As atualizações feitas no nível da conta nas configurações de custo são aplicadas automaticamente na aba de custo nas integrações ativas para aplicativos e canais de mídia relevantes.

Atenção

Se um anunciante usar uma agência para gerenciar as suas campanhas, a agência, e não o anunciante, deve se integrar com os 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 app, os dados de custo são duplicados.

Métodos de integração de custos

O método para ativar a integração de custo depende do modo de integração do canal de mídia com a AppsFlyer:

  • Login: clique em login em <canal de mídia> para abrir a janela de login do canal de mídia. Em seguida, siga os passos de login do canal de mídia.
  • Credenciais: insira valores de parâmetros específicos do canal de mídia. Por exemplo, chave da API.
  • Nenhum: nenhuma configuração de conexão é necessária além de ativar a opção de obter dados de custo conforme instruído acima.

Para saber qual método um canal de mídia específico usa, você pode acessar a coluna método de integração na tabela de integração de custos do canal de mídia.

Mapeamento de site ID

Algumas integrações de canais de mídia permitem que você selecione a maneira como o campo site ID será preenchido ao relatar dados de custo. Isso garante que os macros do link de atribuição da AppsFlyer site-id correspondam ao valor que o canal de mídia espera.

  • Por padrão, o mapeamento de site ID está alinhado com as macros da AppsFlyer no link de atribuição.
  • Se o seu link de atribuição tiver macros diferentes das opções de mapeamento de site ID, os dados do site ID não serão preenchidos corretamente.

Para definir o mapeamento de site IDs no nível do aplicativo, siga essas etapas:

  1. Na aba custo do parceiro integrado, acesse mapeamento de site ID e selecione uma configuração no menu suspenso.
  2. Clique em salvar custo. A alteração tem efeito no dia seguinte, em UTC.

Excluir integrações de custo

Você pode excluir integrações de custo tanto no nível do aplicativo quanto no nível da conta. Uma vez excluídos, a AppsFlyer não poderá mais extrair dados de custo da conta. A eliminação de uma integração não afeta o histórico de dados.

Exclua a integração de custo no nível do aplicativo (aba custo)

Você pode excluir a integração a qualquer momento. Uma vez excluída, o AppsFlyer não poderá mais recuperar dados de custo da conta associada. Esta ação não afetará nenhum histórico de dados de custo já coletados.

Para excluir a integração de custo no nível do aplicativo, siga essas etapas:

  1. Na AppsFlyer, no menu lateral, vá para Colaborar > Integrações ativas.
  2. Selecione o parceiro integrado, por exemplo, Meta ads.
  3. Clique em gerenciar integração.
  4. Abra a aba custo. A lista de contas conectadas é exibida.
  5. Na coluna ações, passe o mouse sobre uma conta e clique em remover conexão.
  6. Em resposta à mensagem de confirmação, clique em Sim, excluir.

A integração de custo configurada no nível do aplicativo é removida também no nível da conta. Como resultado, a coleta de dados de custo será interrompida imediatamente. Essa mudança não afeta nenhum histórico de dados de custo já coletados.

Excluir integração de custo no nível da conta (configurações de custo)

Para excluir a integração de custo no nível da conta, siga essas etapas:

  1. Na AppsFlyer, no menu lateral, selecione ConfiguraçõesROI360 > Configurações de custo e selecione o canal de mídia do qual você deseja excluir a integração.
  2. Na lista de integrações por canal de mídia, clique em delete.jpeg na integração.
  3. Em resposta à mensagem de confirmação, clique em Sim, excluir.

A integração de custo configurada no nível da conta é removida também no nível do aplicativo. Como resultado, a coleta de dados de custo será interrompida imediatamente. Essa mudança não afeta nenhum histórico de dados de custo já coletados.

Desativação da Cost API

A desativação da Cost API está disponível apenas no nível do aplicativo.

Para desativar a Cost API, siga essas etapas:

  1. Vá para integrações ativas e selecione o canal de mídia.
  2. Acesse a aba Custo.
  3. Desative Obter dados de custo.
  4. Clique em salvar custo.

Atenção

Se um anunciante parar de trabalhar com uma agência e desativar as permissões dessa agência ao nível do aplicativo, os dados de custos continuam a ser extraídos caso a agência tenha custos configurados para o aplicativo. O anunciante deve pedir à agência para desativar sua integração de custo para parar a coleta desses dados.

Status da Cost API

O status operacional das integrações de custos está disponível da seguinte forma:

Ver o status da integração de custo do canal de mídia (aba de custo)

A aba de custo na página de integrações ativas do canal de mídia (relevante para canais de mídia compatíveis com a extração de dados de custo via API) exibe:

  • O status da integração de custo do aplicativo selecionado.
  • A última vez que a AppsFlyer conseguiu extrair os dados de custos correspondentes para o app.

Para ver o status da integração de custo do canal de mídia individual para um aplicativo selecionado, siga essas etapas:

  1. Na AppsFlyer, no menu lateral, vá para Colaborar > Integrações ativas.
  2. Selecione o canal de mídia.
  3. Na página de Integração ativa no canal de mídia, na lista de aplicativos acima da barra de abas, selecione o aplicativo cujo status de custo você deseja visualizar.
  4. Clique na aba custo. O status e o horário da última sincronização são exibidos.

Ver o status da integração de custos agregados do canal de mídia (configurações de custo)

Para ver o status da integração de custos agregados do canal de mídia, siga essas etapas:

  1. Na AppsFlyer, no menu lateral, selecione Configurações > ROI360 > Configurações de custo.
  2. Selecione o canal de mídia relevante.
  3. Na página do canal de mídia, você pode ver o status da conta do canal de mídia na coluna de status. Se todos os aplicativos associados à conta tiverem o mesmo status, esse status é exibido. Se os status dos aplicativos forem diferentes, o status é exibido como status misto.
  4. Para ver o status de um aplicativo específico associado a uma conta de canal de mídia, clique na linha do canal de mídia para exibir a página integração de custo.
  5. Veja o status do aplicativo na lista dos aplicativos associados ao canal de mídia.

Tabela de status

Status Observações/ação necessária
Ativo A integração está habilitada e conectada com sucesso ao canal de mídia.
A API do parceiro não retorna dados de custos correspondentes. Isso pode acontecer porque:
• O ID da campanha não foi fornecido, portanto não é possível fazer a correspondência do custo com as campanhas.

• Você integrou uma conta de parceiro diferente ao fazer login por meio da AppsFlyer (por exemplo, uma conta diferente do Meta ads). Verifique se você conectou a conta certa.

• Um dos campos de credenciais na integração de custos do parceiro está incorreto. Por exemplo, o bundle ID. Revise e corrija as credenciais da integração.

• Suas campanhas estão pausadas e não há dados.
A API do parceiro não está respondendo • O servidor do parceiro integrado não está respondendo à AppsFlyer.
• Espere 6 horas. Se o status da mensagem 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 utilizando as credenciais corretas.
Fale com o gerente da conta da sua ad network para ter acesso à API de relatórios. Trabalhe com o gerente da conta do parceiro para ativar a integração de custos no sistema do parceiro.
A API do parceiro não está retornando nenhum dado. Revise a integração. Isso pode acontecer pelo seguinte motivo:
• Suas campanhas estão pausadas e não há dados.
Sua conta não está habilitada para receber custos no sistema do parceiro Entre em contato com o parceiro.
Status misto O status é exibido em Configurações de custo > canal de mídia apenas se os aplicativos associados tiverem status diferentes. Na página do canal de mídia, abra a página de integração para ver o status do aplicativo individual. Esse status não é exibido no dashboard de status

Canais de mídia disponíveis para configuração de custo no nível de conta

Os clientes do ROI360 podem criar e editar integrações de custo no nível de conta em configurações de custo e na aba custo. Canais de mídia compatíveis com a configuração de custo no nível de conta:

Canais de mídia compatíveis

Nome de exibição ID da integração
AdAction3 adaction5_int
Adbloom adbloom_int
AdColony adcolony_int
AdGate Media adgatemedia_int
adjoe GmbH adjoe_int
Adikteev Retargeting trademob_int
Apple Search Ads iossearchads_int
AppLift applift_int
Blind Ferret Agency blindferret_int
Bluestacks bluestacks_int
ByteDance bytedance_int
Dataseat dataseat_int
Digital Turbine Legacy appia_int
Digital Turbine On Device digitalturbine_int
Domob domobc_int
DV360 dv360_int
GlobalWide Media globalwide_int
Google Ads googleadwords_int
InMobi inmobi_int
InMobi DSP inmobidsp_int
Liftoff Influence jetfuelit_int
Mediaforce mediaforce_int
Meta Ads facebook
Mintegral mintegral_int
Mobupps mobupps_int
Moloco moloco_int
MoPub Acquire crossinstall_int
Opera Mobile operaevent_int
Persona.ly RTB personalyrtb_int
Pinterest pinterest_int
Pinsight pinsight_int
Point2Web point2web_int
Reddit reddit_int
Smadex smadex_int
Snapchat snapchat_int
Tapjoy tapjoy_int
Taptica taptica_int
TUNE hasoffers_int
Unity Ads unityads_int
X (Twitter) twitter

Atenção

Outros canais de mídia estão disponíveis através das ad networks InCost. Para obter a lista completa, entre em contato com seu CSM.

Características e limitações

Características Observações
Agências Agências não podem usar configurações de custo para ativar integrações de custo para vários aplicativos ao mesmo tempo.
Aplicativos futuros herdam automaticamente o recurso de configurações de custo das configurações em nível de 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 custo 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.

Cenário
  • O anunciante se conecta à integração de custo usando credenciais de anunciante
  • A agência se conecta à integração de custo usando credenciais de agência
  • Processo atribuído à conta da agência

Resultado

  • O ROI360 extrai dados de custo da conexão da agência.
  • A conexão do anunciante aparece como SEM DADOS.