Устранение неполадок

Информация в этом документе может помочь вам устранить неполадки, с которыми вы можете столкнуться при реализации привязки подписок .

Совет: Откройте консоль JavaScript и проверьте сообщения об ошибках клиентской библиотеки swg.js Это поможет вам выявить потенциальные проблемы в вашей реализации.

CTA-кнопка привязки подписки зависла на экране загрузки

Пример ошибки:

Рисунок 1. CTA-кнопка «Подписка» не загружается.

Чтобы решить эту проблему, проверьте следующее:

• Обязательно добавьте источники страниц, включая тестовые поддомены, в качестве дополнительных URL-адресов в настройках публикации Центра издателей.
  • Убедитесь, что статус URL-адреса — «Проверено», а не «Проверить».
• Для реализаций Extended Access или Reader Revenue Manager Enterprise обязательно добавьте источники страниц, включая тестовые поддомены, в авторизованные источники JavaScript клиента OAuth 2.0, настроенные для такой реализации. Это необходимо сделать в консоли Google Cloud.

Примечание: если вы недавно добавили источники, то может пройти до часа, прежде чем они смогут получить доступ к клиентской библиотеке swg.js

Не удалось привязать аккаунт

Пример ошибки:

Рисунок 2. Проблема с привязкой учетной записи.

Чтобы решить эту проблему, проверьте следующее:

• Обязательно примите Условия обслуживания для привязки подписок в Центре издателей . Для этого перейдите в настройки привязки подписок и нажмите «Подписать условия обслуживания для привязки подписок» .
• Если учётная запись Google уже привязана, при повторной попытке привязать подписку появится сообщение об ошибке. Перед повторным тестированием интеграции на стороне клиента необходимо отменить привязку подписки на странице подписок в учётной записи Google.

Ошибка прав доступа при вызове API привязки подписок

Пример ошибки:

Код	403
Сообщение	'readerrevenuesubscriptionlinking.readerEntitlements.update' отклонено для ресурса '//readerrevenuesubscriptionlinking.googleapis.com/publications/example.com/readers/10078823/entitlements' (или он может не существовать)."

Чтобы решить эту проблему, проверьте следующее:

• Убедитесь, что вы используете тот же проект, который указан в настройках привязки подписок . При настройке привязки подписок в Центре издателей используйте номер проекта . Номер проекта можно найти на панели управления проектами .
• Убедитесь, что в вашем проекте включен API привязки подписок .
• В проекте Identity and Access Management (IAM) убедитесь, что учётной записи службы назначена роль Subscription Linking Admin (Администратор привязки подписок ). Обратите внимание, что изменение роли может занять некоторое время. Если при выполнении вызовов API возникает ошибка 403, даже после подтверждения того, что у вашей учётной записи службы есть правильная роль IAM, подождите несколько секунд и повторите запрос.

• Если вы не уверены, какие учетные записи служб использовать или есть ли у них необходимая роль IAM, воспользуйтесь анализатором политик из проекта, который вы настроили для привязки подписок. Создайте и выполните пользовательский запрос со следующими параметрами:

  Параметр 1	Роль
  Роль	Администратор привязки подписки

• Убедитесь, что вы используете правильный ключ учётной записи сервиса при вызове 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 может вступить в силу через несколько минут или дольше. Подробнее см. в разделе Распространение изменений доступа .

Ошибка недопустимого аргумента при обновлении права

Пример ошибки:

Сообщение

Ошибка: запрос содержит недопустимый аргумент

Чтобы решить эту проблему, проверьте следующее:

• Убедитесь, что вы предоставляете объект entitlements в правильном формате. См. этот пример .
• Убедитесь, что product_id имеет формат publication_id:product .
  • ✅ Допустимый пример: "product_id":"example.com:basic"
  • ❌ Неверный пример: "product_id":"example.com"

Не вижу выделенных статей в результатах поиска

Чтобы решить эту проблему, проверьте следующее:

• Обязательно добавьте структурированные данные во все свои статьи. Используйте тест расширенных результатов для проверки структурированных данных.
• Убедитесь, что вы указали действительный productID в структурированных данных, соответствующий набору идентификаторов продукта, которые вы используете для обновления прав читателя .
• Используйте расширенный отчет о результатах для «подписанного контента» в Search Console, чтобы увидеть любые проблемы, связанные с вашими структурированными данными.

Примечание: при отображении функции «Из ваших подписок» учитываются факторы ранжирования. Это означает, что не всегда гарантируется, что вы увидите свою новостную статью по тому или иному поисковому запросу.

Невозможно изменить язык сообщения с призывом к действию при привязке к подписке.

Язык призыва к действию для ссылки на подписку определяется настройками пользователя. Его нельзя переопределить глобально.

Язык определяется следующим образом:

1. Если пользователь вошел в систему, используя свою учетную запись Google, используется основной язык, установленный в настройках его учетной записи Google ( https://myaccount.google.com/language ).

2. Если пользователь не вошел в систему, язык будет зависеть от основных языковых настроек его браузера или операционной системы.

Призывы к действию, связанные с подпиской, поддерживаются не на всех языках. Если основной язык пользователя не поддерживается, призыв к действию может быть по умолчанию на английском.