Configuração da integração do Apple Search Ads

Para:
Profissionais de marketing
Última atualização:

Visão geral: 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 aplicativo determina se o anúncio é aquele exibido em resposta a uma pesquisa na App Store. 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. 

A ASA oferece atribuição mobile baseada em cliques, retargeting de usuários e dados de custo via API (com uma assinatura ROI360).

Configurar a integração ASA

Comece agora

Pré-requisito

  • A versão mais recente do SDK iOS da AppsFlyer é adotada

Configure o Apple Search Ads na AppsFlyer:

A configuração é feita a partir da página Parceiros integrados, mas para encontrar novos parceiros você deve primeiro ir ao marketplace. 

 Observação

Antes de criar uma integração, certifique-se de entrar em contato com o parceiro e abrir uma conta com ele.

Para ativar a integração:

  1. Acesse o Marketplace: no menu superior de qualquer página da AppsFlyer, clique em Marketplace. 
  2. Procure o parceiro e selecione-o.
  3. Clique em Configurar integração. Você é direcionado para a página de configuração da integração.
  4. Na aba Integração, habilite Ativar parceiro.
    Observação: a alavanca deve permanecer (ativada) enquanto você trabalhar com o parceiro.
  5. Complete a configuração utilizando as abas relevantes, conforme descrito abaixo.

Guia Integração

O Apple Search Ads, um SRN, se integra à AppsFlyer por meio da API. Como tal, não há definições de postback. Conclua as seções a seguir de acordo com seus objetivos de atribuição. 

Seção  Detalhes
Ativação da integração

Ativar parceiro

Para atribuir este parceiro:

  1. Habilite Ativar parceiro.
  2. Clique em Save (Salvar).
Atribuição de instalação

Instalar janela lookback de clique

Defina o tempo máximo do clique à instalação. Isso permite que a AppsFlyer atribua instalações (primeiras inicializações) que ocorrem dentro da janela de lookback para o ASA.

Intervalo: 1—30 dias

Leitura adicional: janela de lookback de cliques
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 painel 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. 

Guia Cost (Custo)

A integração de custos fornece os seguintes dados agregados:

  • Dados de custo para suas campanhas, conjuntos de anúncios, geolocalização/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. Observação: os dados de custo exigem uma assinatura ROI360. 
  • Dados sobre cliques, impressões e dados enriquecidos—palavras-chave, nomes de campanha e nomes de conjunto de anúncios.

Observação

  • O uso de múltiplas contas do ASA é compatível. 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 API de relatórios da ASA, portanto 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.

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

Veja o status da API de custo e a última vez que a AppsFlyer conseguiu extrair dados de custo correspondentes no dashboard de status da integração de custo (e receita de anúncios) ou no dashboard individual da ad network.

Guia Permissões

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

Configurar agências e parceiros de marketing do ASA

Princípios

Apple Search Ads: parceiro de marketing versus agência

Anunciantes e agências podem optar por trabalhar com os parceiros de marketing do ASA para reportar e otimizar campanhas no ASA. 

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

Agência versus parceiro de marketing

  Agência Parceiro de marketing
A AppsFlyer envia postbacks  Não Sim
Tecnologia Executam campanhas em seu nome Tenha 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. Instruções detalhadas aparecem por tipo de parceiro nas seções a seguir. 

Lista de verificação das etapas de configuração

Configurado por Integração com uma agência Integração com um parceiro de marketing
Anunciante
  1. Na AppsFlyer, na aba da integração do ASA, habilite Ativar parceiro.
  2. Selecione a agência, na aba Permissões da Agência, e habilite Permissão da Agência.
  1. Na aba de integração do ASA, habilite Ativar parceiro.
  2. No dashboard ASA obtenha o ID de Grupo de Campanha do parceiro de marketing.
  3. Na aba de integração do parceiro de marketing:
    1. Habilite Ativar parceiro.
    2. Defina o grupo da campanha.
    3. Configure o postback de eventos in-app.
Agência

Na aba da integração ASA, configure o grupo da campanha do Apple Search Ads.

 N/D

Configuração de parceiro de marketing

Para configurar um parceiro de marketing:

  1. Se necessário, ative a integração do Apple Search Ads: 
    1. Na AppsFlyer, vá para Configuração> Parceiros de integração ativos > Apple Search Ads. 
    2. Habilite Ativar parceiro. 
    3. Clique em Save (Salvar).
  2. No seu dashboard do Apple Search Ads: obtenha o parâmetro do ID do grupo de campanhas do Apple Search Ads relacionado ao parceiro de marketing. Use a captura de tela a seguir como um guia para localizar o ID. 

    ASACGroupID.png

  3. Na AppsFlyer, configure o parceiro de marketing do ASA:
    1. Na AppsFlyer, vá para Configuração > Parceiros integrados ativos.
    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 ID da campanha do Apple Search Ads do parceiro que você obteve na etapa anterior. Insira apenas os dígitos (números). 
    6. Clique em Save (Salvar).

  4. [Opcional] Configurar postback de eventos in-app:

    1. Ative Postback de eventos in-app.

    2. Clique em Adicionar evento para adicionar um evento do SDK à lista.

    3. Complete os seguintes parâmetros:

      1. Nome do evento SDK: o nome do evento, como recebido pela AppsFlyer a partir do SDK integrado no aplicativo ou de eventos de servidor para servidor. 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. Enviar receita: selecione 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.

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. 

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.

Ações do anunciante

Pré-requisito:

Conceder permissão a uma agência. 

Para habilitar a atribuição do Apple Search Ads o anunciante deve:

  1. Na AppsFlyer, vá para Configuração > Parceiros integrados ativos.
  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 Save (Salvar).

Ações da agência

  1. No seu painel do Apple Search Ads: obter o ID do Grupo de Campanha. Use a captura de tela a seguir como um guia para localizar o ID. Copie apenas os números.

    ASACGroupID.png

  2. Na AppsFlyer, selecione um aplicativo. 
  3. Vá para Configuração > Parceiros integrados ativos. 
  4. Selecione Apple Search Ads. 
  5. Inserir o parâmetro ID da Campanha do Apple Search Ads Atenção! Insira somente dígitos (números)
  6. Clique emSalvar. 

 Nota

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.

Custo, cliques e dados de impressões

Se você ativar a API de custo, a AppsFlyer receberá dados de custo, cliques e impressão do ASA 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. Observação: os dados de custo exigem uma assinatura ROI360. Sem o ROI360, apenas os dados de cliques e impressões são recebidos. 

Para ativar a API de custo:

  • 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, selecione uma das seguintes opções:
    • Leitura e gravação da conta
    • Somente leitura da conta
      Observação: se você escolher Acesso ilimitado e um grupo específico de campanha, poderá haver erros de dados. 

Visualize o status da API de custo e a última vez que a AppsFlyer conseguiu extrair dados de custo correspondentes no painel de status de integração de custo (e receita publicitária) ou no painel da ad network individual.

 Nota

As agências devem ativar os custos em seu painel e fazer o upload dos certificados do lado deles para sincronizar os custos com a AppsFlyer.

Desative 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: 

  1. Na AppsFlyer, acesse Integrações > Parceiros integrados.
  2. Selecione a agência ou parceiro de marketing conforme o caso. 
  3. Exclua o conteúdo do campo de ID do grupo de campanha do Apple Search Ads. 
  4. Clique em Salvar integração. 

Informações adicionais

Atribuição 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 ASA não depende do IDFA—a atribuição é feita usando um token do dispositivo (atribuição determinística)—e difere de acordo com o consentimento à ATT:

Consentimento à ATT

Hora do clique disponível

Janela de lookback de clique

Observações

Sim

Sim

Definido pelo anunciante

Regras de atribuição de último clique da AppsFlyer usadas

Não

Não

30 dias
(configurado pelo ASA)

 Nenhuma hora de clique fornecida. 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, uma SRN, reporta novas instalações por API. 

Apple Search Ads reportando para a AppsFlyer por API

  • As campanhas são agregadas por geolocalização.
  • Os seguintes itens não são reportados: impressões, toques ou custo de geolocalizações com menos de 100 impressões para uma determinada campanha.
  • Ao agrupar por localização 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

ASA_R_Enabled.png

Retargeting desativado

ASA_R_Disabled.png

Razões adicionais para discrepâncias

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

Discrepância Anúncios do Apple Search AppsFlyer

Diferenças relacionadas às versões do SDK da AppsFlyer

Conta conversões independentemente da versão do SDK da AppsFlyer.

Para AdsServices, é necessário para atribuir o SDK V6.1.3+ corretamente. 

Rastreamento limitado de anúncios (LAT) e ATT:

Sempre conta a conversão.

Se 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 é implementado e iOS14.3+ é 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 inicialização 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)
  • Com IDFA: a AppsFlyer identifica a reinstalação e não a conta para fins de UA. Dica! Ative o retargeting e a reinstalação será registrada como uma instalação de retargeting (ou seja, reatribuição)
  • Sem IDFA: a AppsFlyer pode depender do IDFV para determinar se esta é uma reinstalação ou uma nova instalação:
    1. Se um ou mais aplicativos do fornecedor estiverem instalados no dispositivo, a AppsFlyer atribui o ASA com uma reatribuição.
    2. Caso contrário (se nenhum outro aplicativo existir), a AppsFlyer atribui o ASA com uma nova 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.   

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 redes e atribui de acordo com a metodologia do último clique

Hora da instalação

Hora do download do aplicativo

Primeira inicialização do aplicativo 

Fuso horário

Fuso horário local da app store

Fuso horário UTC

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 API de dados de conversão 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 API de cohort.

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 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 de usar o Apple Search Ads:

Dica Detalhes

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

Observação: a coleta de dados de palavras-chave pode ser adiada por 8 a 12 horas e, em alguns casos, pode incluir apenas o ID da palavra-chave sem o termo da palavra-chave. 

Se os dados da palavra-chave estiverem ausentes na AppsFlyer, isso pode ter sido 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. Estes são semelhantes aos termos de pesquisa reais do usuário.
    • Correspondência de pesquisa: a Apple não compartilha essas palavras-chave com anunciantes.
  • Diferenciação de maiúsculas e minúsculas: a API de marketing do Apple Search Ads retorna dados com diferenciação entre maiúsculas e minúsculas e a API de atribuição do Apple Search Ads retorna dados com letras minúsculas. Para evitar conflitos de dados em relatórios, use apenas palavras-chave com letras minúsculas.

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 custar o mesmo, a qualidade dos usuários atraídos pode ser diferente. Use os relatórios Retenção ou Tabela dinâmica para identificar as palavras-chave que maximizam seu ROI.

Analisar custo de palavra-chave

A plataforma contém dados agregados de custo de palavra-chave quando as campanhas de palavra-chave 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:

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

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 geolocalização. 

 Exemplos

Exemplo de coorte

O exemplo a seguir exibe como configurar Coorte para exibir informações de custo e ROI.

Configuração da Coorte

CohortRequest.png

Tabela de resultados de coorte

Na tabela a seguir, o custo total e o ROI da Coorte são exibidos

CohortTable.png

Exemplo de tabela dinâmica

Configuração da tabela dinâmica

Pivot_define.png

Tabela de resultados de tabela dinâmica

Pivot.png
Encontre o conjunto de criativos com melhor desempenho

creative_sets.png

É uma boa prática testar como os leads respondem a diferentes conjuntos de criativos que você usa. Os conjuntos de criativos com melhor desempenho têm as taxas de conversão mais altas. Além disso, os melhores conjuntos 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 ASA, pois todos eles chegam à página do seu aplicativo pela loja de aplicativos. No entanto, com instalações pelo ASA, a AppsFlyer indica a ID do conjunto de criativos no parâmetro dados brutos da ID do anúncio, permitindo que você compare o desempenho de diferentes conjuntos de criativos.

Direcione para re-downloaders

Seus usuários anteriores são possivelmente o melhor público para você segmentar usando ASA.

Um usuário que desinstalou seu aplicativo e, como resultado de sua campanha de redirecionamento ASA for instalada novamente, é 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, é tratado como uma nova instalação.

ASACGroupID.png

Changelog do ASA

Atualizações e alterações do ASA
Data de início Atualizar/alterar

2023-02-07

Os parâmetros de atribuição enriquecida Nome da campanha Nome do conjunto de anúncios e Palavras-chave estão disponíveis somente quando a aba Custo está habilitada, independentemente do seu plano de assinatura.
Isso significa que, para que seus painéis e relatórios de dados brutos mostrem nomes de campanhas, nomes de conjuntos de anúncios ou palavras-chave, você deve ativar a aba Custo.

16/02/2022

As palavras-chave estão disponíveis via API de custo. 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.

2021-04-07

Integração do Apple Search Ads: o ASA 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 toda as opções de recursos e mensurações fornecidas pelo nosso modelo de atribuição de LTV.

2021-03-07

O Apple Search Ads está lançando a API de gerenciamento de campanhas V4.0.A API está relacionada ao custo e a outros dados relativos à campanha. Ela não tem impacto sobre a atribuição. Estamos no processo de adotar a API atualizada. Você não precisa executar nenhuma ação.

2021-02-15

 A partir dessa data, os campos 'nome da campanha' e 'nome do adset' podem ser preenchidos quando você habilitar Cost API do 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 painel.

Parâmetro do relatório de dados brutos  Disponibilidade 
Nome da campanha Para que este parâmetro esteja disponível, você deve habilitar a API de Custo 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
ID da campanha Sempre disponível
Nome do conjunto de anúncios Para que este parâmetro esteja disponível, você deve habilitar a API de Custo 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
ID do conjunto de anúncios Sempre disponível
Anúncio Atualmente não disponível
ID do anúncio
Esse parâmetro só está disponível quando ambas as condições a seguir são atendidas:
  • Os usuários estão no iOS 15.2 e versões posteriores
  • O anúncio usa Páginas de produtos personalizadas para campanhas que estão associadas a qualquer um dos seguintes posicionamentos de anúncios:
    • Aba Hoje
    • Resultados da pesquisa 
Palavras-chave Para que este parâmetro esteja disponível, você deve habilitar a API de Custo 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
ID da palavra-chave

Este parâmetro está disponível através de relatórios de dados brutos. No entanto, ele deve ser explicitamente selecionado em Data Locker, Push API e Exportar dados. No caso da Pull API, adicione keyword_id ao parâmetro  &additional_fields da chamada da Pull API.
Tipo de correspondência das palavras-chave

Atualmente não disponível

Impacto da Privacidade Avançada Agregada

A partir do iOS 14, a ATTrackingManager (ATT) 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.

Atenção! As instalações trazidas pelo ASA não são reportadas no framework de SKAdNetwork. 

Leitura relacionada: Privacidade Avançada Agregada

Consentimento à ATT 

Hora do clique disponível

Janela de lookback de clique

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

30 dias
(configurado pelo ASA)

Prioridade é dada aos candidatos determinísticos. 

Dados de atribuição a nível do usuário sem a hora do clique. 

Não