← Все инструкции

Firebase, аналитика, реклама и пуши

Шпаргалка: что и зачем настраивать в новом Expo-приложении, чтобы события уходили в Google Analytics, реклама в Google Ads видела установки, а пуш-уведомления доходили. Значения в примерах взяты из AiAstrology, в новом приложении подставь свои (таблица в самом конце).

Как всё связано

Это две независимые цепочки. Первая — аналитика и реклама: приложение рассказывает Google, кто установил приложение и что делал. Вторая — пуши: сервер отправляет уведомления через Expo. Общее у них одно: оба работают через один Firebase-проект, а на Android пушам тоже нужен google-services.json.

Кто есть кто

Чек-лист для нового приложения

Шаги по порядку. Галочки сохраняются только в этом браузере.

• Создать Firebase-проект

  один раз на приложение
• Добавить в проект Android и iOS приложения, скачать конфиги
• Поставить Firebase SDK и плагин в app.json
• Отправлять события из track() в Firebase
• Проверить, что события приходят (DebugView)
• Отметить ключевые события в Google Analytics

  через сутки после первых событий
• Связать Google Ads с Google Play и Firebase, импортировать конверсии
• Пуши Android: загрузить ключ FCM V1 в Expo
• Пуши iOS: загрузить APNs-ключ в Expo
• Отправить тестовый пуш
• Выпустить версию в сторы

  до этого реальных пользователей в отчётах не будет

1Создать Firebase-проект

1. console.firebase.google.com → Create a project.
2. На шаге про Google Analytics оставить его включённым и выбрать или создать GA-аккаунт. Без этого события некуда будет складывать. Если забыл: Project settings → Integrations → Google Analytics.

В AiAstrology проект называется aiastrology-3a616.

2Добавить приложения и скачать конфиги

⚙️ Project settings → General, ниже блок Your apps.

Android

Add app → Android, package name как expo.android.package в app.json. SHA-1 не обязателен (нужен для Google Sign-In, берётся из eas credentials). Скачать google-services.json.

iOS

Add app → значок iOS+.

Заполнить и нажать Register app:

• Apple bundle ID — как expo.ios.bundleIdentifier в app.json. Если не совпадёт, SDK не примет конфиг.
• App nickname — любое, только для консоли.
• App Store ID — число из ссылки на приложение в App Store (apps.apple.com/.../id6756072533). По нему Google Ads связывает события с приложением в сторе. Если приложения в сторе ещё нет, можно добавить позже.

Скачать GoogleService-Info.plist. Следующие шаги мастера, «Add Firebase SDK» и «Add initialization code», пропустить (Next → Continue to console). Они для нативного Swift-проекта, а у нас SDK ставится через npm, и инициализацию плагин добавляет сам (шаг 3).

Куда положить

Если в консоли что-то поменяли у приложения (SHA, OAuth client), конфиг нужно скачать заново. В plist может стоять IS_ANALYTICS_ENABLED = false: это устаревшее поле, SDK его не читает.

3Поставить SDK и плагин

yarn add @react-native-firebase/app @react-native-firebase/analytics

В AiAstrology стоит версия 26.4.0: версия 27 требует Node ≥ 24, а в проекте Node 20. Проверь node -v и, если нужно, укажи версию явно: @26.4.0.

app.json:

"ios":     { "googleServicesFile": "./GoogleService-Info.plist" },
"android": { "googleServicesFile": "./google-services.json" },
"plugins": [
  ["@react-native-firebase/app", { "ios": { "disableSPM": true } }],
  ["expo-build-properties", { "ios": { "extraPods": [
    { "name": "FirebaseCore", "modular_headers": true },
    { "name": "FirebaseCoreInternal", "modular_headers": true },
    { "name": "FirebaseCoreExtension", "modular_headers": true },
    { "name": "FirebaseInstallations", "modular_headers": true },
    { "name": "GoogleDataTransport", "modular_headers": true },
    { "name": "GoogleUtilities", "modular_headers": true },
    { "name": "nanopb", "modular_headers": true }
  ] } }]
]

• disableSPM: true: без него pod install падает с «SPM + static linkage is not supported».
• modular_headers для Firebase-подов: позволяет обойтись без useFrameworks: "static", который ломает другие библиотеки.

Что плагин добавит при prebuild:

Потом пересобрать: npx expo prebuild и обычная сборка. В Expo Go Firebase не работает, нужен dev build.

4Отправлять события в Firebase

Не нужно трогать экраны: достаточно в общей функции track() (src/services/analytics/index.ts) отправлять событие ещё и в Firebase.

reportEvent(name, attributes);          // AppMetrica
reportFirebaseEvent(name, attributes);  // Firebase

src/services/analytics/firebase.ts — можно копировать в новое приложение как есть:

import { getAnalytics, logEvent, logScreenView } from "@react-native-firebase/analytics";

/** Names Firebase reserves for its own automatic events (it collects those itself). */
const SKIPPED = new Set(["session_start", "app_background", "ad_impression"]);

export const reportFirebaseEvent = (name: string, params: Record<string, string | number | boolean>) => {
  if (SKIPPED.has(name)) return;
  try {
    const analytics = getAnalytics();
    const promise =
      name === "screen_view"
        ? logScreenView(analytics, { screen_name: String(params.screen), screen_class: String(params.screen) })
        : logEvent(analytics, name, params);
    void Promise.resolve(promise).catch((e: unknown) => {
      if (__DEV__) console.warn("Firebase logEvent failed", name, e);
    });
  } catch (e) {
    if (__DEV__) console.warn("Firebase logEvent failed", name, e);
  }
};

5Проверить в DebugView

iOS, запуск из Xcode

Product → Scheme → Edit Scheme → Run → Arguments → Arguments Passed On Launch → «+» → -FIRDebugEnabled.

iOS, запуск через npm run ios

expo run:ios аргументы из схемы не передаёт, поэтому перезапусти приложение с флагом (Metro продолжает работать):

xcrun simctl terminate booted com.kapernikrs.aiastrology
xcrun simctl launch booted com.kapernikrs.aiastrology -FIRDebugEnabled

Android

adb shell setprop debug.firebase.analytics.app com.kapernikrs.aiastrology

Выключить: adb shell setprop debug.firebase.analytics.app .none., на iOS — запустить с -FIRDebugDisabled.

Как должно выглядеть: через 10–60 секунд идёт поток событий (screen_view, onboarding_step_completed…), зелёный флажок у first_open. Надпись «Debug Device 0» не страшна, если события идут.

Если пусто: проверь, что в Firebase подключён Google Analytics (Project settings → Integrations), и поищи FirebaseAnalytics в консоли Xcode. Без режима отладки события уходят пачкой примерно раз в час.

6Отметить ключевые события в Google Analytics

Это делается в Google Analytics, не в Firebase: analytics.google.com или кнопка View more in Google Analytics в DebugView. Дальше Admin → Data display → Events.

Вкладка Key events показывает только уже отмеченные. Отмечать нужно на вкладке Recent events звёздочкой ☆ слева от имени.

У нового ресурса Recent events первые сутки пустой. Это нормально, просто вернись завтра.

7Подключить Google Ads

1. Android-установки: Google Ads → Инструменты → Связанные аккаунты → Google Play → запрос. Подтвердить в Play Console: Настройки → Связанные сервисы → Google Ads. Затем Цели → Конверсии → Новое действие → Приложение → Google Play → Установки.
2. Firebase ↔ Google Ads: Firebase → Project settings → Integrations → Google Ads → Link. Нужны Owner/Editor в Firebase и Admin в Google Ads.
3. Импорт конверсий: Google Ads → Цели → Конверсии → «+ Новое действие-конверсия» → Импорт → Google Analytics 4 → Приложение. Отметить first_open и ключевые события из шага 6.

Совет: сначала оптимизировать кампанию на first_open или onboarding_completed. На покупки переключаться, когда их хотя бы 10–20 в день, иначе алгоритму не хватает данных.

Что уже есть в коде AiAstrology (переносится в новое приложение)

8Android: ключ FCM V1 в Expo

1. google-services.json должен быть в сборке (шаг 2). Без него на устройстве getExpoPushTokenAsync падает с ошибкой про FirebaseApp.
2. Firebase → Project settings → Service accounts → Generate new private key. Скачается JSON. Ссылка для AiAstrology.
3. Загрузить JSON в Expo: eas credentials → Android → production → Google Service Account → Push Notifications (FCM V1). Или на expo.dev → проект → Credentials → Android.

9iOS: APNs-ключ в Expo

1. Проще всего: eas credentials → iOS → production → Push Notifications → Set up a new key. EAS сам создаст ключ в Apple и привяжет его к проекту. Capability Push Notifications EAS тоже включает сам.
2. Вручную: developer.apple.com → Certificates, IDs & Profiles → Keys → «+» → Apple Push Notifications service → скачать .p8 (скачивается только один раз), записать Key ID и Team ID → загрузить в eas credentials. Один APNs-ключ подходит для всех приложений аккаунта.

10Отправить тестовый пуш

1. Взять токен с реального устройства (симулятор iOS токен не даёт), например из коллекции MobilePushToken после логина.
2. Отправить через expo.dev/notifications или так:

   curl -H "Content-Type: application/json" -X POST https://exp.host/--/api/v2/push/send \
     -d '{"to":"ExponentPushToken[...]","title":"Test","body":"Hello","data":{"screen":"horoscope"}}'

3. В ответе будет id. Через минуту проверить, что Google/Apple приняли пуш:

   curl -H "Content-Type: application/json" -X POST https://exp.host/--/api/v2/push/getReceipts \
     -d '{"ids":["<id>"]}'

На сервере используется new Expo() без токена. Если на expo.dev включить Enhanced Security for Push Notifications, нужен access token (expo.dev → Account settings → Access tokens) в server/.env и new Expo({ accessToken }).

11Выпустить версию

Реальные пользователи появятся в Firebase и Google Ads только после выхода версии с Firebase в App Store и Google Play. Рекламу на установки запускать после этого.

Значения AiAstrology

В новом приложении замени их на свои.

Грабли, на которые уже наступали