Базовое руководство по интеграции Cordova SDK

В этом разделе содержится информация о том, как интегрировать Pushwoosh Cordova SDK в ваше приложение.

Для интеграции Pushwoosh Cordova SDK в ваше приложение вам потребуется следующее:

Добавьте зависимость Pushwoosh Cordova SDK в ваш проект:

cordova plugin add pushwoosh-cordova-plugin

В корневом компоненте вашего файла index.js:

• Инициализируйте Pushwoosh SDK.
• Вызовите registerDevice() в вашей логике инициализации, чтобы зарегистрироваться для получения push-уведомлений.

function onDeviceReady() {
    var pushwoosh = cordova.require("pushwoosh-cordova-plugin.PushNotification");

    pushwoosh.onDeviceReady({
        appid: "__YOUR_APP_ID__",
        projectid: "__YOUR_FCM_SENDER_ID__"
    });

    pushwoosh.registerDevice(
    function(status) {
        var pushToken = status.pushToken;
        // Обработка успешной регистрации
    },
    function(status) {
        // Обработка ошибки регистрации
  }
);

Где:

• __YOUR_APP_ID__ — это код приложения (application code) из Панели управления Pushwoosh.
• __YOUR_FCM_SENDER_ID__ — это номер проекта Firebase из Firebase Console.

Чтобы включить Push-уведомления в вашем проекте, вам нужно добавить определенные capabilities.

В разделе Signing & Capabilities добавьте следующие capabilities:

• Push Notifications
• Background Modes. После добавления этой capability, установите флажок Remote notifications.

Если вы собираетесь использовать Time Sensitive Notifications (iOS 15+), также добавьте capability Time Sensitive Notifications.

В вашем файле Runner/Info.plist установите для ключа __PUSHWOOSH_DEVICE_API_TOKEN__ значение Pushwoosh Device API Token:

<key>Pushwoosh_API_TOKEN</key>
<string>__PUSHWOOSH_DEVICE_API_TOKEN__</string>

Вы должны добавить Notification Service Extension в ваш проект. Это необходимо для точного отслеживания доставки и использования таких функций, как Rich Media на iOS.

Следуйте шагам из нативного руководства, чтобы добавить расширение и необходимый код Pushwoosh в него.

Убедитесь, что необходимые зависимости и плагины добавлены в ваши Gradle-скрипты:

Добавьте плагин Google Services Gradle в зависимости на уровне проекта build.gradle:

buildscript {
  dependencies {
    classpath 'com.google.gms:google-services:4.3.15'
  }
}

Примените плагин в файле build.gradle на уровне приложения:

apply plugin: 'com.google.gms.google-services'

Поместите файл google-services.json в папку android/app в каталоге вашего проекта.

В вашем main/AndroidManifest.xml добавьте Pushwoosh Device API Token внутри тега <application>:

<meta-data android:name="com.pushwoosh.apitoken" android:value="__YOUR_DEVICE_API_TOKEN__" />

Важно: Убедитесь, что вы предоставили токену доступ к нужному приложению в Панели управления Pushwoosh. Узнать больше

1. Соберите и запустите проект.
2. Перейдите в Панель управления Pushwoosh и отправьте push-уведомление.
3. Вы должны увидеть уведомление в приложении.

На этом этапе вы уже интегрировали SDK и можете отправлять и получать push-уведомления. Теперь давайте рассмотрим основную функциональность.

В Pushwoosh SDK есть два прослушивателя событий, предназначенных для обработки push-уведомлений:

• onPushReceived событие срабатывает, когда получено push-уведомление
• onPushAccepted событие срабатывает, когда пользователь открывает уведомление

Вам следует настроить эти прослушиватели событий сразу после инициализации SDK при запуске приложения:

class PushwooshNotificationHandler {
  setupPushListeners() {

    document.addEventListener('push-receive',
      function(event) {
        console.log("Push получен: " + event.notification.message);
      }
    );

    document.addEventListener('push-notification',
      function(event) {
        console.log("Push принят: " + event.notification.message);
      }
    );
  }
}

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

class Registration {
  afterUserLogin(user) {

    // Установка ID пользователя
    pushwoosh.setUserId(user.getId());

    // Установка дополнительной информации о пользователе в виде тегов для Pushwoosh
    pushwoosh.setTags({
      "age": user.getAge(),
      "name": user.getName(),
      "last_login": user.getLastLoginDate()
    });
  }
}

Теги — это пары «ключ-значение», назначаемые пользователям или устройствам, которые позволяют сегментировать аудиторию на основе таких атрибутов, как предпочтения или поведение, обеспечивая таргетированную отправку сообщений.

class UpdateUser {
  afterUserUpdateProfile(user) {

    // Установка списка любимых категорий
    pushwoosh.setTags({
      "favorite_categories": user.getFavoriteCategoriesList()
    });

    // Установка платежной информации
    pushwoosh.setTags({
      "is_subscribed": user.isSubscribed(),
      "payment_status": user.getPaymentStatus(),
      "billing_address": user.getBillingAddress()
    });
  }
}

События — это определенные действия пользователя или происшествия в приложении, которые можно отслеживать для анализа поведения и запуска соответствующих сообщений или действий.

class Registration {

  // Отслеживание события входа
  afterUserLogin(user) {
    pushwoosh.postEvent("login", {
      "name": user.getName(),
      "last_login": user.getLastLoginDate()
    });
  }

  // Отслеживание события покупки
  afterUserPurchase(product) {
    pushwoosh.postEvent("purchase", {
      "product_id": product.getId(),
      "product_name": product.getName(),
      "price": product.getPrice(),
      "quantity": product.getQuantity()
    });
  }
}

Если у вас возникнут какие-либо проблемы в процессе интеграции, обратитесь к разделу поддержка и сообщество.