Conector de datos de TikTok For Business

Seguir
Avatar
Vaibhav Gupta
Updated
Configuración de TikTok For Business
Agregación de costos
Configurar el conector de datos

 

Descubre cómo Singular extrae los datos de costo publicitario de TikTok For Business y los muestra en tus reportes. En el dashboard de Singular, verás TikTok Ads indicado como la fuente de TikTok For Business.

Detalles rápidos

Tecnología del conector de datos API (TikTok marketing API v. 1.3)
Desglose de datos (segmentación) Tus datos se desglosan por las siguientes dimensiones:
  • Plataforma 
  • País (predeterminado)
  • Ubicación
  • DMA
Importante: Para usar un desglose distinto de País, comunícate con el soporte de Singular. Debido a las limitaciones de la API de TikTok, no podemos extraer datos de varios desgloses a nivel de campaña.

Si no usas el desglose por país, las campañas con un solo segmento mostrarán valores de país, pero una campaña con varios segmentos aparecerá como "N/A" a menos que podamos estimarla con base en los datos de atribución. Los datos estimados pueden no ser idénticos a los de TikTok. Consulta "¿Cómo se calcula el costo por país?"
Desde cuándo extraemos datos 7 días
Zona horaria La zona horaria configurada para la cuenta en TikTok
¿Hay datos disponibles a nivel creativo (anuncio)? Sí
¿Muestra Singular tus activos creativos? Sí

Mapeo de datos

Sugerencia: Para obtener más información sobre cualquier campo de los reportes de Singular, consulta el Glosario de métricas y dimensiones. Además, puedes ver la asignación de las funciones de campaña de TikTok a los campos de su API de reportes aquí.

Field in Singular UI Field in Singular API Field in TikTok API
Dimensions
Account ID adn_account_id (Taken from [advertiser/info])
Account Name adn_account_name advertiser_name
App app app_name
App Site ID app_site_id (Taken from the [app_download_url])
Bid Type bid_type bid_type
Campaign Objective campaign_objective objective_type
Campaign Status campaign_status opt_status
Campaign URL adn_campaign_url landing_page_url
Country country_field location
Date date_field stat_time_day
DMA ID dma_id_field dma.id
DMA Name dma_name_field dma.name
Network Campaign ID adn_campaign_id campaign_id
Network Campaign Name adn_campaign_name campaign_name
Network Creative ID adn_creative_id ad_id
Network Creative Name adn_creative_name ad_name
Network Sub Campaign ID adn_sub_campaign_id adgroup_id
Network Sub Campaign Name adn_sub_campaign_name adgroup_name
Original Bid Amount original_bid_amount bid
Original Bid Currency original_metadata_currency currency
Platform platform
  • platform
  • app_type (If platform is empty)
  • operating_system (If both are empty)
Public Id site_public_id mobile_app_id
Region
 		region_field
 		region.name (State or Province; displayed if sub-campaign targets a single region)
Standardized Bid Type standardized_bid_strategy optimize_goal
Timezone adn_timezone timezone
Text creative_text ad_text
TikTok - Campaign Automation Type tiktok_campaign_automation_type campaign_automation_type
TikTok - SmartPlus Ad ID tiktok_smartplus_ad_id ad_id_v2 / smart_plus_ad_id
TikTok - SmartPlus Ad Name tiktok_smartplus_ad_name ad_id_v2 / smart_plus_ad_id
TikTok - Post ID tiktok_post_id post_id
Age age age
Gender gender gender
Metrics
Comments comments comments
Likes likes likes
Network Clicks adn_clicks clicks
Network Impressions adn_impressions impressions
Network Installs adn_installs

real_time_conversion

(backup option: app_installs)

Note: If app_installs is configured as the default Network Installs metric, the Country dimension may not be available in the Audience Report.

Original Cost adn_original_cost stat_cost
Original Currency adn_original_currency currency
Page Follows
 		page_follows follows
Shares
 		shares shares
Video Views video_views total_play
Video Views - 25% video_views_25pct play_first_quartile
Video Views - 50% video_views_50pct play_midpoint
Video Views - 75% video_views_75pct play_third_quartile
Completed Video Views completed_video_views play_over

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

Instrucciones de configuración

Pasos de configuración

Para configurar el conector de datos de TikTok For Business:

  1. En tu cuenta de Singular, ve a Settings > Data Connectors.

    screenshot--2019.08.11-12-54-10.png

  2. Haz clic en Add New Connector y empieza a escribir "TikTok". Selecciona "TikTok Ads" en la lista que aparece.

    Screen_Shot_2021-03-02_at_17.09.53.png

  3. En la ventana de configuración que se abre, haz clic en Sign In with TikTok e inicia sesión en tu cuenta de TikTok For Business.

    Screen_Shot_2021-03-02_at_17.11.10.png

  4. La plataforma de TikTok te pregunta si quieres otorgar a Singular permisos para acceder a los datos de TikTok. Marca la casilla Agree to the Platform Service Agreement y haz clic en Confirm.

    Screen_Shot_2021-03-02_at_17.20.30.png

  5. Después de otorgar los permisos, la ventana de configuración en Singular indica que estás conectado. Puedes cerrar la ventana.

  6. TikTok ahora aparece en la lista de conectores de datos. El estado del conector de datos es "Pending" mientras Singular realiza la primera extracción de datos. Una vez completada la primera extracción, el estado cambiará a "Active".

    Screen_Shot_2021-03-02_at_17.31.58.png

  7. Una vez que el conector de datos haya extraído datos correctamente en Singular, puedes empezar a ejecutar reportes que incluyan datos de TikTok. Para más información, consulta FAQ de reportes, Referencia de la API de Singular, o FAQ de destinos de datos de Singular.

    Reporte de ejemplo:

    Screen_Shot_2021-03-02_at_17.49.17.png

Métricas adicionales (eventos de conversión)

Singular extrae métricas de la lista de métricas de TikTok For Business. De forma predeterminada, los eventos regulares se extraen de la sección "in-app events metrics" y los eventos SKAdNetwork de la sección "Supported SKAN Metrics" de la lista. Además de estos, puedes extraer cualquier métrica creando un evento de conversión en Singular.

Para crear un evento de conversión:

  1. En Singular, ve a Settings > Events. Si tienes las pestañas Custom Events y Conversion Events, selecciona Conversion Events.
  2. Haz clic en New Event.

  3. En el menú desplegable TikTok Ads, selecciona la métrica que quieras.

    Al día siguiente, cuando Singular extraiga los datos diarios de tu cuenta, también extraerá las conversiones completadas.

  4. Después de que el nuevo evento se llene con algunos datos, ejecuta un reporte en la página Reports y elige el evento de conversión que creaste en el menú desplegable Events.

screenshot-docs.google.com-2021.11.24-16_28_51.png

Campañas TikTok Upgraded Smart+

A medida que TikTok evoluciona su conjunto de herramientas de automatización, estamos actualizando nuestros reportes para ofrecer visibilidad completa de la estructura de campañas Upgraded Smart+. TikTok está pasando de Smart Campaigns (que se descontinuará pronto) al modelo Upgraded Smart+.

El objetivo principal de esta actualización es ofrecer un equilibrio entre datos granulares y combinados en estos nuevos tipos de automatización.

¿Qué está cambiando?

Para respaldar esta transición, agregaremos los siguientes campos de reporte a partir de marzo de 2026:

  • TikTok - Campaign Automation: Este campo identifica la lógica de automatización utilizada y clasifica las campañas como Manual, Smart, o Upgraded Smart+.
  • TikTok - Upgraded Smart+ Ad ID & Name: Estos campos representan una nueva capa de reportes que se ubica directamente por encima del creativo. Esta capa funciona como un contenedor para varios creativos.

Nota: El Upgraded Smart+ Ad ID y el Name son campos únicamente del lado de la red. Si bien esto agrega una nueva capa estructural, tus datos de creativos seguirán combinándose para garantizar un tracking integral del rendimiento.