Menjadwalkan transfer Salesforce Marketing Cloud
Dengan konektor BigQuery Data Transfer Service untuk Salesforce Marketing Cloud, Anda dapat menjadwalkan dan mengelola tugas pemuatan berulang secara otomatis dari Salesforce Marketing Cloud ke BigQuery.
Sebelum memulai
Bagian berikut menjelaskan langkah-langkah yang perlu dilakukan sebelum membuat transfer Salesforce Marketing Cloud.
Prasyarat Salesforce Marketing Cloud
Anda harus memiliki informasi berikut saat membuat transfer Salesforce Marketing Cloud:
Nama Parameter | Deskripsi |
---|---|
subdomain |
Subdomain API |
instance |
Instance server API |
clientId |
Client ID integrasi aplikasi |
clientSecret |
Rahasia klien integrasi aplikasi |
Langkah-langkah berikut menunjukkan cara mendapatkan informasi yang diperlukan untuk melakukan transfer Salesforce Marketing Cloud:
- Instal paket integrasi API jenis server-ke-server.
Catat client ID, rahasia klien, dan subdomain di bagian Komponen
di halaman detail paket.
- Subdomain adalah bagian dari URI dasar. Misalnya, dalam URI dasar autentikasi
https://SUBDOMAIN.auth.marketingcloudapis.com/
, SUBDOMAIN adalah nilai subdomain Anda. - Untuk mengetahui informasi selengkapnya, lihat Integrasi Server-ke-Server dengan Jenis Pemberian Kredensial Klien.
- Subdomain adalah bagian dari URI dasar. Misalnya, dalam URI dasar autentikasi
- Temukan instance server API Anda di URL setelah login ke
aplikasi Salesforce Marketing Cloud. Nilai instance mencakup
s
yang diikuti dengan nilai numerik. Misalnya, untuk URLhttps://mc.s4.exacttarget.com/
, nilai instance adalahs4
. Untuk informasi selengkapnya, lihat Menemukan lokasi stack untuk akun Marketing Cloud.
Anda juga harus mengonfigurasi setelan izin cakupan untuk mengizinkan transfer Salesforce Marketing Cloud:
Login ke aplikasi Salesforce Marketing Cloud.
Luaskan menu drop-down profil Anda, lalu klik Penyiapan.
Di menu navigasi pada bagian Platform Tools, klik Apps > Paket terinstal.
Pilih paket yang diinstal untuk mengubah setelannya.
Di bagian Komponen, klik Edit.
Pilih opsi Read untuk cakupan berikut:
- Konten Tersimpan
- Perjalanan
- Callbacks
- Campaign
Klik Save.
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
. Izin Pub/Sub tidak diperlukan jika Anda hanya menyiapkan notifikasi email. 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 ditetapkan 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.
Menyiapkan transfer data Salesforce Marketing Cloud
Untuk membuat transfer data Salesforce Marketing Cloud:
Konsol
Buka halaman BigQuery di konsol Google Cloud.
Di panel navigasi, klik Transfer data > Buat transfer.
Di bagian Jenis sumber, untuk Sumber, pilih Salesforce Marketing Cloud.
Di bagian Transfer config name, untuk Display name, masukkan nama untuk transfer.
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.
Di bagian Destination settings, untuk Dataset, pilih set data yang Anda buat untuk menyimpan data.
Di bagian Detail sumber data, lakukan hal berikut:
- Untuk API Subdomain, masukkan subdomain API.
- Untuk instance API, masukkan nilai instance API.
- Untuk Client-ID, masukkan client ID integrasi aplikasi.
- Untuk Rahasia Klien, masukkan rahasia klien integrasi aplikasi.
Di menu Service Account, pilih 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.
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.
Klik Save.
Saat transfer ini berjalan, BigQuery Data Transfer Service akan otomatis mengisi tabel berikut berdasarkan antarmuka REST.
Campaigns
Categories
EventDefinitions
Journeys
JourneyActivities
SendDefinitions
Subscriptions
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'
Ganti kode berikut:
- 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,
saphana
). - 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 Salesforce Marketing Cloud:connector.subdomain
: Subdomain API.connector.instance
: Nilai instance API.connector.authentication.oauth.clientId
: Nama ID aplikasi untuk klien OAuth.connector.authentication.oauth.clientSecret
: Rahasia aplikasi untuk klien OAuth.
Misalnya, perintah berikut akan membuat transfer Salesforce Marketing Cloud dalam project default dengan semua parameter yang diperlukan:
bq mk \ --transfer_config \ --target_dataset=mydataset \ --data_source=salesforce_marketing \ --display_name='My Transfer' \ --params='{"connector.subdomain": "abcd", "connector.instance": "x", "connector.authentication.oauth.clientId": "1234567890", "connector.authentication.oauth.clientSecret":"ABC12345"}'
API
Gunakan metode projects.locations.transferConfigs.create
dan berikan instance resource TransferConfig
.
Memecahkan masalah penyiapan transfer
Jika Anda mengalami masalah saat menyiapkan transfer Salesforce Marketing Cloud, coba langkah-langkah pemecahan masalah berikut:
- Pastikan autentikasi yang dikonfigurasi untuk paket integrasi API dikonfigurasi ke Server-ke-server.
- Pastikan aplikasi autentikasi dikonfigurasi dengan izin yang diperlukan di bagian Cakupan.
Harga
Tidak ada biaya untuk mentransfer data Salesforce Marketing Cloud ke BigQuery saat fitur ini berada dalam Pratinjau.
Langkah selanjutnya
- Untuk ringkasan BigQuery Data Transfer Service, lihat Pengantar BigQuery Data Transfer Service.
- Untuk informasi tentang cara menggunakan transfer, termasuk mendapatkan informasi tentang konfigurasi transfer, mencantumkan konfigurasi transfer, dan melihat histori proses transfer, lihat Mengelola transfer.
- Pelajari cara memuat data dengan operasi lintas-cloud.