Configuração de integração do X Ads (antigo Twitter Ads)

Resumo: integre sua conta do X Ads com a AppsFlyer para exibir dados de atribuição de campanhas do X Ads.

Visão geral

O X Ads é uma rede de autorrelato (SRN) avançada que permite que a AppsFlyer atribua eventos de conversão para todos os usuários, mesmo aqueles sem um advertising ID.

Fluxo de atribuição do X Ads na AppsFlyer

O fluxo de atribuição da AppsFlyer para o X Ads é o seguinte:

  1. A AppsFlyer recebe todos os dados de engajamento do X Ads via integração servidor a servidor (S2S) e atribui os engajamentos da seguinte forma:
    • Se tanto o evento de instalação quanto o de engajamento incluírem um mobile advertiser ID (MAID), a AppsFlyer faz o ID matching determinístico.
    • Se o evento de instalação ou o engajamento estiverem sem um MAID, a AppsFlyer aplica a modelagem probabilística (PMOD) para atribuição.
  2. A AppsFlyer envia todos os postbacks de instalação para o X Ads através da integração, mesmo quando instalação não é atribuída ao X Ads.
  3. Quando o usuário rejeita o consentimento da App Tracking Transparency (ATT) e a Privacidade Avançada (AP) está ativa, certos campos dentro dos postbacks enviados ao X Ads se tornam restritos. Esses são os campos restritos:

    • X Ads engagement ID
    • Hashed device ID
    • IP address
    • User Agent

    _- seleção visual.png

Conectando sua conta do X Ads à AppsFlyer 

Atenção

Antes de começar, certifique-se de que você adicionou um método de pagamento à sua conta do X Ads. Caso contrário, você não poderá ativar a integração do parceiro na AppsFlyer.

  1. Faça login na sua conta do X Ads em X Ads.
    Se você não for automaticamente levado para a página de anúncios, clique no botão Ads no canto superior esquerdo.
  2. Quando solicitado a selecionar uma campanha Simple (NEW) ou Advanced, selecione Advanced.  
  3. Em Campaign objective, selecione App Installs ou App re-engagements, depois clique em Next.

    X-Ads-campaign-objective.png

     

  4. Escolha seu app e então clique no link mobile measurement partner .
  5. Na página Conversion tracking , clique em Go to AppsFlyer

    X-Ads-mmp-selection.png

  6. Uma notificação é exibida informando que você está prestes a deixar o Twitter Ads para acessar o site da AppsFlyer. Clique em Go to AppsFlyer e faça login no seu dashboard.
  7. Na AppsFlyer, no menu lateral, selecione Colaboração > Integrações ativas.
  8. Procure por X Ads e selecione-o.
  9. Em Integração , aceite os Termos e condições do X Ads para Mobile App Conversion Recording (MACT) e clique em Salvar integração. 
  10. Habilite Ativar parceiro e clique em Fazer login com o X Ads.
  11. Autorize a AppsFlyer a usar sua conta do X Ads clicando em Autorizar aplicativo
  12. Habilite novamente a opção Ativar parceiro para exibir as configurações da aba Integração e ativar a atribuição.
    Atenção: o toggle deve permanecer ativo enquanto você trabalhar com o parceiro. Saiba mais sobre a ativação de parceiros.
  13. Selecione suas contas do X Ads para ativá-las e, em seguida, clique em Salvar e fechar.

Configuração de atribuição do X Ads

Para acessar uma descrição detalhada do header da página de configuração do parceiro, clique aqui.

Aba de integração

A aba de integração se divide em diferentes seções, conforme descrito abaixo. O parceiro deve ser ativado na primeira visita para permitir sua configuração.

Conta de anúncios conectada

Selecione as contas para ativar a atribuição.

X-Ads_msc_new_4.png

 

Atenção: Você pode conectar até 200 contas de anúncios na AppsFlyer. Para evitar atingir esse limite e garantir a atribuição contínua para todas as contas ativas, recomendamos remover quaisquer contas de anúncios que não estejam mais em uso.

Privacidade avançada

Somente para aplicativos iOS: O toggle de Privacidade Avançada (AP) permite que você controle a quantidade de dados do usuário compartilhados com o X Ads nos postbacks. Essa configuração está em compliance com os requisitos de privacidade do iOS 14.5+.
Quando o toggle AP está ativado: 

Atenção

  • O toggle de Privacidade Avançada fica ativado por padrão assim que você ativa a integração do X Ads.
  • De acordo com o X Ads, manter a Privacidade Avançada ativa pode resultar em menos eventos de campanha em seus relatórios, limitando a otimização de performance no X Ads.

Atribuição de click-through

Use a barra deslizante para definir o tempo máximo entre o clique e a instalação. Somente as instalações (primeiras aberturas) que acontecerem dentro da janela de lookback podem ser atribuídas ao X Ads.

Você pode personalizar esse valor para 1 a 23 horas ou 1 a 30 dias. Recomendamos definir a janela de lookback de click-through para 14 dias, para alinhar com o X Ads.

X-Ads_msc_new_6.png

Janela de lookback de atribuição de view-through

Essa barra deslizante permite definir o tempo máximo desde a impressão até a instalação. Somente instalações (primeiras aberturas) que acontecem durante essa janela de lookback, após uma impressão de anúncio, são atribuídas ao X Ads, desde que não haja nenhum outro clique em anúncio relevante.

Você pode personalizar esse valor para 1 a 23 horas ou 1 a 7 dias. Recomendamos definir a janela de visualização de lookback para 1 dia para corresponder à janela do X Ads.

X-Ads_msc_new_7.png

Configurações de reinstalação

Para habilitar a atribuição de reinstalação, ative Atribuição de reinstalação.

Não é necessário configurar janelas de lookback para atribuição de reinstalação, pois os valores são retirados das configurações de atribuição de instalação.

Configurações de reengajamento

Para campanhas de retargeting no X Ads, a AppsFlyer oferece suporte somente para a mensuração de reengajamento. Nesse caso, isso representa o engajamento de um usuário que já tem o app instalado com uma campanha de retargeting. 

Importante!

Certifique-se de que o retargeting esteja habilitado para o aplicativo na página de configurações do aplicativo. Para mais informações, clique aqui.

A atribuição de retargeting do X Ads inclui somente conversões de reengajamento.

Ative o botão de atribuição de reengajamento para começar a atribuir reengajamentos para o X Ads.

Janela de lookback de reengajamento por click-through

Defina a duração da Janela de lookback de reengajamento por clique (o período máximo após o clique em um anúncio, durante o qual um usuário redirecionado pode ser atribuído ao anúncio). Você pode definir o valor em horas (até 23) ou dias (1 a 30).

X-Ads-reengagement-activate.png

Janela de lookback de reengajamento por view-through

Para começar a atribuir impressões de anúncios de retargeting, ative a Atribuição de reengajamento por exibição.

Em seguida, defina a duração da Janela de lookback de reengajamento por exibição (o período máximo depois de um anúncio ser visualizado, durante o qual um usuário redirecionado pode ser atribuído ao anúncio). Você pode definir o valor em horas (até 23) ou dias (1-7):

X-Ads-reengagement-view-through.png

Janela de reengajamento

Defina a duração da Janela de reengajamento (o período em que os eventos in-app do usuário são atribuídos à fonte de mídia de retargeting). Você pode definir os valores em dias (1 a 90), horas (até 23) ou até mesmo vitalícios:

X-Ads-reengagement-window.png

Ignorar usuários ativos para retargeting

Defina um período de inatividade para evitar o registro de conversões de retargeting para usuários ativos dentro do período especificado. Veja mais sobre o período de inatividade de retargeting.

Configurações de postbacks de eventos in-app

Nessa seção você pode mapear os eventos da AppsFlyer com o parceiro por meio de postbacks.

altIn-app_event_postbacks_en-us.pngalt

Para configurar postbacks de eventos in-app: 

  1. Defina o Partner ID (se necessário).
  2. Ative o postback de eventos in-app.
  3. Clique em Adicionar evento para adicionar um SDK ou evento S2S à lista.
  4. Preencha os parâmetros necessários de acordo com a tabela abaixo.
     
    Parâmetro Descrição
    Evento AppsFlyer O nome do evento, conforme recebido do SDK integrado no aplicativo ou de eventos de servidor para servidor.
    Dica: não encontrou o evento que está procurando?
    • Certifique-se de ativar o evento em um dispositivo com uma instalação não orgânica e verifique novamente.
    • Digite-o em Evento da AppsFlyer, depois clique em Criar personalizado. Leia mais sobre o mapeamento de eventos personalizados.
    Mapeado para evento do parceiro O nome exclusivo ou ID de cada evento, conforme definido pelo parceiro. Selecione o evento AppsFlyer predefinido mais adequado.
    para usuários de Selecione a opção de envio para o evento:

    Atenção

    Para que o X Ads receba postbacks atribuídos à agência, você deve selecionar Todas as fontes de mídia, incluindo orgânicas. Caso contrário, o X Ads não receberá tais postbacks. 

    • Somente este parceiro: enviar postbacks somente quando este evento for atribuído a este parceiro.
    • Todas as fontes de mídia, incluindo orgânicas: envie postbacks para eventos atribuídos a qualquer parceiro e eventos orgânicos.
    incluindo
    • Nenhum dado (padrão): enviar somente o evento em si sem o valor do evento.
    • Valores e receita: enviar todos os parâmetros do evento, incluindo o valor da receita (se existir no evento).
    • Valores sem receita: envie todos os parâmetros excluindo o valor da receita.
  5. [Opcional] Clique em conditional-iae-postbacks-icon.png para definir condições para enviar determinados eventos na aplicação ao parceiro.
    Saiba mais sobre postbacks de eventos in-app condicionais

Aba do link de atribuição

O X Ads não utiliza links de atribuição para atribuição.

 Atenção

Para todas as redes de autorrelato (SRNs), como Meta ads, Apple Search Ads, Google Ads, X Ads, etc., essa aba não é funcional, pois elas não utilizam links externos de atribuição.

Aba custo

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

  • Dados de custo para suas campanhas, conjuntos de anúncios, anúncios, canal e geo/países. 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 sobre cliques, impressões e dados enriquecidos (palavras-chave, nomes de campanha e nomes de conjunto de anúncios).

Para ativar a Cost API:

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 receita de anúncios

A receita de anúncios não está disponível para a X Ads.

Aba permissões

Nessa aba, você pode selecionar as permissões a serem concedidas ao X Ads, independentemente do parceiro atuar como uma ad network, agência ou até mesmo ambos. Observe que mesmo que a atribuição esteja desativada para o parceiro, a aba de permissões está ativa e você pode conceder controle ao X Ads.

Use essas chaves seletoras para conceder permissões à rede de anúncios para gerenciar sua própria configuração do aplicativo:

Permissões da ad network

  • Permitir a configuração da integração – permite que o parceiro configure a aba de integração (exceto postbacks de evento in-app)
  • Permitir a configuração de postbacks de evento in-app – permite que o parceiro configure o mapeamento de postbacks de evento in-app para si mesmo na guia de integração
  • Permitir o acesso ao relatório de retenção – somente aos próprios dados de retenção do parceiro 
  • Permitir acesso aos dados agregados de usuário fiéis — apenas aos dados de usuários fieis do parceiro
  • Permitir acesso aos dados agregados de eventos in-app — apenas aos dados de eventos in-app próprios do parceiro
  • Permitir acesso aos dados agregados de receita — apenas aos dados da receita atribuídos ao parceiro
  • Permitir o acesso ao painel Protect360 – somente aos próprios dados do Protect360 do parceiro e desde que o recurso esteja ativado para o anunciante 

Saiba mais sobre como conceder permissões de ad network.

Permissões da agência

Saiba mais sobre como conceder permissões de agência.  

Recursos do X Ads

Mobile app promotion no X Ads

O Mobile App Promotion do X Ads é um método utilizado para promover aplicativos no X Ads. Isso permite que os anunciantes promovam seus aplicativos usando um design exclusivo para o card de um aplicativo, impulsionando instalações, engajamento e deep linking. Os usuários podem facilmente instalar e colaborar com aplicativos diretamente a partir da linha do tempo do X Ads. 

Web-to-App: mensurando a atividade no app para campanhas fora do app (apenas Android)

A integração da AppsFlyer com o X Ads permite a mensuração da atividade do aplicativo — incluindo instalações, reengajamentos e eventos in-app — para outras campanhas fora do mobile no Android.

Por exemplo, mesmo que o destino do anúncio seja uma web landing page, as instalações do aplicativo e outras atividades pós-instalação ainda podem ser mensuradas, permitindo a mensuração da jornada do usuário web-to-app (W2A).

Para mensurar a atividade do aplicativo a partir de outras campanhas no X e obter insights valiosos sobre o comportamento do usuário, siga essas etapas no X Ads Manager:

  1. Vá para o formulário de criação de campanha no X Ads Manager.
  2. Em Delivery, ative a mensuração de App Conversions para ativar o rastreamento de instalações e conversões no aplicativo resultantes da campanha. Veja mais detalhes na documentação do X Ads (em "Measuring app conversions on non-app objectives").

Importante!

No momento, essa funcionalidade está disponível apenas para Android.

Interoperação da SKAN no X Ads e na AppsFlyer

O X Ads envia dados de postback da SKAdNetwork por meio de uma API dedicada. Os dados de SKAN do X Ads são exibidos no dashboard da SKAN.

O X Ads enriquece os postbacks da SKAN com os seguintes campos de dados:

  • Campaign name
  • Campaign ID
  • Adset name
  • Adset ID

Privacidade do usuário no X Ads

Os anunciantes e usuários do X Ads podem controlar como eles compartilham informações com anunciantes e parceiros de negócios:

  • A partir de 31 de julho de 2021, os anunciantes que não estão inscritos no programa de Advanced Mobile Measurement (AMM) do X Ads não receberão mais dados a nível de usuário do X Ads MACT. Como resultado, todos os dados do X Ads serão restritos nas ferramentas de dados brutos da AppsFlyer. Saiba mais sobre as restrições de dados do X Ads.
  • Se o anunciante estiver no programa AMM e o usuário tiver reconhecido o aviso de privacidade, nenhuma restrição de dados brutos se aplicará.
  • Independentemente do status do AMM, se o usuário estiver na União Europeia e concordou em compartilhar dados com parceiros comerciais, nenhuma restrição de dados brutos se aplicará.
  • Se o usuário estiver na União Europeia e não concordou em compartilhar dados com parceiros comerciais, asrestrições de dados brutos serão aplicadas.
  • Os dados de atribuição agregados são corretamente refletidos na AppsFlyer e não são afetados pela política do X Ads.

Através do programa AMM, os anunciantes podem receber dados de usuário mais completos, concedendo o direito de realizar uma auditoria ao X Ads. Essa auditoria garante que os dados do X Ads sejam usados exclusivamente para fins de mensuração, de acordo com os padrões da indústria e as leis de proteção de dados.

Saiba mais sobre o programa AMM na seção de FAQ. Para mais detalhes, entre em contato com seu Account Manager do X Ads.

Nomes de parâmetros de Advanced SRN

Os seguintes campos na integração de Advanced SRN do X Ads substituem os campos legados no dashboard, relatórios agregados e dados brutos em nível de evento na AppsFlyer.

AppsFlyer
Coluna de dados
SRN Legada Advanced SRN
PID Twitter Twitter
Campaign Name Campaign Name Campaign name
Campaign ID Campaign ID
(base36: diferente do dashboard do X, por exemplo 21I3V9)
Campaign ID
(base10: igual ao dashboard do X, por exemplo 123456789)
Adset Name Line Item ID
(base36: diferente do dashboard do X, por exemplo 21I3V9)
Line Item Name
Adset ID Line Item ID
(base36: diferente do dashboard do X, por exemplo 21I3V9)
Line Item ID
(base10: igual ao dashboard do X, por exemplo 123456789)
Ad Name Tweet ID Ad Name
(se disponível)
Ad ID Tweet ID Tweet ID
Match Type srn id_matching / probabilistic

Características e limitações

Caraterística Observações
Atribuição de pre-roll indisponível O X Ads não é compatível com a atribuição de MMPs para campanhas de pre-roll. 
Nome do anúncio "sem título"

O nome do anúncio não é um campo obrigatório no modelo de dados do X Ads (antigo Twitter), portanto, ele pode estar ausente. Quando o nome do anúncio não está definido no X Ads Manager, a AppsFlyer o exibe como "untitled".

Custo Para X Ads, os dados de custo de campanhas (que têm apenas instalações SKAN, sem instalações "comuns") não estão disponíveis para agências. A integração de custos deve ser configurada pelo anunciante. Os dados só podem ser visualizados pelo anunciante.