SDK メソッド

権限ダイアログを手動で起動する

プラットフォーム経由で権限ダイアログの自動起動を無効にすることもできます。この場合、独自の基準に基づいてダイアログを起動するようにします（例: 訪問者がモーダル / ソフトプロンプトとやり取りした後、特定の画面/ページを訪問した後など）。

以下のコードでダイアログを手動で起動できます:

PushSDK.PushNotifications.showPermissionPrompt(completion = { granted, response, error ->
    // オプションのコールバック
    println("ユーザーが権限を許可しました: $granted")
}

PushSDK.PushNotifications.showPermissionPrompt((granted, response, error) -> {
    // オプションのコールバック
    System.out.printf("ユーザーが権限を許可しました: %b", granted);
    return null;
});

購読者のプロフィールに属性を追加する

購読者のプロフィールに属性を追加し、後でそれらの属性に基づいてセグメント分けを行うことができます。たとえば、特定の種類のニュース（例: 政治、スポーツ）に興味がある訪問者にタグを付け、それらを特定の通知の対象にしたい場合があります。

PushSDK.UserProfile.set(key="interests", value=listOf("politics", "news"))

一度に複数の属性を設定したい場合は、値のマップを送信することもできます。以下の例では、両方を設定します is_paying_subscriber および interests 購読者の属性。

PushSDK.UserProfile.set(data=hashMapOf(
  "is_paying_subscriber" to true,
  "interests" to listOf("politics", "news")
))

プロパティの値を配列として保存している場合は、 append および remove メソッドを使って値を追加または削除します:

// 購読者の既存の興味に 'sports' を追加
PushSDK.UserProfile.append(key = "interests", values = listOf("sports"))

// 購読者の興味から 'fashion' と 'news' を削除
PushSDK.UserProfile.remove(key = "interests", values = listOf("fashion", "news"))

// 購読者の既存の興味に 'sports' を追加
PushSDK.UserProfile.append("interests", List.of("sports"));

// 購読者の興味から 'fashion' と 'news' を削除
PushSDK.UserProfile.remove("interests", List.of("fashion", "news"));

次のプロパティは append および remove メソッドを使用すると、指定された最新の20件の値のみが保存されます。

アクティビティの追跡（URL / 画面の訪問）

アプリケーション内での購読者の流れを追跡するには、アクティビティ追跡を使用できます。画面またはURL経由で追跡でき、必要に応じて関連するメタデータ/タグを渡せます。

この情報は、セグメンテーションで使用して、訪問回数や直近性に基づくタグ付きの特定のURLや画面を訪れた購読者のコホートを作成するために利用できます。例えば: 「過去30日間に少なくとも4回、"Astrology" とタグ付けされたページ/画面を訪れた購読者」.

キーワード/タグのメタデータとともに、訪問したURLまたは画面を追跡するには:

PushSDK.UserProfile.trackActivity(name="myapp://dashboard", tags=listOf("my-tag"))

また、提供するタグがない場合は tags パラメータを省略します:

PushSDK.UserProfile.trackActivity(name="https://www.pushly.com/article-1")

キーワード/タグのメタデータとともに、訪問したURLまたは画面を追跡するには:

PushSDK.UserProfile.trackActivity("myapp://dashboard", List.of("my-tag"));

また、提供するタグがない場合は 2回目 パラメータを省略します:

PushSDK.UserProfile.trackActivity("https://pushly.com/article-1");

匿名の Push ID を取得する

PushSDK は、イベント追跡とデバッグの目的で匿名の Push ID を自動的に割り当てます。

Push ID を返すには、以下のコードを実行してください:

val pushId = PushSDK.UserProfile.anonymousId

購読者の外部IDを設定する

購読者に一意のユーザーIDを提供すると、後で API を通じてその購読者とやり取りできるようになります。

購読者の外部IDが設定されたら、当社チームと連携して双方向の自動データ同期を構築できます。以下のユースケースは、パブリッシャーがサーバー間リクエストを通じて外部IDを使用する一般的な方法です。

個々の購読者にプログラムで通知を送信する
購読解除リクエストを処理する
購読者のプロフィール属性とイベントを追加および削除する

PushSDK.UserProfile.externalId = "external-id"

購読者にすでに External ID がタグ付けされているかどうかも確認できます:

val currentExternalId = PushSDK.UserProfile.externalId

訪問者がすでに購読済みかどうかを判定する

ユーザーがすでに通知の購読者であるかどうかを知る必要がある場合は、次のスニペットを使用できます:

val subscribed = PushSDK.PushNotifications.isSubscribed

訪問者がプロンプト表示の対象かどうかを判定する

val isEligible = PushSDK.PushNotifications.isEligibleToPrompt

ユーザー通知の一時停止 / 再開（ソフト購読解除）

次のメソッドを呼び出すことで、ユーザーの通知を一時停止できます:

PushSDK.PushNotifications.pause()

ユーザーの通知を再開する場合は、次のメソッドを呼び出します:

PushSDK.PushNotifications.resume()

ユーザーの通知が現在一時停止されているかを確認するには:

val isPaused = PushSDK.PushNotifications.isPaused

ユーザーを完全に削除する

ユーザーをすべての通知と追跡の対象から除外する必要がある場合は、次のメソッドを実行してください:

PushSDK.UserProfile.requestUserDeletion()

SDK のログレベルを設定する

PushSDK のログレベルは なし がデフォルトに設定されています。サポートされるログレベルは次のとおりです: 詳細, デバッグ, 情報, 警告, エラー, 重大、および なし.

より詳細なログを有効にするには、アプリケーションのメインに次のコードを追加してください onCreate メソッド:

PushSDK.logLevel = PNLogLevel.INFO

前へID 同期次へSDK コールバック

最終更新 29 日前

hashtag権限ダイアログを手動で起動する

hashtag購読者のプロフィールに属性を追加する

hashtagアクティビティの追跡（URL / 画面の訪問）

hashtag匿名の Push ID を取得する

hashtag購読者の外部IDを設定する

hashtag訪問者がすでに購読済みかどうかを判定する

hashtag訪問者がプロンプト表示の対象かどうかを判定する

hashtagユーザー通知の一時停止 / 再開（ソフト購読解除）

hashtagユーザーを完全に削除する

hashtagSDK のログレベルを設定する