Resumo: o Apple Search Ads (ASA), um parceiro SRN da AppsFlyer, ajuda os usuários a encontrar seu aplicativo na App Store usando palavras-chave.
A relevância do seu aplicativo na busca na app store determina se o seu anúncio será o anúncio mostrado. A resposta do usuário a um anúncio é um sinal de relevância do anúncio. O ASA usa a resposta do usuário como um sinal para decidir quais anúncios exibir com maior frequência.
Atenção:
- A AppsFlyer oferece suporte à atribuição mobile baseada em cliques, retargeting de usuários e dados de custo via API (com uma assinatura ROI360).
- A partir de 27 de março de 2025, a AppsFlyer também oferece suporte à atribuição mobile baseada em impressões do Apple Search Ads.
Configurar a integração do ASA
Primeiros passos
Pré-requisitos
- A versão mais recente do iOS SDK da AppsFlyer
Configurando o Apple Search Ads na AppsFlyer:
A configuração é feita na página Integrações ativas, mas para encontrar novos parceiros você deve primeiro ir ao Marketplace de parceiros. Complete a configuração utilizando as abas relevantes, conforme descrito abaixo.
Atenção:
Antes de criar uma integração, certifique-se de entrar em contato com o parceiro e abrir uma conta com ele.
Aba de integração
O Apple Search Ads, uma SRN, se integra à AppsFlyer por meio da API. Assim, não há configurações de postback. Conclua as próximas etapas de acordo com seus objetivos de atribuição.
Etapa | Detalhes |
---|---|
Ativação da integração |
Para ativar ou editar a integração:
|
Atribuição de instalação por click-through |
Defina o tempo máximo entre um clique e uma instalação. Isso permite que a AppsFlyer atribua instalações (primeiras aberturas) que ocorrem dentro da janela de lookback para o ASA. Intervalo: 1–30 dias |
Atribuição de instalação de view-through |
Defina o tempo máximo entre uma visualização e uma instalação. O slider da janela de lookback de view-through permite somente horas (máx: 24h, padrão: 24h) Intervalo: 1–24 horas Para mais informações sobre janelas de lookback, veja nossa explicação sobre janelas de lookback. |
Reinstalações |
Atribuição de reinstalação Se a atribuição de reinstalação estiver ativada, a AppsFlyer poderá atribuir reinstalações ao ASA. As configurações da janela de lookback de atribuição de reinstalação são definidas de acordo com as configurações de atribuição de instalações. Se o usuário estiver dentro da janela de reatribuição (definida no momento da instalação original), a instalação é atribuída ao ASA como uma reinstalação. A reinstalação pode ser vista na visualização de retargeting do dashboard de Visão Geral. O campo de dados brutos de reinstalação da storeé definido como verdadeiro (true). No momento, o retargeting do ASA não é compatível com reengajamentos. |
Janela de inatividade Defina o limite de inatividade do usuário (em dias) para controlar o impacto das campanhas de retargeting. |
Custo
A integração de custos fornece os seguintes dados agregados:
- Dados de custo para suas campanhas, adset, geo/países e palavras-chave. Consulte a tabela de integração de custos da ad network para obter detalhes completos sobre as dimensões, métricas e recursos compatíveis.
Atenção: os dados de custo requerem uma assinatura ROI360. - Dados de cliques, impressões e dados enriquecidos—palavras-chave, nomes de campanha e nomes de adset.
Atenção
- Você pode usar múltiplas contas do ASA. Ou seja, se você executar campanhas para o mesmo aplicativo usando diferentes contas do ASA, a AppsFlyer pode receber esses dados de todas as contas.
- Dados de custo para "grupos de campanha" não são compatíveis com a reporting API do ASA. Assim, dados de "grupo de campanha" não estão disponíveis na AppsFlyer.
- Para iniciar uma sessão com a Apple, você precisa de permissões de nível de administrador ASA (ou Conta Apenas leitura ou Conta leitura e escrita).
- Quando você entra com a Apple, quaisquer certificados de API fornecidos anteriormente param de extrair dados.
- Quando você faz o login na Apple, a autorização de grupos de campanhas ASA não é cumulativa. Isso significa que quando você integra um novo aplicativo, a autorização para grupos de campanhas escolhidos para os aplicativos anteriores será revogada, a menos que seja ativado novamente.
- Quando você faz o login na Apple, você não pode usar um login federado.
Para habilitar dados de custo, cliques, impressões e dados enriquecidos:
Veja o status da Cost API e a última vez que a AppsFlyer conseguiu extrair dados de custo no dashboard de status da integração de custo (e receita de anúncios) ou no dashboard individual da ad network.
Aba Permissões
Configurar agências e parceiros de marketing do ASA
Princípios
Apple Search Ads: Parceiro de marketing vs. agência
Anunciantes e agências podem optar por trabalhar com os parceiros de marketing do ASA para relatar e otimizar campanhas no ASA.
Veja na tabela a seguir as diferenças entre agências e parceiros de marketing.
Agência vs. parceiro de marketing
Agência | Parceiro de marketing | |
---|---|---|
A AppsFlyer envia postbacks | Não | Sim |
Tecnologia | Executa campanhas em seu nome | Tem uma solução de tecnologia de valor agregado para otimizar campanhas |
Configurando agências e parceiros de marketing
Use a lista abaixo para certificar-se de ter concluído todas as etapas no processo de configuração. Veja as instruções detalhadas por tipo de parceiro nas seções a seguir.
Checklist das etapas de configuração
Configurado por | Integração com uma agência | Integração com um parceiro de marketing |
---|---|---|
Anunciante |
|
|
Agência | Na aba da integração do ASA, configure o grupo da campanha do Apple Search Ads. |
|
Configuração de parceiro de marketing
Para configurar um parceiro de marketing:
- Se necessário, ative a integração do Apple Search Ads:
- Na AppsFlyer, vá para Configuração> Parceiros de integração ativos > Apple Search Ads.
- Habilite Ativar parceiro.
- Clique em Salvar.
-
No seu dashboard do Apple Search Ads: Obtenha o parâmetro do Campaign Group ID do Apple Search Ads relacionado ao parceiro de marketing. Use a captura de tela a seguir como um guia para localizar o ID.
-
Na AppsFlyer, configure o parceiro de marketing do ASA:
- Na AppsFlyer, no menu lateral, selecione Colaboração > Integrações Ativas.
- Pesquise o parceiro de marketing do Apple Search Ads.
A lista de parceiros é exibida. - Selecione um parceiro de marketing.
- Habilite Ativar parceiro.
- Insira a Campaign Group ID do parceiro, que você obteve na etapa anterior. Insira apenas os dígitos (números).
- Clique em Salvar.
- [Opcional] Configurar postbacks de eventos in-app:
- Ative Postback de eventos in-app.
- Clique em Adicionar evento para adicionar um evento do SDK à lista.
- Preencha os seguintes parâmetros:
- Nome do evento do SDK: O nome do evento, conforme recebido pela AppsFlyer, pelo SDK integrado ao seu aplicativo ou de eventos S2S. Dica: não está encontrando o evento desejado na lista? Certifique-se de ativar o evento em um dispositivo com uma instalação não orgânica e verifique novamente.
- Send Revenue (Enviar receita) Escolha uma das seguintes opções: Sem valores e sem receita, Com valores e sem receita, ou Com valores e com receita.
- Clique em Salvar integração.
Configuração da agência
Os anunciantes permitem que as agências executem campanhas em seu nome usando o Apple Search Ads. Tanto anunciantes como agências executam ações de configuração na AppsFlyer, conforme descrito nesta seção.
Pré-requisitos
Antes de configurar uma agência na AppsFlyer, tanto a agência quanto o anunciante devem completar as seguintes etapas na plataforma do ASA:
-
Agência:
- Crie grupos de campanhas separados na conta da agência.
- Convide o anunciante como gerente de grupo de campanha ou através da função de Vincular contar para conectar sua conta da App Store Connect.
- Anunciante: Após receber o convite para vincular contas, o anunciante deve vincular os grupos de campanha à sua conta do App Store Connect.
Consulte a documentação do ASA sobre Como vincular a conta da App Store Connect de um cliente a uma conta de agência.
Grupo de campanha do Apple Search Ads
- Campanhas de agências e campanhas de anunciantes devem compor grupos separados de campanhas do ID do Apple Search Ads.
- Não use caracteres especiais ou espaços no nome do grupo.
- Quando você faz o login na Apple, a autorização de grupos de campanhas ASA não é cumulativa. Isso significa que quando você integra um novo aplicativo, a autorização para grupos de campanhas escolhidos para os aplicativos anteriores será revogada, a menos que seja ativado novamente. Você precisará selecionar Acesso limitado e cada um dos grupos de campanha relevantes (relacionados aos aplicativos que deseja conectar para o anunciante).
Ações do anunciante
Pré-requisito:
Conceder permissão a uma agência.
Para ativar a atribuição do Apple Search Ads, o anunciante deve:
- Na AppsFlyer, no menu lateral, selecione Colaboração > Integrações Ativas.
- Selecione Apple Search Ads.
- Acesse a aba Integração e habilite a opção Ativar parceiro.
- [Opcional] Se você quiser atribuir usuários que reinstalam o aplicativo durante a janela de reatribuição, ative a Atribuição de reinstalação.
- Clique em Salvar.
Ações da agência
-
No seu dashboard do Apple Search Ads: Obtenha seu Campaign Group ID. Use a captura de tela a seguir como um guia para localizar o ID. Pegue apenas os dígitos.
- Na AppsFlyer, selecione um aplicativo.
- No menu lateral, selecione Colaborar > Integrações ativas.
- Selecione Apple Search Ads.
- Insira o parâmetro Apple Search Ads Campaign ID. Atenção! Insira somente dígitos (números)
- Clique em Salvar.
Atenção
Quando uma agência trabalha com um Parceiro de Marketing do Apple Search Ads, a agência deve configurar o mesmo nome de grupo de campanhas na página de configuração do Apple Search Ads e na página de configuração do Parceiro de Marketing.
Dados de custo, cliques e impressões
Se você ativar a Cost API, a AppsFlyer receberá dados de custo de cliques e de impressão do ASA. Consulte a tabela de integração de custos da ad network para ver os detalhes completos sobre as dimensões, métricas e recursos compatíveis. Atenção: os dados de custo requerem uma assinatura ROI360. Sem o ROI360, apenas os dados de cliques e impressões são recebidos.
Para ativar a Cost API:
- Siga essas instruções de integração. Certifique-se de que, quando solicitado a fazer login na sua conta do Apple Search Ads em Selecionar permissões, você selecione uma das seguintes opções:
- Account Read and Write
-
Account Read Only
Atenção: Se você escolher Acesso Limitado em um grupo de campanha específico, você pode encontrar alguns erros de dados.
Visualize o status da Cost API e a última vez que a AppsFlyer conseguiu extrair dados de custo no dashboard de status de integração de custo (e receita de anúncios) ou no dashboard individual da ad network.
Desativar agências e parceiros de marketing
Para interromper o registro da atribuição de instalações do Apple Search Ads geradas por agências ou parceiros de marketing:
- Na AppsFlyer, no menu lateral, selecione Colaboração > Integração Ativa.
- Selecione a agência ou parceiro de marketing conforme o caso.
- Exclua o conteúdo do campo de Apple Search Ads Campaign Group ID.
- Clique em Salvar integração.
Informações adicionais
Atribuição do ASA
O Apple Search Ads funciona independentemente da SKAdNetwork e atribui deterministicamente os usuários, mesmo que eles não tenham dado a permissão à ATT. Isso significa que, para usuários atribuídos ao ASA, você tem todas as opções de recursos e métricas fornecidos pelo nosso modelo de atribuição de LTV.
A atribuição do ASA não depende do IDFA—ela é feita usando um token do dispositivo (atribuição determinística)—e difere de acordo com o consentimento à ATT:
Consentimento à ATT | Hora do clique/impressão disponível | Janela de lookback de clique/impressão | Observações |
---|---|---|---|
Sim | Sim | Definido pelo anunciante | Regras de atribuição de último clique da AppsFlyer usadas |
Não | Não | Cliques: 30 dias (configurado pelo ASA), Impressões: 24h |
Nenhum tempo de clique ou impressão é fornecido. Prioridade é dada a candidatos determinísticos |
Discrepâncias
A AppsFlyer e o Apple Search Ads usam diferentes lógicas de atribuição, o que causa discrepâncias entre as plataformas. O Apple Search Ads, como SRN, reporta novas instalações por API.
Apple Search Ads reportando para a AppsFlyer via API
- As campanhas são agregadas por Geo.
- Os dados abaixo não são relatados: Impressões, toques ou custo de Geos com menos de 100 impressões para uma determinada campanha.
- Ao agrupar por Geo na AppsFlyer, as geolocalizações com dados indisponíveis não são mostradas e o total de dados indisponíveis aparece em N/D.
Discrepâncias relacionadas ao retargeting
O mecanismo de atribuição de retargeting da AppsFlyer permite que os anunciantes mensurem e analisem suas campanhas de retargeting, além de suas campanhas de aquisição de usuários.
As imagens abaixo ilustram como podem ocorrer discrepâncias em relação às campanhas de retargeting (independentemente da configuração de controles de retargeting) executadas no Apple Search Ads.
Retargeting ativado
Retargeting desativado
Razões adicionais para discrepâncias
A tabela a seguir mostra os principais motivos para discrepâncias.
Discrepância | Apple Search Ads | AppsFlyer |
---|---|---|
Diferenças relacionadas às versões do SDK da AppsFlyer | Conta conversões independentemente da versão do SDK da AppsFlyer. | Para AdsServices, a versão 6.1.3+ do SDK é necessária para atribuir corretamente. |
Limit ad tracking (LAT) e ATT. |
Sempre conta a conversão. Se a sua campanha for limitada por idade e sexo, os usuários de LAT serão excluídos da campanha. Usuários da Apple com menos de 18 anos sempre são LAT. |
As conversões de LAT são atribuídas como orgânicas. Se AdServices for implementado e iOS14.3+ for instalado, então os usuários que não deram o consentimento são atribuídos corretamente. |
Contagem de usuários | Conta usuários com base nos downloads | Conta usuários com base na primeira abertura do aplicativo |
Reinstalação: depois de instalar o aplicativo, um usuário o exclui, clica em um Search Ad e o instala novamente | Conta como uma conversão (instalação) |
|
Janela de lookback de clique | Janela fixa de 30 dias | Para respostas de AdServices que não têm a hora do clique, a janela de lookback de cliques é de 30 dias. |
Janela de lookback de impressão | Janela fixa de 24 horas | Para respostas de AdServices que não têm a hora da impressão, a janela de lookback de impressão é de 24 horas. |
Clique vencedor (final) | Sempre atribui a si mesmo se o usuário teve engajamento e fez o download do aplicativo. | Tem visibilidade em múltiplas networks e atribui de acordo com a metodologia do último clique |
Hora da instalação | Hora do download do aplicativo | Primeira abertura do aplicativo |
Fuso horário | Fuso horário local da loja de aplicativos | Fuso horário UTC ou conforme definido nas configurações da AppsFlyer |
Dados de conversão | Pode levar mais de 5 segundos para que a AppsFlyer seja atualizada se o Search Ads for responsável pela instalação | Atribui dentro de 5 segundos no momento em que a Conversion Data API responde. Se nenhum dado for recebido, a resposta é orgânica. |
Dados de custo | Reporta custo para todas as palavras-chave | Não reporta dados de custo para palavras-chave contendo letras maiúsculas no dashboard de cohort ou na Cohort API. |
Geolocalizações | O Apple Search Ads permite que os anunciantes segmentem usuários de acordo com seu país e região. O Apple Search Ads é compatível com um número limitado de países. |
A AppsFlyer reconhece a localização geográfica exata do usuário com base no endereço de IP e, portanto, informa sobre as geolocalizações não disponíveis no Apple Search Ads. Dica! Os usuários que instalam um app enquanto estão no próprio país da app store têm os mesmos dados geográficos na AppsFlyer e no Apple Search Ads. |
Dicas
Trabalhar com o Apple Search Ads permite que você colete dados de marketing valiosos, o que pode melhorar seus esforços de aquisição de usuários com todas as fontes de mídia para seus aplicativos iOS.
Dicas para ajudar você a maximizar os benefícios do Apple Search Ads:
Dica | Detalhes |
---|---|
Obtenha dados de palavra-chave |
O Apple Search Ads compartilha dados de palavras-chave com a AppsFlyer. Você pode ver os dados da palavra-chave nas ferramentas de dados brutos e de análise como Pivot, Retenção e Cohort. Atenção:
Nos casos em que os dados da palavra-chave estão ausentes na AppsFlyer, isso pode ser causado por:
Use apenas campanhas de pesquisa de correspondência exata ou ampla para receber dados completos de palavras-chave. |
Compare a qualidade dos usuários com base em dados de palavras-chave | Nem todas as palavras-chave são iguais, o que significa que, embora diferentes palavras-chave possam ter o mesmo custo, a qualidade dos usuários atraídos pode ser diferente. Use os relatórios de Retenção ou de Pivot para identificar as palavras-chave que maximizam seu ROI. |
Analisar custo da palavra-chave |
A plataforma contém dados agregados de custo de palavra-chave quando as campanhas de palavra-chave do ASA são configuradas como uma correspondência exata ou correspondência ampla. Os dados de custo de palavra-chave têm as seguintes características:
Limitações
ExemplosExemplo de CohortO exemplo a seguir mostra como configurar o Cohort para exibir informações de custo e ROI. Configuração do Cohort Tabela de resultados de cohort Na tabela a seguir, o custo total e o ROI do cohort são exibidos Exemplo do PivotConfiguração do Pivot Tabela de resultados do Pivot |
Encontre o conjunto de criativos com a melhor performance |
Recomendamos que você teste como os leads respondem a diferentes criativos. Os conjuntos de criativos com melhor performance têm taxas de conversão mais altas. Além disso, os melhores conjuntos de criativos convertem usuários com um nível mais alto de engajamento. Isso afeta todos os seus leads do iOS, não apenas os leads do ASA, pois todos eles chegam à página do seu aplicativo pela app store. No entanto, com as instalações pelo ASA, a AppsFlyer indica qual é o creative set ID no parâmetro Ad ID nos dados brutos, permitindo que você compare a performance de diferentes conjuntos de criativos. |
Segmentação de re-downloads |
Usuários adquiridos anteriormente costumam ser a melhor audiência para a sua segmentação no ASA. Um usuário que desinstalou seu app e, como resultado de sua campanha de retargeting no ASA, instala novamente o seu app, é chamado de Re-Downloader pelo ASA. Se a reinstalação for realizada durante a janela de reatribuição, a AppsFlyer chamará isso de Reatribuição. Em todos os outros casos, ela é tratada como uma nova instalação. |
ASA change log
Data de início | Atualização/alteração |
---|---|
07/02/2023 | Os parâmetros de atribuição enriquecidos Campaign name, Adset name e Keywords só estão disponíveis quando a aba Custo está ativada, independentemente do seu plano de assinatura. Isso significa que para que seus dashboards e relatórios de dados brutos mostrem campaign names, adset names e keywords, você deve ter a aba Custo ativada. |
16/02/2022 | As palavras-chave estão disponíveis via Cost API. Você deve ativar a API na página de integração do Apple Search Ads. Atenção! A API está disponível para todos os anunciantes, independentemente do seu plano de assinatura. |
07/04/2021 | Integração do Apple Search Ads: O Apple Search Ads funciona independentemente da SKAdNetwork e atribui os usuários de forma determinística. Isso significa que, para usuários atribuídos ao ASA, você tem todas as opções de recursos e métricas fornecidos pelo nosso modelo de atribuição de LTV. |
07/03/2021 | O Apple Search Ads está lançando a versão 4.0 da Campaign Management API. A API está relacionada ao custo e a outros dados relativos à campanha. Isso não afeta a atribuição. Estamos no processo de adotar a API atualizada. Nenhuma ação é exigida por você. |
15/02/2021 | A partir dessa data, os campos campaign name e adset name podem ser preenchidos se você habilitar a Cost API no ASA. A API está disponível para todos os anunciantes, independentemente do plano de assinatura. |
Disponibilidade dos parâmetros da campanha do Apple Search Ads
A tabela abaixo mostra a disponibilidade dos parâmetros de atribuição nos relatórios de dados brutos ou no dashboard.
Parâmetro do relatório de dados brutos | Disponibilidade |
---|---|
Campaign name | Para que esse parâmetro esteja disponível, você deve habilitar a Cost API na página de integração do Apple Search Ads. A API está disponível para todos os anunciantes, independentemente de seu plano de assinatura |
Campaign ID | Sempre disponível |
Adset name | Para que esse parâmetro esteja disponível, você deve habilitar a Cost API na página de integração do Apple Search Ads. A API está disponível para todos os anunciantes, independentemente de seu plano de assinatura |
Adset ID | Sempre disponível |
Ad | Atualmente não disponível |
Ad ID |
Esse parâmetro só está disponível quando ambas as condições a seguir são atendidas:
|
Keywords | Para que esse parâmetro esteja disponível, você deve habilitar a Cost API na página de integração do Apple Search Ads. A API está disponível para todos os anunciantes, independentemente de seu plano de assinatura |
Keyword ID | Esse parâmetro está disponível por meio de relatórios de dados brutos. No entanto, ele deve ser explicitamente selecionado em Data Locker, Push API e Export data. No caso da Pull API, adicione keyword_id ao parâmetro &additional_fields da chamada da Pull API. |
Keyword Match Type | Atualmente não disponível |
Impacto da Privacidade Avançada Agregada
A partir do iOS 14, o status de ATTrackingManager controla a disponibilidade do IDFA, e os dados de atribuição a nível do usuário de instalações trazidas pelo ASA são controlados pelo ASA. Assim, a disponibilidade de dados a nível do usuário de instalações trazidas pelo ASA não é afetada pela Privacidade Avançada Agregada.
Consentimento à ATT | Hora do clique/impressão disponível | Janela de lookback de clique/impressão | Observações | Disponibilidade de dados | IDFA disponível |
---|---|---|---|---|---|
Com consentimento | Sim | Definido pelo anunciante | Regras de atribuição de último clique da AppsFlyer usadas | Dados de atribuição a nível do usuário | Sim |
Sem consentimento | Não |
Cliques: 30 dias Impressões: 24 horas |
Prioridade é dada a candidatos determinísticos | Dados de atribuição a nível de usuário sem a hora do clique/impressão. | Não |