Marketing Cloud Engagement |MobilePush Detail Extract Report の抽出手順例

Automation Studio を使用して MobilePush Detail Extract Report を生成し、拡張 FTP サイトへ出力する手順は以下の通りです。

前提条件

• 拡張 FTP サイト (Enhanced FTP) へのアクセスができ、ファイルがダウンロードできることを前提とします。

• 本手順は初回設定時の動作確認を主目的としています。実運用時のファイル命名規則やスケジュールは要件に合わせて調整してください。

手順 1: オートメーションの新規作成

1. Marketing Cloud のメニューより Automation Studio を開きます。

2. 画面右上の [新しいオートメーション] (New Automation) をクリックします。

手順 2: アクティビティの配置

左側のアクティビティ一覧から、以下のアイコンをドラッグ＆ドロップでキャンバスに配置します。

• 開始ソース: [スケジュール] (Schedule)

• Step 1: [データ抽出] (Data Extract)

• Step 2: [ファイル転送] (File Transfer)

手順 3: データ抽出 (オートメーション Step 1) の設定

MobilePush の詳細データを抽出する定義を作成します。

1. 配置した「データ抽出」アクティビティ内の [選択] をクリックし、[新しいデータ抽出アクティビティの作成] を選択します。

2. プロパティ (Properties) を設定します。

   • 名前: 管理しやすい任意の名前を入力（例: MobilePush_Detail_Extract_Daily）

   • ファイルの命名パターン: 出力するファイル名を入力。拡張子は .zip としてください (例: MobilePushData.zipなど)

     • 定期実行する場合は %%year%% などのパーソナライズ文字列の利用も検討します

       重要: ここで指定したファイル名は、後の「ファイル転送」設定で正確に参照する必要があるため、メモしておきます。

   • 抽出の種別: MobilePush Detail Extract Report を選択

     ※ドロップダウンに表示されない場合、サポートへの有効化依頼が必要なため、MIDを添えてお問い合わせください。

3. 構成 (Configuration) を設定します。

   • 日付範囲 (Date Range): 抽出したい期間を指定。送信試験を行なった日付が含まれるように指定します。テストでは Specific Range を選択して、送信日の前後1日を指定する形などが推奨されます。例) 10月10日に送信した場合：10月9日 ~ 10月11日と設定

     • 実際の定期実行の運用では [Rolling Range] を選び、 1 Day, 7 Days などの日付範囲を選択します
     • 実運用環境では、範囲を広くとると、収集する送信データが大きくなります。データ量の増加に伴いAutomationの実行時間が長期化するため、広くしすぎないよう注意します。

   • Apply Time Zone: チェックをオンにし、利用したいタイムゾーンを指定します。

4. 設定内容を確認し、[次へ] をクリックし、[終了] をクリックします。

手順 4: ファイル転送 (オートメーション Step 2) の設定

抽出されたファイルを Safehouse という領域から FTP へ移動させる定義を作成します。

1. 配置した「ファイル転送」アクティビティ内の [選択] をクリックし、[新しいファイル転送アクティビティの作成] を選択します。

2. プロパティ (Properties) を設定します。

   • 名前: 管理しやすい任意の名前を入力（例: Move_MobilePush_Data_To_FTP）

   • ファイルアクション: [Safehouse からファイルを移動] (Move a File From Safehouse) を選択

3. 構成 (Configuration) を設定します。

   • ファイルの命名パターン: 手順 3 で設定した「ファイルの命名パターン」と完全に一致する文字列を入力します（例: MobilePushData.zip）。

     注意: 一致していない場合、ファイルが見つからずエラーになります。

   • ディスティネーション: 転送先のディレクトリを選択（例: ExactTarget Enhanced FTP など。これはご利用のSFTPサイトのImportディレクトリ直下を指します）

4. 設定内容を確認し、[次へ] をクリックし、[終了] をクリックします。

手順 5: オートメーションの保存と実行

1. 画面右上の [保存] ボタンをクリックします。

2. 名前: オートメーション全体の名前を入力し任意の場所に保存します（例: Daily_MobilePush_Extract_Automation）。

3. 動作確認を行うため、画面右上の [一回実行] (Run Once) をクリックします。

4. Step 1 と Step 2 のアクティビティを選択し、[実行] します。

5. 実行されるアクティビティを確認し、上で作成したアクティビティが選ばれていることを確認して [今すぐ実行] をクリックします。

6. アクティビティタブに移り、オートメーションが正常に終了するまで待機します。

   • なお、一回実行のリクエストが開始されるまで1-2分待つ場合があります。

7. 正常終了したら、指定した場所にファイルが生成されていることを確認してください。

   • ExactTarget Enhanced FTP を選んだ場合、ご利用の SFTP サイトの Import ディレクトリ直下を確認します。

データの確認

ファイルは ZIP 形式になっているため、展開して CSV を取得し、CSV ファイルを Excel 等のソフトで開いて送信データを確認してください。

 なお、本レポートに記録されるデータの見方などは以下の記事を参照してください。

補足: Apply Time Zone について

出力日時および抽出範囲の基準タイムゾーンを制御します。データの不整合を防ぐため、通常はチェックをオンにすることを推奨します。