Marketing Cloud Engagement | MobilePush SDK 8系以前と9系以降における受信トレイメッセージの主な違いおよび考慮事項

1.メッセージ取得方式の変更

主な違いとして、SDK 9系以降ではメッセージの差分取得を行います。SDKは前回取得したメッセージ群に関するタイムスタンプを保持し、次回のメッセージ取得リクエスト時には、その値以降に更新されたメッセージのみを取得します。
一方、SDK 8系以前では、対象デバイスに紐づくアクティブな受信トレイメッセージをすべて再ダウンロードする方式です。
SDK 9系以降の差分取得方式により、以降のセクションで解説するパーソナライズへの影響が発生します。

2.取得方式の変更に伴うパーソナライズへの影響

受信トレイメッセージにおけるAMPScriptやパーソナライズ文字列の評価は、SDKがメッセージをダウンロードするタイミングで行われます。つまり対象デバイスでアプリを起動したタイミングや、メッセージのリフレッシュを要求 (refreshInbox/refreshMessagesの実行) したタイミングで評価・展開されます。

ここで、SDK 9系以降では差分のメッセージを取得するため、すでにダウンロード済みのメッセージに対してはAMPScript やパーソナライズ文字列が再評価されません。一度ダウンロードした後は、Marketing Cloud Engagement側でコンテンツやData Extensionのデータを更新しても、端末上では初回受信時に評価された値が表示され続けます。（※ただし下記の「タイムスタンプ境界のメッセージ再取得について」の例外動作も確認してください。）

SDK 8系以前では、受信トレイメッセージを常にすべて再ダウンロードするため、ダウンロードのたびに全てのメッセージでAMPScriptやパーソナライズ文字列が再評価されていました。よって Data Extension等のデータが更新された場合、次回ダウンロード時にすべてのメッセージの参照値が最新のデータに基づいて再度評価されます。

SDK 9系以降の差分を取得する方式では、メッセージダウンロード時点のデータを保持しやすい反面、Data ExtensionなどMCE上のデータに基づいて動的にコンテンツを変化させるユースケースでは、8系以前と異なるデータ管理が必要になる場合があります。
そのため8系以前において、この都度全メッセージが評価される挙動に基づいて行われていたパーソナライズを行っている場合は、9系への移行において、該当するユースケースが9系以降でも期待どおりに機能するかを検証・評価することを推奨します。

注意:タイムスタンプ境界のメッセージ再取得について

SDK 9 系では差分のみを取得しますが、具体的には端末側で保持する基準のタイムスタンプ以降のメッセージのみを取得・再評価します。

この基準タイムスタンプには「前回取得時点で最新のメッセージを基準にしたタイムスタンプ」が設定されます。そして次回以降はタイムスタンプ "以降の" メッセージが取得されます。つまり最新のメッセージ自身が毎回取得対象に含まれます。

この結果、次の挙動になります。

1. 新着の受信トレイメッセージがない場合でも、最新の1通だけは取得のたびに毎回 AMPScript などが再評価され、その時点のデータで書き換わる。それ以前のメッセージは最後の評価時の内容のまま固定される。
2. 新着メッセージが追加されると、「直前まで最新だった1通 ＋ 未取得の新着分」がまとめて取得され、これらすべてが AMPScript 再評価される。
3. その後、基準タイムスタンプは新しい最新メッセージに移動し、以降はその1通が毎回再評価される。

例) 下記の通り、10:45 のメッセージダウンロードを最後にメッセージ A はそれ以降ダウンロード対象にはならず、AMPScriptの再評価などもされません。

3. Inbox 2.0で追加された新機能とアプリでの考慮点

*上記挙動は本記事作成時点です。SDK の挙動はバージョンによって異なる場合があります。