--- articleId: f9c48492-8665-4e1e-b7c1-74de2759a0db slug: data-source-facebook-ad-insights title: 転送元 - Facebook Ad Insights parentCategoryId: b257af88-17fc-4a4d-bf94-dc694a258787 languageCode: ja --- ## 概要 Facebook広告の実績を取得してデータを転送する設定のDocsです。 :::(Info) (Instagram広告のデータ取得) Instagram広告の実績も、転送元Facebook Ad Insightsで取得できます。具体的な取得方法でご不明点がございましたら、カスタマーサクセスまでお問い合わせください。 ::: ## 制約 - アクセストークン失効などの原因により転送が失敗する場合があります。 - [Facebook接続情報](/docs/connection-configuration-facebook-ad-insights)を参考に再認証をお願いします。 - アクセストークンは60日ごとに再認証が必要となります。転送設定やワークフローでエラー時の通知を設定することで、期限切れのタイミングで通知できるようになります。 - 内訳部分で、同時指定できない項目があります。 [公式ドキュメント](https://developers.facebook.com/docs/marketing-api/insights/breakdowns/#combiningbreakdowns)に、同時指定可能な組み合わせが記載されています。 ## 設定項目 ### STEP1 基本設定 | 項目名 | 必須 | デフォルト値 | 内容 | | --- | --- | --- | --- | | Facebook接続情報 | Yes | - | あらかじめ登録してある[Facebookの接続情報](/docs/connection-configuration-facebook-ad-insights)から、今回の転送設定に必要な権限を持つものを選択します。 | | 広告アカウントID | Yes | - | レポートを取得する広告アカウントIDを指定します。
広告アカウントIDは、Meta広告マネージャの画面上で確認できます。
![data-source-facebook-ad-insights-2024-08-29-14-7-0](https://cdn.document360.io/3a3bae1e-f157-487f-8798-01e9d820e760/Images/Documentation/data-source-facebook-ad-insights-2024-08-29-14-7-0.png)
広告アカウントIDの確認方法について、詳しくは[Facebook公式ドキュメント - Find your Facebook ad account ID number](https://www.facebook.com/business/help/1492627900875762)を参照ください。 | | レポート種別 | Yes | - | 取得するレポートを以下より選択します。

`account`
`campaign`
`adset`
`ad`

| | フィールド | No | - | 取得するレポートに含めるフィールドを選択します。
[レポートテンプレート読み込み](/docs/data-source-facebook-ad-insights#レポートテンプレート読み込み)をクリックすることで、主要なフィールドをテンプレートから読み込むこともできます。
各項目の詳細については、以下のFacebook公式ドキュメントをそれぞれ参照ください。

`account`：[Facebook公式ドキュメント - Ad Account, Insights](https://developers.facebook.com/docs/marketing-api/reference/ad-account/insights/v25.0)
`campaign`：[Facebook公式ドキュメント - Campaign Insights](https://developers.facebook.com/docs/marketing-api/reference/ad-campaign-group/insights/v25.0)
`adset`：[Facebook公式ドキュメント - Ad Set Insights](https://developers.facebook.com/docs/marketing-api/reference/ad-campaign/insights/v25.0)
`ad`：[Facebook公式ドキュメント - Ad Insights](https://developers.facebook.com/docs/marketing-api/reference/adgroup/insights/v25.0)

TROCCOで選択できるフィールドは、Ad Insights APIで提供されるフィールドの一部です。選択肢に含まれないフィールドは取得できません。必要なフィールドが見つからない場合は、カスタマーサクセスまでお問い合わせください。 | | 内訳 | No | - | デバイスタイプや性別ごとにレポートを取得できます。

取得できる項目一覧

`ad_format_asset`
`age`
`body_asset`
`call_to_action_asset`
`country`
`description_asset`
`device_platform`
`dma`
`frequency_value`
`gender`
`hourly_stats_aggregated_by_advertiser_time_zone`
`hourly_stats_aggregated_by_audience_time_zone`
`image_asset`
`impression_device`
`link_url_asset`
`place_page_id`
`platform_position`
`product_id`
`publisher_platform`
`region`
`title_asset`
`video_asset`

たとえば、`gender`を指定した場合、男性・女性などの内訳ごとに結果が複数行で取得されます。
各項目の詳細については、[Facebook公式ドキュメント - Insights API Breakdowns](https://developers.facebook.com/docs/marketing-api/insights/breakdowns#genericbreakdowns)を参照ください。 | | データ取得期間 | Yes | - | 転送したいデータの、開始日時と終了日時を入力します。
`YYYY-MM-DD`形式で入力してください。 | | 集計単位 | Yes | 1日単位 | データの集計単位を選択します。以下から選択可能です。

指定期間全体：指定したデータ取得期間全体で集計されたデータを取得します。
月単位：月単位で集計されたデータを取得します。
N日単位：1〜90日の範囲で指定した日数単位で集計されたデータを取得します。

| #### STEP1 詳細設定 **詳細設定**をクリックすると、設定項目が表示されます。 | 項目名 | 必須 | デフォルト値 | 内容 | | --- | --- | --- | --- | | アトリビューションウィンドウ | No | 指定なし |

取得できる項目一覧

`1d_view`
`7d_view`
`28d_view`
`1d_click`
`7d_click`
`28d_click`

取得できる項目の一覧

`action_device`
`action_canvas_component_name`
`action_carousel_card_id`
`action_carousel_card_name`
`action_destination`
`action_reaction`
`action_target_id`
`action_type`
`action_video_sound`
`action_video_type`

各項目の詳細については、[Facebook公式ドキュメント - Ads Action Stats](https://developers.facebook.com/docs/marketing-api/reference/ads-action-stats/v25.0)を参照ください。| | 統合アトリビューション設定を有効にする | No | 有効 | 統合アトリビューションを有効にする場合はチェックを入れてください。 | ## レポートテンプレート読み込み **レポートテンプレート読み込み**をクリックすることで、主要なフィールドをテンプレートから読み込むことができます。 :::(Warning) すでにフィールドを設定されている場合、そのすべての項目が上書きされます。ご注意ください。 ::: ### 挿入されるフィールド | 項目名 | 備考 | | --- | --- | | `account_id` | | | `account_name` | | | `campaign_id` | レポート種別で`campaign`, `adset`, `ad`を選択したときに挿入されます。 | | `campaign_name` | レポート種別で`campaign`, `adset`, `ad`を選択したときに挿入されます。 | | `adset_id` | レポート種別で`adset`, `ad`を選択したときに挿入されます。 | | `adset_name` | レポート種別で`adset`, `ad`を選択したときに挿入されます。 | | `ad_id` | レポート種別で`ad`を選択したときに挿入されます。 | | `ad_name` | レポート種別で`ad`を選択したときに挿入されます。 | | `actions` | | | `clicks` | | | `conversions` | | | `cpc` | | | `ctr` | | | `date_start` | | | `date_stop` | | | `gender_targeting` | | | `impressions` | | | `inline_link_clicks` | | | `reach` | | | `spend` | |