Salesforce Marketing Cloud

Entitas, operasi, dan tindakan

Semua Integration Connectors menyediakan lapisan abstraksi untuk objek aplikasi yang terhubung. Anda hanya dapat mengakses objek aplikasi melalui abstraksi ini. Abstraksi ditampilkan kepada Anda sebagai entity, operasi, dan tindakan.

• Entity: Entity dapat dianggap sebagai objek, atau kumpulan properti, dalam aplikasi atau layanan yang terhubung. Definisi entity berbeda dari konektor ke konektor. Misalnya, pada konektor database, tabel adalah entity, pada konektor server file, folder adalah entity, dan di konektor sistem pesan, antrean adalah entity.

  Namun, mungkin saja konektor tidak mendukung atau memiliki entitas, dalam hal ini daftar Entities akan kosong.

• Operasi: Operasi adalah aktivitas yang dapat Anda lakukan pada entity. Anda dapat melakukan salah satu operasi berikut pada entitas:
  • Cantumkan
  • Dapatkan
  • Buat
  • Update
  • Hapus

  Memilih entity dari daftar yang tersedia akan menghasilkan daftar operasi yang tersedia untuk entity tersebut. Untuk deskripsi operasi secara mendetail, lihat operasi entity tugas Konektor. Namun, jika konektor tidak mendukung salah satu operasi entity, operasi yang tidak didukung tersebut tidak akan dicantumkan dalam daftar Operations.

• Tindakan: Tindakan adalah fungsi kelas pertama yang tersedia untuk integrasi melalui antarmuka konektor. Tindakan memungkinkan Anda membuat perubahan pada satu atau beberapa entitas, dan bervariasi dari satu konektor ke konektor lainnya. Namun, mungkin saja konektor tidak mendukung tindakan apa pun, dalam hal ini daftar Actions akan kosong.

Keterbatasan sistem

Konektor Salesforce Marketing Cloud dapat memproses maksimum 7 transaksi per detik, per node, dan throttle semua transaksi di luar batas ini. Secara default, Integration Connectors mengalokasikan 2 node (untuk ketersediaan yang lebih baik) untuk satu koneksi.

Untuk informasi tentang batas yang berlaku untuk Konektor Integrasi, lihat Batas.

Tindakan

Bagian ini mencantumkan semua tindakan yang didukung oleh koneksi Salesforce Marketing Cloud.

Tindakan GetJourneyPublicationStatus

Tindakan ini mendapatkan status publikasi perjalanan.

Masukkan parameter tindakan GetJourneyPublicationStatus

Parameter output tindakan GetJourneyPublicationStatus

Tindakan ini mengembalikan status 200 (OK) dengan isi respons yang menunjukkan semua hasil.

Untuk mengetahui contoh cara mengonfigurasi tindakan GetJourneyPublicationStatus, lihat Contoh.

Tindakan FireEntryEvent

Aktifkan peristiwa entri yang memulai perjalanan.

Parameter input tindakan FireEntryEvent

Parameter output tindakan FireEntryEvent

Tindakan ini menampilkan status 200 (OK) dengan isi respons yang menunjukkan semua hasil

Untuk mengetahui contoh cara mengonfigurasi tindakan FireEntryEvent, lihat Contoh.

Aksi di StopJourney

Menghentikan perjalanan berlari

Parameter input tindakan StopJourney

Parameter output tindakan StopJourney

Tindakan ini menampilkan status 200 (OK) dengan isi respons yang menunjukkan semua hasil

Untuk mengetahui contoh cara mengonfigurasi tindakan StopJourney, lihat Contoh.

Aksi PublishJourney

PublishJourney Action Memublikasikan versi perjalanan secara asinkron

Input parameter tindakan PublishJourney

Parameter output tindakan PublishJourney

Tindakan ini menampilkan status 200 (OK) dengan isi respons yang menunjukkan semua hasil

Untuk mengetahui contoh cara mengonfigurasi tindakan PublishJourney, lihat Contoh.

Tindakan CreateTriggeredSend

Tindakan CreateTriggeredSend Membuat objek pengiriman yang dipicu yang mewakili instance tertentu dari pengiriman email yang dipicu

Parameter input tindakan CreateTriggeredSend

Parameter output tindakan CreateTriggeredSend

Tindakan ini menampilkan status 200 (OK) dengan isi respons yang menunjukkan semua hasil

Untuk mengetahui contoh cara mengonfigurasi tindakan CreateTriggeredSend, lihat Contoh.

Tindakan SendTransactionalMessageToRecipient

Action SendTransactionalMessageToRecipient Mengirim pesan ke satu penerima melalui definisi kirim

Masukkan parameter tindakan SendTransactionalMessageToRecipient

Parameter output tindakan SendTransactionalMessageToRecipient

Tindakan ini menampilkan status 200 (OK) dengan isi respons yang menunjukkan semua hasil

Untuk mengetahui contoh cara mengonfigurasi tindakan SendTransactionalMessageToRecipient, lihat Contoh.

Contoh

Bagian ini menjelaskan cara menjalankan beberapa operasi dan tindakan entity di konektor ini.

Contoh - Mendapatkan status publikasi perjalanan

1. Dalam dialog Configure connector task, klik Actions.
2. Pilih tindakan GetJourneyPublicationStatus, lalu klik Done.
3. Di bagian Task Input pada tugas Connectors, klik connectorInputPayload, lalu masukkan nilai yang mirip dengan berikut di kolom Default Value:

   {
     "StatusId": "3acf1f54-5c9e-4719-b7f7-bfc2e5caf10a"
   }

Jika tindakan ini berhasil, kolom connectorOutputPayload tugas konektor akan memiliki nilai yang mirip dengan berikut ini:

 [{
  "Status": "PublishCompleted",
  "Message": null
}]

Contoh - Aktifkan peristiwa entri untuk memulai perjalanan

1. Dalam dialog Configure connector task, klik Actions.
2. Pilih tindakan FireEntryEvent, lalu klik Done.
3. Di bagian Task Input pada tugas Connectors, klik connectorInputPayload, lalu masukkan nilai yang mirip dengan berikut di kolom Default Value:

   {
     "ContactKey": "Email",
     "EventDefinitionKey": "APIEvent-4d84e619-a629-6b17-945f-9a6e78a1982c",
     "Data": "{\"Email\": \"usr1@test.com\"}"
   }

Jika tindakan berhasil, kolom connectorOutputPayload tugas konektor akan memiliki nilai yang mirip dengan berikut ini:

 [{
  "EventInstanceId": "0d6f6dd1-1aaa-4eec-9727-f99550ab68f9"
}]

Contoh - Menghentikan perjalanan berlari

1. Dalam dialog Configure connector task, klik Actions.
2. Pilih tindakan StopJourney, lalu klik Done.
3. Di bagian Task Input pada tugas Connectors, klik connectorInputPayload, lalu masukkan nilai yang mirip dengan berikut di kolom Default Value:

   {
     "JourneyId": "37D2789E-2B1D-433E-8E18-8F47E4D8E865",
     "JourneyVersion": 1.0
   }

Jika tindakan ini berhasil, kolom connectorOutputPayload tugas konektor akan memiliki nilai yang mirip dengan berikut ini:

  [{
  "Success": true
}]

Contoh - Memublikasikan versi perjalanan

1. Dalam dialog Configure connector task, klik Actions.
2. Pilih tindakan PublishJourney, lalu klik Done.
3. Di bagian Task Input pada tugas Connectors, klik connectorInputPayload, lalu masukkan nilai yang mirip dengan berikut di kolom Default Value:

   {
     "JourneyId": "0868BF36-3107-460E-9EF1-09633A0592E8",
     "JourneyVersion": 1.0
   }

Jika tindakan ini berhasil, kolom connectorOutputPayload tugas konektor akan memiliki nilai yang mirip dengan berikut ini:

 [{
  "StatusId": "acb1734d-483e-400a-97d7-0501b94f03b2"
}]

Contoh - Membuat pemicu untuk memulai perjalanan

1. Dalam dialog Configure connector task, klik Actions.
2. Pilih tindakan CreateTriggeredSend, lalu klik Done.
3. Di bagian Task Input pada tugas Connectors, klik connectorInputPayload, lalu masukkan nilai yang mirip dengan berikut di kolom Default Value:

   {
     "Key": "BU27_SendDefinition1",
     "ToAddress": "usr1@test.com",
     "SubscriberKey": "107",
     "SubscriberAttributes": "{\"FirstName\": \"John\", \"LastName\": \"P\"}"
   }

Jika tindakan ini berhasil, kolom connectorOutputPayload tugas konektor akan memiliki nilai yang mirip dengan berikut ini:

 [{
  "Success": "True",
  "RecipientSendId": "5d06edb1-d07c-48ad-a1f2-d6350eb863f8",
  "Messages": "Queued"
}]

Contoh - Mengirim pesan ke satu penerima

1. Dalam dialog Configure connector task, klik Actions.
2. Pilih tindakan SendTransactionalMessageToRecipient, lalu klik Done.
3. Di bagian Task Input pada tugas Connectors, klik connectorInputPayload, lalu masukkan nilai yang mirip dengan berikut di kolom Default Value:

   {
     "MessageKey": "T9999009",
     "DefinitionKey": "Send-Definition-SFMC-Demo-2",
     "RecipientContactKey": "107",
     "RecipientTo": "usr1@test.com",
     "Attributes": "FirstName :John"
   }

Jika tindakan ini berhasil, kolom connectorOutputPayload tugas konektor akan memiliki nilai yang mirip dengan berikut ini:

[{
  "RequestId": "d8fb9e9e-3ae2-412f-b01e-d198433cfc16"
}] 

Contoh - Menampilkan daftar kumpulan data dalam entity

Contoh ini mencantumkan kumpulan data dalam entity Assets.

1. Dalam dialog Configure connector task, klik Entities.
2. Pilih Assets dari daftar Entity.
3. Pilih operasi LIST, lalu klik Done.
4. Di bagian Task Input pada tugas Connectors, Anda dapat menetapkan filterClause sesuai kebutuhan Anda.

   Misalnya, menetapkan klausa filter ke Location='US' and region='us-east1', hanya akan mencantumkan kumpulan data tersebut di lokasi AS yang regionnya adalah us-east1.

Contoh - Mendapatkan kumpulan data dari entity

Contoh ini mengambil satu data dari entity Assets.

1. Dalam dialog Configure connector task, klik Entities.
2. Pilih Assets dari daftar Entity.
3. Pilih operasi GET, lalu klik Done.
4. Di bagian Task Input pada tugas Connectors, klik EntityId lalu masukkan 49851 di kolom Default Value.

   Di sini, 49851 adalah kunci utama entity Assets.

Contoh - Menghapus data dari entity

Contoh ini menghapus data dari entity Assets.

1. Dalam dialog Configure connector task, klik Entities.
2. Pilih Assets dari daftar Entity.
3. Pilih operasi DELETE, lalu klik Done.
4. Di bagian Task Input pada tugas Connectors, klik entityId, lalu masukkan 49851 di kolom Default Value.

Contoh - Membuat data dalam entity

Contoh ini membuat data dalam entity DataExtensionObject_Custom.

1. Dalam dialog Configure connector task, klik Entities.
2. Pilih DataExtensionObject_Custom dari daftar Entity.
3. Pilih operasi Create, lalu klik Done.
4. Di bagian Task Input pada tugas Connectors, klik connectorInputPayload, lalu masukkan nilai yang mirip dengan berikut di kolom Default Value:

   {
       "StudentName":"John",
       "StudentID":"1",
       "Rank":"1"}

   Jika integrasi berhasil, kolom connectorOutputPayload tugas konektor akan memiliki nilai yang mirip dengan berikut ini:

    {
         "StudentID": 1
       } 

Contoh - Memperbarui data dalam entity

Contoh ini memperbarui data dalam entity Journeys.

1. Dalam dialog Configure connector task, klik Entities.
2. Pilih Journeys dari daftar Entity.
3. Pilih operasi Update, lalu klik Done.
4. Di bagian Task Input pada tugas Connectors, klik connectorInputPayload, lalu masukkan nilai yang mirip dengan berikut di kolom Default Value:

   {
     "Name": "SFMC_CRETAE_JOURNEY_V1"
   }

5. Setel ID entitas ke entitas Perjalanan . Untuk menetapkan ID entity, klik entityId, lalu masukkan 0868BF36-3107-460E-9EF1-09633A0592E8 di kolom Nilai Default.

   Jika integrasi berhasil, kolom connectorOutputPayload tugas konektor akan memiliki nilai yang mirip dengan berikut ini:

   {
     "Id": "0868bf36-3107-460e-9ef1-09633a0592e8"
   }

Menggunakan koneksi Salesforce Marketing Cloud dalam integrasi

Setelah Anda membuat koneksi, koneksi tersebut akan tersedia di Apigee Integration dan Application Integration. Anda dapat menggunakan koneksi dalam integrasi melalui tugas Konektor.

• Untuk memahami cara membuat dan menggunakan tugas Konektor di Integrasi Apigee, lihat Tugas konektor.
• Untuk memahami cara membuat dan menggunakan tugas Konektor dalam Application Integration, lihat tugas konektor.