通知：この項目にはレガシー ドキュメントがありません。そのため、現在のドキュメントが表示されています。
PushEngage を使用すると、アプリのサブスクライバーをセグメントにグループ化できるため、全員に一斉送信するのではなく、関連性の高い通知を特定のオーディエンスにターゲットできます。このガイドでは、サブスクライバーが削除されるまでグループに残る静的セグメントと、設定された日数後にサブスクライバーが自動的に削除される動的セグメントの両方について説明します。ダッシュボードの設定、iOS および Android SDK の方法、サーバーサイド管理用の REST API へのリンクが含まれています。
開始する前に
- アプリは PushEngage iOS または Android SDK と統合されている必要があります。まだ行っていない場合は、まずセットアップを完了してください。
- SDK コードで参照する前に、PushEngage ダッシュボードでセグメントを作成する必要があります。SDK に渡すセグメント名は、ダッシュボードの名前と完全に一致している必要があります（大文字と小文字を区別します）。
- 完全な SDK メソッドの参照は、iOS SDK リファレンス および Android SDK リファレンス で利用できます。
アプリプッシュセグメンテーションの仕組み
ユーザーがアプリを開き、SDK コードがセグメント追加メソッドを呼び出すと、PushEngage はアカウント内の一致するセグメントの下にそのデバイスを登録します。それ以降、そのセグメントをターゲットにしたキャンペーンには、そのサブスクライバーが含まれます。
セグメントには 2 つのタイプがあります。
静的セグメントは、サブスクライバーを明示的に削除するまで永続します。これらは、サブスクライバーのプランティア、好みのコンテンツカテゴリ、完了したオンボーディングステップなど、固定の状態を反映する永続的なグループ化に使用します。
動的セグメントには、日数で定義された有効期限があります。PushEngage は、アプリからのアクションなしにその期間が満了すると、サブスクライバーをセグメントから自動的に削除します。動的セグメントは、最近の購入ウィンドウ、アクティブな試用期間、予約後の保留など、一時的な状態に使用します。
どちらのタイプもダッシュボードで同じように作成されます。違いは、それらにサブスクライバーを追加するために呼び出す SDK メソッドにあります。
ステップ 1: ダッシュボードでセグメントを作成する
SDK がサブスクライバーをセグメントに割り当てる前に、セグメントが PushEngage に存在している必要があります。
- app.pushengage.com で PushEngage アカウントにログインします。
- オーディエンス » セグメントに移動します。
- 新しいセグメントを作成をクリックします。
- セグメント名を入力します。コードで参照しやすい、説明的な名前を使用してください。例：「最近購入したユーザー」または「プレミアムユーザー」。
- セグメントの保存をクリックします。
アプリプッシュ用のセグメントを作成する場合、URL パターンやルールを追加する必要はありません。SDK がプログラムで割り当てを処理します。
使用したいセグメントごとにこの手順を繰り返します。
ステップ 2: アプリサブスクライバーをセグメントに追加する (iOS)
購入が確認された後、ユーザーがコンテンツの選択を行った後、または特定の画面が表示されたときなど、アプリのロジックで意味のある場所からセグメントメソッドを呼び出します。
静的セグメント (iOS)
addSegments を使用して、現在の購読者を 1 つ以上のセグメントに永続的に追加します。
PushEngage.addSegments(["Premium Users", "US Customers"]) { response, error in
if response {
print("Segments added successfully.")
} else {
if let error = error {
print("Failed to add segments: \(error.localizedDescription)")
}
}
}
静的セグメントから購読者を削除するには：
PushEngage.removeSegments(["US Customers"]) { response, error in
if response {
print("Segments removed successfully.")
}
}
動的セグメント (iOS)
addDynamicSegments を使用して、購読者を指定された日数セグメントに追加します。期間が終了すると、PushEngage は自動的に購読者を削除します。
配列の各エントリは、"name"（ダッシュボードに表示されるセグメント名）と "duration"（そのセグメントに購読者を保持する日数）の 2 つのキーを持つ辞書です。
let dynamicSegments: [[String: Any]] = [
["name": "Recent Buyers", "duration": 30],
["name": "Trial Active", "duration": 14],
]
PushEngage.addDynamicSegments(dynamicSegments) { response, error in
if response {
print("Dynamic segments updated successfully.")
} else {
if let error = error {
print("Failed to update dynamic segments: \(error.localizedDescription)")
}
}
}
完全なメソッドシグネチャは、iOS SDK リファレンスで利用できます。
ステップ 3: アプリの購読者をセグメントに追加する (Android)
静的セグメント (Android)
addSegment を使用して、現在の購読者を 1 つ以上のセグメントに永続的に追加します。ダッシュボードで作成したものと完全に一致するセグメント名のリストを渡します。
Java:
List<String> segmentList = new ArrayList<>();
segmentList.add("Premium Users");
PushEngage.addSegment(segmentList, new PushEngageResponseCallback() {
@Override
public void onSuccess(Object responseObject) {
// Segment added successfully
}
@Override
public void onFailure(Integer errorCode, String errorMessage) {
// Handle failure
}
});
静的セグメントから購読者を削除するには：
List<String> segmentList = new ArrayList<>();
segmentList.add("Premium Users");
PushEngage.removeSegment(segmentList, new PushEngageResponseCallback() {
@Override
public void onSuccess(Object responseObject) {
// Segment removed successfully
}
@Override
public void onFailure(Integer errorCode, String errorMessage) {
// Handle failure
}
});
動的セグメント (Android)
addDynamicSegment を使用して、購読者を指定された日数セグメントに追加します。名前と期間を持つ Segment オブジェクトを作成し、リストで渡します。
Java:
AddDynamicSegmentRequest addDynamicSegmentRequest = new AddDynamicSegmentRequest();
List<AddDynamicSegmentRequest.Segment> segments = new ArrayList<>();
AddDynamicSegmentRequest.Segment segment = addDynamicSegmentRequest.new Segment("Recent Buyers", 30);
segments.add(segment);
PushEngage.addDynamicSegment(segments, new PushEngageResponseCallback() {
@Override
public void onSuccess(Object responseObject) {
// Dynamic segment added successfully
}
@Override
public void onFailure(Integer errorCode, String errorMessage) {
// Handle failure
}
});
完全なメソッドシグネチャと Kotlin の同等機能は、Android SDK リファレンスで利用できます。
ステップ 4: キャンペーンでセグメントをターゲットにする
購読者がセグメントに割り当てられたら、プッシュ通知キャンペーンを作成する際にそれらのセグメントをターゲットにすることができます。
- キャンペーン » プッシュブロードキャスト（一括送信の場合）に移動するか、設定したいトリガーキャンペーンを開きます。
- 新しいプッシュブロードキャストを作成をクリックするか、既存のキャンペーンを開きます。
- 通知のタイトル、メッセージ、URL を入力します。
- オーディエンスセクションで、セグメントに送信を選択します。
- ドロップダウンからセグメント名を選択します。
- キャンペーン設定の残りを完了し、スケジュール設定または送信します。
[スクリーンショット: キャンペーン作成ページでオーディエンスセクションが展開され、「セグメントに送信」が選択され、ドロップダウンからセグメントが選択されている様子]
オーディエンスグループを使用して、複数のセグメントを一度にターゲットにしたり、セグメントのターゲティングと他のオーディエンスフィルターを組み合わせたりすることもできます。詳細については、オーディエンスグループのドキュメントを参照してください。
ステップ 5: REST API を介してセグメントを管理する (オプション)
アプリのサーバーが購読者管理を処理する場合、PushEngage REST API を使用して、モバイル SDK を介さずにセグメントを作成し、購読者を割り当てることができます。
REST API のセグメントエンドポイントは次のとおりです。
| エンドポイント | メソッド | 機能 |
|---|---|---|
https://api.pushengage.com/apiv1/segments | POST | 新しいセグメントを作成 |
https://api.pushengage.com/apiv1/segments | GET | すべてのセグメントを表示 |
https://api.pushengage.com/apiv1/segments/addSegmentWithHash | POST | 購読者をサブスクライバーハッシュで追加 |
https://api.pushengage.com/apiv1/profile | POST | プロファイルIDで購読者を追加または削除 |
すべてのREST API呼び出しには、Api-KeyヘッダーにAPIキーが必要です。プロファイルIDは、購読者に割り当てる柔軟な識別子（例：メールアドレスまたはユーザーID）であり、デバイス間で同じ購読者を管理できます。
例：プロファイルIDを使用して購読者をセグメントに追加する方法：
curl -X POST \
-H "Api-Key: <your_pushengage_api_key>" \
-H "Content-Type: application/x-www-form-urlencoded" \
-d 'segment_name=Recent+Buyers&profile_id=user123&operation=add' \
"https://api.pushengage.com/apiv1/profile"
同じ購読者をセグメントから削除するには、operation=addをoperation=deleteに変更します。
完全なドキュメントについては、REST APIセグメントリファレンスを参照してください。
よくある質問
静的セグメントと動的セグメントの違いは何ですか？静的セグメントは、削除メソッドを呼び出すまで購読者をグループに保持します。動的セグメントは、購読者を追加するときに指定した日数後に自動的に期限切れになります。アカウントの種類のような永続的な状態には静的セグメントを使用します。購入後の期間や無料トライアルのような期間限定のウィンドウには動的セグメントを使用します。
動的な使用のためにダッシュボードに個別のセグメントを作成する必要がありますか？いいえ。ダッシュボードでのセグメントの作成方法は、購読者の追加方法に関係なく同じです。違いは、呼び出すSDKメソッドのみです：addSegmentsは永続的に追加し、addDynamicSegmentsは有効期限付きで追加します。
SDKに渡したセグメント名が一致しません。何を確認すべきですか？セグメント名はケースに敏感であり、プッシュエンゲージダッシュボードの名前と正確に一致する必要があります。これには、スペースと大文字/小文字が含まれます。正確な名前を確認するには、Audience » Segmentsに移動してください。
購読者は一度に複数のセグメントに属することができますか？はい。購読者は必要な数のセグメントに追加できます。セグメントにキャンペーンを送信すると、そのセグメントに現在割り当てられているすべての購読者が受信します。
セグメントは、プッシュブロードキャストだけでなく、トリガーキャンペーンでも使用できますか？はい。セグメントターゲティングは、プッシュブロードキャスト、ドリップ自動応答、およびトリガーキャンペーンで利用できます。各キャンペーンタイプの[Audience]セクションには、セグメントでターゲティングするオプションが含まれています。
セグメントに含まれる購読者はどこで確認できますか？ダッシュボードのAudience » Segmentsに移動し、セグメント名をクリックして、購読者の詳細とカウントを確認してください。
問題が発生した場合は、ここをクリックしてお気軽にお問い合わせください。サポートチームがお手伝いします。
