Menjadwalkan transfer Salesforce Marketing Cloud

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].

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 Anda lakukan sebelum membuat transfer data Salesforce Marketing Cloud.

Prasyarat Salesforce Marketing Cloud

Anda harus memiliki informasi berikut saat membuat transfer data 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 membuat transfer data Salesforce Marketing Cloud:

1. Instal paket integrasi API jenis server ke server. Catat client ID, rahasia klien, dan subdomain di bagian Components 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.
2. Temukan instance server API Anda di URL setelah Anda login ke aplikasi Salesforce Marketing Cloud. Nilai instance mencakup s, diikuti dengan nilai numerik. Misalnya, di URL https://mc.s4.exacttarget.com/, nilai instance adalah s4. Untuk mengetahui informasi selengkapnya, lihat Menemukan lokasi stack untuk akun Marketing Cloud.

Anda juga harus mengonfigurasi setelan izin cakupan untuk mengizinkan transfer data Salesforce Marketing Cloud:

1. Login ke aplikasi Salesforce Marketing Cloud.

2. Luaskan menu drop-down profil Anda, lalu klik Siapkan.

   

3. Di menu navigasi pada bagian Platform Tools, klik Apps > Installed packages.

4. Pilih paket yang diinstal untuk mengubah setelannya.

5. Di bagian Components, klik Edit.

6. Pilih opsi Baca untuk cakupan berikut:

   • Email
   • Konten Tersimpan
   • Perjalanan
   • Callbacks
   • Kampanye
   • Langganan

7. Klik Simpan.

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 diperlukan guna 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 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:

Izin yang diperlukan

Izin berikut diperlukan untuk membuat transfer:

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

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

Menyiapkan transfer data Salesforce Marketing Cloud

Untuk membuat transfer data Salesforce Marketing Cloud:

Konsol

1. Buka halaman Data transfers di konsol Google Cloud.

   Buka Data transfers

2. Klik Create transfer.

3. Di bagian Source type, untuk Source, pilih Salesforce Marketing Cloud.

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

   • Untuk Subdomain API, 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.

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

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

7. Di bagian Opsi jadwal, lakukan tindakan berikut:

   • Dalam daftar Repeat frequency, pilih opsi untuk menentukan frekuensi transfer data ini dijalankan. Untuk menentukan frekuensi pengulangan kustom, pilih Custom. 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.

8. Di menu Service Account, pilih service account yang terkait dengan project Google Cloud Anda. Akun layanan yang dipilih harus memiliki peran yang diperlukan untuk menjalankan transfer data ini.

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

   Untuk mengetahui 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.
   • Untuk mengaktifkan notifikasi operasi transfer Pub/Sub untuk transfer ini, klik tombol Notifikasi Pub/Sub. Anda dapat memilih nama topik, atau klik Create a topic untuk membuatnya.

10. Klik Simpan.

Saat transfer data 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 flag 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 data dapat berupa nilai apa pun yang memungkinkan Anda mengidentifikasi transfer jika 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 data Salesforce Marketing Cloud di 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 data 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.

Pesan error

Error: invalid_grant. The client's IP address is unauthorized for this account. Allowlist the client's IP address in Marketing Cloud Administration.

Penyelesaian: Coba salah satu langkah berikut:

• Aktifkan semua alamat IP yang tersedia untuk resource Google Cloud.
• Nonaktifkan daftar IP yang diizinkan. Anda dapat melakukannya dengan login ke aplikasi Salesforce Marketing Cloud, lalu membuka halaman Penyiapan > Setelan Keamanan. Klik Edit, lalu konfigurasikan setelan Batasi Login menurut Alamat IP (Daftar Alamat IP yang Diizinkan) ke Daftar Alamat IP yang Diizinkan Dinonaktifkan.

Error: INVALID_ARGUMENT. Table tableName does not exist in asset TableName

Penyelesaian: Pastikan Anda memiliki izin cakupan yang benar yang dikonfigurasi di aplikasi Salesforce Marketing Cloud. Untuk mengetahui informasi selengkapnya, lihat Prasyarat Salesforce Marketing Cloud.

Harga

Tidak ada biaya untuk mentransfer data Salesforce Marketing Cloud ke BigQuery saat fitur ini dalam Pratinjau.

Langkah selanjutnya

• Untuk ringkasan BigQuery Data Transfer Service, lihat Pengantar BigQuery Data Transfer Service.
• Untuk informasi cara menggunakan transfer data, termasuk mendapatkan informasi tentang konfigurasi transfer, membuat listingan konfigurasi transfer, dan melihat histori pelaksanaan transfer, lihat Mengelola transfer.
• Pelajari cara memuat data dengan operasi lintas-cloud.