TikTok-Integration

Auf dieser Seite werden die erforderlichen Konfigurationen beschrieben, um Daten aus TikTok als Datenquelle der Marketing-Arbeitslast der Cortex Framework Data Foundation zu verwenden.

TikTok ist eine beliebte Social-Media-App, die für Kurzvideos bekannt ist. Mit Cortex Framework können Daten zur Analyse der allgemeinen Marketingleistung erfasst werden. Wenn Sie Daten aus TikTok und verschiedenen anderen Quellen kombinieren, erhalten Sie ein umfassenderes Bild Ihrer Zielgruppe und der Effektivität Ihrer Social-Media-Kampagnen auf verschiedenen Plattformen.

Das folgende Diagramm zeigt, wie TikTok-Daten über die Marketing-Arbeitslast der Cortex Framework Data Foundation verfügbar sind:

TikTok-Datenquelle

Abbildung 1. TikTok-Datenquelle

Konfigurationsdatei

In der Datei config.json werden die Einstellungen konfiguriert, die für die Verbindung zu Datenquellen zur Übertragung von Daten aus verschiedenen Arbeitslasten erforderlich sind. Diese Datei enthält die folgenden Parameter für TikTok:

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

In der folgenden Tabelle wird der Wert für jeden Marketingparameter beschrieben:

Parameter Bedeutung Standardwert Beschreibung
marketing.deployTikTok TikTok bereitstellen true Führen Sie die Bereitstellung für die TikTok-Datenquelle aus.
marketing.TikTok.deployCDC CDC-Scripts für TikTok bereitstellen true Erstelle Verarbeitungsscripts für die TikTok-CDC, die als DAGs in Cloud Composer ausgeführt werden.
marketing.TikTok.datasets.cdc CDC-Datensatz für TikTok CDC-Datensatz für TikTok
marketing.TikTok.datasets.raw Rohdatensatz für TikTok Rohdatensatz für TikTok.
marketing.TikTok.datasets.reporting Datensatz für Berichte zu TikTok "REPORTING_TikTok" Datensatz für Berichte zu TikTok.

Datenmodell

In diesem Abschnitt wird das TikTok-Datenmodell anhand eines Entitäts-Beziehungs-Diagramms (ERD) beschrieben.

Entitätsbeziehungsdiagramm für TikTok

Abbildung 2 TikTok: Entity Relationship Diagram.

Basisansichten

Dies sind die blauen Objekte in der ERD. Sie sind Ansichten auf CDC-Tabellen ohne andere Transformationen als einige Aliasse für Spaltennamen. Scripts in src/marketing/src/TikTok/src/reporting/ddls ansehen

Berichtsdatenansichten

Dies sind die grünen Objekte in der ERD und Berichtsansichten, die zusammengefasste Messwerte enthalten. Scripts in src/marketing/src/TikTok/src/reporting/ddls ansehen

API-Verbindung

Das Cortex-Framework verwendet die TikTok-Melde-APIs der Version v1.3 als maßgebliche Quelle für TikTok-Daten. Cortex Framework verwendet den synchronen Modus und ruft Basic Reporting APIs auf, um Leistungsmesswerte für Anzeigen und Anzeigengruppen abzurufen. So hat Cortex Framework Zugriff auf aktuelle und korrekte Informationen von TikTok, was eine effektive Datenanalyse und Berichterstellung ermöglicht.

Weitere Informationen zur API-Verbindung finden Sie unter TikTok Reporting APIs.

Kontoauthentifizierung

So konfigurierst du ein TikTok-Konto und die Kontoauthentifizierung:

  1. Richten Sie ein TikTok-Entwicklerkonto ein, falls Sie noch keines haben.
  2. Erstellen Sie eine App für die Einbindung in das Cortex Framework. Weitere Informationen finden Sie unter TikTok API for Business. Wählen Sie in den Bereichen für die App die folgenden beiden aus:
    • Ad Account Management/Ad Account Information
    • Reporting/All
  3. Rufe die App-ID, das Secret und das langfristige Zugriffstoken ab, wie im TikTok-Leitfaden beschrieben, und speichere sie jeweils im Secret Manager mit den folgenden Namen:
    • App-ID: cortex_tiktok_app_id
    • Secret: cortex_tiktok_app_secret
    • Langfristiges Zugriffstoken: cortex_tiktok_access_token

Datenaktualität und Verzögerung

Im Allgemeinen ist die Datenaktualität für Cortex Framework-Datenquellen durch die Möglichkeiten der Upstream-Verbindung und die Häufigkeit der DAG-Ausführung begrenzt. Passen Sie die Ausführungshäufigkeit des DAG an die Upstream-Frequenz, die Ressourcenbeschränkungen und Ihre Geschäftsanforderungen an.

Mit der TikTok Marketing API sind die meisten Daten (außer Conversions) nahezu in Echtzeit verfügbar.

Cloud Composer-Verbindungen

Erstellen Sie die folgenden Verbindungen in Cloud Composer. Weitere Informationen finden Sie in der Dokumentation zum Verwalten von Airflow-Verbindungen.

Verbindungsname Purpose
tiktok_raw_dataflow Für TikTok API > BigQuery Rohdatensatz
tiktok_cdc_bq Für die Übertragung von Rohdatensätzen > CDC-Datensätzen
tiktok_reporting_bq Für CDC-Datensatz > Datenübertragung für Berichtsdatensatz

Berechtigungen für das Cloud Composer-Dienstkonto

Gewähren Sie dem in Cloud Composer verwendeten Dienstkonto (wie in der tiktok_raw_dataflow-Verbindung konfiguriert) Dataflow-Berechtigungen. Weitere Informationen finden Sie in der Dataflow-Dokumentation.

Außerdem sollte dasselbe Dienstkonto Zugriff als Secret Manager-Accessor haben.

Aufnahmeeinstellungen

Die Source to Raw- und Raw to CDC-Datenpipelines können über die Einstellungen in der Datei src/TikTok/config/ingestion_settings.yaml gesteuert werden. In diesem Abschnitt werden die Parameter der einzelnen Datenpipelines beschrieben.

Von der Quelle zu Rohtabellen

Dieser Abschnitt enthält Einträge, mit denen festgelegt wird, wie Daten von TikTok abgerufen werden und wo sie im Rohdatensatz landen. Jedem Eintrag entspricht eine Rohtabelle mit Daten, die für diese Entität aus der TikTok API abgerufen wurden. Basierend auf diesen Konfigurationsparametern erstellt das Cortex-Framework Airflow-DAGs, in denen Dataflow-Pipelines zum Verarbeiten von Daten aus TikTok-APIs ausgeführt werden.

Mit den folgenden Parametern werden die Einstellungen für Source to Raw für jeden Eintrag gesteuert:

Parameter Beschreibung
base_table Tabelle im Rohdatensatz, in der die Daten für eine Entität gespeichert sind(z. B. Anzeigendaten).
load_frequency Gibt an, wie oft ein DAG für dieses Element ausgeführt wird, um Daten zu verarbeiten. Weitere Informationen zu den möglichen Werten finden Sie in der Airflow-Dokumentation.
schema_file Schemadatei im Verzeichnis src/table_schema, die API-Antwortfelder den Spaltennamen der Zieltabelle zuordnet.
partition_details Optional:Gibt an, ob diese Tabelle aus Gründen der Leistung partitioniert werden soll. Weitere Informationen finden Sie unter Tabellenpartition.
cluster_details Optional:Wenn Sie möchten, dass diese Tabelle aus Gründen der Leistung gruppiert wird. Weitere Informationen finden Sie unter Clustereinstellungen.

Rohdaten in CDC-Tabellen

Dieser Abschnitt enthält Einträge, mit denen gesteuert wird, wie Daten aus Rohtabellen in CDC-Tabellen verschoben werden. Jeder Eintrag entspricht einer CDC-Tabelle, die wiederum einer Entität entspricht, die für die Source to Raw table erwähnt wird.

Die folgenden Parameter steuern die Einstellungen für Raw to CDC für jeden Eintrag:

Parameter Beschreibung
base_table Tabelle im CDC-Dataset,in der die Rohdaten nach der CDC-Transformation gespeichert werden (z. B. auction_ad_performance)
load_frequency Gibt an, wie oft ein DAG für diese Entität ausgeführt wird, um die CDC-Tabelle zu füllen. Weitere Informationen zu möglichen Werten finden Sie in der Airflow-Dokumentation.
row_identifiers Liste der Spalten (durch Kommas getrennt), die einen eindeutigen Datensatz für diese Tabelle bilden.
partition_details Optional:Wenn diese Tabelle aus Leistungsgründen partitioniert werden soll. Weitere Informationen finden Sie unter Tabellenpartition.
cluster_details Optional:Wenn Sie möchten, dass diese Tabelle aus Gründen der Leistung gruppiert wird. Weitere Informationen finden Sie unter Clustereinstellungen.

Berichtseinstellungen

Mit der Datei „Berichtseinstellungen“src/TikTok/config/reporting_settings.yaml können Sie konfigurieren und steuern, wie das Cortex-Framework Daten für die endgültige Berichtsebene von TikTok generiert. In dieser Datei wird festgelegt, wie BigQuery-Objekte der Berichtsebene (Tabellen, Ansichten, Funktionen oder gespeicherte Prozeduren) generiert werden.

Weitere Informationen finden Sie unter Datei mit Berichtseinstellungen anpassen.

Nächste Schritte