アプリメッセージ

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

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

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

前提条件

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

• iOSアプリ

• iOS 11.0以降がインストールされたデバイスまたはエミュレーター

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

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

アプリケーションが まだ PushSDKを使用していない場合は、ネイティブアプリのPushセットアップガイドを参照してください。 Apple / iOS.

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

SDK	App Messagesを含む最初のバージョン
Objective-C / Swift	1.3.0+
React Native SDK	1.2.0+
Flutter SDK	1.2.0+

Swift Package Manager

Xcodeのプロジェクトナビゲーターパネル内で Package Dependenciesを見つけて右クリックし、 Pushly を選択します。 Update Package.

更新後にパッケージが 1.3.0 以上でない場合は、プロジェクトナビゲータでプロジェクトを選択し、プロジェクトを選択してから、次へ移動します Package Dependencies。次を選択します Pushly に移動し、 Dependency Rule が Up to Next Major Version を、1.3.0以上を対象として。

CocoaPods

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

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

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

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

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

Swift

PushSDK.AppMessages.trigger(condition: "enabled_subscription", withValue: "true")

Objective-C

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

Swift

PushSDK.AppMessages.trigger(conditions: [
    "enabled_subscription": "true",
    "subscriber_tier": "premium"
])

Objective-C

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

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