Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
# Integrasi Google Analytics
Dengan konektor tindakan Google Analytics, Anda dapat mengakses Google Analytics langsung di Amazon Quick melalui bahasa alami. Anda dapat menjalankan laporan, mengambil data audiens, memantau peristiwa penting, dan mengakses metrik waktu nyata tanpa meninggalkan Amazon Quick.
Amazon Quick mendukung beberapa metode otentikasi untuk Google Analytics. Pilih metode yang paling sesuai dengan persyaratan keamanan organisasi Anda.
+ Aplikasi **OAuth default — Menggunakan aplikasi** OAuth yang AWS dikelola. Tidak diperlukan kredensi tambahan. Anda mengautentikasi langsung dengan akun Google Anda.
+ **Aplikasi OAuth khusus** — Menggunakan klien OAuth yang dikelola pelanggan yang dibuat di Google Cloud Console. Opsi ini memberi organisasi Anda kontrol penuh atas konfigurasi OAuth.
Untuk informasi selengkapnya tentang metode otentikasi yang didukung Amazon Quick, lihat[Metode autentikasi](quick-action-auth.md).
## Sebelum Anda mulai
Pastikan Anda memiliki yang berikut ini sebelum Anda mengatur integrasi.
+ Akun Google dengan akses ke properti dan data Google Analytics yang ingin Anda gunakan.
+ Untuk **aplikasi Custom OAuth**: Akses ke [Google Cloud Console](https://console.cloud.google.com/) di situs web Google dengan izin untuk membuat klien OAuth.
+ Untuk persyaratan berlangganan Amazon Quick, lihat[Siapkan integrasi di konsol](integration-console-setup-process.md).
## Mengkonfigurasi Google Cloud
Jika Anda menggunakan otentikasi **aplikasi OAuth Default**, lewati bagian ini dan buka. [Menyiapkan konektor di Amazon Quick](#google-analytics-quicksuite-setup)
Untuk autentikasi aplikasi OAuth Kustom, selesaikan langkah-langkah berikut di Google Cloud Console sebelum Anda mengonfigurasi Amazon Quick. Saat Anda mengaktifkan API di langkah 3, cari dan aktifkan **API Data Google Analytics**.
### Buat klien OAuth di Google Cloud Console
Buat klien OAuth di Google Cloud Console untuk mendapatkan kredensi klien yang Anda butuhkan untuk Amazon Quick. Untuk informasi selengkapnya, lihat [Menggunakan OAuth 2.0 untuk Mengakses Google API](https://developers.google.com/identity/protocols/oauth2) di situs web Google.
1. Masuk ke [Google Cloud Console](https://console.cloud.google.com/) di situs web Google.
1. Buat proyek baru atau pilih proyek yang sudah ada.
1. Di panel navigasi kiri, pilih **API & Layanan**, lalu pilih **Perpustakaan**. Cari API yang dibutuhkan integrasi Anda dan pilih **Aktifkan**.
1. Pilih **layar persetujuan OAuth** dan pilih **Memulai**.
1. Konfigurasikan layar persetujuan:
+ Masukkan **Nama Aplikasi** dan pilih **email Dukungan pengguna**.
+ Untuk **Audiens**, pilih **Internal** (khusus organisasi Anda) atau **Eksternal** (pengguna Google mana pun).
+ Tambahkan detail kontak pengembang dan pilih **Buat**.
1. Pilih **Buat klien OAuth**.
1. Konfigurasikan klien:
+ Untuk **jenis Aplikasi**, pilih **Aplikasi Web**.
+ Masukkan **nama** untuk klien Anda.
+ Di bawah URI **pengalihan resmi, tambahkan URL** callback Cepat Amazon: `https://{{{region}}}.quicksight.aws.amazon.com/sn/oauthcallback`
1. Pilih **Buat**.
1. Catat nilai-nilai berikut. Anda membutuhkannya saat mengonfigurasi Amazon Quick.
+ **ID Klien**
+ **Rahasia klien**
### Cakupan yang direkomendasikan
Cakupan berikut diminta saat Anda terhubung ke Google Analytics.
**Cakupan yang direkomendasikan Google Analytics**
| Lingkup | Deskripsi |
| --- | --- |
| https://www.googleapis.com/auth/analytics.readonly | Membaca data dan konfigurasi Analytics. |
| https://www.googleapis.com/auth/analytics.edit | Mengedit konfigurasi dan data Analytics. |
| openid | Mengautentikasi identitas pengguna. |
| email | Membaca alamat email pengguna. |
**catatan**
`email`Cakupan `openid` dan cakupan secara otomatis disertakan dalam alur persetujuan OAuth untuk otentikasi pengguna. Mereka tidak diperlukan untuk Service-to-Service OAuth.
## Menyiapkan konektor di Amazon Quick
### Connect dari tab Tersedia
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**, cari **Google Analytics** dan pilih **Connect**.
1. Selesaikan alur masuk Google dan berikan izin yang diminta.
Untuk mengonfigurasi konektor dengan aplikasi Custom OAuth sebagai gantinya, gunakan tab **Buat untuk tim Anda** seperti yang dijelaskan di bawah ini.
### Buat dari tab Buat untuk tim Anda
Setelah Anda menyelesaikan konfigurasi Google Cloud yang diperlukan, buat konektor di Amazon Quick.
1. Di konsol Amazon Quick, pilih **Konektor**.
1. Pilih tab **Buat untuk tim Anda**.
1. Temukan dan pilih **Google Analytics**.
**catatan**
Jika konektor Google Analytics sudah ada, dialog akan muncul dengan konektor yang ada. Untuk menggunakan konektor yang ada, pilihlah. Untuk membuat yang baru, pilih **Tidak, buat yang baru**.
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:
+ **URL Dasar** (Opsional) - URL dasar API Google Analytics. Contoh: `https://analyticsdata.googleapis.com`
+ **ID Klien** — ID klien dari klien Google Cloud OAuth Anda.
+ **Rahasia klien** — Rahasia klien dari klien Google Cloud OAuth Anda.
+ **URL Token** — Titik akhir token. Contoh: `https://oauth2.googleapis.com/token`
+ **URL otorisasi** — Titik akhir otorisasi. Contoh: `https://accounts.google.com/o/oauth2/v2/auth`
+ **Redirect URL** — Pre-filled dengan URL callback Amazon Quick.
1. Pilih **Berikutnya**.
1. Jika Anda memilih aplikasi **OAuth Default atau aplikasi** **Custom OAuth, jendela otorisasi** Google 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
Setelah Anda mengatur konektor, tindakan berikut tersedia.
**Tindakan Google Analytics yang tersedia**
| Kategori | Tindakan | Deskripsi |
| --- | --- | --- |
| Laporan | Buat Laporan | Menjalankan laporan untuk properti. |
| Laporan | Laporan Buat Batch | Menjalankan beberapa laporan dalam satu permintaan. |
| Laporan | Buat Laporan Realtime | Menjalankan laporan real-time untuk properti. |
| Laporan | Buat Laporan Corong | Menjalankan laporan corong untuk properti. |
| Pemirsa | Daftar Audiens | Daftar pemirsa untuk properti. |
| Pemirsa | Buat Daftar Pemirsa | Membuat daftar audiens untuk ekspor. |
| Pemirsa | Daftar Daftar Audiens | Daftar daftar audiens untuk properti. |
| Pemirsa | Dapatkan Daftar Pemirsa | Mengambil data dari daftar audiens. |
| Pemirsa | Buat Ekspor Audiens | Membuat ekspor audiens. |
| Pemirsa | Dapatkan Ekspor Pemirsa | Mengambil data dari ekspor audiens. |
| Akun | Daftar Ringkasan Akun | Daftar ringkasan akun yang dapat diakses oleh pengguna. |
| Akun | Daftar Akun | Daftar semua akun yang dapat diakses oleh pengguna. |
| Akun | Dapatkan Akun | Mengambil detail untuk akun tertentu. |
| Sifat-sifat | Dapatkan Properti | Mengambil detail untuk properti tertentu. |
| Sifat-sifat | Cari Properti | Mencari properti dengan penyaringan. |
| Sifat-sifat | Dapatkan Kuota Properti | Mengambil penggunaan kuota untuk properti. |
| Peristiwa | Daftar Acara Utama | Daftar peristiwa penting (konversi) untuk properti. |
| Metadata | Dapatkan Metadata | Mengambil dimensi dan metrik yang tersedia untuk pelaporan. |
| Metadata | Dapatkan Kompatibilitas | Memeriksa kompatibilitas dimensi dan metrik untuk laporan. |
| Anotasi | Daftar Anotasi | Daftar pelaporan anotasi data untuk properti. |
**catatan**
Tindakan yang dapat Anda gunakan bergantung pada properti Analytics dan akun yang dapat diakses oleh pengguna yang diautentikasi.
## Mengelola dan memecahkan masalah
Untuk mengedit, membagikan, atau menghapus konektor Anda, lihat[Mengelola integrasi yang ada](integration-workflows.md#managing-existing-integrations).
### Masalah otentikasi Google yang umum
+ **Sign-in gagal (Aplikasi OAuth default atau aplikasi Custom OAuth)** [— Verifikasi bahwa akun Google Anda aktif dan Anda dapat langsung masuk ke situs web Google.](https://accounts.google.com) Untuk aplikasi Custom OAuth, konfirmasikan bahwa URI pengalihan di klien Google Cloud OAuth Anda cocok dengan URL callback Amazon Quick.
+ **Aplikasi diblokir oleh administrator** — Jika administrator Google Workspace membatasi akses aplikasi pihak ketiga, Anda mungkin akan melihat kesalahan saat mencoba masuk. Hubungi administrator Google Workspace Anda untuk mengizinkan aplikasi Amazon Quick.
+ **Kredensi klien tidak valid (aplikasi OAuth khusus)** — Verifikasi bahwa ID Klien dan rahasia Klien cocok dengan nilai di klien Google Cloud OAuth Anda.
+ **Popup otentikasi gagal** — Verifikasi bahwa browser Anda mengizinkan popup dari domain konsol Amazon Quick. Coba gunakan browser lain atau bersihkan cache browser Anda.
+ **Izin dicabut** - Jika sebelumnya Anda mencabut akses Cepat Amazon dari setelan izin Akun Google, Anda perlu mengautentikasi ulang dengan mengedit konektor dan masuk lagi.
+ **Pembatasan tarif API Google** — Google mungkin membatasi permintaan selama periode penggunaan tinggi. Jika tindakan gagal, coba lagi setelah beberapa menit.
### Analytics-specific Masalah Google
+ **Google Analytics Data API tidak diaktifkan** — Verifikasi bahwa API Data Google Analytics diaktifkan di project Google Cloud Anda di bawah **API & Services**, **Library**.
+ **Tidak ada properti yang terlihat** — Pastikan akun Google yang diautentikasi memiliki akses ke properti Google Analytics yang ingin Anda kueri.