Conector de dados do X (Twitter) Ads

Seguir
Avatar
Vaibhav Gupta
Updated
Configuração do X Ads
Agregação de custos
Configurar o conector de dados
Agregação de monetização de anúncios
Não compatível
Discrepância de dados
Detalhes em breve

 

Saiba como a Singular extrai os dados de custo de publicidade do X Ads (antigo Twitter) e os exibe nos seus relatórios. No dashboard da Singular, o Twitter continua aparecendo como a fonte dos dados de campanha do X Ads.

 

Detalhes rápidos

Tecnologia do conetor de dados API (X Ads API version 11 - ver documentação)
Detalhamento de dados (segmentação)

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

  • Campanha
  • Subcampanha (line item)

Além disso, você pode obter um dos seguintes detalhamentos:

  • Plataforma (padrão)
  • DMA Name
  • Idade
  • Gênero

Se você tiver interesse em obter a localização geográfica em vez do detalhamento por plataforma, entre em contato com seu Customer Success Manager ou com o suporte da Singular e informe se quer o DMAdo usuário.

Observação: O X Ads não oferece detalhamento por publisher.

O X Ads não oferece mais detalhamentos por cidade ou região.
Qual o intervalo de tempo em que extraímos dados 30 dias
Fuso horário Definido pelo cliente para cada conta
Os dados estão disponíveis no nível criativo? Sim
O Singular mostra seus ativos criativos? Sim, incluindo imagens, vídeos e vídeos em streaming.
A Singular não mostra Polls.
Limitações/ problemas conhecidos
 
  • O X Ads não oferece detalhamento por Publisher.
  • A Singular não consegue mostrar os Scheduled Tweets antes que o tweet seja publicado. Nós os extraímos quando eles são publicados.
  • Não há estatísticas de instalações por criativo.
  • As métricas no nível criativo nem sempre coincidem com as métricas extraídas no nível de subcampanha (o Line Item do X Ads).
  • Pode haver discrepâncias entre o relatório de detalhamento por platform do X e o relatório de detalhamento por country do X.

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

Mapeamento de dados

Notas de terminologia:

  • Sub-Campaign na Singular corresponde ao Line Itemdo X Ads.
  • Creative na Singular pode corresponder a Tweet, Promoted Tweet, Card, ou Media Creativedo X Ads. 
  • As métricas são extraídas dos objetos Line Item, Promoted Tweete Media Creative do X Ads.
  • As dimensões de localização geográfica (Country, DMA Name) só ficam disponíveis se você tiver solicitado obter a localização em vez do detalhamento por plataforma (consulte "Detalhamento de dados (segmentação)" acima).

Para ver a descrição de cada campo na Singular, consulte Métricas e dimensões.

Field in Singular UI Field in Singular API Field in X Ads API
Dimensions
Account ID adn_account_id Account_object: id
Account Name adn_account_name Account_object: name
Agency agency Not pulled directly from X Ads, but Singular can set the agency per each account.
App Site ID app_site_id Estimated based on any URLs available in creative-related objects (Tweets,  Promoted Tweets, Cards, Media Creatives, Account Medias). If not possible, we try to estimate based on campaign URLs and Line Item URLs.
Campaign URL adn_campaign_url
  • Pulled from a Card object related to a Tweet related to a Line Item in the campaign.
  • The field is "website_dest_url" in X Ads API v. 6.0 but if that is not populated we look under old field names: “website_url", "website_shortened_url", "media_url". 
  • If there was no Card, we look for the "landing_url" field in a Media Creative object.
Country country_field We query the X Ads API with segment_by=”LOCATIONS”, and take the segment name for each Line Item and Promoted Tweet.
Creative Reported URL creative_reported_url  
Date date_field Since the Singular data connector pulls daily reports, we add the date ourselves.
DMA Name
 		 dma_name_field
 		 Same as Campaign URL
Network Campaign ID adn_campaign_id "id" in the Campaign object
Network Campaign Name adn_campaign_name "name" in the Campaign object
Network Creative ID adn_creative_id

Depends on the type of the creative.

  • If the creative is a Promoted Tweet: "tweet_id" in the Promoted Tweet object
  • If the creative is a Media Creative: "id" in the Account Media object.
Network Creative Name adn_creative_name Take the "media id" from the Card object and query X Ads for the media "name".
Network Sub Campaign ID adn_sub_campaign_id "id" in the Line Item object
Network Sub Campaign Name adn_sub_campaign_name "name" in the Line item object
Placement
 		 placement
 		 placements (possible values: ALL_ON_TWITTER, PUBLISHER_NETWORK, TWITTER_PROFILE, TWITTER_SEARCH, TWITTER_TIMELINE, TAP_BANNER, TAP_FULL, TAP_FULL_LANDSCAPE, TAP_NATIVE, TAP_MRECT)
Platform platform
  • This is only available if you have asked Singular to receive the Platform breakdown instead of the Country breakdown.
  • We query the Twitter API with segment_by=”PLATFORMS”, and take the segment name for each Line Item and Promoted Tweet.
Public Id site_public_id "googleplay_app_id" or "iphone_app_id" in the Card object, if available.
Sub Ad Network adn_subadnetwork
  • Set to "twitterfeed" if the data was queried from "ALL_ON_TWITTER"
  • Set to "twittertpn" if the data was queried from "PUBLISHER_NETWORK"
Target Countries target_countries_str For each sub-campaign (line item), we pull "countries" from the /targeting_criteria endpoint. We concatenate the results into this field.
Text creative_text Depending on the type of the creative, either "name" from the Card object, "text" from the Tweet object, or "media_name" from the Account Media.
Timezone adn_timezone "timezone" in the Account object
Age age AGE
Gender gender GENDER
Metrics
Comments
 		 comments replies
Likes
 		 likes likes
Network Clicks adn_clicks “clicks”
Network Impressions adn_impressions "impressions"
Network Installs adn_installs "mobile_conversion_installs"
Original Cost adn_original_cost "billed_charge_local_micro"
Original Currency adn_original_currency “currency” in the Campaign object
Page Follows
 		 page_follows follows
Shares
 		 shares retweets
Video Views video_views “video_total_views”
Completed Video Views completed_video_views “video_views_100”
Video Views - 25% video_views_25pct “video_views_25”
Video Views - 50% video_views_50pct “video_views_50”
Video Views - 75% video_views_75pct “video_views_75”

A Singular também oferece suporte à extração de propriedades de campanha para este parceiro: veja mais detalhes aqui.