Risoluzione dei problemi

Le informazioni in questo documento possono aiutarti a risolvere i problemi che potresti riscontrare durante l'implementazione del collegamento degli abbonamenti.

Suggerimento: apri la console JavaScript e cerca messaggi di errore nella swg.js libreria client. Questo può aiutarti a identificare potenziali problemi nella tua implementazione.

Invito all'azione per il collegamento degli abbonamenti bloccato sulla schermata di caricamento

Esempio di errore:

Figura 1. L'invito all'azione per il collegamento degli abbonamenti non viene caricato.

Per risolvere il problema, verifica quanto segue:

• Assicurati di aggiungere le origini delle pagine, inclusi i sottodomini di test, come URL aggiuntivi nelle impostazioni della pubblicazione nel Publisher Center.
  • Assicurati che lo stato dell'URL sia "Verificato" anziché "Verifica".
• Per le implementazioni di accesso esteso o Reader Revenue Manager Enterprise, assicurati di aggiungere le origini delle pagine, compresi i sottodomini di test ai sottodomini origini JavaScript autorizzate del client OAuth 2.0 configurato per questa implementazione. Questa operazione deve essere effettuata nella console Google Cloud.

Nota: se hai aggiunto le origini di recente, può essere necessaria fino a un'ora prima che queste origini possano accedere alla swg.js libreria client.

Impossibile collegare l'account

Esempio di errore:

Figura 2. Problema Impossibile collegare l'account.

Per risolvere il problema, verifica quanto segue:

• Assicurati di accettare i Termini di servizio per il collegamento degli abbonamenti nel Centro editori. A questo scopo, vai alle impostazioni Collegamento degli abbonamenti e fai clic su Firma i Termini di servizio per il collegamento degli abbonamenti.
• Se l'Account Google è già stato collegato, riceverai un messaggio di errore quando cercherai di nuovo di collegare l'abbonamento. Prima di ripetere il test di integrazione lato client devi scollegare l'abbonamento tramite la pagina Abbonamenti nell'Account Google.

Errore relativo alle autorizzazioni durante la chiamata dell'API Subscription Linking

Esempio di errore:

Codice	403
Messaggio	'readerrevenuesubscriptionlinking.readerEntitlements.update' negata per la risorsa '//readerrevenuesubscriptionlinking.googleapis.com/publications/example.com/readers/10078823/entitlements' (oppure la risorsa potrebbe non esistere)."

Per risolvere il problema, verifica quanto segue:

• Assicurati di usare lo stesso progetto specificato nella configurazione di Collegamento degli abbonamenti. Quando configuri Collegamento degli abbonamenti nel Publisher Center, usa il numero di progetto. Il numero di progetto si trova nella dashboard dei progetti.
• Assicurati che l'API Subscription Linking sia attiva nel tuo progetto.
• Nel progetto Identity and Access Management (IAM), assicurati di aver assegnato il ruolo di Amministratore collegamento abbonamenti al service account. Tieni presente che la propagazione della modifica del ruolo nel sistema potrebbe richiedere un po' di tempo. Se ricevi l'errore 403 mentre effettui chiamate API anche dopo aver confermato che il service account ha il ruolo IAM corretto, attendi qualche minuto e riprova a inviare la richiesta.

• Se non sai quale service account usare o se ha il ruolo IAM necessario, usa Policy Analyzer nel progetto configurato per Collegamento degli abbonamenti. Crea ed esegui una query personalizzata con i seguenti parametri:

  Parametro 1	Ruolo
  Ruolo	Subscription Linking Admin

• Assicurati di usare la chiave del service account corretta per chiamare l'API Subscription Linking. Controlla le seguenti proprietà nella chiave dell'account di servizio (file JSON):

  • type:deve essere service_account.
  • project_id:deve essere l'ID progetto del numero di progetto specificato nella configurazione di Collegamento degli abbonamenti.
    Nota:l'ID progetto e il numero di progetto sono due identificatori diversi e si trovano nella dashboard dei progetti.
  • client_email:deve corrispondere al service account del progetto IAM a cui è stato assegnato il ruolo di Amministratore collegamento abbonamenti.

• Se hai ottenuto il token di accesso tramite l'endpoint token di Google OAuth 2.0 (https://oauth2.googleapis.com/token), assicurati che il token sia valido e non scaduto quando chiami le API Subscription Linking. Se il token scade, dovrai richiederne uno nuovo.

• Se usi l'API REST, assicurati di usare l'ID pubblicazione specificato nella configurazione di Collegamento degli abbonamenti. Ad esempio, se il tuo ID pubblicazione è example.com, deve essere presente nell'URL della richiesta.

  • ✅ Usa soltanto l'ID pubblicazione configurato: publications/example.com/readers/10078823/entitlements
  • ❌ Non usare un ID pubblicazione diverso da quello specificato nella configurazione di Collegamento degli abbonamenti: publications/example-staging.com/readers/10078823/entitlements
  • ❌ Non includere il prodotto di pubblicazione nella richiesta: publications/example.com:premium/readers/10078823/entitlements

Nota: la modifica dell'autorizzazione in IAM potrebbe richiedere diversi minuti o più tempo. Per scoprire di più, consulta Propagazione della modifica di accesso.

Errore relativo a un argomento non valido durante l'aggiornamento del diritto

Esempio di errore:

Messaggio

Errore: la richiesta contiene un argomento non valido

Per risolvere il problema, verifica quanto segue:

• Assicurati di specificare l'oggetto entitlements nel formato corretto. Vedi questo esempio.
• Assicurati che product_id sia nel formato publication_id:product.
  • ✅ Esempio valido: "product_id":"example.com:basic"
  • ❌ Esempio non valido: "product_id":"example.com"

Gli articoli messi in evidenza non vengono mostrati nei risultati di ricerca

Per risolvere il problema, verifica quanto segue:

• Assicurati di aggiungere i dati strutturati a tutti i tuoi articoli. Utilizza il Test dei risultati avanzati per convalidare i dati strutturati.
• Assicurati di inserire nei dati strutturati un productID valido corrispondente a un insieme di ID prodotto che usi per aggiornare il diritto dei lettori.
• Utilizza un report sui risultati avanzati relativo ai "contenuti in abbonamento" in Search Console per controllare eventuali problemi relativi ai tuoi dati strutturati.

Nota: per la visualizzazione della funzionalità Dai tuoi abbonamenti sono coinvolti diversi fattori di ranking. Ciò significa che non è sempre garantito che tu veda il tuo articolo per un determinato termine di ricerca.

Impossibile modificare la lingua del messaggio dell'invito all'azione per il collegamento degli abbonamenti

La lingua dell'invito all'azione per il collegamento degli abbonamenti dipende dalle impostazioni dell'utente, che non possono essere ignorate globalmente.

Ecco come viene determinata la lingua:

1. Se l'utente ha eseguito l'accesso con il suo Account Google, verrà utilizzata la lingua principale selezionata nelle impostazioni dell'account (https://myaccount.google.com/language).

2. Se l'utente non ha eseguito l'accesso, verrà utilizzata la lingua principale selezionata nelle impostazioni del browser o del sistema operativo.

Gli inviti all'azione per il collegamento degli abbonamenti non supportano tutte le lingue. Se la lingua principale dell'utente non è supportata, l'invito all'azione sarà in inglese per impostazione predefinita.