Устранение неполадок и часто задаваемые вопросы в Firebase Cloud Messaging

В чём разница между компоновщиком уведомлений и FCM ?

Firebase Cloud Messaging предоставляет полный набор возможностей обмена сообщениями через свои клиентские SDK и протокол HTTP-сервера. Для развертываний со сложными требованиями к обмену сообщениями FCM — правильный выбор.

Notifications Composer — это легковесное бессерверное решение для обмена сообщениями, построенное на базе Firebase Cloud Messaging . Благодаря удобной графической консоли и сокращенным требованиям к программированию, Notifications Composer позволяет пользователям отправлять сообщения для повторного привлечения и удержания пользователей, стимулирования роста приложения и поддержки маркетинговых кампаний.

Нужно ли мне использовать другие сервисы Firebase для работы с FCM ?

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

Почему мои целевые устройства, по всей видимости, не получают сообщения?

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

Обработка уведомлений в фоновом режиме. Клиентским приложениям необходимо добавить логику обработки уведомлений, когда приложение находится на переднем плане устройства. Подробности см. для iOS и Android .

Ограничения сетевого брандмауэра. Если в вашей организации используется брандмауэр, ограничивающий трафик в Интернет и из Интернета, вам необходимо настроить его таким образом, чтобы разрешить подключение к FCM , чтобы ваши клиентские приложения Firebase Cloud Messaging могли получать сообщения. Необходимо открыть следующие порты:

• 5228
• 5229
• 5230

FCM обычно использует IP-адрес 5228, но иногда применяет 5229 и 5230. FCM не предоставляет конкретные IP-адреса, поэтому вам следует разрешить вашему брандмауэру принимать исходящие соединения со всеми IP-адресами, содержащимися в блоках IP-адресов, перечисленных в ASN Google 15169 .

Почему в моём Android-приложении не вызывается onMessageReceived ?

Когда ваше приложение находится в фоновом режиме, уведомления отображаются в системном трее, и onMessageReceived не вызывается. Для уведомлений с данными, само уведомление отображается в системном трее, а данные, содержащиеся в уведомлении, могут быть получены из интента, запускаемого при нажатии пользователем на уведомление.

Для получения дополнительной информации см. раздел «Приём и обработка сообщений» .

Почему при отправке сообщений в активный экземпляр приложения, восстановленный из резервной копии, я получаю ошибку 404?

FID (Firebase Installation ID) — это идентификатор экземпляра приложения. По умолчанию данные установки Firebase резервируются и восстанавливаются. Поэтому при восстановлении восстановленный экземпляр приложения и исходный экземпляр приложения используют один и тот же FID. Поскольку FCM хранит только один токен на каждый FID, если используются как исходный, так и восстановленный экземпляры приложения, то при регистрации одного экземпляра приложения в FCM токен другого экземпляра приложения удаляется, что приводит к ошибке 404.

Мы рекомендуем разработчикам выполнить в своих приложениях следующие действия:

• Исключите данные установки Firebase из резервной копии. Данные установки Firebase хранятся в файле PersistedInstallation....json . Имя файла является константой для приложения. Например, <exclude domain="file" path="PersistedInstallation.W0R...GQ.json" />

Компания Apple объявила о прекращении поддержки устаревшего бинарного протокола для APN. Нужно ли мне что-либо делать?

Нет. Firebase Cloud Messaging перешла на протокол APNs на основе HTTP/2 в 2017 году. Если вы используете FCM для отправки уведомлений на устройства iOS, от вас ничего не потребуется.

Как мне уведомить большую клиентскую базу за 2 минуты?

Данный вариант использования невозможен. Необходимо распределить трафик на 5 минут.

Моё приложение уведомляет пользователей о событиях, и эти сообщения должны доставляться незамедлительно для поддержки моей бизнес-модели. Могу ли я получить дополнительную квоту?

К сожалению, по этой причине мы не можем увеличить квоту. Чтобы избежать скачков трафика , вам необходимо распределить свой трафик на 5 минут.

Мои сообщения касаются запланированных событий. Как мне перенаправить весь трафик в начале каждого часа?

Мы рекомендуем начинать отправку уведомлений как минимум за 5 минут до события. В качестве альтернативы, отправляйте сообщения с данными и реализуйте аналог обработчика onMessageReceived на вашей платформе, чтобы заранее запланировать локальные уведомления.

Как я могу отслеживать использование своей квоты?

См. рекомендации Google Cloud по построению графиков и мониторингу показателей квот .

Ошибки, связанные с формой 429, создают трудности для меня и моего бизнеса. Могу ли я получить исключение или увеличить квоту, чтобы избежать получения таких ошибок?

Мы понимаем, что ограничения по квотам могут создавать сложности, но квоты жизненно важны для обеспечения надежности сервиса, и мы не можем предоставлять исключения. Используйте повторные попытки для корректной обработки ошибок 429 .

Сколько времени потребуется для выполнения моей просьбы об увеличении квоты?

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

Могу ли я получить дополнительную квоту для временного мероприятия?

Вы можете запросить дополнительную квоту для проведения мероприятия, длящегося до 1 месяца. Запрос необходимо подать не менее чем за 1 месяц до мероприятия, указав четкие даты начала и окончания мероприятия. FCM приложит все практические усилия для выполнения запроса. В случае одобрения, увеличение квоты будет отменено после окончания мероприятия.

Может ли моя текущая квота измениться?

Хотя Google не будет делать это легкомысленно, квоты могут изменяться по мере необходимости для защиты целостности системы. По возможности Google будет уведомлять вас о таких изменениях заранее. Поддерживайте актуальность контактных данных ваших партнеров по Cloud MSA , чтобы повысить вероятность получения уведомлений о работе сервиса.

Какие API и функции устарели и будут выведены из эксплуатации? Что мне следует делать, если я использую эти API?

Все API сервера InstanceId и функция групп устройств устарели и будут выведены из эксплуатации 29 сентября 2027 года. В следующей таблице приведены более подробные сведения об устаревших API/функциях и необходимых действиях.

Если я использую Firebase Admin SDK для управления подписками на темы, повлияет ли на меня прекращение поддержки этой функции? Что мне следует предпринять?

Если вы используете более ранние версии Firebase Admin SDK для управления подписками на темы, вас затронет вопрос устаревания этой функции. Вам потребуется обновить Firebase Admin SDK до следующих версий:

Увидю ли я снижение уровня предоставляемых услуг до 29 сентября 2027 года?

Нет. У вас есть 12 месяцев на миграцию с устаревших API на альтернативные без снижения уровня сервиса. Мы настоятельно рекомендуем вам спланировать миграцию как можно раньше, чтобы избежать последствий вывода из эксплуатации.

После 29 сентября 2027 года при вызове устаревших API-интерфейсов ожидаются ошибки.