Integrazione con TikTok

Questa pagina descrive le configurazioni richieste per importare i dati da TikTok come origine dati del workload di marketing di Cortex Framework Data Foundation.

TikTok è una popolare app di social media nota per i video nel formato breve che Cortex Framework può utilizzare per analizzare il rendimento complessivo del marketing. Combinando i dati di TikTok e di varie origini, puoi ottenere una comprensione più completa del tuo pubblico di destinazione e dell'efficacia delle tue campagne sui social media su diverse piattaforme.

Il seguente diagramma descrive come i dati di TikTok sono disponibili tramite il workload di marketing di Cortex Framework Data Foundation:

Origine dati TikTok

Figura 1. Origine dati di TikTok.

File di configurazione

Il config.json file configura le impostazioni richieste per la connessione alle origini dati per il trasferimento dei dati da vari workload. Questo file contiene i seguenti parametri per TikTok:

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

La seguente tabella descrive il valore di ogni parametro di marketing:

Parametro Significato Valore predefinito Descrizione
marketing.deployTikTok Esegui il deployment di TikTok true Esegui il deployment per l'origine dati di TikTok.
marketing.TikTok.deployCDC Esegui il deployment degli script CDC per TikTok true Genera script di elaborazione CDC di TikTok da eseguire come DAG in Managed Service for Apache Airflow.
marketing.TikTok.datasets.cdc Set di dati CDC per TikTok Set di dati CDC per TikTok.
marketing.TikTok.datasets.raw Set di dati non elaborati per TikTok Set di dati non elaborati per TikTok.
marketing.TikTok.datasets.reporting Set di dati di reporting per TikTok "REPORTING_TikTok" Set di dati di reporting per TikTok.

Modello dati

Questa sezione descrive il modello dati di TikTok utilizzando il diagramma entità-relazione (ERD).

Diagramma delle relazioni tra entità per TikTok

Figura 2. TikTok: diagramma entità-relazione.

Visualizzazioni di base

Questi sono gli oggetti blu nell'ERD e sono visualizzazioni delle tabelle CDC senza trasformazioni, ad eccezione di alcuni alias dei nomi delle colonne. Consulta gli script in src/marketing/src/TikTok/src/reporting/ddls.

Viste report

Questi sono gli oggetti verdi nell'ERD e sono viste report che contengono metriche aggregate. Consulta gli script in src/marketing/src/TikTok/src/reporting/ddls.

Connessione API

Cortex Framework utilizza le API di reporting di TikTok, versione v1.3, come origine autorevole per i dati di TikTok. Cortex Framework utilizza la modalità sincrona e chiama le API di reporting di base per recuperare le metriche sul rendimento di annunci e gruppi di annunci. In questo modo, Cortex Framework ha accesso a informazioni aggiornate e accurate da TikTok, consentendo un'analisi e una reportistica efficaci dei dati.

Per ulteriori informazioni sulla connessione API, consulta API di reporting di TikTok.

Autenticazione account

Per configurare un account TikTok e l'autenticazione dell'account:

  1. Configura un account sviluppatore TikTok, se non ne hai già uno.
  2. Crea un'app per l'integrazione di Cortex Framework. Per ulteriori informazioni, consulta API TikTok for Business. Assicurati di selezionare i seguenti due ambiti per l'app:
    • Ad Account Management/Ad Account Information
    • Reporting/All
  3. Recupera l'ID app, il secret e il token di accesso a lungo termine come descritto nella guida di TikTok, e archiviali rispettivamente in Secret Manager con i seguenti nomi:
    • ID app: cortex_tiktok_app_id
    • Secret: cortex_tiktok_app_secret
    • Token di accesso a lungo termine: cortex_tiktok_access_token

Aggiornamento e ritardo dei dati

In generale, l'aggiornamento dei dati per le origini dati di Cortex Framework è limitato da ciò che consente la connessione upstream, nonché dalla frequenza di esecuzione del DAG. Modifica la frequenza di esecuzione del DAG in modo che sia in linea con la frequenza upstream, i vincoli delle risorse e le esigenze aziendali.

Con l'API Marketing di TikTok, la maggior parte dei dati (escluse le conversioni) è disponibile quasi in tempo reale.

Connessioni Managed Airflow

Crea le seguenti connessioni in Managed Airflow. Per maggiori dettagli, consulta la documentazione Gestire le connessioni Airflow.

Nome connessione Scopo
tiktok_raw_dataflow Per l'API TikTok > set di dati non elaborati di BigQuery
tiktok_cdc_bq Per il trasferimento dal set di dati non elaborati al set di dati CDC
tiktok_reporting_bq Per il trasferimento dal set di dati CDC al set di dati di reporting

Autorizzazioni dell'account di servizio Managed Service for Apache Airflow

Concedi le autorizzazioni Dataflow all'account di servizio utilizzato in Managed Airflow (come configurato nella connessione tiktok_raw_dataflow). Consulta le istruzioni nella documentazione di Dataflow.

Inoltre, lo stesso account di servizio deve avere anche l'accesso a Secret Manager Accessor.

Impostazioni di importazione

Controlla le pipeline di dati Source to Raw e Raw to CDC tramite le impostazioni nel file src/TikTok/config/ingestion_settings.yaml. Questa sezione descrive i parametri di ogni pipeline di dati.

Tabelle non elaborate di origine

Questa sezione contiene voci che controllano la modalità di recupero dei dati da TikTok e la posizione in cui i dati vengono inseriti nel set di dati non elaborati. Ogni voce corrisponde a una tabella non elaborata che contiene i dati recuperati dall'API TikTok per l'entità. In base a questi parametri di configurazione, Cortex Framework crea DAG Airflow che eseguono pipeline Dataflow per elaborare i dati dalle API TikTok.

I seguenti parametri controllano le impostazioni di Source to Raw per ogni voce:

Parametro Descrizione
base_table Tabella nel set di dati non elaborati in cui sono archiviati i dati di un'entità(ad esempio, i dati "Annuncio").
load_frequency La frequenza con cui viene eseguito un DAG per questa entità per processare i dati. Per informazioni dettagliate sui valori possibili, consulta la documentazione di Airflow.
schema_file File di schema nella directory src/table_schema che mappa i campi di risposta dell'API ai nomi delle colonne della tabella di destinazione.
partition_details Facoltativo: Se vuoi che questa tabella sia partizionata per motivi di prestazioni. Per ulteriori informazioni, consulta Partizionamento delle tabelle.
cluster_details Facoltativo: Se vuoi che questa tabella sia raggruppata per motivi di prestazioni. Per ulteriori informazioni, consulta Impostazioni cluster.

Tabelle CDC non elaborate

Questa sezione contiene voci che controllano la modalità di spostamento dei dati dalle tabelle non elaborate alle tabelle CDC. Ogni voce corrisponde a una tabella CDC (che a sua volta corrisponde a un'entità menzionata per la Source to Raw table).

I seguenti parametri controllano le impostazioni di Raw to CDC per ogni voce:

Parametro Descrizione
base_table Tabella nel set di dati CDC in cui sono archiviati i dati non elaborati dopo la trasformazione CDC (ad esempio,auction_ad_performance).
load_frequency La frequenza con cui viene eseguito un DAG per questa entità per popolare la tabella CDC. Per informazioni dettagliate sui valori possibili, consulta la documentazione di Airflow.
row_identifiers Elenco di colonne (separate da virgole) che formano un record univoco per questa tabella.
partition_details Facoltativo: Se vuoi che questa tabella sia partizionata per motivi di prestazioni. Per ulteriori informazioni, consulta Partizionamento delle tabelle.
cluster_details Facoltativo: Se vuoi che questa tabella sia raggruppata per motivi di prestazioni. Per ulteriori informazioni, consulta Impostazioni cluster.

Impostazioni report

Configura e controlla la modalità con cui Cortex Framework genera i dati per il livello di reporting finale di TikTok utilizzando il file delle impostazioni di reporting src/TikTok/config/reporting_settings.yaml. Questo file controlla la modalità di generazione degli oggetti BigQuery del livello di reporting (tabelle, viste, funzioni o stored procedure).

Per ulteriori informazioni, consulta Personalizzare il file delle impostazioni di reporting.

Passaggi successivi