Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

# Integrasi Agen Pemasaran Adobe
<a name="adobe-integration"></a>

Dengan konektor aksi Agen Pemasaran Adobe, Anda dapat bekerja dengan data pemasaran dan kemampuan AI-powered pemasaran Adobe Experience Platform secara langsung di Amazon Quick melalui bahasa alami.

Amazon Quick mendukung beberapa metode otentikasi untuk Adobe Marketing Agent. Pilih metode yang paling sesuai dengan persyaratan keamanan organisasi Anda.
+ Aplikasi **OAuth default — Menggunakan aplikasi** OAuth yang AWS dikelola. Tidak diperlukan kredensi tambahan. Pengguna mengautentikasi langsung dengan akun Adobe mereka.
+ Aplikasi **OAuth khusus — Menggunakan aplikasi** yang dikelola pelanggan yang terdaftar di Adobe Developer Console. Opsi ini memberi organisasi Anda kontrol penuh atas konfigurasi OAuth.
+ **Service-to-Service OAuth** — Menggunakan kredensi klien untuk otentikasi server-ke-server tanpa interaksi pengguna. Cocokkan untuk alur kerja otomatis.
+ **API Key** — Menggunakan kunci API untuk otentikasi. Cocokkan untuk pola akses akun layanan.

Untuk informasi selengkapnya tentang metode otentikasi yang didukung Amazon Quick, lihat[Metode autentikasi](quick-action-auth.md).

## Sebelum Anda mulai
<a name="adobe-integration-prerequisites"></a>

Pastikan Anda memiliki yang berikut ini sebelum Anda mengatur integrasi.
+ Akun Adobe aktif dengan akses ke Adobe Marketing Agent.
+ Untuk **aplikasi Custom OAuth** atau **Service-to-Service OAuth**: Akses ke [Adobe Developer Console](https://developer.adobe.com/console) di situs web Adobe untuk membuat aplikasi dan mendapatkan kredensi klien.
+ Untuk **Kunci API: Kunci** Adobe-issued API dengan cakupan akses data pemasaran yang diperlukan.
+ Untuk persyaratan berlangganan Amazon Quick, lihat[Siapkan integrasi di konsol](integration-console-setup-process.md).

## Mengkonfigurasi Adobe
<a name="adobe-source-setup"></a>

Jika Anda menggunakan otentikasi **aplikasi OAuth Default**, lewati bagian ini dan lanjutkan ke. [Menyiapkan konektor di Amazon Quick](#adobe-quicksuite-setup)

Untuk aplikasi Custom OAuth atau otentikasi Service-to-Service OAuth, daftarkan aplikasi di [Adobe Developer Console](https://developer.adobe.com/console) di situs web Adobe dan tambahkan URL callback Amazon Quick sebagai URI pengalihan. `https://{{{region}}}.quicksight.aws.amazon.com/sn/oauthcallback` Ganti {{{region}}} dengan AWS Wilayah Anda (misalnya,`us-east-1`). Rekam ID Klien dan Rahasia Klien — Anda memerlukannya saat mengonfigurasi Amazon Quick. Untuk autentikasi API Key, buat kunci API dari akun Adobe Anda.

## Menyiapkan konektor di Amazon Quick
<a name="adobe-quicksuite-setup"></a>

### Connect dari tab Tersedia
<a name="adobe-quick-connect"></a>

Jika Anda ingin menggunakan otentikasi aplikasi OAuth Default, Anda dapat terhubung langsung dari tab **Tersedia** tanpa konfigurasi tambahan.

1. Di konsol Amazon Quick, pilih **Konektor**.

1. Pada tab **Tersedia**, temukan **Adobe Marketing Agent** dan pilih **Connect**.

1. Selesaikan alur masuk Adobe dan berikan izin yang diminta.

Untuk mengonfigurasi konektor dengan salah satu metode otentikasi lainnya, gunakan tab **Buat untuk tim Anda** seperti yang dijelaskan di bawah ini.

### Buat dari tab Buat untuk tim Anda
<a name="adobe-full-setup"></a>

1. Di konsol Amazon Quick, pilih **Konektor**.

1. Pilih tab **Buat untuk tim Anda**.

1. Temukan dan pilih **Adobe Marketing Agent**.

1. Masukkan **Nama** untuk konektor Anda. Secara opsional, pilih **\+ Tambahkan Deskripsi** untuk menambahkan deskripsi.

1. Untuk **jenis Koneksi**, pilih **Jaringan publik**.

1. Untuk **Konfigurasi OAuth**, pilih salah satu metode otentikasi berikut dan konfigurasikan bidang yang diperlukan.

   1. Untuk aplikasi **OAuth Default**:

      Tidak diperlukan kredensi tambahan. Pilih **Next** untuk melanjutkan.

   1. Untuk **aplikasi Custom OAuth**, konfigurasikan bidang berikut:
      + **ID Klien** — ID klien dari aplikasi Adobe Developer Console Anda.
      + **Klien OAuth Publik** (Opsional) - Pilih opsi ini jika aplikasi Adobe Developer Console Anda dikonfigurasi sebagai klien publik (tidak ada rahasia klien).
      + **Rahasia klien — Rahasia** klien dari aplikasi Adobe Developer Console Anda.
      + **URL Token** — Titik akhir token. Default: `https://aep-ai-ama.adobe.io/token`
      + **URL otorisasi** — Titik akhir otorisasi. Default: `https://aep-ai-ama.adobe.io/authorize`
      + **Redirect URL** — Pre-filled dengan URL callback Amazon Quick.

   1. Untuk **Service-to-ServiceOAuth**, konfigurasikan bidang berikut:
      + **ID Klien — ID** klien dari Server-to-Server kredensi Adobe Developer Console Anda.
      + **Rahasia klien — Rahasia** klien dari Server-to-Server kredensi Adobe Developer Console Anda.
      + **URL Token** — Titik akhir token. Default: `https://aep-ai-ama.adobe.io/token`

   1. Untuk **API Key**, konfigurasikan bidang berikut:
      + **Kunci API — Kunci** Adobe API.
      + **Email** (Opsional) — Alamat email yang terkait dengan kunci API.

1. Pilih **Berikutnya**.

1. Jika Anda memilih aplikasi **OAuth Default atau aplikasi** **Custom OAuth, jendela otorisasi** Adobe akan terbuka. Tinjau izin yang diminta dan pilih **Izinkan**.

1. Pada halaman **Ulasan**, tinjau tindakan yang tersedia untuk konektor. Pilih **Berikutnya**.

1. Pada halaman **Publikasikan**, pilih siapa yang dapat mengakses konektor. Anda dapat mengaktifkan akses untuk semua orang di organisasi Anda atau mencari tim atau grup tertentu.

1. Pilih **Terbitkan**.

## Tindakan yang tersedia
<a name="adobe-integration-actions"></a>

Setelah Anda mengatur konektor, tindakan yang diekspos oleh Adobe Marketing Agent tersedia. Untuk melihat rangkaian tindakan saat ini untuk konektor Anda, buka tampilan **Tindakan yang tersedia** konektor di konsol Amazon Quick.

## Mengelola dan memecahkan masalah
<a name="adobe-integration-troubleshooting"></a>

Untuk mengedit, membagikan, atau menghapus konektor Anda, lihat[Mengelola integrasi yang ada](integration-workflows.md#managing-existing-integrations).

### Masalah otentikasi
<a name="adobe-troubleshooting-auth"></a>
+ **Sign-in gagal (Aplikasi OAuth default atau aplikasi Custom OAuth)** - Verifikasi bahwa akun Adobe Anda aktif dan Anda dapat masuk ke Adobe secara langsung. Untuk aplikasi OAuth Khusus, konfirmasikan bahwa URI pengalihan di aplikasi Adobe Developer Console cocok dengan URL callback Amazon Quick.
+ **Kredensi klien tidak valid (aplikasi OAuth khusus atau Service-to-Service OAuth)** — Verifikasi bahwa ID Klien dan rahasia Klien cocok dengan nilai di aplikasi Adobe Developer Console Anda.
+ **Otentikasi Kunci API gagal** — Verifikasi bahwa kunci API belum dicabut dan memiliki cakupan yang diperlukan untuk operasi yang ingin Anda lakukan.