Pemecahan masalah

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

Tips: Buka konsol JavaScript dan cari pesan error dari library klien swg.js. Hal ini dapat membantu Anda mengidentifikasi potensi masalah dalam penerapan.

Perintah Penautan Langganan macet di layar pemuatan

Contoh error:

Gambar 1. Perintah 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 Pusat Penerbit.
  • Pastikan status URL-nya "Terverifikasi", bukan "Verifikasi".
• Untuk penerapan Akses yang Diperluas atau Reader Revenue Manager Enterprise, pastikan Anda menambahkan origin halaman, termasuk subdomain pengujian, ke origin JavaScript resmi Klien OAuth 2.0 yang Anda konfigurasikan untuk penerapan tersebut. Tindakan ini harus dilakukan di Konsol Google Cloud.

Catatan: Jika Anda baru saja menambahkan origin, mungkin perlu waktu hingga satu jam sebelum origin tersebut dapat mengakses library klien swg.js.

Akun tidak dapat ditautkan

Contoh error:

Gambar 2. Masalah akun tidak dapat ditautkan.

Untuk mengatasi masalah ini, periksa hal berikut:

• Pastikan untuk 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 langganan lagi. Anda harus membatalkan tautan langganan, melalui halaman langganan di Akun Google, sebelum mengulangi pengujian 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 mungkin tidak ada)."

Untuk mengatasi masalah ini, periksa hal berikut:

• Pastikan Anda menggunakan project yang sama seperti yang ditentukan dalam Penyiapan Penautan Langganan. Saat 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 akun layanan diberi peran sebagai Subscription Linking Admin. Perhatikan bahwa penerapan perubahan peran melalui sistem mungkin memerlukan waktu. Jika Anda menerima error 403 saat melakukan panggilan API, bahkan 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 akan digunakan atau apakah akun tersebut memiliki peran IAM yang diperlukan, gunakan Policy Analyzer dari project yang Anda siapkan untuk Penautan Langganan. Buat dan jalankan kueri kustom dengan parameter kueri berikut:

  Parameter 1	Peran
  Peran	Subscription Linking Admin

• 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 Project number yang ditentukan dalam penyiapan Penautan Langganan.
    Catatan: Project ID dan Nomor project adalah dua ID yang berbeda yang dapat Anda temukan dari dasbor project.
  • client_email: Akun layanan ini harus sama dengan akun layanan di IAM project yang ditetapkan dengan peran Subscription Linking Admin.

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

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

  • ✅ 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

Catatan: Mungkin perlu waktu beberapa menit atau lebih lama agar perubahan izin di IAM berlaku. Untuk mengetahui informasi selengkapnya, lihat Penerapan perubahan akses.

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:

• Pastikan untuk menambahkan data terstruktur ke semua artikel Anda. Gunakan Pengujian Hasil Kaya untuk memvalidasi data terstruktur Anda.
• Pastikan Anda memasukkan productID yang valid dalam data terstruktur yang sesuai dengan kumpulan ID Produk yang Anda gunakan untuk memperbarui hak pembaca.
• Gunakan laporan hasil kaya untuk "konten yang di-subscribe" di Search Console untuk melihat masalah apa pun terkait data terstruktur Anda.

Catatan: Ada faktor peringkat yang terlibat saat kami menampilkan fitur Dari Langganan Anda. Artinya, tidak ada jaminan bahwa Anda akan melihat artikel berita untuk istilah penelusuran tertentu.

Tidak dapat mengubah bahasa pesan ajakan (CTA) Penautan Langganan

Bahasa pesan ajakan Penautan Langganan ditentukan oleh setelan pengguna. Nilai ini tidak dapat diganti secara global.

Bahasa ditentukan sebagai berikut:

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

2. Jika pengguna tidak login, bahasa didasarkan pada setelan bahasa utama browser atau sistem operasi mereka.

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

##