Integrasi dengan TikTok

Halaman ini menjelaskan konfigurasi yang diperlukan untuk mengambil data dari TikTok sebagai sumber data beban kerja pemasaran Cortex Framework Data Foundation.

TikTok adalah aplikasi media sosial populer yang dikenal dengan video pendek yang dapat digunakan Cortex Framework untuk menganalisis performa pemasaran secara keseluruhan. Dengan menggabungkan data dari TikTok dan berbagai sumber, Anda dapat memperoleh pemahaman yang lebih komprehensif tentang target audiens dan efektivitas kampanye media sosial di berbagai platform.

Diagram berikut menjelaskan cara data TikTok tersedia melalui beban kerja pemasaran Cortex Framework Data Foundation:

Sumber data TikTok

Gambar 1. Sumber data TikTok.

File konfigurasi

File config.json mengonfigurasi setelan yang diperlukan untuk terhubung ke sumber data guna mentransfer data dari berbagai beban kerja. File ini berisi parameter berikut untuk TikTok:

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

Tabel berikut menjelaskan nilai untuk setiap parameter pemasaran:

Parameter Arti Nilai Default Deskripsi
marketing.deployTikTok Men-deploy TikTok true Jalankan deployment untuk sumber data TikTok.
marketing.TikTok.deployCDC Men-deploy skrip CDC untuk TikTok true Buat skrip pemrosesan CDC TikTok untuk dijalankan sebagai DAG di Managed Service untuk Apache Airflow.
marketing.TikTok.datasets.cdc Set data CDC untuk TikTok Set data CDC untuk TikTok.
marketing.TikTok.datasets.raw Set data mentah untuk TikTok Set data mentah untuk TikTok.
marketing.TikTok.datasets.reporting Set data pelaporan untuk TikTok "REPORTING_TikTok" Set data pelaporan untuk TikTok.

Model Data

Bagian ini menjelaskan Model Data TikTok menggunakan Diagram Hubungan Entity (ERD).

Diagram Hubungan Entity untuk TikTok

Gambar 2. TikTok: Diagram Hubungan Entitas.

Tampilan dasar

Objek ini adalah objek biru dalam ERD dan merupakan tampilan pada tabel CDC tanpa transformasi selain beberapa alias nama kolom. Lihat skrip di src/marketing/src/TikTok/src/reporting/ddls.

Tampilan pelaporan

Ini adalah objek hijau dalam ERD dan merupakan tampilan pelaporan yang berisi metrik gabungan. Lihat skrip di src/marketing/src/TikTok/src/reporting/ddls.

Koneksi API

Cortex Framework menggunakan TikTok Reporting API, versi v1.3, sebagai sumber resmi untuk data TikTok. Cortex Framework menggunakan mode sinkron dan memanggil API Pelaporan Dasar untuk mengambil metrik performa iklan dan grup iklan. Hal ini memastikan bahwa Cortex Framework memiliki akses ke informasi yang akurat dan terbaru dari TikTok, sehingga memungkinkan analisis dan pelaporan data yang efektif.

Untuk mengetahui informasi selengkapnya tentang koneksi API, lihat TikTok Reporting API.

Autentikasi akun

Untuk mengonfigurasi akun TikTok dan autentikasi akun, ikuti langkah-langkah berikut:

  1. Siapkan Akun Developer TikTok, jika Anda belum memilikinya.
  2. Buat aplikasi untuk integrasi Cortex Framework. Lihat TikTok API for Business untuk mengetahui informasi selengkapnya. Pastikan Anda memilih dua cakupan berikut untuk aplikasi:
    • Ad Account Management/Ad Account Information
    • Reporting/All
  3. Dapatkan ID aplikasi, secret, dan token akses jangka panjang seperti yang dijelaskan dalam panduan TikTok, lalu simpan masing-masing di Secret Manager dengan nama berikut:
    • ID Aplikasi: cortex_tiktok_app_id
    • Secret: cortex_tiktok_app_secret
    • Token akses jangka panjang: cortex_tiktok_access_token

Keaktualan dan Penundaan Data

Sebagai aturan umum, keaktualan data untuk sumber data Cortex Framework dibatasi oleh apa yang diizinkan oleh koneksi upstream, serta frekuensi eksekusi DAG Anda. Sesuaikan frekuensi eksekusi DAG agar selaras dengan frekuensi upstream, batasan resource, dan kebutuhan bisnis Anda.

Dengan TikTok Marketing API, sebagian besar data (kecuali konversi) tersedia hampir secara real time.

Koneksi Managed Airflow

Buat koneksi berikut di Managed Airflow. Untuk mengetahui detail selengkapnya, lihat dokumentasi Mengelola koneksi Airflow.

Nama Koneksi Tujuan
tiktok_raw_dataflow Untuk TikTok API > BigQuery Set Data Mentah
tiktok_cdc_bq Untuk transfer set data Raw > CDC
tiktok_reporting_bq Untuk set data CDC > Transfer set data pelaporan

Izin akun layanan Managed Service untuk Apache Airflow

Berikan izin Dataflow ke akun layanan yang digunakan di Managed Airflow (seperti yang dikonfigurasi di koneksi tiktok_raw_dataflow). Lihat petunjuk di dokumentasi Dataflow.

Selain itu, akun layanan yang sama juga harus memiliki akses Secret Manager Accessor.

Setelan penyerapan

Kontrol pipeline data Source to Raw dan Raw to CDC melalui setelan dalam file src/TikTok/config/ingestion_settings.yaml. Bagian ini menjelaskan parameter setiap pipeline data.

Sumber ke tabel mentah

Bagian ini memiliki entri yang mengontrol cara pengambilan data dari TikTok dan tempat data berakhir dalam set data mentah. Setiap entri sesuai dengan satu tabel mentah yang memiliki data yang diambil dari TikTok API untuk entity tersebut. Berdasarkan parameter konfigurasi ini, Cortex Framework membuat DAG Airflow yang menjalankan pipeline Dataflow untuk memproses data dari TikTok API.

Parameter berikut mengontrol setelan untuk Source to Raw untuk setiap entri:

Parameter Deskripsi
base_table Tabel dalam set data Mentah tempat data untuk entitas disimpan(misalnya, data 'Iklan').
load_frequency Seberapa sering DAG dijalankan untuk entitas ini guna memproses data. Lihat dokumentasi Airflow untuk mengetahui detail tentang kemungkinan nilai.
schema_file File skema di direktori src/table_schema yang memetakan kolom respons API ke nama kolom tabel tujuan.
partition_details Opsional: Jika Anda ingin tabel ini dipartisi untuk pertimbangan performa. Untuk mengetahui informasi selengkapnya, lihat Partisi Tabel.
cluster_details Opsional: Jika Anda ingin tabel ini dikelompokkan untuk pertimbangan performa. Untuk mengetahui informasi selengkapnya, lihat Setelan Cluster.

Tabel mentah ke CDC

Bagian ini memiliki entri yang mengontrol cara data dipindahkan dari tabel mentah ke tabel CDC. Setiap entri sesuai dengan tabel CDC (yang pada gilirannya sesuai dengan entity yang disebutkan untuk Source to Raw table.)

Parameter berikut mengontrol setelan untuk Raw to CDC untuk setiap entri:

Parameter Deskripsi
base_table Tabel dalam set data CDC tempat data mentah setelah transformasi CDC disimpan (misalnya,auction_ad_performance)
load_frequency Seberapa sering DAG untuk entitas ini dijalankan untuk mengisi tabel CDC. Untuk mengetahui informasi selengkapnya, lihat dokumentasi Airflow untuk mengetahui detail tentang kemungkinan nilai.
row_identifiers Daftar kolom (dipisahkan dengan koma) yang membentuk rekaman unik untuk tabel ini.
partition_details Opsional: Jika Anda ingin tabel ini dipartisi untuk pertimbangan performa. Untuk mengetahui informasi selengkapnya, lihat Partisi Tabel.
cluster_details Opsional: Jika Anda ingin tabel ini dikelompokkan untuk pertimbangan performa. Untuk mengetahui informasi selengkapnya, lihat Setelan Cluster.

Setelan pelaporan

Konfigurasi dan kontrol cara Cortex Framework membuat data untuk lapisan pelaporan akhir TikTok menggunakan file setelan pelaporansrc/TikTok/config/reporting_settings.yaml. File ini mengontrol cara objek BigQuery lapisan pelaporan (tabel, tampilan, fungsi, atau prosedur tersimpan) dibuat.

Untuk mengetahui informasi selengkapnya, lihat Menyesuaikan file setelan pelaporan.

Apa langkah selanjutnya?