早期アクセス これは早期アクセス機能です。アカウントを有効にするには、CSMに連絡するか、 サポートチケットを提出してください 。 |
概要
敏感な情報を含むプッシュ通知を送信するマーケターは、意図した受取人が最新のアクティブデバイスで通知を受け取ることを確認したいと考えています。これは、Eメール、SMS、およびWhatsApp通知に関しては問題ではありません。なぜなら、これらは個々のユーザーに固有のEメールIDと携帯番号に送信されるからです。また、携帯電話番号やメールIDは一般的にユーザー間で共有されることはありません。ただし、デバイスレベルで送信されるプッシュ通知は、デバイスがユーザー間で共有される可能性があるため、問題を引き起こす可能性があります。これにより、機密性の高い通知が公開される可能性があります。
この ユーザーごとのプライマリデバイス 機能を使用すると、ユーザーの最後にアクティブなデバイスにのみプッシュ通知を送信できるため、機密通知を受信する際のプライバシーを維持できます。ただし、ユーザーごとに単一または主要なデバイスをターゲットにすることで、ユーザーに関連付けられたすべてのデバイスを削除することなく保持しますが、キャンペーンは最後にアクティブなデバイスにのみ送信されます。
デバイスを検出する
MoEngageは、ユーザーレベルで全デバイスに追加のフラグを維持して、主要デバイスを検出します。このフラグは、最新のアクティブデバイスをプライマリデバイスとしてマークします。
ユーザーが複数のデバイスに関連付けられている場合、MoEngageはSDKを使用して イベント時間 を追跡します。これは、ユーザーがイベントを実行する時です。MoEngageによってキャプチャされた最新の イベント時間 に基づいて、 最新のイベント時間 を持つデバイスは、 プライマリ フラグを設定することでプライマリデバイスとしてマークされます。プライマリーフラグを持つことができるデバイスは1つだけで、残りのデバイスは持つことができません。
例えば、ユーザーU1は、D1、D2、およびD3という3つのデバイスを持っています。SDKリクエストに基づき、D2のイベント時間が他のデバイスの最新イベント時間よりも大きい場合、D2はユーザーU1のプライマリデバイスとしてマークされます。
info |
情報
|
最後にアクティブだったデバイスにキャンペーンを送信する
キャンペーンを最後にアクティブだったデバイスに送信する方法は次のとおりです:
Using the MoEngage Dashboard
MoEngage内の以下のキャンペーンタイプに対して、最後にアクティブなデバイスをターゲットにする機能が適用されます:
プッシュキャンペーン
プッシュキャンペーンを作成する際に、この機能にアクセスするには次の手順を実行してください:
- 「 ステップ 3: スケジュールと目標 」に移動します。
-
「
詳細設定
」セクションで、
最後にアクティブなデバイス
チェックボックスを選択して、このプッシュキャンペーンをターゲットユーザーの最新のアクティブデバイスにのみ送信します。
プッシュステージを伴うフローキャンペーン
フローキャンペーンを作成する際にプッシュステージでこの機能にアクセスするには、次の手順を実行してください:
- ステップ 3: 誰がフローに入るか に移動し、必要な詳細を追加して 次へ をクリックします。
- キャンバス上で、プラスアイコンをクリックして ステージを追加 します。 アクション > プッシュ 。
- 「 Pushキャンペーン 」ページで、必要な詳細を追加し、「 Advanced 」セクションに移動します。
-
ターゲットユーザーの最新のアクティブデバイスにのみこのフローキャンペーンを送信するには、
最後にアクティブなデバイス
のチェックボックスを選択できます。
プッシュチャネルで構成されたアラート
アラートキャンペーンをプッシュチャネルで作成する際に、この機能にアクセスするには、次の手順を実行します:
- 「ステップ 2: コンテンツ」に移動します。
- プッシュチャンネルに必要な詳細を入力し、 詳細設定 セクションに移動します。
-
このアラートを対象ユーザーの最新のアクティブデバイスにのみ送信するには、
最新のアクティブデバイス
チェックボックスを選択できます。
Using APIs
ユーザーの最後にアクティブなデバイスにキャンペーンを送信するために、次のAPIを使用できます:
Push APIを使用する
Push APIを使用すると、プッシュキャンペーンを作成できます。このキャンペーンをユーザーの最後にアクティブなデバイスに送信したい場合は、パラメータ targetLastActiveDevice=true. を渡してください。以下は、そのためのサンプルcURLリクエストです:
curl --location 'https://pushapi-0X.moengage.com/v2/transaction/sendpush
--header 'accept: application/json' \\
--header 'Content-Type: application/json' \\
--header 'MOE-APPKEY: {{Workspace_ID or APP_ID}}' \\
--header 'Authorization: Basic {{Authorization_Key}}' \\
--data '{
"signature": "{{signature}}",
"requestType": "push",
"responseId": "{{repsonseId}}",
"appId": "{{appId}}",
"campaignName": "サンプルキャンペーン",
"targetAudience": "全ユーザー",
"targetPlatform": [
"ANDROID",
"IOS"
],
"payload": {
"ANDROID": {
"message": "サンプルメッセージ",
"title": "サンプルタイトル",
"Summary": "サンプルサマリー",
"richContent": [
{
"type": "image",
"value": "https://www.planwallpaper.com/static/images/desktop-year-of-the-tiger-images-wallpaper.jpg"
},
{
"type": "coupon",
"value": "無料"
},
{
"type": "sound",
"value": "tring"
}
],
"defaultAction": {
"type": "navigation",
"value": "com.moengage.demoapp.SecondActivity"
},
"additionalActions": [
{
"type": "call",
"value": "12345678",
"name": "コールボタン",
"iconURL": "abc"
},
{
"type": "copy",
"value": "12345678",
"name": "コピーボタン",
"iconURL": "abc"
}
],
"fallback": {
"message": "サンプルメッセージ",
"title": "サンプルタイトル",
"richContent": [
{
"type": "image",
"value": "https://picsum.photos/200/300/?random"
},
{
"type": "coupon",
"value": "無料"
},
{
"type": "sound",
"value": "tring"
}
],
"defaultAction": {
"type": "richlanding",
"value": "https://www.google.co.in/webhp?sourceid=chrome-instant&ion=1&espv=2&ie=UTF-8"
},
"additionalActions": [
{
"type": "call",
"value": "12345678",
"name": "コールボタン",
"iconURL": "abc"
},
{
"type": "copy",
"value": "12345678",
"name": "コピーボタン",
"iconURL": "abc"
}
]
}
},
"IOS": {
"message": "サンプルメッセージ",
"title": "サンプルタイトル",
"contentAvailable": 1,
"richContent": [
{
"type": "sound",
"value": "custSound2.wav"
},
{
"type": "image",
"value": "https://picsum.photos/200/300/?random"
},
{
"type": "coupon",
"value": "これは自動化されたAPIメッセージです:51"
}
],
"additionalActions": [
{
"category": "abc"
}
],
"defaultAction": {
"type": "navigation",
"value": "",
"kvPairs": {
"key1": "value1",
"Key2": "value2"
}
},
"fallback": {
"message": "サンプルメッセージ",
"title": "サンプルタイトル",
"richContent": [
{
"type": "coupon",
"value": "iOS"
}
],
"additionalActions": [
{
"category": "abc"
}
]
}
}
},
"campaignDelivery": {
"type": "soon"
},
"advancedSettings": {
"ttl": {
"ANDROID": 12,
"WEB": 24
},
"ignoreFC": "true",
"targetLastActiveDevice": "true",
"notificationPrioritySettings": {
"ANDROID": "normal",
"IOS": 5
}
}
}'
Push API に関する詳細は、 Push API を参照してください。
Using the Inform API
Inform APIを使用すると、ユーザーの最も最近アクティブなデバイスにプッシュ通知を送信できます。この機能は、MoEngage ダッシュボード内で事前に設定されたアラートの通知をトリガーすることに制限されています。MoEngageダッシュボードで既に設定されていない新しいアラートを作成または送信するためにInform APIを使用することはできません。
Inform APIに関する詳細は、 Inform API を参照してください。
ユースケース 1: プッシュトークンパラメータを含む cURL リクエスト
次のcURLリクエストにはプッシュトークンパラメータが含まれており、以前に作成されたアラートのプッシュ通知をトリガーするために送信されます。プッシュ通知は、cURLリクエストにユーザーの最後にアクティブなデバイスのプッシュトークンが含まれている場合にのみ配信されます。
例えば、ユーザーがD1、D2、D3の3つのデバイスを持っているシナリオを考えてみましょう。D3が最後にアクティブなデバイスです。MoEngageダッシュボードでアラートを設定する際、最後にアクティブだったデバイスにアラートを送信します。cURLリクエストに最後にアクティブなデバイス(D3)のプッシュトークンパラメータが含まれている場合、プッシュ通知はリクエストに記載されたユーザーIDを持つユーザーに配信されます。ただし、APIリクエストにD1またはD2のプッシュトークンが含まれている場合、プッシュ通知は配信されません。
curl --location --request POST 'https://inform-api-0X.moengage.com/v1/send' \\
--header 'MOE-APPKEY: YOUR_APP_KEY_HERE' \\
--header 'Authorization: Basic Base64_ENCODED_APPKEY_APIKEY' \\
--header 'Content-Type: application/json' \\
--data-raw '{
"alert_id": "636b77e6e2cf83277195fb60",
"alert_reference_name": "Demo_ID",
"user_id": "USER_ID",
"transaction_id": "YOUR_TRANSACTION_ID_VAL_HERE",
"payloads": {
"PUSH": {
"recipient":"<push-token>"
}
}
}'
ユースケース 2: プッシュトークンパラメーターなしのcURLリクエスト
次のcURLリクエストにはプッシュトークンパラメータが含まれておらず、以前に作成されたアラートのプッシュ通知をトリガーするために送信されます。プッシュ通知は、ユーザーの最後にアクティブなデバイスに配信されます。
例えば、ユーザーが D1、D2、D3 の 3 つのデバイスを持っているシナリオを考えてみましょう。D3 が最後にアクティブなデバイスです。MoEngage ダッシュボードでアラートを設定する際、最後にアクティブだったデバイス (D3) にアラートを送信します。cURLリクエストにプッシュトークンが含まれていないため、プッシュ通知はリクエストに記載されたユーザーIDの最後にアクティブなデバイスに配信されます。
curl --location --request POST 'https://inform-api-0X.moengage.com/v1/send' \\
--header 'MOE-APPKEY: YOUR_APP_KEY_HERE' \\
--header 'Authorization: Basic Base64_ENCODED_APPKEY_APIKEY' \\
--header 'Content-Type: application/json' \\
--data-raw '{
"alert_id": "636b77e6e2cf83277195fb60",
"alert_reference_name": "Demo_ID",
"user_id": "USER_ID",
"transaction_id": "YOUR_TRANSACTION_ID_VAL_HERE",
"payloads": {
"PUSH": {
}
}
}'
info |
情報
|