MobilePush Detail Extract Report (MobilePush 詳細抽出レポート) のデータ内容に関する FAQ

Q1. MobilePush Detail Extract Reportに出力される各項目の定義について教えてください
A.項目の意味は下記のドキュメントのDescriptionに記載があります。
また実際に出力されるデータを確認するとさらに理解が深まるため、テスト送信を行い、レポートを実際に出力して確認することを推奨します。

参考: 

Marketing Cloud - MobilePush Detail Extract Report Output

Q2.MobilePush Detail Extract Reportに出力される各項目のデータ型や長さ、Null可能かなどを教えてください

Q2. MobilePush Detail Extract Reportに出力される各項目のデータ型や長さ、Null可能かなどを教えてください
A. レポートは CSV 形式のため、データベースのような型定義は持たずすべてテキストです。長さの定義・Null 可否および Nullというデータ・プライマリーキーという概念はなく、値がない項目は空欄になります。なお、Q1のドキュメントにはデータ型や長さの記載がありますが、これらはデータエクステンションに取り込む際の設定例としてご参照ください。
また外部データベースへ取り込む際は、特に日付型のフォーマットが取り込み先と異なる場合があり、定義通りに設定してもエラーなく取り込めることを保証するものではありません。必要に応じて受信側でデータの加工を行ってください。データ長についても、実際の値が想定を超えるケースがあるため、MCEの定義を問わず VARCHAR 等の可変長型で余裕を持った長さを確保することを推奨します。

参考:
https://help.salesforce.com/s/articleView?id=000393014&type=1

Q3. レポートの出力の日付範囲を変更した場合に、一部の開封のデータが変わることがあります
A. はい、開封関連の情報はレポートの出力日付によって変更になる場合があります。
例えば送信後しばらく日付が経過したのちに開封が行われた場合を想定します。（下記例）

ここで、レポートの出力日付範囲内に送信データがあるものの、開封データは範囲外にあるとします。
その場合、得られたレポート上は開封がされていないように見られますが、日付範囲を広くとって開封日時を含めて再度取得すると、開封データも出力日付範囲内に収まり、開封データがレポートに記録されます。

例:
10/1 通知送信
10/5 開封
・レポートの出力日付範囲 10/1- 10/7 : 上記開封が取得できる
・レポートの出力日付範囲 10/1- 10/3 : 上記開封が取得できない

Q4. Status の欄が空白になっていますがこれは何を意味しますか
A 受信トレイメッセージ (Inbox Only) のダウンロード情報の可能性があります。Template の項目が Inbox になっているかご確認ください。
Inbox Only では、Push 通知を送信しないため Status も空白になります。また Inbox Only ではダウンロードされてはじめて本レポートにダウンロード情報に関するレコードが記録されます。逆にダウンロードがされない限りレポートにはレコードが記録されないともいえます。このため、本レポートでは受信対象のデバイス数を確認することができません。

※注意※
ただし Inbox  でも上記と異なるケースが2つあります。

Inbox メッセージの送信設定において、バックグラウンドでプッシュ通知の技術を利用する場合、その送信結果としてStatusの欄が空白にならないレコードが生成されます。

1. Inbox Only かつ「iOSバッジの更新 (Update iOS Badge)」が有効な場合

   • 概要: メッセージ種別が Inbox Only であっても、オプションの [Update iOS Badge] を「はい」に設定しているケースです。

   • 挙動: アプリアイコンのバッジ数字を更新するために「サイレントプッシュ」が送信されます。このサイレントプッシュの送信結果として、Inbox メッセージのダウンロード有無にかかわらずレコードが生成されます。

2. Inbox + Alert の場合

   • 概要: Inbox メッセージと同時に、プッシュ通知（Alert）も送信する設定のケースです。

   • 挙動: Inbox メッセージとは別にプッシュ通知が送信されるため、そのプッシュ通知の送信結果として、Inbox メッセージのダウンロード有無にかかわらずレコードが生成されます。

※上記における Status が "Failed" の場合の解釈

ここでの Failed は、あくまで付随する「サイレントプッシュ」または「プッシュ通知 (Alert)」の送信が失敗したことを示しています。Inboxメッセージのダウンロード可否とは関連はありません。

なお、Inbox Only の場合、プッシュ通知としての送信が行われないため、MessageOpened（プッシュ通知タップによるアプリ起動日時）も合わせて空白になります。ユーザーがアプリ内 Inbox でメッセージを開封した場合は、代わりに InboxMessageOpened に日時が記録されます。

Q5. Inbox + Alert であっても Status が空白になるケースがあるようですが、これは何を意味しますか

A 当該デバイスが通知を OptOut していた等によりPushアラート(Push通知）の送信が行われず、 Inbox のみダウンロードした場合です。Inbox Only の場合と同様、 Status が空白になります。

Q6. Inbox メッセージの DateTimeSend 項目が、送信ジョブの開始時刻とは乖離しているように見受けられます
A Inboxメッセージの場合そのような状況が発生しえます。詳細は下記をご参照ください

参考:

MobilePush Detail Extract Report (MobilePush 詳細抽出レポート) の DateTimeSend について
https://help.salesforce.com/s/articleView?id=004269023&type=1

Q7. アプリ内メッセージ (In-App Message) の表示やクリックなどのエンゲージメント情報は取得できますか？

A. いいえ、本レポートには記録されません。

本レポートでTemplate が In-Appとして出力されるレコードは、アプリ内メッセージが更新されたことを端末に知らせるための「サイレントプッシュ通知」の送信記録です。メッセージそのものの「表示」や「ボタンクリック」といったユーザーのエンゲージメントデータではありません。なお、本記事の記載時点では、個々のデバイス単位でアプリ内メッセージの表示やクリックログを出力するレポート種別は提供されておりません。

また、このサイレントプッシュに関するデータの解釈において、以下の点にご注意ください。

• Status が Failed の場合： あくまで「サイレントプッシュ通知」の送信リクエストが失敗したことを示しており、アプリ内メッセージそのものの表示可否とは直接関係ありません。

• レコード数が対象人数と一致しない（多い・少ない）場合： 通常のプッシュ通知と同様、サイレントプッシュ通知も「オプトインしているデバイス」にのみ送信されます。そのため、ジャーニービルダーを通過した連絡先総数とは一致しない場合がほとんどです。 オプトアウトしているデバイスにはサイレントプッシュは送信されませんが、アプリ起動時などに Marketing Cloud Engagement と通信することでメッセージはダウンロードされます。そのため、このレポートに記録がなくともアプリ内メッセージの表示には支障ありません。

• Open (開封) の記録について： サイレントプッシュ通知はユーザーの目に触れるものではないため、開封（Open）という概念がありません。したがって、このレポート上で Open 数がゼロであっても問題ありません（仕様通りの挙動です）。

Q8. テスト対象デバイスの記録を確認したくデバイスIDを確認したいのですが、Contact Builder 以外でデバイス ID の確認方法はありますか
A MobilePushのフィルター済みリストをエクスポートする方法が比較的容易です。フィルター済みリストのエクスポートを行って得られるCSVは、さまざまなデバイスの属性情報が取得できます。例えばテスト対象の Contact Key を条件にリストを作ってExportし、得られたCSVから該当機種の情報や名前などの属性値をもとにテスト対象のデバイスのレコードを探します。


参考:
リストからの連絡先のエクスポート　
https://help.salesforce.com/s/articleView?id=sf.mc_mp_export_contacts_standard.htm&language=ja&type=5

• MessageOpened：プッシュ通知をタップしてアプリを起動した日時が記録されます。プッシュ通知の送信が行われていない場合（Inbox Only のケースなど）は空白になります。
• InboxMessageOpened：アプリ内に実装された Inbox メッセージ一覧から特定のメッセージを開いた日時が記録されます。

Q10. TimeInApp フィールドはどのような値が記録されますか

A. プッシュ通知をタップしてアプリを起動してからのアプリ滞在時間が、秒単位の整数値で記録されます。
プッシュ通知の送信が行われていない場合（Inbox Only のケースなど）は、プッシュ通知のタップというアプリ起動の起点がないため、空白になります。