{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-@l10n/ja/sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":[]},"type":"markdown"},"seo":{"title":"Google Analytics Import Integration CLI","description":"Google AnalyticsデータをCLIを使用してTreasure AIにインポートする方法を解説。コネクタの設定、データ転送の指定、プレビュー方法を詳しく説明します。","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":"google-analytics-import-integration-cli","__idx":0},"children":["Google Analytics Import Integration CLI"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"cliからのdata-connectorの作成","__idx":1},"children":["CLIからのData Connectorの作成"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["コンソールUIの代わりに、コマンドラインインターフェース(CLI)からTreasure Data connectorを設定することもできます。Treasure Dataのconnectorは、Treasureデータアカウントへのエクスポートを可能にするYAMLプラグイン形式の設定ファイルを使用します。"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["開始する前に、'td'コマンドv0.11.9以降がインストールされていることを確認してください。"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"bash","header":{"controls":{"copy":{}}},"source":"$ td —version\n","lang":"bash"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["必要に応じて、",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"https://toolbelt.treasuredata.com/"},"children":["Treasure Data Toolbelt"]},"にアクセスしてください。"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"データ転送の指定","__idx":2},"children":["データ転送の指定"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["data connector .ymlファイルを作成または取得します。"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["データ設定ファイルのIn:セクションで入力データを指定します。次に、out:セクションで、Treasureデータアカウントの詳細情報である宛先情報を指定します。"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["この例では、セクション2で元々作成されたservice accountが指定されています。また、セクション2で作成されたJSONファイルの秘密鍵情報も使用します。"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"img","attributes":{"src":"/assets/image-20191015-195341.fb7e6c2f7c29b7c30885bd2963f582ded080d2559175cbf546e60c9b6ed57f13.ef8005ce.png","alt":""},"children":[]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["設定ファイルのセクション:"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["\"type\"はこのインスタンスではgoogle analyticsです。"," ","\"json_key_content\"には、開き括弧から閉じ括弧( {} )まで、JSONファイルの内容をここに貼り付けます。"," ","\"view_id\": セクション2で説明されているGoogle Analytics View IDをここに入力します。"," ","\"Start_date\": \"YYYY-MM-DD\"形式で指定されたデータ取得期間の開始日。(デフォルト: 7日前)"," ","\"end_date\": \"YYYY-MM-DD\"形式で指定されたデータ取得期間の終了日。(デフォルト: 1日前)"," ","\"time_series\": TDへのインポート時に\"time\"カラムのタイムスタンプを指定する必要があります。\"date\"または\"dateHour\"を指定できます。これにより、time_seriesで1つのdimensionを消費します。"," ","さらに最大6つのdimensionsを設定できます。\"dimension\", \"metrics\": Google Analyticsからアクセスするディメンションカラムとメトリクスを指定します。\"Out:\"既存のテーブルに入ってくるデータを追加するには\"mode: append\"と入力します。既存のテーブルのデータを置き換えるには\"mode:replace\"と入力します。"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"データ転送のプレビュー","__idx":3},"children":["データ転送のプレビュー"]},{"$$mdtype":"Tag","name":"p","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":"p","attributes":{},"children":["システムが予期しない方法でカラム名またはカラムタイプを検出した場合は、",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["config.yml"]},"を直接変更して再度プレビューしてください。data connectorは\"boolean\"、\"long\"、\"double\"、\"string\"、および\"timestamp\"タイプの解析をサポートしています。"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"img","attributes":{"src":"/assets/image-20191015-195559.4d03087ddc1052ef1022445380e42974568dcbde7eb9a1e2e0fcf930df18d97d.ef8005ce.png","alt":""},"children":[]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["設定ファイルで指定されたtime series (\"date_hour\")、dimensions (\"browser\")、およびmetrics (\"visits\", \"pageviews\")が表示されます。"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["プレビューは転送結果の感覚をつかむのに役立ちます。Google Analyticsの\"time_series\"は、TDデータテーブルのtimeカラムにマップされます。通常、timeカラムはTDのパーティショニングキーです。\"date_hour\"の代わりに\"ga: date\"を使用することもできます。一部の\"time-series\"の組み合わせは無効であることに注意してください。たとえば、ga:1dayUsersとga:7dayUsersを同じ設定で使用することはできません。"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"オプション追加のdimensionsまたはmetricsの追加","__idx":4},"children":["オプション—追加のDimensionsまたはMetricsの追加"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Google API V4 > Reporting > Dimensions& Metrics Explorerでは、Treasure Dataにインポートできるディメンションとメトリクスのリストを確認できます。"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"img","attributes":{"src":"/assets/image-20191015-195642.103a2a21cc4dc56118e0b818436f45df2366efb0451fa793748fcfb7abfe6d14.ef8005ce.png","alt":""},"children":[]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"データ転送プロセスの開始","__idx":5},"children":["データ転送プロセスの開始"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Treasure Dataへのデータ転送は、データのサイズに応じて数時間かかる場合があります。"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["データが保存されるdatabaseとtableを指定する必要があります。"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"load-jobの送信","__idx":6},"children":["Load Jobの送信"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"bash","header":{"controls":{"copy":{}}},"source":"td connector:issue config.yml --database td_sample_db --table td_sample_table \\\n  --time-column date_hour\n","lang":"bash"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["上記のコマンドは、すでに*database(td_sample_db)",{"$$mdtype":"Tag","name":"em","attributes":{},"children":["と"]},"table(td_sample_table)*を作成していることを前提としています。databaseまたはtableがTDに存在しない場合、このコマンドは成功しないため、databaseとtableを手動で作成するか、TD connector:issueコマンドで--auto-create-tableオプションを使用してdatabaseとtableを自動作成してください:"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"bash","header":{"controls":{"copy":{}}},"source":"td connector:issue config.yml --database td_sample_db --table td_sample_table --time-column date_hour --auto-create-table\n","lang":"bash"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["data connectorはサーバー側でレコードをソートしません。時間ベースのパーティショニングを効果的に使用するには、事前にファイル内のレコードをソートしてください。"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["次の例では、databaseが既に存在しない場合、それが作成されることがわかります。Treasure DataのバルクデータローダーであるEmbulkによってインポートされる指定を確認できます。デフォルトでは、In:セクションで指定されたtime_series項目がOut:セクションのtimeカラムに変換されることがわかります。timeカラムはTreasure Dataで'パーティションキー'として使用されます。"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"img","attributes":{"src":"/assets/image-20191015-195737.5b0cc76e39585c214bd959809792d43c912888b018c1b335aecbe4d218ebd544.ef8005ce.png","alt":""},"children":[]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"スケジュール実行","__idx":7},"children":["スケジュール実行"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["増分Google Analyticsインポートのために、定期的なData Connector実行をスケジュールできます。高可用性を確保するために、スケジューラーを慎重に設定しています。この機能を使用することで、ローカルデータセンターにcronデーモンを配置する必要がなくなります。"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["スケジュールされたインポートの場合、Data Connector for Google Analyticsは最初にすべてのデータをインポートします。"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["スケジュール実行は、ネイティブタイムスタンプの1つに基づいてGoogle Analyticsからデータを取得する際のData Connectorの動作を制御する追加の設定パラメータをサポートしています:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["incremental この設定は、ロードモードを制御するために使用され、ネイティブタイムスタンプの1つに基づいてData ConnectorがGoogle Analyticsからデータを取得する方法を管理します。"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["incremental: true (デフォルト)"," ","このモードでは、data connectorはconnectorの前回の実行以降に更新されたレコードのみを取得します。これは、ユーザーが時間範囲内のレコードのみを取得したい場合に便利です。"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["start_date"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["end_date"," ","これらのオプションは、次の例のように、Google Analyticsから必要なデータのみをロードするために、増分モードで必要です。"]}]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["incremental: false"," ","このモードでは、data connectorは、最後に更新された時期に関係なく、指定されたすべてのレコードを取得します。"]}]}]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["last_record_time この設定は、この時間からレコードを取得するために使用されます。"]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["例: 増分モードとlast_record_timeを使用したシードファイル"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"header":{"controls":{"copy":{}}},"source":"in:\n  type: google_analytics\n  json_key_content: |\n    {\n      ... paste here you got key file content on Step 1 ...\n    }\n  view_id: 104222666\n  time_series: \"ga:dateHour\"\n  incremental: true\n  start_date: '2016-01-30'\n  end_date: '2017-01-01'\n  last_record_time: '2016-12-01 08:00:00 UTC'\n  dimensions:\n    - \"ga:browser\"\n  metrics:\n    - \"ga:visits\"\n    - \"ga:pageviews\"\n"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["上記の設定では、data connectorは2016-12-01 00:00:00から始まるすべてのレコードをロードします。"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["2回目以降の実行では、最後の実行後に来たデータのみがインポートされます。"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"スケジュールの作成","__idx":8},"children":["スケジュールの作成"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["TD connector:createコマンドを使用して新しいスケジュールを作成できます。次の項目が必要です: スケジュールの名前、cron形式のスケジュール、データが保存されるdatabaseとtable、およびdata connector設定ファイル。"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"header":{"controls":{"copy":{}}},"source":"$ td connector:create \\\n    daily_import \\\n    \"10 0 * * *\" \\\n    td_sample_db \\\n    td_sample_table \\\n    config.yml\n"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Treasure Dataのストレージは時間でパーティション化されているため、--time-columnオプションを指定することも推奨されます(",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"https://docs.treasuredata.com/smart/project-product-documentation/data-partitioning-in-treasure-data"},"children":["データパーティショニングについて"]},"も参照してください)。"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"header":{"controls":{"copy":{}}},"source":"$ td connector:create \\\n    daily_import \\\n    \"10 0 * * *\" \\\n    td_sample_db \\\n    td_sample_table \\\n    load.yml \\\n"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["cron"]},"パラメータは、",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["@hourly"]},"、",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["@daily"]},"、",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["@monthly"]},"の3つの特別なオプションも受け入れます。デフォルトでは、スケジュールはUTCタイムゾーンで設定されます。-tまたは--timezoneオプションを使用して、タイムゾーンでスケジュールを設定できます。",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["--timezone"]},"オプションは'Asia/Tokyo'、'America/Los_Angeles'などの拡張タイムゾーン形式のみをサポートしていることに注意してください。PST、CSTなどのタイムゾーンの略語は*サポートされておらず*、予期しないスケジュールにつながる可能性があります。"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"スケジュールのリスト表示","__idx":9},"children":["スケジュールのリスト表示"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["TD connector:listコマンドを実行すると、スケジュールされたエントリのリストを確認できます。"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"header":{"controls":{"copy":{}}},"source":"$ td connector:list\n"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"設定とスケジュール履歴の表示","__idx":10},"children":["設定とスケジュール履歴の表示"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["td connector:showは、スケジュールエントリの実行設定を表示します。"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"bash","header":{"controls":{"copy":{}}},"source":"td connector:show daily_import\n","lang":"bash"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["td connector:historyは、スケジュールエントリの実行履歴を表示します。個々の実行の結果を調査するには、td job jobidを使用します。"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"bash","header":{"controls":{"copy":{}}},"source":"td connector:history daily_import\n","lang":"bash"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"スケジュールの削除","__idx":11},"children":["スケジュールの削除"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["td connector:deleteはスケジュールを削除します。"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"header":{"controls":{"copy":{}}},"source":"$ td connector:delete daily_import\n"},"children":[]}]},"headings":[{"value":"Google Analytics Import Integration CLI","id":"google-analytics-import-integration-cli","depth":1},{"value":"CLIからのData Connectorの作成","id":"cliからのdata-connectorの作成","depth":2},{"value":"データ転送の指定","id":"データ転送の指定","depth":3},{"value":"データ転送のプレビュー","id":"データ転送のプレビュー","depth":3},{"value":"オプション—追加のDimensionsまたはMetricsの追加","id":"オプション追加のdimensionsまたはmetricsの追加","depth":3},{"value":"データ転送プロセスの開始","id":"データ転送プロセスの開始","depth":3},{"value":"Load Jobの送信","id":"load-jobの送信","depth":3},{"value":"スケジュール実行","id":"スケジュール実行","depth":2},{"value":"スケジュールの作成","id":"スケジュールの作成","depth":3},{"value":"スケジュールのリスト表示","id":"スケジュールのリスト表示","depth":3},{"value":"設定とスケジュール履歴の表示","id":"設定とスケジュール履歴の表示","depth":3},{"value":"スケジュールの削除","id":"スケジュールの削除","depth":3}],"frontmatter":{"seo":{"title":"Google Analytics Import Integration CLI","description":"Google AnalyticsデータをCLIを使用してTreasure AIにインポートする方法を解説。コネクタの設定、データ転送の指定、プレビュー方法を詳しく説明します。"}},"lastModified":"2026-06-17T07:22:53.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/ja/int/google-analytics-import-integration-cli","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}