SDK メソッド

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

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

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

Swift

PushSDK.PushNotifications.showPermissionPrompt() { granted, settings, error in
    // 任意のコールバック
    print("User accepted permissions: \(granted)")
}

Objective-C

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

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

Swift

PushSDK.UserProfile.set(["politics", "news"], forKey: "interests")

Objective-C

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

Swift

PushSDK.UserProfile.set([
  "is_paying_subscriber": true,
  "interests": ["politics", "news"]
])

Objective-C

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

Swift

// 購読者の既存の興味に 'sports' を追加
PushSDK.UserProfile.append(["sports"], to: "interests")

// 購読者の興味から 'fashion' と 'news' を削除
PushSDK.UserProfile.remove(["fashion", "news"], from: "interests")

Objective-C

以下を使うプロパティ append では、提供された最新の20個の値のみが保存されます。

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

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

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

Swift

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

PushSDK.UserProfile.trackActivity(name: "myapp://dashboard", withTags: ["my-tag"])

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

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

Objective-C

匿名の Push ID を取得する

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

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

Swift

let pushId = PushSDK.UserProfile.anonymousId

Objective-C

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

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

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

• 個々の購読者にプログラムで通知を送信する

• 購読解除リクエストを処理する

• 購読者のプロフィール属性とイベントを追加および削除する

Swift

PushSDK.UserProfile.externalId = "external-id"

Objective-C

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

Swift

let currentExternalId = PushSDK.UserProfile.externalId

Objective-C

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

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

Swift

let subscribed = PushSDK.PushNotifications.isSubscribed

Objective-C

アプリケーションがユーザーの購読状態の変化に反応する必要がある場合は、次の実装を推奨します 権限ライフサイクルデリゲート 変更があればすぐに通知を受け取れるようにするためです。

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

Swift

let isEligible = PushSDK.PushNotifications.isEligibleToPrompt

Objective-C

アプリケーションがユーザーの購読状態の変化に反応する必要がある場合は、次の実装を推奨します 権限ライフサイクルデリゲート 変更があればすぐに通知を受け取れるようにするためです。

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

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

Swift

PushSDK.PushNotifications.pause()

Objective-C

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

Swift

PushSDK.PushNotifications.resume()

Objective-C

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

Swift

PushSDK.PushNotifications.isPaused

Objective-C

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

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

Swift

PushSDK.UserProfile.requestUserDeletion()

Objective-C

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

PushSDK のログレベルは none がデフォルトに設定されています。サポートされるログレベルは次のとおりです: verbose, debug, info, warn, error, critical、および none.

Swift

PushSDK.logLevel = .info

Objective-C