Pemecahan masalah

Informasi dalam dokumen ini dapat membantu memecahkan masalah yang mungkin Anda alami saat menerapkan Penautan Langganan.

CTA Penautan Langganan macet di layar pemuatan

Contoh error:

Memuat simbol

Gambar 1. CTA Penautan Langganan tidak dimuat.

Untuk mengatasi masalah ini, periksa hal berikut:

  • Pastikan Anda menambahkan asal halaman, termasuk subdomain pengujian, sebagai URL tambahan di setelan publikasi Publisher Center.
    • Pastikan status URL adalah "Terverifikasi", bukan "Verifikasi".
  • Untuk penerapan Akses yang Diperluas atau Reader Revenue Manager Enterprise, pastikan Anda menambahkan asal halaman, termasuk subdomain pengujian, ke asal JavaScript resmi Klien OAuth 2.0 yang Anda konfigurasi untuk penerapan tersebut. Tindakan ini harus dilakukan di Google Cloud Console.

Akun tidak dapat ditautkan

Contoh error:

Akun tidak dapat ditautkan

Gambar 2. Masalah akun tidak dapat ditautkan.

Untuk mengatasi masalah ini, periksa hal berikut:

  • Pastikan Anda menyetujui Persyaratan Layanan untuk Penautan Langganan di Pusat Penerbit. Untuk melakukannya, buka setelan Penautan Langganan dan klik tanda tangani persyaratan layanan penautan langganan.
  • Jika Akun Google sudah ditautkan, Anda akan mendapatkan pesan error saat mencoba menautkan kembali langganan. Anda harus membatalkan tautan langganan melalui halaman langganan di Akun Google sebelum mengulangi uji integrasi sisi klien.

Error izin saat memanggil Subscription Linking API

Contoh error:

Kode 403
Pesan 'readerrevenuesubscriptionlinking.readerEntitlements.update' ditolak pada resource
'//readerrevenuesubscriptionlinking.googleapis.com/publications/example.com/readers/10078823/entitlements' (atau resource mungkin tidak ada)."

Untuk mengatasi masalah ini, periksa hal berikut:

  • Pastikan Anda menggunakan project yang sama seperti yang ditentukan dalam penyiapan Penautan Langganan. Saat Anda menyiapkan Penautan Langganan di Pusat Penerbit, gunakan Nomor project. Anda dapat menemukan Nomor project dari dasbor project.
  • Pastikan Subscription Linking API diaktifkan di project Anda.
  • Di Identity and Access Management (IAM) project, pastikan peran diberikan ke akun layanan sebagai Admin Penautan Langganan. Perhatikan bahwa penerapan perubahan peran melalui sistem mungkin memerlukan waktu. Jika Anda menerima error 403 saat melakukan panggilan API, meskipun setelah Anda mengonfirmasi bahwa akun layanan Anda memiliki peran IAM yang benar, tunggu beberapa saat, lalu coba lagi permintaan Anda.

  • Jika Anda tidak yakin akun layanan mana yang harus digunakan atau apakah akun tersebut memiliki peran IAM yang diperlukan, gunakan Penganalisis Kebijakan dari project yang Anda siapkan untuk Penautan Langganan. Buat dan jalankan kueri kustom dengan parameter kueri berikut:

    Parameter 1 Peran
    Peran Admin Penautan Langganan

  • Pastikan Anda menggunakan kunci akun layanan yang benar saat memanggil Subscription Linking API. Periksa properti berikut di kunci akun layanan (file JSON):

    • type: Harus berupa service_account.
    • project_id: Harus berupa Project ID dari Nomor project yang ditentukan dalam penyiapan Penautan langganan.
    • client_email: Harus berupa akun layanan yang sama di IAM project yang diberi peran Subscription Linking Admin.

  • Jika Anda mendapatkan token akses melalui endpoint token OAuth 2.0 Google (https://oauth2.googleapis.com/token), pastikan token tersebut valid dan tidak habis masa berlakunya saat Anda memanggil Subscription Linking API. Jika masa berlaku token habis, Anda harus mendapatkan token baru.

  • Jika Anda menggunakan REST API, pastikan Anda menggunakan ID Publikasi yang Anda berikan dalam penyiapan Penautan Langganan. Misalnya, jika ID Publikasi Anda adalah example.com, URL permintaan harus menyertakannya.

    • ✅ Hanya gunakan ID Publikasi yang dikonfigurasi: publications/example.com/readers/10078823/entitlements
    • ❌ Jangan gunakan ID Publikasi selain yang ditentukan dalam konfigurasi Penautan Langganan: publications/example-staging.com/readers/10078823/entitlements
    • ❌ Jangan sertakan produk publikasi dalam permintaan: publications/example.com:premium/readers/10078823/entitlements

Error argumen tidak valid saat memperbarui hak

Contoh error:

Pesan Error: Permintaan berisi argumen yang tidak valid

Untuk mengatasi masalah ini, periksa hal berikut:

  • Pastikan Anda memberikan objek entitlements dalam format yang benar. Lihat contoh ini.
  • Pastikan product_id dalam format publication_id:product.
    • ✅ Contoh yang valid: "product_id":"example.com:basic"
    • ❌ Contoh tidak valid: "product_id":"example.com"

Tidak melihat artikel yang ditandai di hasil penelusuran

Untuk mengatasi masalah ini, periksa hal berikut:

Tidak dapat mengubah bahasa pesan ajakan penautan Langganan

Pesan ajakan (CTA) Penautan Langganan

Bahasa teks ajakan (CTA) Penautan Langganan ditentukan oleh setelan pengguna. Tidak dapat diganti secara global.

Bahasa ditentukan sebagai berikut:

  1. Jika pengguna login dengan Akun Google mereka, bahasa utama yang ditetapkan di setelan Akun Google mereka (https://myaccount.google.com/language) akan digunakan.

  2. Jika pengguna tidak login, bahasa akan didasarkan pada setelan bahasa utama browser atau sistem operasinya.

Pesan ajakan Penautan Langganan tidak mendukung semua bahasa. Jika bahasa utama pengguna tidak didukung, teks ajakan (CTA) mungkin menggunakan bahasa Inggris secara default.