メインコンテンツにスキップ

アウトバウンドメッセージデータをどのようにエクスポートしますか?

メッセージとキャンペーンデータをCSVファイルとして簡単にエクスポートできます。

対応者:Beth-Ann Sher

メッセージのパフォーマンスを分析するために、メッセージデータをCSVファイルとしてエクスポートしてください。このデータでできることは:

  • Intercomのメッセージデータをusersデータと組み合わせて、メッセージの影響をよりよく理解できます。 

  • メッセージとseriesが時間の経過とともにどのようにパフォーマンスを発揮しているかを理解します。

Intercomでは、メッセージデータをエクスポートする方法が3つあります。


特定の日付範囲のすべてのメッセージデータをエクスポートする

特定の日付範囲のすべてのアウトバウンドメッセージデータをエクスポートするには、すべてのレポート > Intercomレポート > カスタマーエンゲージメント概要に移動してください。

注意:これはレガシーレポートで、カスタマイズできません。

レポートの上部で、CSVをエクスポートをクリックします。

2つのレポートから選択し、日付範囲を定義できます:

  • 詳細な統計 - このCSVレポートでは、メッセージを受け取ったすべてのusersの詳細な内訳を提供し、個々のusersがメッセージにどのように反応しているかを深く掘り下げて確認できます。

  • 概要統計 - このCSVレポートでは、すべてのメッセージのパフォーマンスの概要を表示し、アウトバウンドメッセージの全体的な集計統計と監査データを提供します。

重要:

  • チームが送信したメッセージのデータのみエクスポートできます。顧客が開始した会話をエクスポートしたい場合は、会話データのエクスポートに関するこの記事をお読みください。

  • ここで選択した日付範囲は、その期間に送信されたメッセージを表示するためにレポートをフィルタリングしますが、これらのメッセージの個別の統計(クリック率など)は全期間の結果を表示します。

  • CSVをダウンロードするために送信されるリンクは2日間のみ有効で、その後期限切れになります。

注意:大量のデータが含まれる可能性のある日付範囲を選択した場合は、テキストエディタでCSVファイルを開くことをお勧めします。

最後に、データをエクスポートをクリックすると、CSVファイルがメールアドレスに届きます。

メッセージデータのエクスポートには数時間かかることがあります。‘receipt’のようなさまざまなインタラクションごとに複数のCSVが含まれたZIPファイルが届きます。‘completion’はSeries、‘screen views’はmobile carouselなどです。

ファイルは別々にエクスポートされます。なぜなら、1つのコンテンツ配信に対して、usersが同じ統計を何度も記録する可能性があるためです。

例えば、メールを受け取り複数のリンクをクリックしたり、ツアーを受けて複数のステップを閲覧した場合、クリックや閲覧したステップの統計がその都度新たに記録されます。

そのため、すべてを1行に収めることはできません。

詳細な統計のエクスポート

エクスポート可能な統計と、それらが関連する異なるコンテンツタイプのリストです。各イベントは独自のファイルでエクスポートされ、発生日時の詳細が確認できます。イベントをクリックして詳細を確認してください。

イベント

コンテンツタイプ

series

mobile carousel

投稿、バナー、チャット、メール

チャット

カスタムボット、プロダクトツアー、mobile carousel

mobile carousel

投稿、バナー、プロダクトツアー、プッシュ、コントロールグループ、mobile carousel、チャット、メール、series、カスタムボット、Series Edge Split、SMS

メール

SMS

投稿、プッシュ、チャット、メール、

mobile carousel

投稿、バナー

すべて

投稿、チャット、メール、カスタムボット

モバイルカルーセル

シリーズ

シリーズ

シリーズ

SMS

メール

メール

プロダクトツアー

プロダクトツアー

メール、SMS


各統計はそれぞれのファイルにエクスポートされます。以下は異なる統計の完全なリスト、エクスポートで提供される属性とその説明です。

ヒント: 基本的な分析には 'receipt' CSV ファイルを使用してください。特定の日付間のメッセージのクリック率集計など、複数ファイルを手動で集計せずに済みます。詳細なイベントファイル(例:'click_TIMESTAMP.csv')は、特定メッセージのクリック回数や最もクリックされたリンクを知りたい場合に使います。

チェックポイント

チェックポイントは、ユーザーと会社のグループが訪れたシリーズ内の各ブロックに作成されます。処理すべき内容とその処理のタイミング・場所を示します。

属性

説明

user_id

ユーザー、リード、または訪問者の Intercom ID。

company_id

会社の Intercom ID。

ruleset_id

Intercom システム内のメッセージの ID。コンテンツの URL に表示される ID と同じです。

status_code

  • 0 - アクティブ

  • 1 - 完了(主要なエッジ*を進行)

  • 2 - 期限切れ

  • 3 - 無効

  • 4 - 退出済み

  • 5 - 完了(代替エッジ*を進行)

  • 6 - 完了(強制退出)

  • 7 - 完了(終了)

  • 8 - 完了(分岐エッジ*を進行)

  • 9 - 拒否(会社の優先順位による)

status_name

status_code の説明。可能な値:

  • アクティブ

  • took_primary_edges*

  • 期限切れ

  • 無効

  • 終了済み

  • took_alt_edges*

  • 排除された

  • 完了

  • took_split_edges*

  • company_prioritization_rejection

created_at

チェックポイントが作成された日時のタイムスタンプ。

last_processed_at

ユーザーがノードのルールに一致するか、またはノードのコンテンツを受け取るべきかを最後に確認した時間。

expires_at

ユーザーをノードの「一致しなかった」パスに送るか、代替パスがなければパスから完全に削除する時間。

times_processed

ユーザーがノードに一致するかを確認した回数。

*プライマリー、オルタネート、スプリットエッジとは?

  • プライマリーエッジ — 顧客がルールに一致し、メッセージ(またはタグ)を受け取るか、待機ブロックを通過した。

  • オルタネートエッジ — 顧客がルールに一致しなかったか、メッセージを受け取るためにオンラインにならなかった。

  • スプリットエッジ — 顧客がスプリットテストの一つのパスを選択した。

ボタンタップ

モバイルカルーセルでユーザーがボタンをタップしたときに記録される。

属性

説明

receipt_id

この統計にリンクされたreceiptのID。

button_action_tapped_at

ボタンがタップされた日時のタイムスタンプ。

クリック

ユーザー、リード、訪問者がコンテンツ内のリンクをクリックしたときに記録される。リンクは通常のテキストリンク、ボタン、またはどこかにリンクされた画像である可能性がある。

属性

説明

receipt_id

この統計にリンクされたreceiptのID。

clicked_at

リンク、画像、またはボタンがクリックされた日時のタイムスタンプ。

収集されたメール

訪問者がチャットでメールアドレスを求められ、送信したときに記録される統計。

属性

説明

receipt_id

この統計にリンクされたreceiptのID。

email_collected_at

メールが収集された日時のタイムスタンプ。

email

収集されたメールアドレス。

完了

ユーザー、リード、または訪問者がMobile CarouselまたはProduct Tourを完了するたびに、完了が記録されます。シリーズには別の「Series Completion」統計があります。

属性

説明

receipt_id

この統計にリンクされたreceiptのID。

completed_at

カルーセルまたはツアーが完了した時刻のタイムスタンプ。

Dismissal

ユーザーがMobile Carouselを閉じるたびに、Dismissalが記録されます。

属性

説明

receipt_id

この統計にリンクされたreceiptのID。

dismissed_at

Mobile Carouselが閉じられた時刻のタイムスタンプ。

Goal success

ユーザー、リード、または訪問者がメッセージの目標を達成するたびに、Goal successが記録されます。

属性

説明

receipt_id

この統計にリンクされたreceiptのID。

goal_hit_at

目標が達成された時刻のタイムスタンプ。

Hard bounce

メールが受信者のメールクライアントによって永久に拒否された場合に、Hard bounceが記録されます。例えば、次の場合:

  • メールアドレスがサーバーに存在しない。

  • domain名が存在しない。

  • または受信者が配信をブロックしている。

属性

説明

receipt_id

この統計にリンクされたreceiptのID。

hard_bounced_at

メッセージがHard bounceした時刻のタイムスタンプ。

Keyword reply

属性

説明

receipt_id

この統計にリンクされたreceiptのID。

replied_at

返信が送信された時刻のタイムスタンプ。

reply

Post、Chat、Email、Custom Bot

keyword_type

DEFAULT(例:認識されない返信)
STOP(例:unsubscribe、quit、cancelなど)
START(例:start、subscribe、resubscribe)
INFO(例:help)
CUSTOM
CARRIER_STOP

Open

Push、Post、Chat、Emailメッセージを誰かが初めて開いたときに、Openが記録されます。

属性

説明

receipt_id

この統計にリンクされたreceiptのID。

opened_at

メッセージが開かれた時刻のタイムスタンプ。

許可の付与

Mobile Carouselで許可をリクエストし、ユーザーがその時に許可を与えた場合に許可の付与が記録されます。すでに許可されている場合や後で設定から許可された場合は記録されません。

属性

説明

receipt_id

この統計にリンクされたreceiptのID。

granted_at

許可が付与された時刻のタイムスタンプ。

permission_type

ユーザーが付与した許可の種類。例えば:

  • location_permission

  • push_notifications_permission

  • camera_permission

  • microphone_permission

  • photos_permission

リアクション

ユーザー、リード、またはビジターがPostまたはBannerメッセージに絵文字でリアクションした場合にリアクションが記録されます。

属性

説明

receipt_id

この統計にリンクされたreceiptのID。

reacted_at

リアクションが発生した時刻のタイムスタンプ。

reaction

ユーザー、リード、またはビジターが選択したリアクション。

Receipt

ユーザー、リード、またはビジターにメッセージが送信された場合にReceiptが記録されます。バウンスなどでメッセージが正常に受信されなくても記録されます。receipt_idはこのメッセージに関連する他のイベントをリンクするために使用できます。

属性

説明

user_id

ユーザー、リード、またはビジターのIntercom ID。

user_external_id

ユーザー、リード、またはビジターのあなたのID。

company_id

ユーザーが所属する会社のID。

email

ユーザーのメールアドレス。

name

ユーザーのフルネーム。

ruleset_id

ユーザーに配信されたメッセージのID。

content_id

ユーザーに配信されたメッセージのバリアントID(A/Bテストでは同じruleset_idで異なるcontent_idを持ちます)。

content_type

配信されたメッセージの種類(例:‘email’, ‘tour’)。

content_title

メッセージのタイトル。

created_via

メッセージが配信された理由

ruleset_version_id

コンテンツを編集すると新しいバージョンが記録されます。このIDは受信したコンテンツのバージョンを特定するのに役立ちます。

receipt_id

このレシートのID。関連する統計と共に含まれます。

received_at

レシートが記録されたタイムスタンプ。

series_id

このコンテンツが属するシリーズのID。

series_title

このコンテンツが属するシリーズのタイトル。

node_id

このrulesetが関連付けられているシリーズノードのID。シリーズ内の各ブロックには対応するnode_idがあります。

first_people_reached_receipt

属性名のタイムスタンプ。

first_checklist_step_receipt

属性名のタイムスタンプ。

first_checklist_step_open

属性名のタイムスタンプ。

first_checklist_step_click

属性名のタイムスタンプ。

first_checklist_step_completion

属性名のタイムスタンプ。

first_reply

ユーザーがこのメッセージのレシートに初めて返信した時のタイムスタンプ。

(返信をサポートするコンテンツタイプのみ値が表示され、ユーザーがレシートに返信していない場合は空白になります)

first_completion

ユーザーがこのレシートを初めて完了した時のタイムスタンプ(例:ツアーメッセージの場合、ユーザーが初めてその製品ツアーを完了した時)。

(完了をサポートするコンテンツタイプのみ値が表示され、ユーザーがメッセージを完了していない場合は空白になります)。

first_series_completion

ユーザーがこのシリーズを初めて完了した時のタイムスタンプ。

(シリーズ完了をサポートするレシートコンテンツタイプのみ値が表示され、ユーザーがシリーズを完了していない場合は空白になります)。

first_series_disengagement

first_series_exit

first_goal_success

first_tour_step_failure

first_tour_step_view

first_reaction

first_open

first_click

first_dismissal

first_collected_email

first_unsubscribe

first_hard_bounce

first_soft_bounce

first_spam_complaint

first_permission_grant

first_button_tap

first_screen_view

first_webhook_failure

first_sms_failure

first_push_failure

first_answer

返信

返信は、ユーザーがPost、Chat、Custom Bot、またはEmailに返信したときに記録されます。

属性

説明

receipt_id

この統計に関連付けられたreceiptのID。

replied_at

返信が送信されたタイムスタンプ。

画面表示

ユーザーがMobile Carouselの各画面を表示するたびに画面表示が記録されます。

属性

説明

receipt_id

この統計に関連付けられたreceiptのID。

viewed_at

画面が表示されたタイムスタンプ。

シリーズ完了

ユーザーまたはリードがシリーズを完了したときにシリーズ完了が記録されます。

属性

説明

receipt_id

この統計に関連付けられたreceiptのID。

completed_at

シリーズが完了したタイムスタンプ。

completion_node_ruleset_id

ユーザーまたはリードがSeriesを完了したRulesetのID。

Seriesの離脱

ユーザーまたはリードがSeriesから離脱した場合にSeries離脱が記録されます。これは、メッセージまたはルールブロックの指定された待機期間の終了に達したときに発生します。メッセージを受け取っていないかルールに一致しなかった場合、離脱としてマークされます。

属性

説明

receipt_id

この統計にリンクされたreceiptのID。

disengaged_at

ユーザーまたはリードがSeriesから離脱した時刻のタイムスタンプ。

disengaged_node_ruleset_id

ユーザーまたはリードがSeriesから離脱したRulesetのID。

Seriesの終了

ユーザーまたはリードがSeriesの終了ルールに一致した場合にSeries終了が記録されます。

属性

説明

receipt_id

この統計にリンクされたreceiptのID。

exited_at

ユーザーまたはリードがSeriesを終了した時刻のタイムスタンプ。

SMS失敗

属性

説明

receipt_ID

この統計にリンクされたreceiptのID。

failed_at

ツアーステップが失敗した時刻のタイムスタンプ。

message_status

失敗または未配信

error_code

ソフトバウンス

メールボックスが満杯などの一時的な理由で、ユーザーまたはリードにメールを配信できなかった場合にソフトバウンスが記録されます。

属性

説明

receipt_id

この統計にリンクされたreceiptのID。

soft_bounced_at

メッセージがソフトバウンスした時刻のタイムスタンプ。

スパム苦情

ユーザーまたはリードがメールクライアントであなたのメッセージをスパムとしてマークした場合にスパム苦情が記録されます。

属性

説明

receipt_id

この統計にリンクされたreceiptのID。

complained_at

スパム苦情が発生した時刻のタイムスタンプ。

ツアーステップ失敗

製品ツアーステップが表示されなかった場合に、ユーザー、リード、または訪問者に対してツアーステップ失敗が記録されます。

属性

説明

receipt_id

この統計にリンクされたreceiptのID。

step_id

失敗したツアーステップのID。

failed_selector

失敗したCSSセレクター。

failure_url

失敗が発生したときにusers、lead、またはvisitorがいたURL。

failed_at

ツアーステップが失敗した時刻のタイムスタンプ。

ツアーステップビュー

Productツアーステップがusers、lead、またはvisitorに表示されるたびにツアーステップビューが記録されます。

属性

説明

receipt_id

この統計にリンクされたreceiptのID。

step_id

表示されたツアーステップのID。

viewed_at

ツアーステップが表示された時刻のタイムスタンプ。

配信停止

usersがあなたのメールメッセージの1つから配信停止した場合、配信停止が記録されます。

属性

説明

receipt_id

この統計にリンクされたreceiptのID。

unsubscribed_at

usersまたはleadが配信停止した時刻のタイムスタンプ。


概要統計のエクスポート

概要統計は、workspaceのメッセージの詳細な統計を、usersのreceiptレベルではなくメッセージレベルで集計したCSVレポートです。

注意: 日付フィルター機能は詳細統計レポートとは異なります。概要統計レポートでは、フィルターされた日付範囲内の任意の時点でライブだったすべてのメッセージがエクスポートされます。

このデータをエクスポートすると、メッセージの概要を含む単一のCSVファイルがメールで送信されます。

メッセージの詳細や「last edited by」などの監査関連の列に加え、メッセージ統計システムの各統計の列があります。これらの統計は、その統計をサポートするメッセージ/コンテンツタイプの値のみを表示します。

各統計は3つの値に分かれています:

  • その統計の合計数 - 例:‘open_total’ - メッセージが開かれた総回数をusersに関係なく表示します。

  • その統計のユニーク数 - 例:‘click_unique’ - メッセージ内で少なくとも1回クリックしたユニークusers数を表示します。

  • 総receipt数に基づくその統計の割合 - 例:‘reply_rate’ - メッセージに返信した送信総数の割合を表示します。

すべての列の説明

列名

説明

ruleset_id

メッセージのID

作成日時

メッセージが作成された日時

content_title

Intercom workspaceで表示されるコンテンツのタイトル。

content_id

特定のメッセージコンテンツ/バリアントのID - A/Bテストでは各バージョンに独自のContent IDがあります。

content_type

メッセージの種類(例:Email、Chat、Post)

series_id

このコンテンツが属するシリーズのID。

series_title

このコンテンツが属するシリーズのタイトル。

state

メッセージの現在の状態。例:ライブ、停止中、下書き。

last_state_change_by

メッセージの状態を更新したチームメイトのメールアドレス。

last_state_change_at

最後の状態変更が行われた日時のタイムスタンプ。

last_edited_by

メッセージを最後に編集したチームメイトのメールアドレス。

last_edited_at

最後にメッセージが編集された日時のタイムスタンプ。

url

Intercom内でメッセージを表示/編集するためのURL。

receipt_total

上記参照。

receipt_unique

上記参照。

reply_total

上記参照。

reply_unique

上記参照。

reply_rate

上記参照。

completion_total

上記参照。

completion_unique

上記参照。

completion_rate

上記参照。

goal_success_total

上記参照。

goal_success_unique

上記参照。

goal_success_rate

上記参照。

tour_step_failure_total

上記参照。

tour_step_failure_unique

上記参照。

tour_step_failure_rate

上記参照。

tour_step_view_total

上記参照。

tour_step_view_unique

上記参照。

reaction_total

上記参照。

リアクション_ユニーク

上記参照

リアクション率

上記参照

開封合計

上記参照

開封ユニーク

上記参照

開封率

上記参照

クリック合計

上記参照

クリックユニーク

上記参照

クリック率

上記参照

解約合計

上記参照

解約ユニーク

上記参照

解約率

上記参照

収集されたメール合計

上記参照

収集されたメールユニーク

上記参照

収集されたメール率

上記参照

配信停止合計

上記参照

配信停止ユニーク

上記参照

配信停止率

上記参照

ハードバウンス合計

上記参照

ハードバウンスユニーク

上記参照

ハードバウンス率

上記参照

ソフトバウンス合計

上記参照

ソフトバウンスユニーク

上記参照

ソフトバウンス率

上記参照

スパム苦情合計

上記参照

スパム苦情ユニーク

上記参照

スパム苦情率

上記参照

許可付与合計

上記参照

許可付与ユニーク

上記参照

許可付与率

上記参照

ボタンタップ合計

上記参照

ボタンタップユニーク

上記参照

ボタンタップ率

上記参照

画面表示合計

上記参照

画面表示ユニーク

上記参照

画面表示率

上記参照

webhook_failure合計

上記参照

webhook_failureユニーク

上記参照

webhook_failure率

上記参照

sms_failure合計

上記参照

sms_failureユニーク

上記参照

sms_failure率

上記参照

push_failure合計

上記参照

push_failureユニーク

上記参照

push_failure率

上記参照

回答合計

上記参照

回答ユニーク

上記参照

email_failure合計

上記参照

email_failureユニーク

上記参照

email_failure率

上記参照


特定のアウトバウンドメッセージからデータをエクスポートする

特定のアウトバウンドメッセージのパフォーマンスを詳しく確認したい場合は、Outbound に移動し、エクスポートしたいメッセージを選択してから、More ドロップダウンをクリックし、Export CSV を選択してください。

注意:Mobile PushメッセージとProduct Toursからエクスポートされたデータは、「Receipt」、「Open」、「Completion (for tours only)」などの個別のメッセージイベントに基づき、複数のファイルに分かれます。

こちらの回答で解決しましたか?