{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-@l10n/ja/sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":["admonition"]},"type":"markdown"},"seo":{"title":"Facebook Ads Insights インポート連携","description":"Facebook Ads Insightsのデータをインポートする方法を解説。OAuth認証やアクセストークンを使用し、広告キャンペーンの結果データを簡単に取り込めます。","siteUrl":"https://docs.treasure.ai","lang":"en-US","jsonLd":{"@context":"https://schema.org","@graph":[{"@type":"Organization","@id":"https://www.treasure.ai/","name":"Treasure AI","url":"https://www.treasure.ai/","logo":"https://www.treasure.ai/hubfs/assets/images/logos/primary-logo.svg"},{"@type":"WebSite","@id":"https://docs.treasure.ai/#website","name":"Treasure AI Documentation","url":"https://docs.treasure.ai/","inLanguage":["en","ja"],"publisher":{"@id":"https://www.treasure.ai/"}}]}},"dynamicMarkdocComponents":[],"compilationErrors":[],"ast":{"$$mdtype":"Tag","name":"article","attributes":{},"children":[{"$$mdtype":"Tag","name":"Heading","attributes":{"level":1,"id":"facebook-ads-insights-インポート連携","__idx":0},"children":["Facebook Ads Insights インポート連携"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Facebook Ads Insights のデータコネクタ(旧称 Facebook Ads Reporting)は、Facebook 広告キャンペーンの結果データをインポートすることができます。"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":1,"id":"前提条件","__idx":1},"children":["前提条件"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Treasure Data の基本知識"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Facebook Marketing API、特に ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"https://developers.facebook.com/docs/marketing-api/reporting"},"children":["Ads Insights API"]}," の基本知識"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["管理者権限として Admin または Advertiser が必要"]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"treasure-コンソール-を使用する","__idx":2},"children":["Treasure コンソール を使用する"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"新しい接続を作成する","__idx":3},"children":["新しい接続を作成する"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"https://console.treasuredata.com/app/connections/my-connections"},"children":["Treasure Data Connections"]}," に移動し、Facebook Ads を検索して選択します。次のダイアログが開きます。"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"img","attributes":{"src":"/assets/image-20191017-181035.1577cc83f5875887b50ad38a67bdf8a6d5d95d993a4b9e160cc6050c17b8fc52.7ecd5fd4.png","alt":""},"children":[]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["2つの認証方法をサポートしています:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["OAuth"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Access Token"]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"id":"oauth-を使用する","__idx":4},"children":["OAuth を使用する"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Facebook の既存の OAuth 接続を選択するか、OAuth connection の下にあるリンクを選択して新しい接続を作成します。"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"img","attributes":{"src":"/assets/image-20191017-181104.d6e7e16dd7f44db42198d496e64bf99984d3766c9505f7705939367defbe8047.7ecd5fd4.png","alt":""},"children":[]}]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["新しい OAuth 接続を作成する"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["ポップアップウィンドウで Facebook アカウントにログインします:"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"img","attributes":{"src":"/assets/image-20191017-181215.84b82feaced3680bb19707fc0476cccb5f24b8dd22ba66375fadc90e070dd4e6.7ecd5fd4.png","alt":""},"children":[]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["そして、Treasure Data アプリへのアクセスを許可します。"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"https://console.treasuredata.com/app/connections/data-sources"},"children":["Treasure Data Connections"]}," にリダイレクトされます。最初のステップ(新しい接続を作成する)を繰り返し、新しい OAuth 接続を選択します。"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"img","attributes":{"src":"/assets/image-20191017-181244.a60ae0b7f0aec4926d5bb6e9027725877936e6031873e0ece3d5fffe7045d67e.7ecd5fd4.png","alt":""},"children":[]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"access-token-を使用する","__idx":5},"children":["Access Token を使用する"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Access Token を作成するには、セクション3の「Facebook Token の取得」を参照してください。"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"新しい転送を作成する","__idx":6},"children":["新しい転送を作成する"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["接続を作成すると、自動的に ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"https://console.treasuredata.com/app/connections/my-connections"},"children":["Authentications"]}," タブに移動します。作成した接続を探して、New Source を選択します。"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["次のダイアログが開きます。"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"img","attributes":{"src":"/assets/image-20191017-181852.d2ec4e6047223b7cccc3332d17d8f8a421150cf341c65ffcf559706b30bec298.7ecd5fd4.png","alt":""},"children":[]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["以下の詳細を編集します:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Ad Account ID"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Data Level"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Import Metadata for Related Objects"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Import all Insights or Insights Fields"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Breakdowns"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Filtering"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Action Attribution Windows"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Start and End Date or Incremental"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Reporting Period"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["これらのパラメータの詳細は次のとおりです:"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"id":"ad-account-id","__idx":7},"children":["Ad Account ID"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Ad Account ID を追加します。これは",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"https://www.facebook.com/business/help/1492627900875762"},"children":["こちらの説明"]},"に従って見つけることができます。"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"id":"data-level","__idx":8},"children":["Data Level"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Ads オブジェクトレベルです。使用可能なオプションは、",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"https://developers.facebook.com/docs/marketing-api/reference/ad-campaign-group"},"children":["Campaign"]},"、",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"https://developers.facebook.com/docs/marketing-api/reference/ad-campaign"},"children":["Ad Set"]},"、",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"https://developers.facebook.com/docs/marketing-api/reference/adgroup"},"children":["および Ad"]}," です。"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"id":"import-metadata-for-related-objects","__idx":9},"children":["Import Metadata for Related Objects"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["デフォルトでは、Import metadata for related objects はチェックされておらず、コネクタは基本的なメタデータフィールドのみをインポートします: created_time、effective_status、status。"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["これをチェックすることで、インポートする関連オブジェクトまたは個別のメタデータフィールドを指定できます。"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"id":"related-edges","__idx":10},"children":["Related Edges"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["すべての関連 edges をインポートするには、All Metadata Fields を選択します。Fetch Metadata に各 edge を追加することで、インポートする edges を選択できます。"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"img","attributes":{"src":"/assets/image-20191017-181943.0f8662c25dfaa1f79353be528fb0081ae03f2f43c1784f5f48f843c97839d9b0.7ecd5fd4.png","alt":""},"children":[]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"id":"metadata-fields","__idx":11},"children":["Metadata Fields"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Ads オブジェクトに関連付けられたメタデータフィールドです。Individual Metadata Fields を選択すると、必要なフィールドのみをインポートできます。Metadata Fields の下でフィールドを選択します。"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"img","attributes":{"src":"/assets/image-20191017-182014.d8c6197ead093910d4d366530fdddb591b4ce6f4d99ef6c89786fd5206b6d49b.7ecd5fd4.png","alt":""},"children":[]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["edge{field1, field2…} を使用して、Ads オブジェクトの edges にアクセスすることもできます。"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"id":"insights-fields","__idx":12},"children":["Insights Fields"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Insight フィールドは、キャンペーンのパフォーマンスに関するデータを提供します。"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["デフォルトでは、Import all insights fields がチェックされています。"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"img","attributes":{"src":"/assets/image-20191017-182145.5f85958eaeb7374abdbeeacce093f8279dfffbce1dd8511fce87603fe0cbdf23.7ecd5fd4.png","alt":""},"children":[]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Import all insights fields のチェックを外して、特定のフィールドを選択できます。"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"img","attributes":{"src":"/assets/image-20191017-182233.abf14a3a7aea654749a46b8a4e89bc52d41bb3cdd36adc1bf7eab279f0553e0e.7ecd5fd4.png","alt":""},"children":[]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"https://developers.facebook.com/docs/marketing-api/insights#field-expansion"},"children":["Insights"]}," フィールドの date_start と date_stop は、明示的に設定されていない場合、デフォルトで追加されます。Insight の値は、Ads オブジェクトの状態によって空の場合があります。フィールドに値が含まれていない場合でも、エラーは生成されません。"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"id":"breakdowns","__idx":13},"children":["Breakdowns"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Breakdowns は、異なるセットまたはコホートにグループ化された Ads Insights レスポンスをキャプチャするために使用されます。サポートされている breakdowns は次のとおりです:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["age"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["gender"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["country"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["region"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["hourly_stats_aggregated_by_advertiser_time_zone"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"img","attributes":{"src":"/assets/image-20191017-182602.176baa834f7a5c988fb153840b1f707717ea1aa4bd2e2d5cf56833bb82c43cc9.7ecd5fd4.png","alt":""},"children":[]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"id":"filtering","__idx":14},"children":["Filtering"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["報告されたInsightsデータのフィルター。フォーマット: フィールド —> オペレーター —> 値、action_typeはカンマ区切りの値でINオペレーターをサポートします。例: post_like, like"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"img","attributes":{"src":"/assets/image-20191017-182636.70e3b86ff9bd63c4aebb6d29997f5c20aac293a1785898c2008fad41a77ae1d3.7ecd5fd4.png","alt":""},"children":[]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"id":"action-attribution-windows","__idx":15},"children":["Action Attribution Windows"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["アクションのアトリビューションウィンドウを決定します。サポートされる値は以下の通りです:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["1d_view"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["7d_view"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["28d_view"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["1d_click"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["7d_click"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["28d_click"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["明示的に設定されていない場合、デフォルト値は: ([\"1d_view\",\"28d_click\"]) です。"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"img","attributes":{"src":"/assets/image-20191017-182744.08b30b683726638e208b213f3e8165b5015c618e91133cf1158977685e764000.7ecd5fd4.png","alt":""},"children":[]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"incremental-import-and-start-date","__idx":16},"children":["Incremental Import and Start Date"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Incremental"]},"インポートと",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Start Date"]},"を指定するかどうかを選択します。"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["incrementalを有効にすることで、各増分ロードの期間(日数)を定義できます。デフォルトは1日です。",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Start Date"]},"が指定されていない場合、デフォルトは過去30日間に設定されます。"]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"info"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["取得されるデータには、前日の深夜まで利用可能なデータが含まれます。"]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"reporting-period","__idx":17},"children":["Reporting Period"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Start Date"]},"と",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["End Date"]},"を使用してレポート期間を選択した後、期間全体の結果を取得するか、より小さな時間単位で結果を取得するかを選択できます。",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["All Days"]},"を選択すると、期間全体で1つの結果セットが取得されます。",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["monthly"]},"を指定すると、指定された期間内の各暦月ごとに1つの結果セットが取得されます。"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"img","attributes":{"src":"/assets/image-20191017-182818.b3f389943b38e920575a9742ccabc8647a09c5e7fc4d53df09cba266e5c55653.7ecd5fd4.png","alt":""},"children":[]},{"$$mdtype":"Tag","name":"img","attributes":{"src":"/assets/image-20191017-182855.3ce754b59a79079685b577b72b2ea1e57e42d4b1585e06692418734f362cfdcf.7ecd5fd4.png","alt":""},"children":[]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["または、",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["In Days"]},"を選択して指定したN日間の期間ごとに1つの結果セットを取得することもできます。1から90までの日数を指定できます。"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"img","attributes":{"src":"/assets/image-20191017-182922.3ce754b59a79079685b577b72b2ea1e57e42d4b1585e06692418734f362cfdcf.7ecd5fd4.png","alt":""},"children":[]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["パラメーターの指定が完了したら、",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Next"]},"を選択します。以下のダイアログと同様のデータのプレビューが表示されます。",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Next"]},"を選択します。プレビューを超えて進めない場合は、",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"https://docs.treasuredata.com/smart/project-product-documentation/about-data-preview"},"children":["Preview while Importing Data"]},"を参照してください。"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"img","attributes":{"src":"/assets/image-20191017-183241.0cc37aaa8b7ebcd6de0c81a800b22ae833fd9e18777c6196fc6a306ec8c4ea45.7ecd5fd4.png","alt":""},"children":[]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["以下のダイアログに示すように、データを転送するデータベースとテーブルを選択します:"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"img","attributes":{"src":"/assets/image-20191017-183551.7daa417c4552d8d9afeb062c627880a591e65eb2edac38f029a5fe7f8f85301d.7ecd5fd4.png","alt":""},"children":[]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["以下のダイアログを使用してデータ転送のスケジュールを指定し、",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Start Transfer"]},"を選択します。"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"img","attributes":{"src":"/assets/image-20191017-183622.02f17beca8df86817524a2635baefb2e2afd3e513414ef6af7cb557ca028dbd9.7ecd5fd4.png","alt":""},"children":[]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["新しいデータ転送が進行中としてMy Input Transfersタブの下に表示され、対応するジョブがJobsセクションに表示されます。"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["これで、データの分析を開始する準備が整いました!"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"use-command-line","__idx":18},"children":["Use Command Line"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"install-td-toolbelt","__idx":19},"children":["Install TD Toolbelt"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["最新のTD Toolbeltをインストールします。"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"obtain-facebook-token","__idx":20},"children":["Obtain Facebook Token"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"https://developers.facebook.com/docs/facebook-login/access-tokens"},"children":["Facebookは3種類のトークンを提供しています"]},"。期限切れのないPage Access Tokenの使用を推奨します。User Tokenも使用できますが、延長しても2か月後に期限切れになります。バッチ処理には適していません。"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["期限切れのないPage Access Tokenの取得方法については、",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"https://developers.facebook.com/docs/facebook-login/guides/access-tokens/get-long-lived/"},"children":["Facebook Long-Lived Access Tokens"]},"を参照してください。"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"prepare-configuration-and-preview-data","__idx":21},"children":["Prepare Configuration and Preview Data"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["facebook_ads_reportingコネクターに対してtd connector:guessを実行する必要はありません。"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["以下のようにconfig.ymlを準備します:"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"yaml","header":{"controls":{"copy":{}}},"source":"in:\n  type: \"facebook_ads_reporting\"\n  ad_account_id: '[your ad account id]'\n  access_token: \"[your Facebook access token]\"\n  data_level: ad\n  fields:\n    - clicks\n    - impressions\n  metadata_import: all\n  metadata_edge:\n    - adrules_governed\n    - copies\n    - keywordstats\n    - leads\n    - targetingsentencelines\n  filtering:\n    - {field : \"clicks\", operator: \"GREATER_THAN\", value: 10}\n    - {field : \"impressions\", operator: \"GREATER_THAN\", value: 200}\nout:\n  mode: append\n","lang":"yaml"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["preview"]},"コマンドを使用してデータのプレビューを表示できます。"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"bash","header":{"controls":{"copy":{}}},"source":"td connector:preview config.yml\n","lang":"bash"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"configuration","__idx":22},"children":["Configuration"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["利用可能なモードの詳細については、以下の表を参照してください。"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Option name"},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Option name"]}]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Description"},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Description"]}]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Type"},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Type"]}]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Required?"},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Required?"]}]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Default value"},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Default value"]}]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["ad_account_id"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["access_tokenのアドアカウントID"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["string"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["yes"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["—"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["access_token"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Access Token。期限切れのないトークンの使用を推奨します(次のセクションを参照)"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["string"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["yes"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["—"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["app_secret"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["設定されている場合、appsecret_proofパラメーターがAPIへのアクセスに使用されます"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["string"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["optional"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["—"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["metadata_import"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["関連エッジまたは個別のメタデータフィールドをインポートしますか? 利用可能なオプションはallとindividualです"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["string"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["optional"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["individual"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["metadata_edge"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["インポートする関連エッジ。metadata_importがallの場合のみ有効です。関連エッジを参照してください。"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["array"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["optional"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["—"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["metadata_fields"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["指定されたオブジェクトに対して取得したいメタデータフィールド。",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"https://developers.facebook.com/docs/marketing-api/reference/v2.9"},"children":["利用可能なフィールドを確認してください。"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["array"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["optional"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["created_time, status, effective_status"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["fields"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Insightsに対して取得したいフィールド。",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"https://developers.facebook.com/docs/marketing-api/reference/v2.9"},"children":["利用可能なフィールドを確認してください。"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["array"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["optional"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["—"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["breakdowns"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["詳細についてはbreakdownsを参照してください。"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["string"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["optional"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["—"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["filtering"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["詳細についてはfilterを参照してください。"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["array"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["optional"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["—"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["action_attribution_windows"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["アクションのアトリビューションウィンドウを決定します。たとえば、28d_clickは広告がクリックされてから28日以内に発生したすべてのアクションをAPIが返すことを意味します。"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["array"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["optional"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["—"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["retry_limit"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["最大リトライ回数"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["integer"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["optional"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["5"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["retry_initial_wait_sec"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["エクスポネンシャルバックオフの初期値の待機秒数"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["integer"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["optional"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["10"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["last_fetched_at"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["この日付以降のデータのみをインポートします。指定されていない場合は、今日から30日前（つまり、today - 30 days）になります。推奨形式: %m/%d/%Y または %Y-%m-%dT%H:%M:%S.%L%Z"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["string"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["optional"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["—"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["incremental"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["embulk run -c config.diffで \"config_diff\" を生成する場合はtrue"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["bool"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["optional"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["true"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["duration"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["開始日からインサイトデータを取得する日数。詳細は付録Bを参照してください。"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["integer"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["optional"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["1"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["time_increment"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["整数の場合、1から90までの日数を指定します。last_fetched_atとlast_fetched_untilを使用してレポート期間を選択した後、期間全体の結果を取得するか、より小さな時間スライスの結果を取得するかを選択できます。\"all_days\"を使用すると、期間全体の1つの結果セットが得られます。\"monthly\"を使用すると、指定された期間内の各カレンダー月ごとに1つの結果セットが得られます。または、このパラメータで指定されたN日間ごとに1つの結果セットを取得できます。詳細は付録Bを参照してください。"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["string"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["optional"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["1"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["last_fetched_until"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["この日付までのデータのみをインポートします。指定されていない場合は今日になります。推奨形式: last_fetched_atを参照してください。詳細は付録Cを参照してください。"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["string"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["optional"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["—"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["add_time_column"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["trueの場合、インサイトのdate_stop値に基づいて\"time\"カラムが自動的に追加されます。それ以外の場合は、upload_timeによって\"time\"カラムが追加されます"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["bool"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["optional"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["true"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["data_level"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["データレベルを取得します。Facebookインサイトレベル: Campaign –> Adset –> Ad。使用可能なオプションは \"campaign\"、\"adset\"、\"ad\"、または \"ad_creative\" です。"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["string"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["optional"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["\"ad\""]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["api_version"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["使用するFacebook APIのバージョン。デフォルトはv3.2です。指定されたバージョンがv3.1より古い場合（非推奨）、プラグインは \"v3.2\" を使用します"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["string"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["optional"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["\"v3.2\""]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["limit_per_page"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["ページあたりのレコード数。\"Please reduce the amount of data you're asking for, then retry your request\"というエラーメッセージが表示された場合は、この値を減らしてください"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["integer"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["optional"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["100000"]}]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"サポートされている関連エッジ","__idx":23},"children":["サポートされている関連エッジ"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"id":"campaign","__idx":24},"children":["Campaign"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["ad_studies"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["adrules_governed"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["ads"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["adsets"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["copies"]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"id":"adset","__idx":25},"children":["AdSet"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["activities"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["ad_studies"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["adrules_governed"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["ads"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["copies"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["targetingsentencelines"]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"id":"ad","__idx":26},"children":["Ad"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["adrules_governed"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["copies"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["keywordstats"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["leads"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["targetingsentencelines"]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"durationとtime_increment","__idx":27},"children":["durationとtime_increment"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"id":"durationはいつ使用しますか","__idx":28},"children":["durationはいつ使用しますか？"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["duration"]},"は",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["incremental = true"]},"の場合にのみ有効です"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["duration"]},"は",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["last_fetched_at"]},"に基づいてリクエストの時間範囲を計算するために使用されます。たとえば、",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["last_fetched_at = 02/01/2017"]},"で",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["duration = 2"]},"の場合、リクエストする時間範囲は02/01/2017 → 02/02/2017になります"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Facebookリクエストパラメータに直接変換すると:"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"header":{"controls":{"copy":{}}},"source":".time_range({\"since\":\"2017-02-01\",\"until\":\"2017-02-02\"})\n"},"children":[]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["このパラメータを使用する場合、ブレークダウンの動作はありません。時間範囲全体のインサイト値を返します。"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["注"]},": ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["last_fetched_at"]},"が指定されていない場合、今日から30日前（つまり、today – 30 days）になります"]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"id":"time_incrementはいつ使用しますか","__idx":29},"children":["time_incrementはいつ使用しますか？"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["time_increment"]},"は、インサイトデータを日数で分割したい場合に使用します。結果は、インクリメンタルモードとdurationを使用しない場合に最も認識しやすくなります。"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["例:"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"yaml","header":{"controls":{"copy":{}}},"source":"incremental: false\nlast_fetched_at: 03/01/2017\nlast_fetched_until: 03/31/2017\ntime_increment: 1\n","lang":"yaml"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["上記の設定を使用すると、2017年3月全体を1回の実行でインポートでき、それでも日次で分割できます。"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"id":"durationとtime_incrementの違い","__idx":30},"children":["durationとtime_incrementの違い"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["duration"]},"は",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["incremental"]},"モードで使用されます"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["time_increment"]},"は公式のFacebookパラメータです"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["重要な注意事項"]},": ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["duration"]},"と",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["time_increment"]},"の両方が使用可能な場合（デフォルト）、",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["duration"]},"の値が",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["time_increment"]},"より小さい場合、",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["duration"]},"は",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["time_increment"]},"よりも優先されます。つまり、",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["duration = 1"]},"の場合、2日ごとのブレークダウンデータ（",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["time_increment = 2"]},"）は取得できず、結果は1日分のデータになります。一方で、2日間のduration（",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["duration = 2"]},"）に対して日次でデータを分割（",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["time_increment = 1"]},"）することは完全に可能です。"]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"id":"last_fetched_untilはいつ使用しますか","__idx":31},"children":["last_fetched_untilはいつ使用しますか？"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["last_fetched_until"]},"はオプションであり、その唯一の用途はインポートするデータを終了日で制限することです。"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["例: 2017年3月のデータをインポートするジョブがあり、毎日データを取得するために繰り返し実行するようにスケジュールされています。したがって、次の設定を使用してこれを実現できます:"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"yaml","header":{"controls":{"copy":{}}},"source":"incremental: true\nduration: 1\nlast_fetched_at: 03/01/2017\nlast_fetched_until: 03/31/2017\n","lang":"yaml"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["注"]},": ご覧のとおり、",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["duration"]},"を使用してジョブを繰り返し実行することで",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["time_increment"]},"の効果をシミュレートできますが、より多くのリクエストが発生します（リクエストレート制限により早く到達します）。"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["スケジュールされたジョブが（最終的に）設定された",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["last_fetched_until"]},"を超えた場合、空の結果が返されます。"]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"2018年7月10日リリースでのdata-connectorスキーマの変更","__idx":32},"children":["2018年7月10日リリースでのData Connectorスキーマの変更"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Facebook APIの最近の変更により、Data Connectorが更新されました。"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["変更前:"]}," 一部のフィールドが追加されましたが、値が空だったため、出力スキーマに一部のカラムが欠落していました。"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["変更後:"]}," 一部の新しいカラムが追加されますが、値が含まれていない場合があります。出力スキーマは、入力設定と必須フィールドから組み合わされます。"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["必須フィールドと暗黙的に追加されるカラムは次のとおりです:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["メタデータフィールド"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["created_time"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["effective_status"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["status"]}]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["インサイトフィールド"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["date_start"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["date_stop"]}]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["以前の更新でスキップされた可能性のある無効な",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["**fields**"]},"は、更新後にエラーになります。インサイトフィールドとメタデータフィールドの完全なリファレンスについては、次のリンクの",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Fields"]},"セクションを参照してください:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"https://developers.facebook.com/docs/marketing-api/reference/ad-campaign-group#Reading"},"children":["Campaignレベルのメタデータフィールド"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"https://developers.facebook.com/docs/marketing-api/reference/ad-campaign#Reading"},"children":["Ad Setレベルのメタデータフィールド"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"https://developers.facebook.com/docs/marketing-api/reference/adgroup#Reading"},"children":["Adレベルのメタデータフィールド"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"https://developers.facebook.com/docs/marketing-api/reference/ads-insights/"},"children":["インサイトフィールド"]}]}]}]},"headings":[{"value":"Facebook Ads Insights インポート連携","id":"facebook-ads-insights-インポート連携","depth":1},{"value":"前提条件","id":"前提条件","depth":1},{"value":"Treasure コンソール を使用する","id":"treasure-コンソール-を使用する","depth":2},{"value":"新しい接続を作成する","id":"新しい接続を作成する","depth":3},{"value":"OAuth を使用する","id":"oauth-を使用する","depth":4},{"value":"Access Token を使用する","id":"access-token-を使用する","depth":3},{"value":"新しい転送を作成する","id":"新しい転送を作成する","depth":3},{"value":"Ad Account ID","id":"ad-account-id","depth":4},{"value":"Data Level","id":"data-level","depth":4},{"value":"Import Metadata for Related Objects","id":"import-metadata-for-related-objects","depth":4},{"value":"Related Edges","id":"related-edges","depth":4},{"value":"Metadata Fields","id":"metadata-fields","depth":4},{"value":"Insights Fields","id":"insights-fields","depth":4},{"value":"Breakdowns","id":"breakdowns","depth":4},{"value":"Filtering","id":"filtering","depth":4},{"value":"Action Attribution Windows","id":"action-attribution-windows","depth":4},{"value":"Incremental Import and Start Date","id":"incremental-import-and-start-date","depth":3},{"value":"Reporting Period","id":"reporting-period","depth":3},{"value":"Use Command Line","id":"use-command-line","depth":2},{"value":"Install TD Toolbelt","id":"install-td-toolbelt","depth":3},{"value":"Obtain Facebook Token","id":"obtain-facebook-token","depth":3},{"value":"Prepare Configuration and Preview Data","id":"prepare-configuration-and-preview-data","depth":3},{"value":"Configuration","id":"configuration","depth":3},{"value":"サポートされている関連エッジ","id":"サポートされている関連エッジ","depth":3},{"value":"Campaign","id":"campaign","depth":4},{"value":"AdSet","id":"adset","depth":4},{"value":"Ad","id":"ad","depth":4},{"value":"durationとtime_increment","id":"durationとtime_increment","depth":3},{"value":"durationはいつ使用しますか？","id":"durationはいつ使用しますか","depth":4},{"value":"time_incrementはいつ使用しますか？","id":"time_incrementはいつ使用しますか","depth":4},{"value":"durationとtime_incrementの違い","id":"durationとtime_incrementの違い","depth":4},{"value":"last_fetched_untilはいつ使用しますか？","id":"last_fetched_untilはいつ使用しますか","depth":4},{"value":"2018年7月10日リリースでのData Connectorスキーマの変更","id":"2018年7月10日リリースでのdata-connectorスキーマの変更","depth":2}],"frontmatter":{"seo":{"title":"Facebook Ads Insights インポート連携","description":"Facebook Ads Insightsのデータをインポートする方法を解説。OAuth認証やアクセストークンを使用し、広告キャンペーンの結果データを簡単に取り込めます。"}},"lastModified":"2026-06-17T07:22:53.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/ja/int/facebook-ads-insights-import-integration","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}