Conector de datos de X (Twitter) Ads

Seguir
Avatar
Vaibhav Gupta
Updated
Configuración de X Ads
Agregación de costos
Configurar el conector de datos
Agregación de monetización de anuncios
No compatible
Discrepancia de datos
Detalles próximamente

 

Descubre cómo Singular extrae los datos de costo publicitario de X Ads (antes Twitter) y los muestra en tus reportes. En el dashboard de Singular, seguirás viendo Twitter indicado como la fuente de los datos de campañas de X Ads.

 

Detalles rápidos

Tecnología del conector de datos API (X Ads API version 11 - ver documentación)
Desglose de datos (segmentación)

Los datos de X Ads (Twitter) siempre se desglosan por:

  • Campaña
  • Subcampaña (line item)

Además, puedes obtener uno de los siguientes desgloses:

  • Plataforma (predeterminado)
  • DMA Name
  • Edad
  • Género

Si te interesa obtener la ubicación geográfica en lugar del desglose por plataforma, comunícate con tu Customer Success Manager o con el soporte de Singular e indica si quieres el DMAdel usuario.

Nota: X Ads no ofrece desglose por publisher.

X Ads ya no admite desgloses por ciudad o región.
Desde cuándo extraemos datos 30 días
Zona horaria Definida por el cliente para cada cuenta
¿Hay datos disponibles a nivel creativo? Sí
¿Muestra Singular tus activos creativos? Sí, incluidos imágenes, videos y videos en streaming.
Singular no muestra Polls.
Limitaciones y problemas conocidos
 
  • X Ads no ofrece desglose por Publisher.
  • Singular no puede mostrar los Scheduled Tweets antes de que el tweet esté publicado. Los extraemos cuando se publican.
  • No hay estadísticas de instalaciones por creativo.
  • Las métricas a nivel creativo no siempre coinciden con las métricas extraídas a nivel de subcampaña (el Line Item de X Ads).
  • Puede haber discrepancias entre el reporte de desglose por platform de X y el reporte de desglose por country de X.

Para obtener más información sobre las discrepancias internas en los datos de X Ads, consulta el artículo de X Ads sobre el tema.

Mapeo de datos

Notas de terminología:

  • Sub-Campaign en Singular corresponde al Line Itemde X Ads.
  • Creative en Singular puede corresponder a Tweet, Promoted Tweet, Card, o Media Creativede X Ads. 
  • Las métricas se extraen de los objetos Line Item, Promoted Tweety Media Creative de X Ads.
  • Las dimensiones de ubicación geográfica (Country, DMA Name) solo están disponibles si has solicitado obtener la ubicación en lugar del desglose por plataforma (consulta "Desglose de datos (segmentación)" más arriba).

Para ver la descripción de cada campo en Singular, consulta Métricas y dimensiones.

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”

Singular también admite la extracción de propiedades de campaña para este partner: consulta más detalles aquí.