Jadwalkan transfer Iklan Facebook

Pratinjau

Fitur ini tunduk pada "Persyaratan Penawaran Pra-GA" di bagian Persyaratan Layanan Umum dalam Persyaratan Khusus Layanan. Fitur pra-GA tersedia "sebagaimana adanya" dan mungkin memiliki dukungan terbatas. Untuk mengetahui informasi selengkapnya, lihat deskripsi tahap peluncuran.

Catatan: Untuk mendapatkan dukungan atau memberikan masukan terkait fitur ini, hubungi [e-mail].

BigQuery Data Transfer Service untuk Facebook Ads memungkinkan Anda menjadwalkan dan mengelola tugas pemuatan berulang secara otomatis dari Iklan Facebook ke BigQuery.

Batasan

Transfer Iklan Facebook tunduk pada batasan berikut:

• Waktu interval minimum antara transfer Iklan Facebook berulang adalah 15 menit. Interval default untuk transfer berulang adalah 24 jam.
• BigQuery Data Transfer Service untuk Iklan Facebook hanya mendukung kumpulan tabel tetap. Laporan kustom tidak didukung.
• Transfer Iklan Facebook memiliki durasi maksimum enam jam. Transfer akan gagal jika memakan waktu lebih lama dari durasi maksimum ini.
• Transfer inkremental tidak didukung.
• BigQuery Data Transfer Service mendukung transfer data hingga satu hari (kemarin) ke tabel AdInsights dan AdInsightsActions.

Sebelum memulai

Bagian berikut menjelaskan langkah-langkah yang perlu dilakukan sebelum membuat transfer Iklan Facebook.

Prasyarat Iklan Facebook

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

Parameter Iklan Facebook	Deskripsi
clientID	Nama ID aplikasi untuk klien OAuth 2.0.
clientSecret	Rahasia aplikasi untuk klien OAuth 2.0.
refreshToken	Token akses pengguna yang berumur panjang, juga dikenal sebagai token refresh.

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

1. Buat aplikasi developer Facebook dengan jenis aplikasi Business.
2. Di Facebook App Dashboard, klik App Settings > Basic dan temukan ID aplikasi dan rahasia aplikasi yang sesuai dengan aplikasi.

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

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

2. Di bagian Data Source Details, salin URI pengalihan yang tercantum setelah kolom Refresh Token.

   

3. Klik dasbor Facebook App, lalu klik Set up di bagian Facebook login for Business.

   

4. Di halaman Settings, masukkan URL alihan di kolom Valid OAuth Redirect URI, lalu klik Save.

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

   

6. Pilih aplikasi developer Facebook untuk mengizinkan akun yang terhubung dengan BigQuery Data Transfer Service.

7. Setelah selesai, klik Got it untuk kembali ke konsol Google Cloud. Token akses jangka panjang kini diisi di konfigurasi transfer.

Atau, Anda dapat membuat token akses pengguna yang berumur panjang menggunakan Graph API. Izin ads_management, ads_read, dan business_management diperlukan agar token yang valid untuk transfer.

Token akses pengguna yang berumur panjang akan habis masa berlakunya setelah 60 hari.

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 Anda perlukan untuk membuat transfer, minta administrator untuk memberi Anda peran IAM BigQuery Admin (roles/bigquery.admin). Untuk mengetahui informasi selengkapnya tentang cara memberikan peran, lihat Mengelola akses.

Peran yang telah ditentukan ini berisi izin yang diperlukan untuk membuat transfer. Untuk melihat izin yang benar-benar diperlukan, perluas bagian Izin yang diperlukan:

Izin yang diperlukan

Izin berikut diperlukan untuk membuat transfer:

• bigquery.transfers.update pada pengguna
• bigquery.datasets.get di set data target
• bigquery.datasets.update di set data target

Anda mung juga bisa mendapatkan izin ini dengan peran khusus atau peran bawaanlainnya.

Buat transfer data Iklan Facebook

Pilih salah satu opsi berikut:

Konsol

1. Di konsol Google Cloud, buka halaman BigQuery Studio.

   Buka BigQuery Studio

2. Klik Transfer data > Buat transfer.

3. Di bagian Source type, untuk Source, pilih Facebook Ads.

4. Di bagian Transfer config name, untuk Display name, masukkan nama untuk transfer.

5. Di bagian Opsi jadwal, lakukan tindakan berikut:

   • Dalam daftar Repeat frekuensi, pilih opsi untuk menentukan seberapa sering transfer ini berjalan. Untuk menentukan frekuensi pengulangan kustom, pilih Kustom. Jika Anda memilih On-demand, transfer ini akan berjalan saat Anda memicu transfer secara manual.

   • Jika berlaku, pilih Start now atau Start at set time dan masukkan tanggal mulai dan waktu proses.

6. Di bagian Destination settings, untuk Dataset, pilih set data yang Anda buat untuk menyimpan data.

7. Di bagian Detail sumber data, lakukan hal berikut:

   • Untuk Client-ID, masukkan ID aplikasi.
   • Untuk Rahasia klien, masukkan rahasia aplikasi.
   • Untuk Token refresh, masukkan ID token akses pengguna yang berumur panjang dengan mengklik Authorize.

   Untuk mengetahui informasi tentang cara mengambil nilai ini, lihat Prasyarat Iklan Facebook.

8. Opsional: Di menu Akun Layanan, pilih akun layanan dari akun layanan yang terkait dengan project Google Cloud Anda. Akun layanan yang dipilih harus memiliki peran yang diperlukan untuk menjalankan transfer ini.

   Jika Anda login dengan identitas gabungan, akun layanan diperlukan untuk membuat transfer. Jika Anda login dengan Akun Google, akun layanan untuk transfer bersifat opsional.

   Untuk informasi selengkapnya tentang cara menggunakan akun layanan dengan transfer data, lihat Menggunakan akun layanan.

9. Opsional: Di bagian Opsi notifikasi, lakukan hal berikut:

   • Untuk mengaktifkan notifikasi email, klik tombol Notifikasi email. Jika Anda mengaktifkan opsi ini, administrator transfer akan menerima notifikasi email saat proses transfer gagal.
   • Guna mengaktifkan notifikasi run Pub/Sub untuk transfer ini, klik tombol Notifikasi Pub/Sub. Anda dapat memilih nama topic, atau mengklik Create a topic untuk membuatnya.

10. Klik Save.

Saat transfer ini berjalan, BigQuery Data Transfer Service akan otomatis mengisi tabel berikut.

Nama Tabel	Deskripsi
AdAccounts	Akun iklan yang tersedia untuk pengguna.
AdInsights	Laporan analisis iklan untuk semua akun iklan.
AdInsightsActions	Laporan tindakan analisis iklan untuk semua akun iklan.

bq

Masukkan perintah bq mk dan berikan tanda pembuatan transfer --transfer_config:

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

Dengan keterangan:

• PROJECT_ID (opsional): project ID Google Cloud Anda. Jika --project_id tidak diberikan untuk menentukan project tertentu, project default akan digunakan.
• DATA_SOURCE: sumber data (misalnya, facebook-ads).
• DISPLAY_NAME: nama tampilan untuk konfigurasi transfer. Nama transfer dapat berupa nilai apa pun yang memungkinkan Anda mengidentifikasi transfer jika Anda perlu mengubahnya nanti.
• DATASET: set data target untuk konfigurasi transfer.
• PARAMETERS: parameter untuk konfigurasi transfer yang dibuat dalam format JSON. Contoh: --params='{"param":"param_value"}'. Berikut adalah parameter untuk transfer Iklan Facebook:
  • connector.authentication.oauth.clientId: Nama ID aplikasi untuk klien OAuth 2.0.
  • connector.authentication.oauth.clientSecret: Rahasia aplikasi untuk klien OAuth 2.0.
  • connector.authentication.oauth.refreshToken: ID token yang berumur panjang.

Misalnya, perintah berikut akan membuat transfer Iklan Facebook dalam project default dengan semua parameter yang diperlukan:

    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"}'
  

API

Gunakan metode projects.locations.transferConfigs.create dan berikan instance resource TransferConfig.

Memecahkan masalah konfigurasi transfer

Jika Anda mengalami masalah saat menyiapkan transfer Iklan Facebook, periksa tab Tindakan yang Diperlukan di dasbor Aplikasi Facebook untuk item apa pun yang perlu diperhatikan.

Harga

Transfer data Iklan Facebook ke BigQuery tidak dikenai biaya saat fitur ini berada dalam Pratinjau.

Langkah selanjutnya

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