Pemecahan masalah

Informasi dalam dokumen ini dapat membantu memecahkan masalah yang mungkin Anda hadapi 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.

Permintaan Penautan Langganan macet di layar pemuatan

Contoh error:

Gambar 1. Permintaan 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.
• Untuk penerapan Perluasan Akses atau Reader Revenue Manager Enterprise, pastikan Anda menambahkan asal halaman, termasuk subdomain pengujian, ke asal JavaScript resmi Klien OAuth 2.0 yang dikonfigurasi untuk penerapan tersebut. Hal ini harus dilakukan di Konsol Google Cloud.

Catatan: Jika Anda baru saja menambahkan origin, perlu waktu hingga satu jam sebelum asal 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 Anda menyetujui Persyaratan Layanan untuk Penautan Langganan di Pusat Penerbit. Untuk melakukannya, buka setelan Penautan Langganan, lalu klik tanda tangani persyaratan layanan penautan langganan.
• Jika Akun Google telah ditautkan, Anda akan menerima pesan error saat mencoba menautkan kembali langganan. 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:

Code	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 Project number dari dasbor project Anda.
• Pastikan Subscription Linking API diaktifkan di project Anda.
• Dalam 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 permintaan Anda lagi.

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

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

• Jika 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 berisi ID tersebut.

  • ✅ Hanya gunakan ID Publikasi yang dikonfigurasi: publications/example.com/readers/10078823/entitlements
  • ❌ Jangan menggunakan 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 propagasi 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 menggunakan 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 Multi 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 langganan" di Search Console guna melihat masalah apa pun yang terkait dengan data terstruktur Anda.

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