Odstraňování problémů

Informace v tomto dokumentu mohou pomoci při odstraňování problémů, se kterými se můžete setkat při implementaci propojení předplatného .

Tip: Otevřete konzolu JavaScriptu a vyhledejte chybové zprávy v klientské knihovně swg.js To vám může pomoci identifikovat potenciální problémy ve vaší implementaci.

CTA propojení předplatného se zasekla na obrazovce načítání

Příklad chyby:

Obrázek 1. CTA propojení předplatného se nenačte.

Chcete-li tento problém vyřešit, zkontrolujte následující:

• Ujistěte se, že jste do nastavení publikace Centra pro vydavatele přidali původy stránek, včetně testovacích subdomén, jako další adresy URL .
  • Ujistěte se, že stav adresy URL je „Ověřeno“ namísto „Ověřit“.
• U implementací Extended Access nebo Reader Revenue Manager Enterprise se ujistěte, že jste přidali původy stránek, včetně testovacích subdomén, k autorizovaným zdrojům JavaScriptu klienta OAuth 2.0, kterého jste pro takovou implementaci nakonfigurovali. To je třeba provést v Google Cloud Console.

Poznámka: Pokud jste nedávno přidali původy, může trvat až hodinu, než budou mít přístup ke klientské knihovně swg.js

Účet se nepodařilo propojit

Příklad chyby:

Obrázek 2. Problém s propojením účtu.

Chcete-li tento problém vyřešit, zkontrolujte následující:

• Nezapomeňte přijmout smluvní podmínky pro propojení předplatného v Centru pro vydavatele . Chcete-li tak učinit, přejděte do nastavení Propojení předplatného a klikněte na podepsat smluvní podmínky propojení předplatného .
• Pokud již byl účet Google propojen, při opětovném pokusu o propojení předplatného se zobrazí chybová zpráva. Než zopakujete test integrace na straně klienta, musíte předplatné zrušit prostřednictvím stránky odběrů v účtu Google.

Chyba oprávnění při volání rozhraní API pro propojení předplatného

Příklad chyby:

Kód	403
Zpráva	'readerrevenuesubscriptionlinking.readerEntitlements.update' odepřen u zdroje '//readerrevenuesubscriptionlinking.googleapis.com/publications/example.com/readers/10078823/entitlements' (nebo nemusí existovat).“

Chcete-li tento problém vyřešit, zkontrolujte následující:

• Ujistěte se, že používáte stejný projekt, jaký je uveden v nastavení Propojení předplatného . Když v Centru pro vydavatele nastavujete propojení odběrů, použijte číslo projektu . Číslo projektu můžete najít na řídicím panelu projektu .
• Ujistěte se, že je ve vašem projektu povoleno Subscription Linking API .
• V projektu Identity and Access Management (IAM) se ujistěte, že servisnímu účtu je přidělena role správce propojování předplatného . Všimněte si, že šíření změny role v systému může nějakou dobu trvat. Pokud se při volání rozhraní API zobrazí chyba 403, a to i poté, co potvrdíte, že váš servisní účet má správnou roli IAM, počkejte několik okamžiků a zkuste požadavek znovu.

• Pokud si nejste jisti, které servisní účty použít nebo zda mají nezbytnou roli IAM, použijte Policy Analyzer z projektu, který jste nastavili pro propojení předplatného. Vytvořte a spusťte vlastní dotaz s následujícími parametry dotazu:

  Parametr 1	Role
  Role	Správce propojení předplatného

• Ujistěte se, že používáte správný klíč servisního účtu, když voláte rozhraní Subscription Linking API. Zkontrolujte následující vlastnosti v klíči účtu služby (soubor JSON):

  • typ: Musí to být service_account.
  • project_id: Musí to být ID projektu čísla projektu zadaného v nastavení propojování předplatného.
    Poznámka: ID projektu a číslo projektu jsou dva různé identifikátory, které můžete najít na řídicím panelu projektu .
  • client_email: Musí to být stejný účet služby v projektu IAM, kterému je přiřazena role Správce propojení předplatného .

• Pokud jste přístupový token získali prostřednictvím koncového bodu tokenu Google OAuth 2.0 (https://oauth2.googleapis.com/token), při volání rozhraní API pro propojení předplatného se ujistěte, že je token platný a nevypršela jeho platnost. Pokud platnost tokenu vyprší, musíte získat nový.

• Pokud používáte REST API, ujistěte se, že používáte ID publikace, které jste zadali v nastavení propojení předplatného . Pokud je například vaše ID publikace example.com , musí jej obsahovat adresa URL požadavku.

  • ✅ Používejte pouze nakonfigurované ID publikace: publications/example.com/readers/10078823/entitlements
  • ❌ Nepoužívejte jiné ID publikace než to, které je uvedeno v konfiguraci propojení předplatného : publications/example-staging.com/readers/10078823/entitlements
  • ❌ Nezahrnujte publikační produkt do požadavku: publications/example.com:premium/readers/10078823/entitlements

Poznámka: Může trvat několik minut nebo déle, než se změna oprávnění v IAM projeví. Další informace najdete v tématu Šíření změn Accessu .

Chyba neplatného argumentu při aktualizaci nároku

Příklad chyby:

Zpráva

Chyba: Požadavek obsahuje neplatný argument

Chcete-li tento problém vyřešit, zkontrolujte následující:

• Ujistěte se, že poskytujete objekt entitlements ve správném formátu. Viz tento příklad .
• Ujistěte se, že product_id je ve formátu publication_id:product .
  • ✅ Platný příklad: "product_id":"example.com:basic"
  • ❌ Neplatný příklad: "product_id":"example.com"

Ve výsledcích vyhledávání se nezobrazují zvýrazněné články

Chcete-li tento problém vyřešit, zkontrolujte následující:

• Nezapomeňte přidat strukturovaná data do všech svých článků. Pomocí testu rozšířených výsledků ověřte svá strukturovaná data.
• Ujistěte se, že jste do strukturovaných dat vložili platné productID , které odpovídá sadě ID produktů, které používáte k aktualizaci oprávnění čtenáře .
• Pomocí přehledu rozšířených výsledků pro „předplacený obsah“ ve službě Search Console můžete zobrazit jakékoli problémy související s vašimi strukturovanými daty.

Poznámka: Při zobrazení funkce Z vašich předplatných jsou zahrnuty faktory hodnocení. To znamená, že není vždy zaručeno, že uvidíte svůj zpravodajský článek pro daný hledaný výraz.

Nelze změnit jazyk zprávy výzvy k akci propojení předplatného

Jazyk výzvy k akci Propojení předplatného je určen nastavením uživatele. Nelze jej globálně přepsat.

Jazyk se určuje takto:

1. Pokud je uživatel přihlášen pomocí svého účtu Google, použije se primární jazyk nastavený v nastavení jeho účtu Google ( https://myaccount.google.com/language ).

2. Pokud uživatel není přihlášen, je jazyk založen na primárním nastavení jazyka prohlížeče nebo operačního systému.

Předplatné Propojení výzvy k akcím nepodporuje všechny jazyky. Pokud primární jazyk uživatele není podporován, může být výchozím nastavením výzvy k akci angličtina.

##