ユーザーごとの主要デバイス

早期アクセス

これは早期アクセス機能です。アカウントを有効にするには、CSMに連絡するか、 サポートチケットを提出してください

概要

敏感な情報を含むプッシュ通知を送信するマーケターは、意図した受取人が最新のアクティブデバイスで通知を受け取ることを確認したいと考えています。これは、Eメール、SMS、およびWhatsApp通知に関しては問題ではありません。なぜなら、これらは個々のユーザーに固有のEメールIDと携帯番号に送信されるからです。また、携帯電話番号やメールIDは一般的にユーザー間で共有されることはありません。ただし、デバイスレベルで送信されるプッシュ通知は、デバイスがユーザー間で共有される可能性があるため、問題を引き起こす可能性があります。これにより、機密性の高い通知が公開される可能性があります。

この ユーザーごとのプライマリデバイス 機能を使用すると、ユーザーの最後にアクティブなデバイスにのみプッシュ通知を送信できるため、機密通知を受信する際のプライバシーを維持できます。ただし、ユーザーごとに単一または主要なデバイスをターゲットにすることで、ユーザーに関連付けられたすべてのデバイスを削除することなく保持しますが、キャンペーンは最後にアクティブなデバイスにのみ送信されます。

デバイスを検出する

MoEngageは、ユーザーレベルで全デバイスに追加のフラグを維持して、主要デバイスを検出します。このフラグは、最新のアクティブデバイスをプライマリデバイスとしてマークします。

ユーザーが複数のデバイスに関連付けられている場合、MoEngageはSDKを使用して イベント時間 を追跡します。これは、ユーザーがイベントを実行する時です。MoEngageによってキャプチャされた最新の イベント時間 に基づいて、 最新のイベント時間 を持つデバイスは、 プライマリ フラグを設定することでプライマリデバイスとしてマークされます。プライマリーフラグを持つことができるデバイスは1つだけで、残りのデバイスは持つことができません。

例えば、ユーザーU1は、D1、D2、およびD3という3つのデバイスを持っています。SDKリクエストに基づき、D2のイベント時間が他のデバイスの最新イベント時間よりも大きい場合、D2はユーザーU1のプライマリデバイスとしてマークされます。

info

情報

  • この機能は、Pushキャンペーン(Push APIを使用)、Pushステージを持つフロー、およびPushチャネル(Inform APIを使用)を使用したInformアラートにのみ適用されます。
  • MoEngageは、この機能を有効にした後のみ、ユーザーのデバイスをプライマリとしてマークし始めます。この機能を有効にする前に行われた歴史的なイベントは、主要デバイスを検出するためには使用されません。
  • 機能を有効にした後は、すべての月間アクティブユーザー(MAU)が主なデバイスで検出されるまで、30日間待つことをお勧めします。
  • プッシュ通知は、これらの通知に機密情報が含まれているため、検出された主要デバイスのみに送信されます。ユーザーのプライマリデバイスが検出されない場合、通知は送信されません。

最後にアクティブだったデバイスにキャンペーンを送信する

キャンペーンを最後にアクティブだったデバイスに送信する方法は次のとおりです:

Using the MoEngage Dashboard

MoEngage内の以下のキャンペーンタイプに対して、最後にアクティブなデバイスをターゲットにする機能が適用されます:

プッシュキャンペーン

プッシュキャンペーンを作成する際に、この機能にアクセスするには次の手順を実行してください:

  1. ステップ 3: スケジュールと目標 」に移動します。
  2. 詳細設定 」セクションで、 最後にアクティブなデバイス チェックボックスを選択して、このプッシュキャンペーンをターゲットユーザーの最新のアクティブデバイスにのみ送信します。
    last active device push.png

プッシュステージを伴うフローキャンペーン

フローキャンペーンを作成する際にプッシュステージでこの機能にアクセスするには、次の手順を実行してください:

  1. ステップ 3: 誰がフローに入るか に移動し、必要な詳細を追加して 次へ をクリックします。
  2. キャンバス上で、プラスアイコンをクリックして ステージを追加 します。 アクション > プッシュ
  3. Pushキャンペーン 」ページで、必要な詳細を追加し、「 Advanced 」セクションに移動します。
  4. ターゲットユーザーの最新のアクティブデバイスにのみこのフローキャンペーンを送信するには、 最後にアクティブなデバイス のチェックボックスを選択できます。 flow with push.png

プッシュチャネルで構成されたアラート

アラートキャンペーンをプッシュチャネルで作成する際に、この機能にアクセスするには、次の手順を実行します:

  1. 「ステップ 2: コンテンツ」に移動します。
  2. プッシュチャンネルに必要な詳細を入力し、 詳細設定 セクションに移動します。
  3. このアラートを対象ユーザーの最新のアクティブデバイスにのみ送信するには、 最新のアクティブデバイス チェックボックスを選択できます。
    Inform alerts- push-last active device.png

Using APIs

ユーザーの最後にアクティブなデバイスにキャンペーンを送信するために、次のAPIを使用できます:

Push APIを使用する

Push APIを使用すると、プッシュキャンペーンを作成できます。このキャンペーンをユーザーの最後にアクティブなデバイスに送信したい場合は、パラメータ targetLastActiveDevice=true. を渡してください。以下は、そのためのサンプルcURLリクエストです:

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
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
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

情報

  • 最後にアクティブなデバイスは、モバイルデバイス、つまりAndroidおよびiOSプラットフォームに対してのみ計算されます。
  • プッシュ通知は、アラートを作成する際にウェブプラットフォームが選択されると、すべてのウェブデバイスに配信されます。
    例えば、ユーザーが3つのデバイスを持っているシナリオを考えてみましょう: D1(ウェブデバイス)、D2(ウェブデバイス)、D3(Androidデバイス)で、D3が最後にアクティブなデバイスです。MoEngageダッシュボードでアラートを設定する際に、Androidとウェブプラットフォームを選択し、最後にアクティブなデバイス(D3、Androidデバイス)にアラートを送信することを選択します。この場合、プッシュ通知は最後にアクティブなデバイス(D3)と両方のウェブデバイス(D1およびD2)に配信されます。

この記事は役に立ちましたか?
0人中0人がこの記事が役に立ったと言っています

How can we improve this article?