アプリメッセージ

Pushly PushSDKでAndroidアプリにApp Messageサポートを追加するためのクイックスタートガイド

App Messages は、Push Notifications や Live Activities とは異なり、サブスクリプショントークンを必要とせずに、ユーザーベースとやり取りし、エンゲージすることができます。App Message は、プログラムで提供できるカスタム条件を含む、さまざまな基準に基づいて自動的に表示するよう設定できます。

カスタム条件付きの App Messages では、PushSDK により、これらの条件が満たされたことを通知するための便利なメソッドや、特定のライフサイクルイベントを監視する機能が提供されます。

前提条件

SDK に App Messages を統合する前に、以下の要件を満たす必要があります:

• を使用するアプリ Jetpack（AndroidX）

• Google Play ストア サービスがインストールされた、API 19 以上（Android 4.4）を実行する Android デバイスまたはエミュレーター。

• App Messages をサポートする PushSDK リリース（下のバージョンサポート表を参照）

ステップ 1: Android SDK のセットアップ

アプリケーションが まだ PushSDK を使用していない場合は、ネイティブアプリ Push のセットアップガイドをご覧ください: Android.

すでに PushSDK を使用しているアプリケーションでは、App Message サポートを含む後のバージョンへのアップグレードが必要になる場合があります。以下の表を使用して、インストールのアップグレードが必要かどうかを判断してください。

SDK	App Messages をサポートする最初のバージョン
Java / Kotlin	1.2.0+
React Native SDK	1.2.0+
Flutter SDK	1.2.0+

app/build.gradle

• 対象になっていることを確認してください com.pushly.android:pushsdk:[1.2, 2.0[ をアプリの gradle で。

• gradle sync を実行します。

dependencies {
    ...
    implementation 'com.pushly.android:pushsdk:[1.2, 2.0['
}

ステップ 2: App Message の作成とスケジュール設定

Pushly プラットフォームを使用して、最初の App Message.

ステップ 3:（任意）App Message のカスタム条件をトリガーする

カスタム条件を使用する場合、PushSDK はこれらの条件をプログラムで提供し、その後、現在アクティブで提供された条件に一致する App Messages を評価するトリガーとなります。

ほとんどの場合、一度に 1 つの条件がトリガーされ、評価されます。このような場合は、 trigger(condition: String, value: String) のメソッドシグネチャを使用します。

Kotlin

PushSDK.AppMessages.trigger(condition = "enabled_subscription", value = "true")

Java

PushSDK.AppMessages.trigger("enabled_subscription", "true");

ただし、評価のために複数の条件を一度にトリガーする方が便利な場合もあります。このような場合は、任意の数の条件を含む HashMap を trigger(conditions: HashMap<String, String>) のメソッドシグネチャを使用します。

Kotlin

PushSDK.AppMessages.trigger(conditions = hashMapOf(
    "enabled_subscription" to "true",
    "subscriber_tier" to "premium"
))

Java

PushSDK.AppMessages.trigger(Map.of(
    "enabled_subscription", "true",
    "subscriber_tier", "premium"
));

ステップ 4:（任意）App Message のライフサイクルイベントを監視する

こちらの SDK コールバック ドキュメントで、App Messages のライフサイクルイベントの処理に関する情報をご覧ください。