Pengaturan Google Service Account
Buat Google service account, aktifkan API Search Console dan Analytics, lalu hubungkan kunci JSON ke 1MarketingTool.
Gunakan Google service account ketika Anda ingin 1MarketingTool membaca data Search Console dan GA4 tanpa masuk melalui akun Google pribadi.
Pilih alur cepat Cloud Shell, atau ikuti panduan manual Google Cloud Console.
Penyiapan cepat dengan Cloud Shell
Cloud Shell berjalan di browser, sudah masuk ke akun Google Anda. Buka Cloud Shell, tempel skrip, tekan Enter, dan key.json akan terunduh setelah selesai. Kemudian gunakan Import JSON di 1MarketingTool untuk memuat kunci yang diunduh dan menyimpannya.
set -e
PROJECT_ID=$(gcloud config get-value project 2>/dev/null)
if [ -z "$PROJECT_ID" ]; then
PROJECT_ID="marketing-tool-$RANDOM$RANDOM"
gcloud projects create "$PROJECT_ID" --set-as-default
fi
gcloud services enable iam.googleapis.com searchconsole.googleapis.com analyticsadmin.googleapis.com \
analyticsdata.googleapis.com indexing.googleapis.com --project "$PROJECT_ID"
SA_EMAIL="marketing-tool@$PROJECT_ID.iam.gserviceaccount.com"
gcloud iam service-accounts create marketing-tool --display-name "1MarketingTool" --project "$PROJECT_ID" || true
echo "Waiting for the service account to be ready..."
for i in $(seq 1 30); do
gcloud iam service-accounts describe "$SA_EMAIL" --project "$PROJECT_ID" >/dev/null 2>&1 && break
sleep 2
done
rm -f key.json
gcloud iam service-accounts keys create key.json --iam-account "$SA_EMAIL" --project "$PROJECT_ID"
cloudshell download key.json
echo "Grant read access in Search Console and GA4 to: $SA_EMAIL"1. Buat Google Cloud Project
Buka Google Cloud Console, gunakan dropdown proyek di bilah atas, lalu pilih New Project. Anda juga dapat menggunakan kembali proyek yang sudah ada jika sudah memilikinya untuk workspace ini.
Beri nama proyek yang mudah dikenali, seperti marketing-tool, lalu klik Create.
Pastikan proyek baru terpilih di bilah atas sebelum Anda melanjutkan.
2. Buat Service Account
Buka APIs & Services -> Credentials, lalu pilih Create credentials -> Service account.
Masukkan nama seperti marketing-tool-reader. Google akan menghasilkan ID dan alamat email service account dari nama tersebut. Klik Create and continue.
Anda dapat melewati pemberian peran proyek Google Cloud. Akses Search Console dan GA4 diberikan nanti di dalam produk tersebut. Klik Done.
Salin email service account. Bentuknya seperti [email protected]. Anda akan menggunakan email ini saat memberikan akses Search Console dan Analytics.
3. Unduh Kunci JSON
Buka service account, beralih ke tab Keys, lalu pilih Add key -> Create new key.
Pilih JSON, lalu klik Create. File .json akan terunduh ke komputer Anda. Simpan file ini secara pribadi karena ini adalah kredensial.
4. Aktifkan API yang Diperlukan
Di Google Cloud Console, buka APIs & Services -> Library dan cari Google Search Console API.
Pilih Google Search Console API.
Klik Enable untuk proyek yang dipilih.
Kembali ke API Library, cari Google Analytics Data API, lalu aktifkan. API ini diperlukan untuk pelaporan GA4.
Opsional, aktifkan juga Google Analytics Admin API. Ini memungkinkan aplikasi untuk mencantumkan properti GA4 jika didukung oleh alur kerja yang terhubung.
5. Berikan Akses di Search Console
Buka Google Search Console, pilih properti yang ingin Anda hubungkan, lalu buka Settings -> Users and permissions -> Add user.
Tempel email service account dari langkah 2. Pilih izin Full atau Restricted, lalu klik Add.
6. Berikan Akses di Google Analytics
Buka Google Analytics, klik Admin, lalu pilih properti GA4 yang benar.
Buka Property access management, klik +, dan tambahkan email service account. Gunakan akses Viewer atau Analyst, lalu klik Add.
7. Hubungkan di 1MarketingTool
Di 1MarketingTool, buka pengaturan penyedia atau integrasi Google dan impor file kunci JSON yang Anda unduh sebelumnya.
Setelah menyimpan, petakan properti Search Console atau GA4 ke proyek yang tepat di aplikasi.
Catatan
- Jika data Search Console atau GA4 tidak langsung muncul, tunggu sebentar dan coba lagi. Izin Google bisa memerlukan beberapa menit untuk menyebar.
- Satu service account dapat ditambahkan ke sebanyak mungkin properti Search Console dan GA4 yang Anda butuhkan, lalu dipetakan per proyek di 1MarketingTool.
- Jika Anda merotasi atau menghapus kunci JSON di Google Cloud, impor kunci baru di aplikasi.
- Simpan kunci JSON dengan aman dan jangan commit ke source control.