Odstraňování problémů

Informace v tomto dokumentu vám pomohou při odstraňování problémů s implementací propojení předplatných.

Tip: Otevřete konzoli JavaScriptu a vyhledejte chybové zprávy z klientské knihovny swg.js. Pomůže vám to odhalit potenciální problémy ve vaší implementaci.

Výzva ohledně propojení předplatných zaseknutá na obrazovce načítání

Příklad chyby:

Obrázek 1. Výzva ohledně propojení předplatných se nenačítá.

Pokud tento problém chcete odstranit, zkontrolujte tyto skutečnosti:

• Ujistěte se, že jste zdrojová umístění stránek, včetně testovacích subdomén, v nastavení publikace v nástroji Publisher Center přidali jako další adresy URL.
• U implementací rozšířeného přístupu nebo platformy Reader Revenue Manager Enterprise se ujistěte, že jste zdrojová umístění stránek, včetně testovacích subdomén, přidali k autorizovaným zdrojovým umístěním JavaScriptu klienta OAuth 2.0, kterého jste pro takovou implementaci nakonfigurovali. Je to potřeba provést v Google Cloud Console.

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

Účet se nepodařilo připojit

Příklad chyby:

Obrázek 2. Problém s nemožností připojit účet.

Pokud tento problém chcete odstranit, zkontrolujte tyto skutečnosti:

• V nástroji Publisher Center přijměte smluvní podmínky propojení předplatných. Přejděte do nastavení Propojení předplatných a klikněte na Podepsat smluvní podmínky propojení předplatného.
• Pokud již byl účet Google připojen, při opětovném pokusu o propojení předplatného se zobrazí chybová zpráva. Před opakováním testu integrace na straně klienta je propojení předplatného potřeba prostřednictvím stránky předplatných v účtu Google zrušit.

Chyba oprávnění při volání rozhraní Subscription Linking API

Příklad chyby:

Kód	403
Zpráva	Metoda 'readerrevenuesubscriptionlinking.readerEntitlements.update' byla u zdroje '//readerrevenuesubscriptionlinking.googleapis.com/publications/example.com/readers/10078823/entitlements' zamítnuta (nebo neexistuje).

Pokud tento problém chcete odstranit, zkontrolujte tyto skutečnosti:

• Zkontrolujte, zda používáte projekt, který jste uvedli v nastavení propojení předplatných. Při nastavování propojení předplatných v nástroji Publisher Center použijte číslo projektu. Číslo projektu najdete na panelu projektů.
• Ujistěte se, že je v projektu povoleno rozhraní Subscription Linking API.
• Ve správě identit a přístupů (IAM) projektu zajistěte, aby servisnímu účtu byla přidělena role administrátora propojení předplatných. Může nějakou dobu trvat, než se změna role v systému rozšíří. Pokud při volání rozhraní API obdržíte chybu 403, ačkoliv jste si ověřili, že váš servisní účet má správnou roli IAM, chvíli počkejte několik a pak zkuste požadavek odeslat znovu.

• Pokud nevíte, které servisní účty máte použít nebo zda mají nezbytnou roli IAM, použijte analyzátor zásad z projektu, který jste nastavili pro propojení předplatných. Vytvořte a spusťte vlastní dotaz s následujícími parametry:

  Parametr 1	Role
  Role	Administrátor propojení předplatných

• Zkontrolujte, zda při volání rozhraní Subscription Linking API používáte správný klíč servisního účtu. Zkontrolujte následující vlastnosti v klíči servisního účtu (soubor JSON):

  • type: Musí být service_account.
  • project_id: Musí se jednat o ID projektu přidružené k číslu projektu zadanému v nastavení propojení předplatných.
    Poznámka: ID projektu a číslo projektu jsou dva různé identifikátory, které najdete na panelu projektů.
  • client_email: Musí se jednat o servisní účet v IAM projektu, kterému je přiřazena role Administrátor propojení předplatných.

• Pokud jste přístupový token získali prostřednictvím koncového bodu pro tokeny Google OAuth 2.0 (https://oauth2.googleapis.com/token), při volání rozhraní Subscription Linking API se ujistěte, že je token platný a že jeho platnost nevypršela. Až platnost tokenu vyprší, budete muset 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ých. Pokud je například vaše ID publikace example.com, musí ho adresa URL požadavku obsahovat.

  • ✅ 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ých: publications/example-staging.com/readers/10078823/entitlements
  • ❌ Nezahrnujte do požadavku publikační produkt: 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 sekci o propagaci změn přístupu.

Neplatný argument při aktualizaci nároku

Příklad chyby:

Zpráva

Chyba: Požadavek obsahuje neplatný argument

Pokud tento problém chcete odstranit, zkontrolujte tyto skutečnosti:

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

Články nejsou ve výsledcích vyhledávání zvýrazněny

Pokud tento problém chcete odstranit, zkontrolujte tyto skutečnosti:

• Nezapomeňte do všech svých článků přidat strukturovaná data. Ověřte svá strukturovaná data pomocí testu rozšířených výsledků.
• Vložte do strukturovaných dat platné productID, které odpovídá sadě ID produktů, které používáte k aktualizaci nároku čtenáře.
• Pomocí přehledu rozšířených výsledků pro předplacený obsah v Search Console zobrazte případné problémy související s vašimi strukturovanými daty.

Poznámka: Při zobrazování funkce Z vašich odběrů zohledňujeme různé faktory hodnocení. To znamená, že není vždy zaručeno, že váš článek pro konkrétní vyhledávací dotaz zobrazí.