X (Twitter) Conector de datos

Documento

Aprenda cómo Singular extrae datos de costes publicitarios de X (antes Twitter) y los muestra en sus informes. En el panel de control de Singular, Twitter sigue siendo la fuente de X.

Detalles rápidos

Tecnología del conector de datos API (X Ads API versión 9 - consulte la documentación)
Desglose de datos (segmentación)

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

  • Campaña
  • Subcampaña (partida)

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

  • Plataforma (por defecto)
  • País + Ciudad
  • País + Región
  • País + Nombre DMA
  • Edad
  • Sexo

Si estás interesado en obtener la ubicación geográfica en lugar del desglose por plataforma, ponte en contacto con tu Customer Success Manager o con el servicio de asistencia de Singular y especifica si quieres la ciudad, la región o el DMA del usuario.

Nota: Twitter no proporciona el desglose por editor.

¿Cuánto tiempo atrás extraemos los datos? 30 días
Zona horaria Definido por el cliente por cuenta
¿Hay datos disponibles a nivel creativo?
¿Muestra Singular sus activos creativos? Sí, incluyendo imágenes, vídeos y vídeos en streaming.
Singular no muestra encuestas.
Limitaciones y problemas conocidos
  • Twitter no proporciona el desglose de Publisher.
  • Singular no puede mostrar Tweets programados antes de que el tweet esté en directo. Los mostramos cuando se publican.
  • No hay estadísticas de instalación por creatividad.
  • Las métricas a nivel creativo no siempre coinciden con las métricas extraídas a nivel de subcampaña (elemento de línea de Twitter).
  • Puede haber discrepancias entre el informe de desglose por plataforma de Twitter y el informe de desglose por país de Twitter.

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

Mapeo de datos

Notas terminológicas:

  • Subcampaña en Singular corresponde a Partida de Twitter.
  • Creative en Singular puede corresponder a Tweet, Promoted Tweet, Card o Media Creative de Twitter.
  • Las métricas se extraen de los objetos Elemento de línea, Tweet promocionado y Creativo de medios de Twitter.
  • Las dimensiones de ubicación geográfica(país, región, ciudad, nombre de la DMA) sólo están disponibles si ha solicitado obtener la ubicación en lugar del desglose de la plataforma (consulte "Desglose de datos" más arriba).

Para obtener una descripción de cada campo en Singular, consulte Métricas y dimensiones.

Campo en Singular UI Campo en Singular API Campo en Twitter
Dimensiones
ID de cuenta adn_account_id Objeto_cuenta: id
Nombre de la cuenta adn_account_name Objeto_cuenta: nombre
Agencia agencia No se extrae directamente de Twitter, pero Singular puede establecer la agencia para cada cuenta.
ID del sitio de la aplicación app_site_id Estimado basado en cualquier URL disponible en objetos relacionados con creatividades (Tweets, Tweets Promocionados, Cards, Media Creatives, Account Medias). Si no es posible, tratamos de hacer una estimación basada en las URL de la campaña y las URL de las partidas.
URL de campaña adn_campaign_url
  • Se extrae de un objeto de tarjeta relacionado con un Tweet relacionado con una partida de la campaña.
  • El campo es "website_dest_url" en la API de Twitter v. 6.0, pero si no se rellena, buscaremos en los nombres de campo antiguos: "website_url", "website_shortened_url", "media_url".
  • Si no hay Card, buscamos el campo "landing_url" en un objeto Media Creative.
Ciudad
campo_ciudad
País campo_país Consultamos la API de Twitter con segment_by="LOCATIONS", y tomamos el nombre del segmento para cada Line Item y Tweet Promocionado.
URL creativa notificada creative_reported_url
Fecha campo_fecha Dado que el conector de datos de Singular extrae informes diarios, añadimos la fecha nosotros mismos.
Nombre DMA
dma_name_field
Igual que URL de campaña
ID de campaña de red adn_campaign_id "id" en el objeto Campaign
Nombre de la campaña de red adn_campaign_name "nombre" en el objeto Campaña
ID creativo de la red adn_creative_id Depende del tipo de creatividad.
  • Si la creatividad es un Tweet Promocionado "tweet_id" en el objeto Tweet Promocionado
  • Si la creatividad es un Media Creative: "id" en el objeto Account Media.
Nombre de la creatividad de red adn_creative_name Toma el "media id" del objeto Card y consulta a Twitter el "nombre" del medio.
ID de subcampaña de red adn_sub_campaign_id "id" en el objeto Partida
Nombre de la subcampaña de red adn_sub_campaign_name "name" en el objeto Partida
Colocación
colocación
colocaciones (valores posibles: ALL_ON_TWITTER, PUBLISHER_NETWORK, TWITTER_PROFILE, TWITTER_SEARCH, TWITTER_TIMELINE, TAP_BANNER, TAP_FULL, TAP_FULL_LANDSCAPE, TAP_NATIVE, TAP_MRECT)
Plataforma plataforma
  • Sólo está disponible si ha solicitado a Singular que reciba el desglose por plataforma en lugar del desglose por país.
  • Consultamos la API de Twitter con segment_by="PLATFORMS", y tomamos el nombre del segmento para cada Line Item y Tweet Promocionado.
Id. público site_public_id "googleplay_app_id" o "iphone_app_id" en el objeto Card, si está disponible.
Región
region_field
Subred publicitaria adn_subadnetwork
  • Se establece en "twitterfeed" si los datos se consultaron desde "ALL_ON_TWITTER".
  • Se establece en "twittertpn" si los datos se consultan desde "PUBLISHER_NETWORK".
Países de destino target_countries_str Para cada subcampaña (partida), extraemos los "países" del punto final /targeting_criteria. Concatenamos los resultados en este campo.
Texto texto_creativo Dependiendo del tipo de creatividad, "name" del objeto Card, "text" del objeto Tweet o "media_name" de Account Media.
Zona horaria adn_timezone "timezone" del objeto Cuenta
Edad edad EDAD
Sexo género GÉNERO
Métrica
Frecuencia media
frecuencia frecuencia_media
Comentarios
comentarios respuestas
Me gusta
me gusta me gusta
Clics en la red adn_clicks "clics
Impresiones en la red adn_impresiones "impresiones
Instalaciones de red adn_installs "mobile_conversion_installs" (instalaciones de conversión móvil)
Coste original adn_original_cost "cargo_facturado_local_micro"
Moneda original adn_original_currency "currency" en el objeto Campaign
Seguimientos de página
page_follows sigue
Alcance
alcance alcance_audiencia_total
Acciones
compartidos retweets
Visionados de vídeo video_views "video_total_views"
Vistas de vídeo completadas completed_video_views "video_views_100"
Vistas de vídeo - 25% video_views_25pct "video_views_25
Visionados de vídeo - 50% video_views_50pct "video_views_50"
Visionados de vídeo - 75% video_views_75pct "video_views_75

Singular también admite la extracción de propiedades de campaña para este socio - consulte más detalles aquí.