X (Twitter) Conector de dados

Seguir
Avatar
Vaibhav Gupta
Updated
Documento

Saiba como o Singular obtém dados de custo de publicidade do X (antigo Twitter) e os exibe em seus relatórios. O Twitter continua a ser indicado como a fonte do X no painel de controlo do Singular.

Detalhes rápidos

Tecnologia de conetor de dados API (API do X Ads versão 9 - consulte a documentação)
Detalhamento de dados (segmentação)

Os dados do X (Twitter) são sempre divididos por:

  • Campanha
  • Sub-campanha (item de linha)

Além disso, é possível obter uma das seguintes subdivisões:

  • Plataforma (predefinição)
  • País + Cidade
  • País + Região
  • País + Nome DMA
  • Idade
  • Sexo

Se você estiver interessado em obter a localização geográfica em vez do detalhamento da plataforma, entre em contato com o gerente de sucesso do cliente ou com o suporte da Singular e especifique se deseja a cidade, a região ou o DMA do usuário.

Observação: o Twitter não fornece discriminação de publishers.
Qual o intervalo de tempo em que obtemos dados 30 dias
Fuso horário Definido pelo cliente por conta
Os dados estão disponíveis no nível do criativo? Sim
O Singular mostra os seus activos criativos? Sim - incluindo imagens, vídeos e vídeos de streaming.
O Singular não mostra pesquisas.
Limitações/ problemas conhecidos
  • O Twitter não fornece detalhamento do editor.
  • O Singular não pode mostrar Tweets programados antes que o tweet esteja ao vivo. Nós os exibimos quando/se eles forem ao ar.
  • Não há estatísticas de instalação por criativo.
  • As métricas no nível do criativo nem sempre correspondem às métricas extraídas no nível da subcampanha (item de linha do Twitter).
  • Pode haver discrepâncias entre o relatório de detalhamento de plataformas do Twitter e o relatório de detalhamento de países do Twitter.

Para saber mais sobre discrepâncias internas nos dados do Twitter, consulte o artigo do Twitter sobre o assunto.

Mapeamento de dados

Notas de terminologia:

  • Subcampanha no Singular corresponde ao item de linha do Twitter.
  • O criativo no Singular pode corresponder ao Tweet, Tweet Promovido, Card ou Criativo de Mídia do Twitter.
  • As métricas são extraídas dos objetos Item de linha, Tweet promovido e Criativo de mídia do Twitter.
  • As dimensões de localização geográfica(País, Região, Cidade, Nome do DMA) estão disponíveis somente se você tiver solicitado a localização em vez do detalhamento da plataforma (consulte "Detalhamento de dados" acima).

Para obter uma descrição de cada campo no Singular, consulte Métricas e dimensões.

Campo em Singular UI Campo na API do Singular Campo no Twitter
Dimensões
ID da conta adn_account_id Objeto_da_conta: id
Nome da conta adn_account_name Objecto_da_conta: nome
Agência agência Não é extraído diretamente do Twitter, mas o Singular pode definir a agência por cada conta.
ID do site do aplicativo app_site_id Estimado com base em quaisquer URLs disponíveis em objetos relacionados a criativos (Tweets, Tweets Promovidos, Cards, Criativos de Mídia, Mídias da Conta). Se não for possível, tentamos estimar com base nos URLs de campanha e nos URLs de item de linha.
URL da campanha adn_campaign_url
  • Extraído de um objeto de Card relacionado a um Tweet relacionado a um Item na campanha.
  • O campo é "website_dest_url" na API do Twitter v. 6.0, mas se ele não for preenchido, procuramos por nomes de campos antigos: "website_url", "website_shortened_url", "media_url".
  • Se não existir um cartão, procuramos o campo "landing_url" num objeto Media Creative.
Cidade
 campo_cidade
País campo_do_país Consultamos a API do Twitter com segment_by="LOCATIONS" e obtemos o nome do segmento para cada Item e Tweet Promovido.
URL criativo relatado creative_reported_url
Data campo_data Como o conetor de dados Singular obtém relatórios diários, nós mesmos adicionamos a data.
Nome do DMA
 campo_nome_dma
 O mesmo que URL da campanha
ID da campanha de rede adn_campaign_id "id" no objeto Campaign
Nome da campanha de rede adn_campaign_name "nome" no objeto da campanha
ID criativa da rede adn_creative_id Depende do tipo de criativo.
  • Se o criativo for um Tweet Promovido: "tweet_id" no objeto Tweet Promovido
  • Se o criativo for um criativo de mídia: "id" no objeto Mídia da conta.
Nome do criativo de rede adn_creative_name Pegue o "media id" do objeto Card e consulte o Twitter para obter o "nome" da mídia.
ID da subcampanha de rede adn_sub_campaign_id "id" no objeto Item
Nome da subcampanha de rede adn_sub_campaign_name "nome" no objeto Item
Colocação
 colocação
 posicionamentos (valores possíveis: ALL_ON_TWITTER, PUBLISHER_NETWORK, TWITTER_PROFILE, TWITTER_SEARCH, TWITTER_TIMELINE, TAP_BANNER, TAP_FULL, TAP_FULL_LANDSCAPE, TAP_NATIVE, TAP_MRECT)
Plataforma plataforma
  • Esta opção só está disponível se tiver pedido à Singular para receber a discriminação da Plataforma em vez da discriminação do País.
  • Consultamos a API do Twitter com segment_by="PLATFORMS" e obtemos o nome do segmento para cada Item e Tweet Promovido.
ID público site_public_id "googleplay_app_id" ou "iphone_app_id" no objeto Cartão, se disponível.
Região
 campo_região
Sub-rede de anúncios adn_subadnetwork
  • Definido como "twitterfeed" se os dados tiverem sido consultados a partir de "ALL_ON_TWITTER"
  • Definido como "twittertpn" se os dados tiverem sido consultados a partir de "PUBLISHER_NETWORK"
Países de destino target_countries_str Para cada sub-campanha (item de linha), extraímos "países" do ponto de extremidade /targeting_criteria. Concatenamos os resultados neste campo.
Texto creative_text Dependendo do tipo de criativo, "name" do objeto Card, "text" do objeto Tweet ou "media_name" do Account Media.
Fuso horário adn_timezone "timezone" no objeto Conta
Idade idade IDADE
Género género GÉNERO
Métricas
Frequência média
 frequência média_frequência
Comentários
 comentários respostas
Gostos
 gostos gostos
Cliques na rede adn_clicks "cliques"
Impressões da rede adn_impressões "impressões"
Instalações de rede adn_installs "instalações_conversão_móvel"
Custo original adn_original_cost "custo_facturado_local_micro"
Moeda original adn_original_currency "currency" no objeto Campaign
Seguidores da página
 page_follows segue
Alcance
 alcance alcance_total_da_audiência
Partilhas
 partilhas retweets
Visualizações de vídeo visualizações_vídeo "video_total_views"
Visualizações de vídeo concluídas visualizações_de_vídeo_concluídas "video_views_100"
Visualizações de vídeo - 25% visualizações_de_vídeo_25pct "video_views_25"
Visualizações de vídeo - 50% video_views_50pct "video_views_50"
Visualizações de vídeo - 75% video_views_75pct "video_views_75"

A Singular também suporta a extração de propriedades de campanha para este parceiro - veja mais detalhes aqui.