Menjadwalkan transfer Salesforce Marketing Cloud

Konektor BigQuery Data Transfer Service untuk Salesforce Marketing Cloud memungkinkan Anda secara otomatis menjadwalkan dan mengelola tugas pemuatan berulang dari Salesforce Marketing Cloud ke menggunakan 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 Salesforce Marketing Cloud transfer data:

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 Komponen di halaman detail paket.
  2. Temukan instance server API Anda di URL setelah login ke Aplikasi Salesforce Marketing Cloud. Nilai instance mencakup s diikuti dengan sebuah nilai numerik. Misalnya, dalam URL https://mc.s4.exacttarget.com/, nilai instance-nya adalah s4. Untuk mengetahui informasi selengkapnya, lihat Menemukan lokasi stack untuk akun Marketing Cloud.

Anda juga harus mengonfigurasi setelan izin cakupan untuk memungkinkan Transfer data Salesforce Marketing Cloud:

  1. Login ke aplikasi Salesforce Marketing Cloud.

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

    Klik Penyiapan di setelan Salesforce Marketing Cloud

  3. Pada menu navigasi di bagian Platform Tools, klik Apps > Paket yang diinstal.

  4. Pilih paket yang terinstal untuk mengubah setelannya.

  5. Di bagian Komponen, klik Edit.

  6. Pilih opsi Baca untuk cakupan berikut:

    • Email
    • Konten Tersimpan
    • Perjalanan
    • Callbacks
    • Kampanye
    • Langganan
  7. Klik Simpan.

Prasyarat BigQuery

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 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 di set data target
  • bigquery.datasets.update di 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 Transfer data di Konsol Google Cloud.

    Buka Transfer data

  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 Set data, pilih yang dibuat untuk menyimpan data.

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

  7. Di bagian Opsi jadwal, lakukan tindakan berikut:

    • Di daftar Frekuensi pengulangan, pilih opsi untuk menentukan caranya sering kali transfer data ini berjalan. Untuk menentukan frekuensi pengulangan kustom, pilih Kustom. Jika Anda memilih On-demand, transfer ini 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 Akun Layanan, pilih akun layanan yang terkait dengan project Google Cloud Anda. Layanan yang dipilih akun ini harus memiliki peran yang diperlukan untuk menjalankan peran ini untuk mentransfer data.

    Jika Anda login dengan identitas gabungan, akun layanan diperlukan untuk membuat transfer data. Jika Anda menandatangani dengan Akun Google, lalu 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 Notifikasi email tombol. Jika Anda mengaktifkan opsi ini, administrator transfer menerima pemberitahuan email ketika proses transfer gagal.
    • Untuk mengaktifkan Notifikasi proses transfer Pub/Sub untuk transfer ini, klik tombol notifikasi Pub/Sub. Anda dapat memilih topik nama, atau Anda dapat mengklik Buat topik untuk membuatnya.
  10. Klik Simpan.

Ketika transfer data ini berjalan, BigQuery Data Transfer Service secara otomatis mengisi tabel berikut berdasarkan antarmuka REST.

  • Campaigns
  • Categories
  • EventDefinitions
  • Journeys
  • JourneyActivities
  • SendDefinitions
  • Subscriptions

bq

Masukkan perintah bq mk dan memberikan 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): ID project 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 identifikasi 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 ini 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 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:

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 buka Penyiapan > Setelan Keamanan kami. Klik Edit, lalu konfigurasi Batasi Logins menurut Alamat IP (Daftar yang Diizinkan IP) setelan ke Pemberian Izin IP Dinonaktifkan.

Nonaktifkan daftar IP yang diizinkan

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

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

Harga

Mentransfer data Salesforce Marketing Cloud ke dalam BigQuery saat fitur ini tersedia Pratinjau.

Langkah selanjutnya