Αντιμετώπιση προβλημάτων

Οι πληροφορίες σε αυτό το έγγραφο μπορούν να σας βοηθήσουν να αντιμετωπίσετε προβλήματα που ενδέχεται να αντιμετωπίσετε κατά την εφαρμογή της Σύνδεσης Συνδρομών .

Συμβουλή: Ανοίξτε την κονσόλα JavaScript και αναζητήστε μηνύματα σφάλματος από τη βιβλιοθήκη-πελάτη swg.js Αυτό μπορεί να σας βοηθήσει να εντοπίσετε πιθανά προβλήματα στην υλοποίησή σας.

Το CTA σύνδεσης συνδρομής κολλάει στην οθόνη φόρτωσης

Παράδειγμα σφάλματος:

Σχήμα 1. Το CTA σύνδεσης συνδρομής δεν φορτώνει.

Για να επιλύσετε αυτό το πρόβλημα, ελέγξτε τα εξής:

• Βεβαιωθείτε ότι έχετε προσθέσει την προέλευση των σελίδων, συμπεριλαμβανομένων των υποτομέων δοκιμών, ως πρόσθετες διευθύνσεις URL στις ρυθμίσεις δημοσίευσης του Κέντρου εκδοτών.
  • Βεβαιωθείτε ότι η κατάσταση της διεύθυνσης URL είναι "Επαληθευμένη" αντί για "Επαλήθευση".
• Για υλοποιήσεις Extended Access ή Reader Revenue Manager Enterprise, βεβαιωθείτε ότι έχετε προσθέσει τις προελεύσεις των σελίδων, συμπεριλαμβανομένων των υποτομέων δοκιμών, στις εξουσιοδοτημένες προελεύσεις JavaScript του OAuth 2.0 Client που έχετε διαμορφώσει για αυτήν την υλοποίηση. Αυτό πρέπει να γίνει στο Google Cloud Console.

Σημείωση: Εάν προσθέσατε πρόσφατα τις προελεύσεις, μπορεί να χρειαστεί έως και μία ώρα για να μπορέσουν αυτές οι προελεύσεις να έχουν πρόσβαση στη βιβλιοθήκη-πελάτη swg.js

Δεν ήταν δυνατή η σύνδεση του λογαριασμού

Παράδειγμα σφάλματος:

Σχήμα 2. Πρόβλημα με την αδυναμία σύνδεσης του λογαριασμού.

Για να επιλύσετε αυτό το πρόβλημα, ελέγξτε τα εξής:

• Βεβαιωθείτε ότι αποδέχεστε τους Όρους Παροχής Υπηρεσιών για τη Σύνδεση Συνδρομών στο Κέντρο Εκδοτών . Για να το κάνετε αυτό, μεταβείτε στις ρυθμίσεις Σύνδεσης Συνδρομών και κάντε κλικ στην επιλογή Υπογραφή των όρων Παροχής Υπηρεσιών για τη Σύνδεση Συνδρομών .
• Εάν ο Λογαριασμός Google έχει ήδη συνδεθεί, θα λάβετε ένα μήνυμα σφάλματος όταν επιχειρήσετε ξανά να συνδέσετε τη συνδρομή. Πρέπει να αποσυνδέσετε τη συνδρομή, μέσω της σελίδας συνδρομών στον Λογαριασμό Google, προτού επαναλάβετε τη δοκιμή ενσωμάτωσης από την πλευρά του προγράμματος-πελάτη.

Σφάλμα δικαιωμάτων κατά την κλήση του API σύνδεσης συνδρομής

Παράδειγμα σφάλματος:

Κώδικας	403
Μήνυμα	Η εντολή 'readerrevenuesubscriptionlinking.readerEntitlements.update' απορρίφθηκε στον πόρο '//readerrevenuesubscriptionlinking.googleapis.com/publications/example.com/readers/10078823/entitlements' (ή ενδέχεται να μην υπάρχει)."

Για να επιλύσετε αυτό το πρόβλημα, ελέγξτε τα εξής:

• Βεβαιωθείτε ότι χρησιμοποιείτε το ίδιο έργο όπως καθορίζεται στη ρύθμιση Σύνδεσης Συνδρομών . Όταν ρυθμίζετε τη Σύνδεση Συνδρομών στο Κέντρο Εκδοτών, χρησιμοποιήστε τον Αριθμό Έργου . Μπορείτε να εντοπίσετε τον αριθμό Έργου από τον πίνακα ελέγχου του έργου σας.
• Βεβαιωθείτε ότι το Subscription Linking API είναι ενεργοποιημένο στο έργο σας.
• Στο έργο Identity and Access Management (IAM), βεβαιωθείτε ότι στον λογαριασμό υπηρεσίας έχει εκχωρηθεί ο ρόλος του Subscription Linking Admin . Σημειώστε ότι η μετάδοση της αλλαγής ρόλου μέσω του συστήματος ενδέχεται να χρειαστεί χρόνο. Εάν λάβετε ένα σφάλμα 403 κατά την πραγματοποίηση κλήσεων API, ακόμα και αφού επιβεβαιώσετε ότι ο λογαριασμός υπηρεσίας σας έχει τον σωστό ρόλο IAM, περιμένετε λίγα λεπτά και, στη συνέχεια, δοκιμάστε ξανά το αίτημά σας.

• Εάν δεν είστε σίγουροι ποιους λογαριασμούς υπηρεσίας να χρησιμοποιήσετε ή αν διαθέτουν τον απαραίτητο ρόλο IAM, χρησιμοποιήστε το Policy Analyzer από το έργο που ρυθμίσατε για τη σύνδεση συνδρομών. Δημιουργήστε και εκτελέστε ένα προσαρμοσμένο ερώτημα με τις ακόλουθες παραμέτρους ερωτήματος:

  Παράμετρος 1	Ρόλος
  Ρόλος	Διαχειριστής σύνδεσης συνδρομών

• Βεβαιωθείτε ότι χρησιμοποιείτε το σωστό κλειδί λογαριασμού υπηρεσίας όταν καλείτε το Subscription Linking API. Ελέγξτε τις ακόλουθες ιδιότητες στο κλειδί λογαριασμού υπηρεσίας σας (αρχείο JSON):

  • τύπος: Πρέπει να είναι service_account.
  • project_id: Πρέπει να είναι το αναγνωριστικό έργου του αριθμού έργου που καθορίζεται στη ρύθμιση σύνδεσης συνδρομής.
    Σημείωση: Το Αναγνωριστικό Έργου και ο Αριθμός Έργου είναι δύο διαφορετικά αναγνωριστικά που μπορείτε να εντοπίσετε από τον πίνακα ελέγχου του έργου σας.
  • client_email: Πρέπει να είναι ο ίδιος λογαριασμός υπηρεσίας στο έργο IAM στον οποίο έχει αντιστοιχιστεί ο ρόλος Διαχειριστής σύνδεσης συνδρομών .

• Εάν αποκτήσατε το διακριτικό πρόσβασης μέσω του τελικού σημείου διακριτικού Google OAuth 2.0 (https://oauth2.googleapis.com/token), βεβαιωθείτε ότι το διακριτικό είναι έγκυρο και δεν έχει λήξει όταν καλείτε τα API σύνδεσης συνδρομής. Εάν το διακριτικό λήξει, πρέπει να αποκτήσετε ένα νέο.

• Εάν χρησιμοποιείτε το REST API, βεβαιωθείτε ότι χρησιμοποιείτε το αναγνωριστικό δημοσίευσης που παρείχατε στη ρύθμιση σύνδεσης συνδρομής . Για παράδειγμα, εάν το αναγνωριστικό δημοσίευσης είναι example.com , τότε η διεύθυνση URL αιτήματος πρέπει να το περιέχει.

  • ✅ Χρησιμοποιήστε μόνο το διαμορφωμένο αναγνωριστικό δημοσίευσης: publications/example.com/readers/10078823/entitlements
  • ❌ Μην χρησιμοποιείτε αναγνωριστικό δημοσίευσης διαφορετικό από αυτό που καθορίζεται στη διαμόρφωση σύνδεσης συνδρομής : publications/example-staging.com/readers/10078823/entitlements
  • ❌ Μην συμπεριλάβετε το προϊόν δημοσίευσης στο αίτημα: publications/example.com:premium/readers/10078823/entitlements

Σημείωση: Ενδέχεται να χρειαστούν αρκετά λεπτά ή και περισσότερο για να τεθεί σε ισχύ η αλλαγή δικαιωμάτων στο IAM. Για περισσότερες πληροφορίες, ανατρέξτε στην ενότητα Μετάδοση αλλαγών στην Access .

Σφάλμα μη έγκυρου ορίσματος κατά την ενημέρωση του δικαιώματος

Παράδειγμα σφάλματος:

Μήνυμα

Σφάλμα: Το αίτημα περιέχει ένα μη έγκυρο όρισμα

Για να επιλύσετε αυτό το πρόβλημα, ελέγξτε τα εξής:

• Βεβαιωθείτε ότι παρέχετε το αντικείμενο entitlements στη σωστή μορφή. Δείτε αυτό το παράδειγμα .
• Βεβαιωθείτε ότι product_id έχει τη μορφή publication_id:product .
  • ✅ Έγκυρο παράδειγμα: "product_id":"example.com:basic"
  • ❌ Μη έγκυρο παράδειγμα: "product_id":"example.com"

Δεν εμφανίζονται άρθρα που επισημαίνονται στα αποτελέσματα αναζήτησης

Για να επιλύσετε αυτό το πρόβλημα, ελέγξτε τα εξής:

• Βεβαιωθείτε ότι έχετε προσθέσει τα δομημένα δεδομένα σε όλα τα άρθρα σας. Χρησιμοποιήστε τη Δοκιμή Εμπλουτισμένων Αποτελεσμάτων για να επικυρώσετε τα δομημένα δεδομένα σας.
• Βεβαιωθείτε ότι έχετε τοποθετήσει ένα έγκυρο productID στα δομημένα δεδομένα που αντιστοιχεί σε ένα σύνολο Product IDs που χρησιμοποιείτε για την ενημέρωση των δικαιωμάτων του αναγνώστη .
• Χρησιμοποιήστε μια εμπλουτισμένη αναφορά αποτελεσμάτων για το "περιεχόμενο που έχετε εγγραφεί" στο Search Console για να δείτε τυχόν προβλήματα που σχετίζονται με τα δομημένα δεδομένα σας.

Σημείωση: Υπάρχουν παράγοντες κατάταξης που εμπλέκονται όταν εμφανίζουμε τη λειτουργία "Από τις συνδρομές σας" . Αυτό σημαίνει ότι δεν είναι πάντα εγγυημένο ότι θα δείτε το άρθρο ειδήσεών σας για οποιονδήποτε δεδομένο όρο αναζήτησης.

Δεν είναι δυνατή η αλλαγή της γλώσσας του μηνύματος παρότρυνσης για δράση για τη σύνδεση συνδρομής

Η γλώσσα της παρότρυνσης για δράση στη σύνδεση συνδρομής καθορίζεται από τις ρυθμίσεις του χρήστη. Δεν μπορεί να παρακαμφθεί καθολικά.

Η γλώσσα καθορίζεται ως εξής:

1. Εάν ο χρήστης είναι συνδεδεμένος με τον Λογαριασμό του Google, χρησιμοποιείται η κύρια γλώσσα που έχει οριστεί στις ρυθμίσεις του Λογαριασμού του Google ( https://myaccount.google.com/language ).

2. Εάν ο χρήστης δεν είναι συνδεδεμένος, η γλώσσα βασίζεται στην κύρια ρύθμιση γλώσσας του προγράμματος περιήγησής του ή του λειτουργικού συστήματος.

Η σύνδεση παρότρυνσης για δράση δεν υποστηρίζει όλες τις γλώσσες. Εάν η κύρια γλώσσα ενός χρήστη δεν υποστηρίζεται, η παρότρυνση για δράση ενδέχεται να είναι από προεπιλογή τα Αγγλικά.