X (Twitter) Web - Campanhas Web-to-App

Seguir
Avatar
Fernando Cabral
Updated
Configurando o X (Twitter) Ads
Web e Mobile
Web-to-App
Configurar para campanhas Web e Mobile Web-to-App
Agregação de Ad Monetization
Não suportado
Discrepância de Dados
Detalhes em breve

Este artigo detalha como configurar a atribuição de instalações mobile, PC e Console da Singular para campanhas web (não relacionadas a apps) do X (Twitter). Para instruções sobre como configurar e atribuir campanhas de app do X (Twitter), consulte nosso guia de Atribuição do X (Twitter) Ads .

As campanhas do X (Twitter) não suportam URLs de trackers de MMP, portanto todas as conversões são medidas apenas com atribuição de click-through, definindo o Singular Tracker na Website URL.

Visão geral

As soluções de atribuição web-to-app da Singular permitem que profissionais de marketing executem campanhas web que geram instalações de app nas plataformas Mobile, PC e Console. Veja mais detalhes em Otimização de Campanhas Web, Web-to-App, PC e Console.

Adicionar a Partner Configuration do X (Twitter) Web na Singular

Adicionar a Partner Configuration do X (Twitter) Web CAPI na Singular

  1. Acesse Singular > Attribution > Partner Configuration
  2. Clique em " Add a Partner ", digite e escolha " Twitter Web CAPI "
  3. Na caixa de diálogo, escolha o App e o App site (plataforma) que deseja configurar. Apps mobile, PC e console são suportados por esta integração
  4. Cole o " Access Token ", o " Access Secret ", a " Consumer Key ", o " Consumer Secret ", o " Install Event ID " e o " Pixel ID " do seu app.
    Configuração de parceiro Twitter Web CAPI da Singular exibindo os campos Access Token, Access Secret, Consumer Key, Consumer Secret, Install Event ID e Pixel ID
  5. Opcionalmente, configure quaisquer eventos adicionais a serem enviados ao X (Twitter) e mapeie-os para um "X Event ID"
    Configurando eventos adicionais mapeados para X Event IDs na Singular

  6. Clique em " Save " para finalizar.
Criar um Singular Link para "Twitter Web CAPI"

Criar um Singular Link para "Twitter Web CAPI"

  1. Acesse Singular > Attribution > Manage Links
  2. Selecione seu app mobile na lista de apps à esquerda
  3. Selecione "Create Link" -> Link Type "Partner" -> Source Name "Twitter Web CAPI"
  4. Prossiga pelo processo passo a passo de criação do link.
  5. (Opcional) Se o seu link incluir um destino de deep link para iOS, habilite a Social Landing Page. Consulte abaixo para mais detalhes.
  6. Clique em "Generate"
  7. Copie o "Click-through Tracking Link" para a próxima etapa.

Planeja usar deep linking?

O navegador in-app do X (Twitter) não suporta iOS Universal Links. Quando os usuários clicam no seu anúncio dentro do app do X (Twitter) no iOS, os deep links falham silenciosamente — levando os usuários para a tela inicial do app em vez do destino pretendido.

A Social Landing Page da Singular resolve isso. É uma página intermediária criada automaticamente pela Singular — sem necessidade de configuração. Quando os usuários clicam no seu anúncio, eles chegam a esta página e tocam em um botão de CTA que aciona de forma confiável o deep linking para a tela correta no app.

Como habilitar: No fluxo de criação do link, acesse Social Link Settings > ative o Enable Landing Page .

⚠️ Não recomendado quando o link não inclui um destino de deep link.

Saiba mais sobre a Social Landing Page

Configurar sua campanha Twitter Web

Configurar sua campanha Twitter Web

  1. No Twitter Ads Manager, crie uma campanha e selecione o objetivo de campanha "Sales" ou "Website Traffic":
    • Sales - otimiza a partir dos eventos que você configurou na sua Partner Configuration da Singular
    • Website Traffic - otimiza para cliques
    Selecionando o objetivo de campanha Sales ou Website Traffic no Twitter Ads Manager
  2. Ao adicionar a mídia, defina o Singular Link da seção acima na Website URL
    Definindo o Singular Link como Website URL ao adicionar a mídia no Twitter Ads Manager
  3. Preencha todas as macros de campanha manualmente, pois o X Ads não processa macros de link. Exemplo: 
    https://singular.sng.link/XXXXX/YYYY?pcn={campaign_name}&pscn={ad_group_name}&pcrn={ad_name}&wpsrc=Twitter%20Web%20CAPI&_forward_params=1&wpcn={campaign_name}&wpscn={ad_group_name}&wpcrn={ad_name}
    para 
    https://singular.sng.link/XXXXX/YYYY?pcn=Singular%20CName%20Test&pscn=Singular%20AdGroup%20Test1&pcrn=Singular%20Ad%20Test2&wpsrc=Twitter%20Web%20CAPI&_forward_params=1&wpcn=Singular%20CName%20Test&wpscn=Singular%20AdGroup%20Test1&wpcrn=Singular%20Ad%20Test2
    Exemplo de um Singular Link com macros de campanha preenchidas manualmente para o X Ads

FAQ

Onde encontrar os Access e Consumer Tokens e Secrets?
  1. Se você não se cadastrou em uma X Developer Account, siga as instruções do X Developer Platform para se cadastrar e criar um APP: X Ads API: Getting Started .
  2. Com o Developer APP criado, navegue até o X Developer Portal dashboard.
  3. Navegue até a página " Projects & Apps ", selecione o projeto e abra a página de credenciais do APP. Abrindo a página de credenciais do app a partir da página Projects & Apps no X Developer Portal
  4. Na página Keys and tokens você encontrará todas as credenciais de API para a integração: Localizando as credenciais de API na página Keys and tokens no X Developer Portal
Onde encontrar os X Event IDs e o X Pixel ID?
  1. Navegue até a página do X Ads Manager .
  2. Navegue até a página " Tools & Events Manager ". Navegando até a página Tools & Events Manager no X Ads Manager
  3. No topo, copie o seu " X pixel ", e na tabela na parte inferior copie os seus " Event IDs " Copiando o X pixel ID no topo e os Event IDs da tabela em Tools & Events Manager

    Se este for um novo pixel ou evento, siga o guia passo a passo do X Ads para criar um " Pixel ". Leia mais sobre Generating the Pixel and Creating Events .
Quais dados a Singular envia via API?
Parâmetro Detalhes
conversion_time
  • Timestamp da instalação ou do evento.
event_id
  • Um X Event ID padrão. Este valor é usado para auxiliar o X na deduplicação de eventos.
twclid
  • ID de clique do X (Twitter)
  • passado automaticamente
hashed email
  • Opcional se o twclid for fornecido.
  • O hashed email pode ser passado como um atributo de evento instrumentado pela Singular chamado "ehash"
  • O valor do hashed email deve ser normalizado e transformado em hash SHA 256
IP address
  • O Client IP Address
user agent
  • O user agent do navegador correspondente ao evento
Quais são as limitações da X (Twitter) Conversions API?
  • Não há macros para preencher automaticamente os dados da campanha. Se você quiser ter esse detalhamento na Singular, você precisa defini-lo manualmente ao adicionar a Website URL, conforme instruído no menu " Configurar sua campanha Twitter Web " acima.
  • O X Ads recomenda que a X Conversion API seja usada para complementar uma implementação de X pixel existente ou quando você não conseguir implementar JavaScript no seu site.
  • Para integrações mobile, o X e a Singular recomendam passar os dados de conversão mobile pela integração de atribuição mobile dedicada da Singular com o X Ads. Se você tiver interesse em passar os dados de conversão mobile pela X Conversions API, entre em contato com o seu customer success manager da Singular.