Memuat data Iklan Facebook ke BigQuery

Anda dapat memuat data dari Iklan Facebook ke BigQuery menggunakan konektor BigQuery Data Transfer Service untuk Iklan Facebook. Dengan BigQuery Data Transfer Service, Anda dapat menjadwalkan tugas transfer berulang yang menambahkan data terbaru dari Iklan Facebook ke BigQuery.

Laporan yang didukung

BigQuery Data Transfer Service untuk Iklan Facebook mendukung transfer laporan Iklan Facebook berikut:

• Ads
• AdInsights
• AdInsightsActions

Untuk mengetahui informasi tentang cara laporan Iklan Facebook diubah menjadi tabel dan tabel virtual BigQuery, lihat Transformasi data Iklan Facebook.

Batasan

Transfer data Iklan Facebook tunduk pada batasan berikut:

• Waktu interval minimum antar-transfer data Iklan Facebook berulang adalah 24 jam. Interval default untuk transfer data berulang adalah 24 jam.
• BigQuery Data Transfer Service untuk Iklan Facebook hanya mendukung kumpulan tabel tetap. Laporan kustom tidak didukung.
• Transfer data Iklan Facebook memiliki durasi maksimum enam jam. Transfer gagal jika memerlukan waktu lebih lama dari durasi maksimum ini.
• Transfer inkremental tidak didukung untuk tabel AdInsights dan AdInsightsActions. Saat Anda membuat transfer data yang mencakup tabel AdInsights dan AdInsightsActions, dan Anda menentukan tanggal di Opsi jadwal, semua data yang tersedia untuk tanggal tersebut akan ditransfer.
• BigQuery Data Transfer Service mendukung periode perpanjangan satu hari untuk tabel AdInsights dan AdInsightsActions. Periode refresh mengacu pada jumlah hari saat transfer data akan mengambil data sumber. Saat Anda menjalankan transfer data untuk pertama kalinya, transfer data akan mengambil semua data sumber yang tersedia dalam periode refresh.

• Masa berlaku token akses pengguna yang berumur panjang yang diperlukan untuk transfer Iklan Facebook berakhir setelah 60 hari.

  Jika masa berlaku token akses pengguna yang berumur panjang telah habis, Anda dapat memperoleh token baru dengan membuka detail transfer data dan mengklik Edit. Di halaman edit transfer, ikuti langkah-langkah yang sama dalam Prasyarat Iklan Facebook untuk membuat token akses pengguna yang berlaku lama.

• Jika lampiran jaringan dan instance virtual machine (VM) yang dikonfigurasi berada di region yang berbeda, mungkin ada pergerakan data lintas region saat Anda mentransfer data dari Iklan Facebook.

Penyerapan data dari transfer Iklan Facebook

Untuk tabel AdInsights dan AdInsightsAction, partisi tabel tempat data dimuat sesuai dengan tanggal dari sumber data.

Untuk tabel AdAccounts, snapshot diambil sekali sehari dan disimpan di partisi tanggal terakhir transfer dijalankan. Jendela muat ulang tidak berlaku untuk tabel AdAccounts.

Sebelum memulai

Bagian berikut menjelaskan langkah-langkah yang perlu Anda lakukan sebelum membuat transfer data Iklan Facebook.

Prasyarat Iklan Facebook

Pastikan Anda memiliki informasi Iklan Facebook berikut saat membuat transfer data Iklan Facebook.

Untuk mendapatkan clientID dan clientSecret, lakukan langkah-langkah berikut:

1. Buat aplikasi developer Facebook dengan jenis aplikasi Business.
2. Di dasbor Aplikasi Facebook, klik Setelan Aplikasi > Dasar, lalu temukan ID aplikasi dan secret aplikasi yang sesuai dengan aplikasi.

Untuk mendapatkan token akses pengguna yang berlaku lama, yang juga dikenal sebagai token refresh, lakukan langkah-langkah berikut:

1. Di Google Cloud konsol, lanjutkan langkah-langkah untuk membuat transfer Iklan Facebook.

2. Di bagian Detail Sumber Data, salin URI pengalihan yang tercantum setelah kolom Token Refresh.

   

3. Klik dasbor Aplikasi Facebook, lalu klik Siapkan di bagian Login Facebook untuk Bisnis.

   

4. Di halaman Setelan, masukkan URL pengalihan di kolom URI Pengalihan OAuth yang Valid, lalu klik Simpan.

5. Kembali ke konsol Google Cloud . Di bagian Detail Sumber Data, klik Beri Otorisasi. Anda akan dialihkan ke halaman autentikasi Facebook.

   

6. Pilih aplikasi developer Facebook untuk memberi otorisasi pada akun yang terhubung dengan BigQuery Data Transfer Service.

7. Setelah selesai, klik Oke untuk kembali ke konsol Google Cloud . Token akses pengguna yang berlaku lama kini diisi dalam konfigurasi transfer.

Masa berlaku token akses pengguna yang berumur panjang berakhir setelah 60 hari. Untuk mengetahui informasi tentang cara mendapatkan token akses pengguna yang baru dan berlaku lama, lihat Batasan.

Alternatif token refresh

Atau, Anda dapat memberikan token refresh saat membuat transfer data jika Anda telah mendapatkannya menggunakan salah satu metode berikut:

• Buat token akses pengguna berumur panjang menggunakan Graph API. Izin ads_management, ads_read, dan business_management diperlukan untuk token yang valid untuk transfer data.
• Buat token pengguna sistem. Token pengguna sistem memungkinkan Anda menambahkan aset secara manual, seperti akun iklan, untuk disertakan dalam transfer data. Jika masa berlaku token pengguna sistem telah berakhir, Anda harus memperbarui konfigurasi transfer secara manual dengan kredensial baru. Anda juga memiliki opsi untuk membuat token yang tidak akan habis masa berlakunya saat Anda membuat token pengguna sistem. Untuk mengetahui informasi selengkapnya, lihat Token akses yang didukung.

Prasyarat BigQuery

• Pastikan Anda telah menyelesaikan semua tindakan yang diperlukan untuk mengaktifkan BigQuery Data Transfer Service.
• Buat set data BigQuery untuk menyimpan data Anda.
• Jika ingin menyiapkan notifikasi operasi transfer untuk Pub/Sub, pastikan Anda memiliki izin Identity and Access Management (IAM) pubsub.topics.setIamPolicy. Jika Anda hanya menyiapkan notifikasi email, izin Pub/Sub tidak diperlukan. Untuk mengetahui informasi selengkapnya, lihat Notifikasi operasi BigQuery Data Transfer Service.

Peran BigQuery yang diperlukan

Untuk mendapatkan izin yang diperlukan untuk membuat transfer, minta administrator Anda untuk memberi Anda peran IAM BigQuery Admin (roles/bigquery.admin). Untuk mengetahui informasi selengkapnya tentang cara memberikan peran, lihat Mengelola akses ke project, folder, dan organisasi.

Peran bawaan ini berisi izin yang diperlukan untuk membuat transfer. Untuk melihat izin yang benar-benar diperlukan, luaskan bagian Izin yang diperlukan:

Anda mungkin juga bisa mendapatkan izin ini dengan peran khusus atau peran bawaan lainnya.

Membuat transfer data Iklan Facebook

Pilih salah satu opsi berikut:

bq mk
    --transfer_config
    --project_id=PROJECT_ID
    --data_source=DATA_SOURCE
    --display_name=DISPLAY_NAME
    --target_dataset=DATASET
    --params='PARAMETERS'

bq mk
--transfer_config
--target_dataset=mydataset
--data_source=facebook_ads
--display_name='My Transfer'
--params='{"connector.authentication.oauth.clientId": "1650000000",
    "connector.authentication.oauth.clientSecret":"TBA99550",
    "connector.authentication.oauth.refreshToken":"abcdef"}'

Memecahkan masalah konfigurasi transfer

Jika Anda mengalami masalah saat menyiapkan transfer data Iklan Facebook, coba langkah-langkah pemecahan masalah berikut:

• Periksa apakah token akses pengguna Anda telah habis masa berlakunya menggunakan Facebook Access Token Debugger. Masa berlaku token akses pengguna yang aktif lama akan berakhir setelah 60 hari. Jika token akses pengguna yang berlaku lama telah habis masa berlakunya, buka detail transfer, lalu klik Edit untuk mengubah konfigurasi transfer. Di halaman edit transfer, ikuti langkah-langkah yang sama di Prasyarat Iklan Facebook untuk membuat yang baru.
• Pastikan token akses pengguna yang berumur panjang dibuat dengan izin yang diperlukan - ads_management, ads_read, dan business_management. Jika tidak, ikuti langkah-langkah di Prasyarat Iklan Facebook untuk membuat token akses pengguna yang berlaku lama.
• Periksa tab Tindakan yang Diperlukan di dasbor Aplikasi Facebook untuk melihat item yang memerlukan perhatian.

Anda mungkin mengalami pesan error berikut terkait error batas frekuensi Meta API:

Error: There have been too many calls from this ad-account. Wait a bit and try again.

Penyelesaian: Pastikan tidak ada alur kerja paralel yang menggunakan aplikasi atau kredensial yang sama. Jika error ini terus terjadi, coba tingkatkan izin Anda ke Akses Lanjutan untuk mendapatkan kuota pembatasan frekuensi yang lebih besar. Untuk mengetahui informasi selengkapnya, lihat Pembatasan Kapasitas Marketing API.

Pesan metrik pemantauan umum

Anda juga dapat memeriksa metrik pemantauan BigQuery Data Transfer Service untuk menentukan penyebab kegagalan transfer data. Tabel berikut mencantumkan beberapa pesan ERROR_CODE umum untuk transfer data Iklan Facebook.

Harga

Tidak ada biaya untuk mentransfer data Iklan Facebook ke BigQuery selama fitur ini dalam versi Pratinjau.

Langkah berikutnya

• Pelajari lebih lanjut BigQuery Data Transfer Service.
• Pelajari lebih lanjut cara menangani transfer, seperti melihat konfigurasi dan histori pelaksanaan.
• Pelajari cara memuat data dengan operasi lintas-cloud.