Loading
ただいま大変多くのお問い合わせをいただいており、ご連絡までにお時間を頂戴しております続きを読む

Marketing Cloud Engagement | MobilePush Detail Extract Report の ContactKey の値に関して

公開日: Jul 2, 2026
説明

本記事では、MobilePush Detail Extract Reportに記録される ContactKey 列の出力挙動について解説します。
ContactKey 列の値は、Push 通知（アラート）と受信トレイ（Inbox）メッセージとでデータ取得の仕組みが異なるため、レポートの値も挙動が異なります。

例えば Push 通知 (アラート) は送信時の値で固定されるため、後から値が変わることはありません。一方、受信トレイメッセージの場合はレポート出力時点の値が出力されます。また受信トレイ＋アラートの場合は、その双方の性質が混在します。つまりレポートの出力対象期間の指定方法や各ユーザーの受信トレイメッセージのダウンロードのタイミングによって、レポート実行時点の最新の ContactKey が出力される場合があります。

解決策

1. Push 通知（アラート）のみの場合

Push通知の送信が実行された時点の ContactKey の値が出力されます。

送信完了後にデバイスに紐づく ContactKey が変更された場合でも、送信時点の値が利用され、遡って新しい値で更新されることはありません。

 

例:

 
日時 (JST)
操作内容
Device_001 のコンタクトキーの状態
2026-05-01 09:00
ContactKey ContactKey_A /デバイス Device_001 に Push 通知を送信
ContactKey_A（送信時点）
2026-05-01 11:00
Device_001 に紐づくコンタクトキーを変更
ContactKey_A → ContactKey_B
2026-05-01 13:00
MobilePush Detail Extract Report を抽出　1回目
ContactKey_B
2026-05-01 15:00
ContactKey ContactKey_B /デバイス Device_001 に Push 通知を送信
ContactKey_B （送信時点）
2026-05-01 17:00
MobilePush Detail Extract Report を抽出　2回目
ContactKey_B
 
この場合以下のように出力されます
 
・1回目のレポート
9 時の送信分に対しレポートには ContactKey_A が出力される
 
・2回目のレポート
9 時の送信分に対しレポートには ContactKey_A が出力される
15 時の送信分に対しレポートには ContactKey_B が出力される
 
このように、送信完了後に同一デバイスに紐づくコンタクトキーが変更された場合でも、送信時点での連絡先キーが記録されます。その後改めて Device_001 のコンタクトキーを変更してもレポートは上記のままです。記録済みのレコードは遡って更新されません
 

2. 受信トレイ（Inbox）メッセージ単体の場合

受信トレイメッセージのみの場合はContactKeyの値はレポート出力時点での対象デバイスに紐づく値となります。

 

3. 受信トレイ ＋ Push通知（Inbox ＋ Alert）の場合

受信トレイ ＋ Push通知の場合は上記 2 つの特性が混在するため、レポートの抽出期間の指定方法によって出力される値が変動する場合があります。

A. レポート抽出期間にPush通知の送信日が含まれる場合

Push通知の送信が実行された時点の ContactKey の値が出力されます。

B. レポート抽出期間に Push 通知の送信日は含まれないが、受信トレイのダウンロード日が含まれる場合

受信トレイのみの場合と同様に、ContactKey が変更されていた場合は、変更後の新しい ContactKey が出力されます。

 
まとめると以下のようになります
 
送信種別ContactKeyの値
Push 通知 (アラート)送信時点
受信トレイのみレポート出力時点

受信トレイ + アラート

※ レポート出力日付が送信日を含む

送信時点

受信トレイ + アラート

※ レポート出力日付が送信日を含まず、ダウンロードのみ

レポート出力時点
 
 
※本記事作成時点の挙動となります。MobilePush の挙動は随時見直しが行われるため、予告なく変更される場合があります。
 
ナレッジ記事番号

005322024

 
読み込み中
Salesforce Help | Article