Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
# Menghubungkan ke Adobe Marketo Engage
Adobe Marketo Engage adalah platform otomatisasi pemasaran yang memungkinkan pemasar mengelola program dan kampanye multi-saluran yang dipersonalisasi kepada prospek dan pelanggan.
**Topics**
+ [AWS Glue dukungan untuk Adobe Marketo Engage](adobe-marketo-engage-support.md)
+ [Kebijakan yang berisi operasi API untuk membuat dan menggunakan koneksi](adobe-marketo-engage-configuring-iam-permissions.md)
+ [Mengkonfigurasi Adobe Marketo Engage](adobe-marketo-engage-configuring.md)
+ [Mengkonfigurasi koneksi Adobe Marketo Engage](adobe-marketo-engage-configuring-connections.md)
+ [Membaca dari entitas Adobe Marketo Engage](adobe-marketo-engage-reading-from-entities.md)
+ [Menulis ke entitas Adobe Marketo Engage](adobe-marketo-engage-writing-to-entities.md)
+ [Opsi koneksi Adobe Marketo Engage](adobe-marketo-engage-connection-options.md)
+ [Keterbatasan dan catatan untuk konektor Adobe Marketo Engage](adobe-marketo-engage-connector-limitations.md)
# AWS Glue dukungan untuk Adobe Marketo Engage
AWS Glue mendukung Adobe Marketo Engage sebagai berikut:
**Didukung sebagai sumber?**
Ya. Anda dapat menggunakan pekerjaan AWS Glue ETL untuk menanyakan data dari Adobe Marketo Engage.
**Didukung sebagai target?**
Ya. Anda dapat menggunakan pekerjaan AWS Glue ETL untuk menulis data ke Adobe Marketo.
**Versi Adobe Marketo Engage API yang didukung**
Versi Adobe Marketo Engage API berikut didukung:
+ v1
Untuk dukungan entitas per versi tertentu, lihat Entitas yang didukung untuk Sumber.
# Kebijakan yang berisi operasi API untuk membuat dan menggunakan koneksi
Kebijakan contoh berikut menjelaskan izin AWS IAM yang diperlukan untuk membuat dan menggunakan koneksi. Jika Anda membuat peran baru, buat kebijakan yang berisi hal-hal berikut:
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Effect": "Allow",
"Action": [
"glue:ListConnectionTypes",
"glue:DescribeConnectionType",
"glue:RefreshOAuth2Tokens",
"glue:ListEntities",
"glue:DescribeEntity"
],
"Resource": "*"
}
]
}
```
------
Jika Anda tidak ingin menggunakan metode di atas, gunakan kebijakan IAM terkelola berikut ini:
+ [AWSGlueServiceRole](https://console.aws.amazon.com/iam/home#policies/arn:aws:iam::aws:policy/service-role/AWSGlueServiceRole)— Memberikan akses ke sumber daya yang diperlukan berbagai AWS Glue proses untuk dijalankan atas nama Anda. Sumber daya ini termasuk AWS Glue, Amazon S3, IAM, CloudWatch Log, dan Amazon. EC2 Jika Anda mengikuti konvensi penamaan untuk sumber daya yang ditentukan dalam kebijakan ini, AWS Glue proses memiliki izin yang diperlukan. Kebijakan ini biasanya dilampirkan pada peran yang ditentukan saat menentukan crawler, tugas, dan titik akhir pengembangan.
+ [AWSGlueConsoleFullAccess](https://console.aws.amazon.com/iam/home#policies/arn:aws:iam::aws:policy/AWSGlueConsoleFullAccess)— Memberikan akses penuh ke AWS Glue sumber daya saat identitas yang dilampirkan kebijakan menggunakan Konsol AWS Manajemen. Jika Anda mengikuti konvensi penamaan untuk sumber daya yang ditentukan dalam kebijakan ini, maka pengguna memiliki kemampuan konsol penuh. Kebijakan ini biasanya dilampirkan ke pengguna AWS Glue konsol.
# Mengkonfigurasi Adobe Marketo Engage
Sebelum Anda dapat menggunakan AWS Glue untuk mentransfer data dari Adobe Marketo Engage, Anda harus memenuhi persyaratan ini:
## Persyaratan minimum
Berikut ini adalah persyaratan minimum:
+ Anda memiliki akun Adobe Marketo Engage dengan kredensi klien.
+ Akun Adobe Marketo Engage Anda memiliki akses API dengan lisensi yang valid.
Jika memenuhi persyaratan ini, Anda siap untuk terhubung AWS Glue ke akun Adobe Marketo Engage Anda. Untuk koneksi biasa, Anda tidak perlu melakukan hal lain di Adobe Marketo Engage.
## Mendapatkan kredensi OAuth 2.0
Untuk mendapatkan kredensional API untuk melakukan panggilan terautentikasi ke instans Anda, lihat [Adobe](https://experienceleague.adobe.com/en/docs/marketo-developer/marketo/rest/rest-api) Marketo Rest API
# Mengkonfigurasi koneksi Adobe Marketo Engage
Adobe Marketo Engage mendukung jenis hibah KREDENSIAL KLIEN untuk. OAuth2
+ Jenis hibah ini dianggap OAuth 2.0 berkaki 2 karena digunakan oleh klien untuk mendapatkan token akses di luar konteks pengguna. AWS Glue dapat menggunakan ID klien dan rahasia klien untuk mengautentikasi Adobe Marketo Engage APIs yang disediakan oleh layanan khusus yang Anda tentukan.
+ Setiap layanan kustom dimiliki oleh pengguna khusus API yang memiliki serangkaian peran dan izin yang mengizinkan layanan untuk melakukan tindakan tertentu. Token akses dikaitkan dengan satu layanan kustom.
+ Jenis hibah ini menghasilkan token akses yang berumur pendek, dan dapat diperbarui dengan memanggil titik akhir identitas.
+ Untuk dokumentasi Adobe Marketo Engage publik untuk OAuth 2.0 dengan kredensi klien, lihat [Otentikasi](https://developers.adobe-marketo-engage.com/rest-api/authentication/) di Panduan Pengembang Adobe Marketo Engage.
Untuk mengonfigurasi koneksi Adobe Marketo Engage:
1. Di AWS Secrets Manager, buat rahasia dengan detail berikut:
1. Untuk aplikasi terhubung yang dikelola pelanggan, Rahasia harus berisi aplikasi yang terhubung Rahasia Konsumen dengan kunci `USER_MANAGED_CLIENT_APPLICATION_CLIENT_SECRET` sebagai.
1. Catatan: Anda harus membuat rahasia per koneksi di AWS Glue.
1. Di AWS Glue Glue Studio, buat koneksi di bawah **Koneksi Data** dengan mengikuti langkah-langkah di bawah ini:
1. Saat memilih **jenis Koneksi**, pilih Adobe Marketo Engage.
1. Berikan contoh Adobe Marketo Engage yang ingin Anda sambungkan. `INSTANCE_URL`
1. Pilih peran AWS IAM yang AWS Glue dapat mengasumsikan dan memiliki izin untuk tindakan berikut:
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Effect": "Allow",
"Action": [
"secretsmanager:DescribeSecret",
"secretsmanager:GetSecretValue",
"secretsmanager:PutSecretValue",
"ec2:CreateNetworkInterface",
"ec2:DescribeNetworkInterfaces",
"ec2:DeleteNetworkInterface"
],
"Resource": "*"
}
]
}
```
------
1. Pilih `secretName` yang ingin Anda gunakan untuk koneksi ini AWS Glue untuk memasukkan token.
1. Pilih opsi jaringan jika Anda ingin menggunakan jaringan Anda.
1. Berikan peran IAM yang terkait dengan izin AWS Glue pekerjaan Anda untuk membaca`secretName`.
# Membaca dari entitas Adobe Marketo Engage
**Prasyarat**
Objek Adobe Marketo Engage yang ingin Anda baca. Anda akan memerlukan nama objek seperti lead atau aktivitas atau customobjects. Tabel berikut menunjukkan entitas yang didukung.
**Entitas yang didukung untuk sumber (sinkron)**:
| Entitas | Dapat disaring | Mendukung batas | Mendukung Pesanan oleh | Mendukung Pilih\$1 | Mendukung partisi |
| --- | --- | --- | --- | --- | --- |
| memimpin | Ya | Ya | Tidak | Ya | Tidak |
| aktivitas | Ya | Ya | Tidak | Ya | Tidak |
| customobjects | Ya | Ya | Tidak | Ya | Tidak |
**Entitas yang didukung untuk sumber (asinkron**):
| Entitas | Dapat disaring | Mendukung batas | Mendukung Pesanan oleh | Mendukung Pilih\$1 | Mendukung partisi |
| --- | --- | --- | --- | --- | --- |
| memimpin | Ya | Tidak | Tidak | Ya | Ya |
| aktivitas | Ya | Tidak | Tidak | Ya | Tidak |
| customobjects | Ya | Tidak | Tidak | Ya | Ya |
**Contoh:**
```
adobe-marketo-engage_read = glueContext.create_dynamic_frame.from_options(
connection_type="adobe-marketo-engage",
connection_options={
"connectionName": "connectionName",
"ENTITY_NAME": "leads",
"API_VERSION": "v2",
"INSTANCE_URL": "https://539-t**-6**.mktorest.com"
}
```
Entitas dan detail **bidang Adobe Marketo Engage**:
**Entitas dengan metadata statis**:
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/glue/latest/dg/adobe-marketo-engage-reading-from-entities.html)
**Entitas dengan metadata dinamis**:
Untuk entitas berikut, Adobe Marketo Engage menyediakan titik akhir untuk mengambil metadata secara dinamis, sehingga dukungan operator ditangkap pada tingkat tipe data untuk setiap entitas.
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/glue/latest/dg/adobe-marketo-engage-reading-from-entities.html)
## Mempartisi kueri
Anda dapat memberikan opsi Spark tambahan`PARTITION_FIELD`,, `LOWER_BOUND``UPPER_BOUND`, dan `NUM_PARTITIONS` jika Anda ingin memanfaatkan konkurensi di Spark. Dengan parameter ini, kueri asli akan dibagi menjadi `NUM_PARTITIONS` sejumlah sub-kueri yang dapat dijalankan oleh tugas Spark secara bersamaan.
+ `PARTITION_FIELD`: nama bidang yang akan digunakan untuk mempartisi kueri.
+ `LOWER_BOUND`: nilai batas bawah **inklusif** dari bidang partisi yang dipilih.
Untuk DateTime bidang, kami menerima nilai dalam format ISO.
Contoh nilai yang valid:
```
"2024-07-01T00:00:00.000Z"
```
+ `UPPER_BOUND`: nilai batas atas **eksklusif** dari bidang partisi yang dipilih.
+ `NUM_PARTITIONS`: jumlah partisi.
Tabel berikut menjelaskan rincian dukungan bidang partisi entitas:
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/glue/latest/dg/adobe-marketo-engage-reading-from-entities.html)
Contoh:
```
adobe-marketo-engage_read = glueContext.create_dynamic_frame.from_options(
connection_type="adobe-marketo-engage",
connection_options={
"connectionName": "connectionName",
"ENTITY_NAME": "leads",
"API_VERSION": "v1",
"PARTITION_FIELD": "createdAt"
"LOWER_BOUND": "2024-07-01T00:00:00.000Z"
"UPPER_BOUND": "2024-07-02T00:00:00.000Z"
"NUM_PARTITIONS": "10"
}
```
# Menulis ke entitas Adobe Marketo Engage
**Prasyarat**
+ Objek Adobe Marketo yang ingin Anda tulis. Anda akan membutuhkan nama objek seperti `leads` atau`customobjects`.
+ Konektor Adobe Marketo mendukung tiga operasi penulisan:
+ INSERT
+ MENEGAKKAN
+ UPDATE
+ Untuk `UPSERT` dan `UPDATE` menulis operasi, Anda harus memberikan `ID_FIELD_NAMES` opsi untuk menentukan bidang ID untuk catatan. Saat bekerja dengan `leads` entitas, gunakan `email` `ID_FIELD_NAMES` untuk `UPSERT` operasi dan `id` untuk `UPDATE` operasi. Untuk `customobjects` entitas, gunakan `marketoGUID` `ID_FIELD_NAMES` untuk keduanya `UPDATE` dan `UPSERT` operasi.
**Entitas yang didukung untuk Destination (Synchronous)**
| Nama entitas | Akan didukung sebagai Konektor Tujuan | Dapat Dimasukkan | Dapat Diperbarui | Dapat Ditegaskan |
| --- | --- | --- | --- | --- |
| memimpin | Ya | Ya (Massal) | Ya (Massal) | Ya (Massal) |
| customobjects | Ya | Ya (Massal) | Ya (Massal) | Ya (Massal) |
**Contoh:**
**Operasi INSERT:**
```
marketo_write = glueContext.write_dynamic_frame.from_options(
frame=frameToWrite,
connection_type="marketo",
connection_options={
"connectionName": "connectionName",
"ENTITY_NAME": "leads",
"API_VERSION": "v1",
"WRITE_OPERATION": "INSERT"
}
```
**Operasi UPDATE:**
```
marketo_write = glueContext.write_dynamic_frame.from_options(
frame=frameToWrite,
connection_type="marketo",
connection_options={
"connectionName": "connectionName",
"ENTITY_NAME": "leads",
"API_VERSION": "v1",
"WRITE_OPERATION": "UPDATE",
"ID_FIELD_NAMES": "id"
}
```
**catatan**
Untuk `customobjects` entitas `leads` dan, Adobe Marketo menyediakan titik akhir untuk mengambil metadata secara dinamis sehingga bidang yang dapat ditulis diidentifikasi dari respons API Marketo.
# Opsi koneksi Adobe Marketo Engage
Berikut ini adalah opsi koneksi untuk Adobe Marketo Engage:
+ `ENTITY_NAME`(String) - (Diperlukan) Digunakan untuk Baca. Nama objek Anda di Adobe Marketo Engage.
+ `API_VERSION`(String) - (Diperlukan) Digunakan untuk Baca. Adobe Marketo Engage Rest API versi yang ingin Anda gunakan. Misalnya: v1.
+ `SELECTED_FIELDS`(Daftar) - Default: kosong (SELECT \$1). Digunakan untuk Baca. Kolom yang ingin Anda pilih untuk objek.
+ `FILTER_PREDICATE`(String) - Default: kosong. Digunakan untuk Baca. Itu harus dalam format Spark SQL.
+ `QUERY`(String) - Default: kosong. Digunakan untuk Baca. Kueri SQL Spark penuh.
+ `PARTITION_FIELD`(String) - Digunakan untuk Baca. Bidang yang akan digunakan untuk mempartisi kueri.
+ `LOWER_BOUND`(String) - Digunakan untuk Baca. Nilai batas bawah inklusif dari bidang partisi yang dipilih.
+ `UPPER_BOUND`(String) - Digunakan untuk Baca. Nilai batas atas eksklusif dari bidang partisi yang dipilih.
+ `NUM_PARTITIONS`(Integer) - Default: 1. Digunakan untuk Baca. Jumlah partisi untuk dibaca.
+ `TRANSFER_MODE`(String) - Default: SINKRONISASI. Digunakan untuk membaca asinkron.
+ `WRITE_OPERATION`(String) - Default: SISIPKAN. Digunakan untuk menulis. Nilai harus INSERT, UPDATE, UPSERT.
+ `ID_FIELD_NAMES`(String) - Default: null. Diperlukan untuk UPDATE dan UPSERT.
# Keterbatasan dan catatan untuk konektor Adobe Marketo Engage
Berikut ini adalah batasan atau catatan untuk konektor Adobe Marketo Engage:
+ 'SincedateTime' dan 'activityTypeId' adalah parameter filter wajib untuk entitas Aktivitas Sinkronisasi.
+ Langganan dialokasikan 50.000 panggilan API per hari (yang disetel ulang setiap hari pada pukul 12:00 CST). Kapasitas harian tambahan dapat dibeli sebagai bagian dari langganan Adobe Marketo Engage. Untuk referensi, lihat [Adobe Marketo Rest API](https://experienceleague.adobe.com/en/docs/marketo-developer/marketo/rest/rest-api).
+ Rentang waktu maksimum untuk filter rentang tanggal (`createdAt`atau`updatedAt`) adalah 31 hari. Untuk referensi, lihat [Ekstrak Massal - Pengembang Marketo](https://experienceleague.adobe.com/en/docs/marketo-developer/marketo/rest/bulk-extract/bulk-extract).
+ Langganan dialokasikan maksimal 10 pekerjaan ekstrak massal dalam antrian pada waktu tertentu. Untuk referensi, lihat [Ekstrak Massal - Pengembang Marketo](https://experienceleague.adobe.com/en/docs/marketo-developer/marketo/rest/bulk-extract/bulk-extract).
+ Secara default, pekerjaan ekstrak dibatasi hingga 500 MB per hari (yang disetel ulang setiap hari pada pukul 12:00 CST). Kapasitas harian tambahan dapat dibeli sebagai bagian dari langganan Adobe Marketo Engage. Untuk referensi, lihat [Ekstrak Massal - Pengembang Marketo](https://experienceleague.adobe.com/en/docs/marketo-developer/marketo/rest/bulk-extract/bulk-extract).
+ Jumlah maksimum pekerjaan ekspor bersamaan adalah 2. Untuk referensi, lihat [Ekstrak Massal - Pengembang Marketo](https://experienceleague.adobe.com/en/docs/marketo-developer/marketo/rest/bulk-extract/bulk-extract).
+ Jumlah maksimum pekerjaan ekspor antrian (termasuk pekerjaan yang saat ini mengekspor) adalah 10. Untuk referensi, lihat [Ekstrak Massal - Pengembang Marketo](https://experienceleague.adobe.com/en/docs/marketo-developer/marketo/rest/bulk-extract/bulk-extract).
+ Ukuran file maksimum yang diizinkan adalah 1 GB untuk diekstrak dari pekerjaan Massal.
+ Setelah pekerjaan asinkron dibuat, periode penyimpanan file akan menjadi 7 hari sebelum kedaluwarsa. Untuk referensi, lihat [Ekstrak Massal - Pengembang Marketo](https://experienceleague.adobe.com/en/docs/marketo-developer/marketo/rest/bulk-extract/bulk-extract).
+ `createdAt`atau `updatedAt` merupakan parameter filter wajib untuk entitas Async Leads.
+ `createdAt`adalah parameter filter wajib untuk entitas Aktivitas Async.
+ `updatedAt`adalah parameter filter wajib untuk entitas Objek Kustom Async.
+ Saat menggunakan konektor AWS Glue SaaS, pengguna tidak dapat mengidentifikasi catatan spesifik mana yang gagal selama operasi penulisan ke platform SaaS tujuan jika terjadi kegagalan sebagian.
+ Saat menggunakan operasi tulis Sinkronisasi, bidang apa pun dengan nilai nol dalam file input akan secara otomatis dijatuhkan dan tidak dikirim ke platform SaaS.
+ Anda dapat membuat atau memperbarui hingga 300 catatan dalam satu batch untuk Sync write.
Untuk informasi selengkapnya, lihat [Adobe Marketo Engage Integration Best Practices](https://experienceleague.adobe.com/en/docs/marketo-developer/marketo/rest/marketo-integration-best-practices) dan [Bulk](https://https://experienceleague.adobe.com/en/docs/marketo-developer/marketo/rest/bulk-extract/bulk-activity-extract) Extract.