Integración con TikTok

En esta página se describen las configuraciones necesarias para importar datos de TikTok como fuente de datos de la carga de trabajo de marketing de Cortex Framework Data Foundation.

TikTok es una popular aplicación de redes sociales conocida por sus vídeos cortos. Cortex Framework puede aportar datos para analizar el rendimiento general del marketing. Al combinar datos de TikTok y de varias fuentes, puedes obtener una visión más completa de tu audiencia objetivo y de la eficacia de tus campañas en redes sociales en diferentes plataformas.

En el siguiente diagrama se describe cómo se pueden obtener los datos de TikTok a través de la carga de trabajo de marketing de la base de datos de Cortex Framework:

Fuente de datos de TikTok

Imagen 1. Fuente de datos de TikTok.

Archivo de configuración

El archivo config.json configura los ajustes necesarios para conectarse a fuentes de datos y transferir datos de varias cargas de trabajo. Este archivo contiene los siguientes parámetros de TikTok:

   "marketing": {
        "deployTikTok": true,
        },
        "TikTok": {
            "deployCDC": true,
            "datasets": {
                "cdc": "",
                "raw": "",
                "reporting": "REPORTING_TikTok"
            }
        }

En la siguiente tabla se describe el valor de cada parámetro de marketing:

Parámetro Significado Valor predeterminado Descripción
marketing.deployTikTok Desplegar TikTok true Ejecuta la implementación de la fuente de datos de TikTok.
marketing.TikTok.deployCDC Implementar secuencias de comandos de CDC para TikTok true Genera secuencias de comandos de procesamiento de CDC de TikTok para ejecutarlas como DAGs en Cloud Composer.
marketing.TikTok.datasets.cdc Conjunto de datos de CDC para TikTok Conjunto de datos de los CDC para TikTok.
marketing.TikTok.datasets.raw Conjunto de datos sin procesar de TikTok Conjunto de datos sin procesar de TikTok.
marketing.TikTok.datasets.reporting Conjunto de datos de informes de TikTok "REPORTING_TikTok" Conjunto de datos de informes de TikTok.

Modelo de datos

En esta sección se describe el modelo de datos de TikTok mediante el diagrama de relaciones entre entidades (DRE).

Diagrama de relaciones entre entidades de TikTok

Imagen 2. TikTok: diagrama de relaciones entre entidades.

Vistas básicas

Son los objetos azules del diagrama ER y son vistas de tablas de CDC sin transformaciones, salvo algunos alias de nombres de columna. Consulta las secuencias de comandos en src/marketing/src/TikTok/src/reporting/ddls.

Vistas de informes

Son los objetos verdes del diagrama ER y son vistas de informes que contienen métricas agregadas. Consulta las secuencias de comandos en src/marketing/src/TikTok/src/reporting/ddls.

Conexión a la API

Cortex Framework usa las APIs Reporting de TikTok, versión v1.3, como fuente oficial de datos de TikTok. Cortex Framework usa el modo síncrono y llama a las APIs de Informes básicos para obtener métricas de rendimiento de anuncios y grupos de anuncios. De esta forma, Cortex Framework tiene acceso a información actualizada y precisa de TikTok, lo que permite realizar análisis de datos y generar informes eficaces.

Para obtener más información sobre la conexión de la API, consulta APIs de informes de TikTok.

Autenticación de cuenta

Para configurar una cuenta de TikTok y autenticarla, sigue estos pasos:

  1. Configura una cuenta de desarrollador de TikTok si aún no tienes una.
  2. Crea una aplicación para la integración de Cortex Framework. Consulta más información sobre la API de TikTok para empresas. Asegúrate de seleccionar los dos siguientes ámbitos para la aplicación:
    • Ad Account Management/Ad Account Information
    • Reporting/All
  3. Obtén el ID de aplicación, el secreto y el token de acceso a largo plazo tal como se describe en la guía de TikTok y guárdalos respectivamente en Secret Manager con los siguientes nombres:
    • ID de la aplicación: cortex_tiktok_app_id
    • Secreto: cortex_tiktok_app_secret
    • Token de acceso a largo plazo: cortex_tiktok_access_token

Actualización y latencia de los datos

Por lo general, la actualización de los datos de las fuentes de datos de Cortex Framework está limitada por lo que permite la conexión ascendente, así como por la frecuencia de ejecución de tu DAG. Ajusta la frecuencia de ejecución de tu DAG para que se ajuste a la frecuencia de los elementos anteriores, las restricciones de recursos y las necesidades de tu empresa.

Con la API Marketing de TikTok, la mayoría de los datos (excepto las conversiones) están disponibles prácticamente en tiempo real.

Conexiones de Cloud Composer

Crea las siguientes conexiones en Cloud Composer. Para obtener más información, consulta la documentación sobre cómo gestionar conexiones de Airflow.

Nombre de la conexión Purpose
tiktok_raw_dataflow Para la API de TikTok > BigQuery Conjunto de datos sin procesar
tiktok_cdc_bq Conjunto de datos sin procesar > Transferencia de conjunto de datos de CDC
tiktok_reporting_bq Conjunto de datos de CDC > Transferencia de conjuntos de datos de informes

Permisos de la cuenta de servicio de Cloud Composer

Concede permisos de Dataflow a la cuenta de servicio utilizada en Cloud Composer (tal como se configura en la conexión tiktok_raw_dataflow). Consulta las instrucciones en la documentación de Dataflow.

Además, la misma cuenta de servicio también debe tener acceso de lector de Secret Manager.

Configuración de ingestión

Controla las canalizaciones de datos Source to Raw y Raw to CDC a través de los ajustes del archivo src/TikTok/config/ingestion_settings.yaml. En esta sección se describen los parámetros de cada canalización de datos.

De las fuentes a las tablas sin procesar

Esta sección contiene entradas que controlan cómo se obtienen los datos de TikTok y dónde acaban en el conjunto de datos sin procesar. Cada entrada se corresponde con una tabla sin procesar que contiene los datos obtenidos de la API de TikTok para esa entidad. En función de estos parámetros de configuración, Cortex Framework crea DAGs de Airflow que ejecutan las canalizaciones de Dataflow para procesar datos de las APIs de TikTok.

Los siguientes parámetros controlan los ajustes de Source to Raw de cada entrada:

Parámetro Descripción
base_table Tabla del conjunto de datos sin procesar en la que se almacenan los datos de una entidad(por ejemplo, los datos de un anuncio).
load_frequency Frecuencia con la que se ejecuta un DAG para que esta entidad procese los datos. Consulta la documentación de Airflow para obtener información sobre los valores posibles.
schema_file Archivo de esquema en el directorio src/table_schema que asigna los campos de respuesta de la API a los nombres de las columnas de la tabla de destino.
partition_details Opcional: si quieres que esta tabla se particione por motivos de rendimiento. Para obtener más información, consulta Partición de tabla.
cluster_details Opcional: si quiere que esta tabla se agrupe por motivos de rendimiento. Para obtener más información, consulta Configuración del clúster.

Tablas de datos sin procesar a tablas de CDC

Esta sección contiene entradas que controlan cómo se mueven los datos de las tablas sin procesar a las tablas de CDC. Cada entrada se corresponde con una tabla de CDC (que, a su vez, se corresponde con una entidad mencionada en Source to Raw table).

Los siguientes parámetros controlan los ajustes de Raw to CDC de cada entrada:

Parámetro Descripción
base_table Tabla del conjunto de datos de CDC en la que se almacenan los datos sin procesar después de la transformación de CDC (por ejemplo,auction_ad_performance).
load_frequency Con qué frecuencia se ejecuta un DAG de esta entidad para rellenar la tabla de CDC. Para obtener más información, consulta la documentación de Airflow, donde encontrarás detalles sobre los valores posibles.
row_identifiers Lista de columnas (separadas por comas) que forman un registro único para esta tabla.
partition_details Opcional: si quieres que esta tabla se particione por motivos de rendimiento. Para obtener más información, consulta Partición de tabla.
cluster_details Opcional: si quieres que esta tabla se agrupe por motivos de rendimiento. Para obtener más información, consulta Configuración del clúster.

Configuración de informes

Configura y controla cómo genera datos Cortex Framework para la capa de informes final de TikTok mediante el archivo de configuración de informessrc/TikTok/config/reporting_settings.yaml. Este archivo controla cómo se generan los objetos de BigQuery de la capa de informes (tablas, vistas, funciones o procedimientos almacenados).

Para obtener más información, consulte Personalizar el archivo de configuración de informes.

Siguientes pasos