Pré-requisito

• 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.

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. 

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 do ROI360.
• Dados de cliques, impressões e dados enriquecidos—palavras-chave, nomes de campanha e nomes de adset.

Para habilitar dados de custo, cliques, impressões e dados enriquecidos:

• Siga essas instruções de integração

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.

Definindo permissões de ad network e agência.

Apple Search Ads: Parceiro de marketing vs. agência

Anunciantes e agências podem optar por trabalhar com Parceiros de marketing do Apple Ads para gerar relatórios e otimizar campanhas no Apple Ads. 

Veja na tabela a seguir as diferenças entre agências e parceiros de marketing. 

Agência vs. parceiro de marketing

Configurando agências e parceiros de marketing 

Use a lista de verificação a seguir para garantir que você conclua todas as etapas do processo de configuração. Veja as instruções detalhadas por tipo de parceiro nas seções a seguir. 

Checklist das etapas de configuração

Para configurar um parceiro de marketing:

1. Se necessário, ative a integração do Apple Search Ads:
   1. No AppsFlyer, vá para Configuração> Parceiros de integração ativos > Apple Ads.
   2. Habilite Ativar parceiro.
   3. Clique em Salvar.

2. 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. 

   

3. No AppsFlyer, configure o parceiro de marketing do Apple Ads:
   1. Na AppsFlyer, no menu lateral, selecione Colaboração > Integrações ativas.
   2. Pesquise o parceiro de marketing do Apple Search Ads.
      A lista de parceiros de marketing é exibida.
   3. Selecione um parceiro de marketing.
   4. Habilite Ativar parceiro.
   5. Insira a Campaign Group ID do parceiro, que você obteve na etapa anterior. Insira apenas os dígitos (números).
   6. Clique em Salvar.
4. [Opcional] Configurar postbacks de eventos in-app:
   1. Ative Postback de eventos in-app.
   2. Clique em adicionar evento para adicionar um evento de SDK à lista.
   3. Preencha os seguintes parâmetros:
      1. 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.
      2. 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.
5. Clique em Salvar integração.

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 no AppsFlyer, tanto a agência quanto o anunciante devem seguir as etapas abaixo na plataforma do Apple Ads:

• Agência:
  1. Crie grupos de campanhas separados na conta da agência.
  2. 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 Apple Ads sobre Como vincular a conta do 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 login com a Apple, a autorização dos grupos de campanha do Apple Ads 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:

1. Na AppsFlyer, no menu lateral, selecione Colaboração > Integrações ativas.
2. Selecione Apple Search Ads.
3. Acesse a aba Integração e habilite a opção Ativar parceiro.
4. [Opcional] Se você quiser atribuir usuários que reinstalam o aplicativo durante a janela de reatribuição, ative a Atribuição de reinstalação.
5. Clique em Salvar.

Ações da agência

1. 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. Copie apenas os números.

   

2. Na AppsFlyer, selecione um aplicativo.
3. No menu lateral, selecione Colaborar > Integrações ativas.
4. Selecione Apple Search Ads.
5. Insira o parâmetro Apple Search Ads Campaign ID. Atenção! Insira somente dígitos (números)
6. Clique em Salvar. 

Dados de custo, cliques e impressões

Se você ativar a API de custo, o AppsFlyer recebe dados de custo, cliques e impressões do Apple Ads por meio da API. 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. 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. 

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.

Para interromper o registro da atribuição de instalações do Apple Search Ads geradas por agências ou parceiros de marketing: 

1. Na AppsFlyer, no menu lateral, selecione Colaboração > Integrações ativas.
2. Selecione a agência ou parceiro de marketing conforme o caso.
3. Exclua o conteúdo do campo Apple Search Ads Campaign Group ID.
4. Selecione Apple Search Ads. Etapa 1:

O Apple Ads funciona de forma independente da SKAdNetwork e atribui os usuários de forma determinística, independentemente do consentimento do ATT (App Tracking Transparency). Isso significa que, para usuários atribuídos ao Apple Ads, você tem toda a gama de recursos e mensurações fornecida pelo nosso modelo de atribuição de LTV.

A atribuição do Apple Ads não depende do IDFA; ela é feita usando um token do dispositivo (atribuição determinística).

Depois de 1 de setembro de 2026

O horário do clique e da impressão está disponível independentemente do status do ATT. A janela de lookback é definida pelo anunciante, e a AppsFlyer aplica as regras de atribuição de último toque ao engajamento.

Antes de 1 de setembro de 2026

A disponibilidade do horário do clique e da impressão, bem como a janela de lookback, varia de acordo com o consentimento do ATT:

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 figuras a seguir mostram como podem ocorrer discrepâncias em relação às campanhas de retargeting (independentemente da configuração dos controles de retargeting) em execução no Apple Ads.

Retargeting ativado

Retargeting desativado

Razões adicionais para discrepâncias

A tabela a seguir mostra os principais motivos para discrepâncias.

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:

Observação	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: A coleta de dados de palavras-chave pode ter um atraso de 8 a 12 horas e, em alguns casos, pode incluir apenas o ID da palavra-chave, sem o termo correspondente da palavra-chave. Para obter os dados de palavras-chave, a opção de "custo" deve estar ativada. Os dados de palavras-chave são fornecidos como parte da integração de custos, sem que seja necessário uma assinatura do ROI360. Nos casos em que os dados da palavra-chave estão ausentes na AppsFlyer, isso pode ser causado por: Tipo de pacote: os dados de palavra-chave são compartilhados pelo Apple Search Ads com anunciantes que têm o pacote avançado do Apple Search Ads. Tipo de campanha: você pode configurar diferentes tipos de correspondência de palavras-chave de campanha no Apple Search Ads. Com base no tipo de correspondência, o Apple Search Ads compartilha as palavras-chave da seguinte forma: Correspondência exata: As palavras-chave exatas pesquisadas pelo usuário Correspondência ampla: As palavras-chave que a Apple usou para realizar a pesquisa. Elas são parecidas com os termos de pesquisa reais do usuário. Correspondência de pesquisa: a Apple não compartilha essas palavras-chave com anunciantes. 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 Apple Ads são configuradas como correspondência exata ou correspondência ampla. Os dados de custo de palavra-chave têm as seguintes características: O histórico de dados está disponível a partir de 13 de outubro de 2019. Dimensões: Data Campanha Conjunto de anúncios Ferramentas de análise: Coorte Pivot Master API  Limitações Use apenas as dimensões observadas para filtrar e agrupar consultas de dados de custo. Por exemplo, não filtre ou agrupe usando Geo.  Exemplos Exemplo de Cohort O 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 Pivot Configuraçã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 de iOS, não apenas os leads do Apple Ads, pois todos eles chegam à página do seu aplicativo na App Store. No entanto, com as instalações do Apple Ads, a AppsFlyer indica o ID do conjunto de criativos no parâmetro raw data Ad ID, permitindo que você compare a performance de diferentes conjuntos de criativos.
Segmentação de re-downloads	Seus usuários anteriores possivelmente são a melhor audiência para você segmentar usando o Apple Ads. Um usuário que desinstalou seu aplicativo e, como resultado da sua campanha de retargeting do Apple Ads, instala novamente é chamado de Re-Downloader pelo Apple Ads. 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.

A tabela abaixo mostra a disponibilidade dos parâmetros de atribuição nos relatórios de dados brutos ou no dashboard.

A partir do iOS 14, o ATTrackingManager (ATT) determina a disponibilidade do IDFA, e o Apple Ads controla os dados de atribuição em nível de usuário das instalações trazidas pelo Apple Ads. Assim, a disponibilidade de dados em nível de usuário das instalações geradas pelo Apple Ads não é afetada pela Privacidade Avançada Agregada.

Após 1 de setembro de 2026

Antes de 1 de setembro de 2026

A disponibilidade do horário de clique/impressão, a janela de lookback e a disponibilidade dos dados variavam de acordo com o consentimento do ATT: