Integrasi dengan TikTok

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

TikTok adalah aplikasi media sosial populer yang dikenal dengan video berdurasi singkat yang dapat memberikan data kepada Framework Cortex untuk menganalisis performa pemasaran secara keseluruhan. Dengan menggabungkan data dari TikTok dan berbagai sumber, Anda bisa mendapatkan pemahaman yang lebih komprehensif tentang target audiens dan efektivitas kampanye media sosial Anda 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 Cloud Composer.
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 Entitas (ERD).

Diagram Hubungan Entitas untuk TikTok

Gambar 2. TikTok: Diagram Hubungan Entitas.

Tampilan dasar

Ini adalah objek biru di 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 di 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 tepercaya untuk data TikTok. Cortex Framework menggunakan mode sinkron dan memanggil Basic Reporting API untuk mengambil metrik performa untuk iklan dan grup iklan. Hal ini memastikan bahwa Cortex Framework memiliki akses ke informasi terbaru dan akurat dari TikTok, sehingga memungkinkan analisis dan pelaporan data yang efektif.

Untuk 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 untuk Bisnis untuk mengetahui informasi selengkapnya. Pastikan Anda memilih dua opsi berikut dalam cakupan untuk aplikasi:
    • Ad Account Management/Ad Account Information
    • Reporting/All
  3. Dapatkan ID aplikasi, rahasia, dan token akses jangka panjang seperti yang dijelaskan dalam panduan TikTok, dan 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 (tidak termasuk konversi) tersedia hampir secara real time.

Koneksi Cloud Composer

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

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

Izin akun layanan Cloud Composer

Berikan izin Dataflow ke akun layanan yang digunakan di Cloud Composer (seperti yang dikonfigurasi dalam koneksi tiktok_raw_dataflow). Lihat petunjuk di dokumentasi Dataflow.

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

Setelan proses transfer

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 di 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 informasi selengkapnya, lihat Setelan Cluster.

Tabel mentah ke CDC

Bagian ini memiliki entri yang mengontrol cara data berpindah 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 entity ini berjalan untuk mengisi tabel CDC. Untuk informasi selengkapnya, lihat dokumentasi Airflow untuk mengetahui detail tentang kemungkinan nilai.
row_identifiers Daftar kolom (dipisahkan koma) yang membentuk kumpulan data 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 informasi selengkapnya, lihat Setelan Cluster.

Setelan pelaporan

Konfigurasikan dan kontrol cara Cortex Framework menghasilkan 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) dihasilkan.

Untuk mengetahui informasi selengkapnya, lihat Menyesuaikan file setelan pelaporan.

Apa langkah selanjutnya?