アプリメッセージ

Pushly PushSDK を使用して Android アプリケーションにアプリメッセージサポートを追加するためのクイックスタートガイド

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, 1.3[ アプリの gradle に追加します。

• gradle の同期を実行します。

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

ステップ2: App Messageを作成してスケジュールする

Pushly Platformを使用して、最初の App Message.

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

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

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

Kotlin

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

Java

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

Kotlin

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

Java

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

こちらの SDK コールバック ドキュメントを参照して、App Messagesのライフサイクルイベントの処理方法について確認してください。