Marketing

マーケティングに関するアクション一覧です。
GetGAReport
概要
GetGAReportは、Googleアナリティクスからレポートを取得するアクションです。パラメーターを設定することで、カスタマイズされたレポートを作成することができます。レポートの対象期間は、startDate、endDateで設定します。取得したい値は、metricsで選択します。ページ別、ブラウザ別などの分析軸を設定したい場合は、dimensionsで指定します。リクエストで返されるディメンションまたは指標を制限したい場合は、filtersで指定します。また、mcf_reportをtrueにすることでマルチチャネルレポートデータを取得することが出来ます。返却されるレスポンスはデフォルトで最大1000行です。
パラメーター
*は、必須パラメーター
名前
型
概要
例
provider*
文字列
google analyticsからデータを取得するのに必要なプロバイダーID
ga_e7502c3b8b8147410ce2
mcf_report*
真理値
取得するレポートの種類を切り替えます。trueの場合、マルチチャネルレポートデータを取得します。
false
viewId*
文字列
ユーザーID
12345678
startDate*
文字列
リクエスト期間の開始日付
2019-04-01
endDate*
文字列
リクエスト期間の終了日付
2019-04-30
metrics*
文字列
指標(定量化されたデータ)。カンマ区切りで10個まで指定可能。
​
dimensions
文字列
ディメンション(データの属性)。カンマ区切りで7個まで指定可能
ga:browser
filters
文字列
リクエストで返されるデータを制限するディメンションまたは指標のフィルタ
ga:browser==Chrome
pageSize
数値
リクエストで返されるデータの数。最大で、100,000行。
1000 (デフォルト値)
補足: 入力フォーマット
すべての指標がすべてのディメンションと組み合わせることができるわけではありません。ディメンションと指標は、同じ階層のもの同士を組み合わせる必要があります。たとえば、「セッション」はセッションの指標なので、同じセッションレベルの「参照元」や「市区町村」などのディメンションと組み合わせます。「セッション」を「ページ」などのヒットレベルのディメンションと組み合わせても意味はありません。ディメンションと指標の有効な組み合わせについては、下記に記載したディメンションと指標の組み合わせの具体例を参照してください。
①新規ユーザーのセッション数を計測したい場合
action>: GetGAReport
  provider: ga_xxxxxxx
  mcf_report false
  viewId: 11110000
  startDate: '2019-04-01'
  endDate: '2019-04-30'
  metrics: ga:sessions
  dimensions: ga:userType
  filters: ga:userType==New Visitor
②任意の市町村区における平均セッション時間を計測したい場合
action>: GetGAReport
  provider: ga_xxxxxx
  mcf_report false
  viewId: 11110000
  startDate: '2019-04-01'
  endDate: '2019-04-30'
  metrics: ga:sessions
  dimensions: ga:city
  filters: ga:city==cityName
dimensionsとmetrixに関する詳細情報は下記のURLを参考にしてください。 https://developers.google.com/analytics/devguides/reporting/core/dimsmets​
補足: 入力フォーマット(マルチチャネルレポートデータ)
マルチチャネルレポートデータを取得する場合、通常のGoogleアナリティクスからのレポート取得の際に使用するものとは異なる独自のディメンションと指標を使用する必要があります。 また、マルチチャネルレポートデータ取得用のディメンションと指標はすべて組み合わせることができます。
①参照元サイトの種類がemailのアシストコンバージョン数を計測したい場合
action>: GetGAReport
  provider: ga_xxxxxxx
  mcf_report true
  viewId: 11110000
  startDate: '2019-04-01'
  endDate: '2019-04-30'
  metrics: 'mcf:assistedConversions'
  dimensions: 'mcf:medium'
  filters: 'mcf:medium==email'
dimensionsとmetrixに関する詳細情報は下記のURLを参考にしてください。https://developers.google.com/analytics/devguides/reporting/mcf/dimsmets​
アウトプット
タイプ
型
概要
例
JSON
オブジェクト
JSONレスポンス
※使用例のアウトプット参照
使用例
action>: GetGAReport
  provider: ga_xxxxxxxx
  mcf_report: false
  viewId: 1234567890
  startDate: '2019-04-01'
  endDate: '2019-04-30'
  metrics: 'ga:users,ga:sessions'
  dimensions: 'ga:browser'
# => {
# "reports": [
#    {
#      "columnHeader": {
#        "dimensions": [
#          "ga:browser"
#        ],
#        "metricHeader": {
#          "metricHeaderEntries": [
#            {
#              "name": "ga:users",
#              "type": "INTEGER"
#            },
#            {
#              "name": "ga:sessions",
#              "type": "INTEGER"
#            }
#          ]
#        }
#      },
#      "data": {
#        "rows": [
#          {
#            "dimensions": [
#              "Chrome"
#            ],
#            "metrics": [
#              {
#                "values": [
#                  "3229",
#                  "4660"
#                ]
#              }
#            ]
#          },
#          {
#            "dimensions": [
#              "Firefox"
#            ],
#            "metrics": [
#              {
#                "values": [
#                  "360",
#                  "480"
#                ]
#              }
#            ]
#          },
#          {
#            "dimensions": [
#              "Internet Explorer"
#            ],
#            "metrics": [
#              {
#                "values": [
#                  "2402",
#                  "3149"
#                ]
#              }
#            ]
#          },
#        ],
#        "totals": [
#          {
#            "values": [
#              "7212",
#              "9981"
#            ]
#          }
#        ],
#        "rowCount": 16,
#        "minimums": [
#          {
#            "values": [
#              "1",
#              "1"
#            ]
#          }
#        ],
#        "maximums": [
#          {
#            "values": [
#              "3229",
#              "4660"
#            ]
#          }
#        ],
#        "isDataGolden": true
#      }
#    }
#  ]
# }
GetGoogleAdsReport (beta)
概要
GetGoogleAdsReportアクションは、Google広告からレポートを取得するアクションです。広告キャンペーン全体の掲載結果データのレポートを取得したり、広告が表示されるきっかけとなった検索語句などに絞ってデータを取得する事が出来ます。レポートを取得する為に、Google広告アカウントの「お客様ID」が必要になります。またコネクション作成時に、クライアントセンター(MCC)アカウントで連携した場合は、クライアントセンター(MCC)アカウントの「お客様ID」を入力する必要があります。「お客様ID」は下記の場所に記載されています。 取得したいデータの指定は、「Google Ads Query Language」という形式で入力する必要があります。セクション毎に取得したいデータを設定する事で様々な組み合わせのデータが取得可能です。
Google広告アカウントの階層構造
クライアントセンター(MCC)アカウントは、主に広告代理店ユーザーが、複数のクライアントアカウントをまとめて管理する為のアカウントです。MCCアカウントはツリー構造になっており、最上位の各 MCCアカウントでは、個々のアカウントや他のMCCアカウントを管理できます。下位のMCCアカウントでも、個々のアカウントや他のMCCアカウントを管理することができます。 AUTOROでコネクションを連携する際に、社内で運用するMCCアカウントを選択した場合には、どの階層に位置するMCCアカウントであれクライアントアカウントが持つ広告情報にアクセスする為に、アクションパラメーターに「manager_id」を入力する必要があります。
パラメーター
*は、必須パラメーター
名前
型
概要
例
customer_id*
文字列
Google Adsからデータを取得するのに必要なお客様ID
123456789
manager_id
文字列
MCCアカウントでアクションを利用する場合、このパラメーターにMCCアカウントのお客様IDを入力します。MCCアカウントで利用しない場合は、空欄にしておいてください。
123456780
query*
文字列
取得したいレポートを「Google Ads Query Language」で入力します。
※使用例の入力例を参照
補足: Google Ads Query Languageパラメーターの入力フォーマット
-SELECT(必須)
取得したいデータ項目を入力してください。このパラメーターでは、Segment/Metrics/Customerなどフィールド毎に取得したいデータ項目を指定します。
設定可能な全てのフィールドから、取得したいデータを入力し全てにリクエストを送る事も可能です。
​
(例)
Resource fields
-campaign.name
-campaign.status
​
Segment fields
-ad_group.name
​
Metrics fields
-metrics.impressions
​
-FROM(必須)
SELECTで指定したデータを取得するリソースを選択します。一つのリソースしか選択する事が出来ません。
​
(例)
campaign
customer
ad_group
​
-WHERE(オプション)
条件を指定する事で取得したいデータをフィルタリングする事が可能です。複数の条件を指定する事も可能です。
​
(例)
segments.device = MOBILE
segments.date DURING LAST_30_DAYS
metrics.impressions > 0
​
-ORDER_BY(オプション)
返却されるデータの順番を、指定した条件で並び替える事が出来ます。取得したデータ毎に条件を指定し、各データ毎に表示する順番を指定する事が出来ます。
​
(例)
metrics.clicks ASC
metrics.impressions DESC
​
-LIMIT(オプション)
APIから返却されるデータの数を、数値で直接指定する事が出来ます。
​
(例)
LIMIT 100
​
-PARAMETERS(オプション)
この項目では管理しているGoogle広告のメタパラメータを指定する事が出来ます。
現在APIで使用できるメタパラメータは「include_drafts」の一つだけとなっており、デフォルトでは「False」になっています。
管理しているGoogle広告アカウントに下書き状態の広告が存在する場合、「True」に設定する事で下書き状態の広告に関するデータを取得する事が出来ます。
​
(例)
include_drafts=true
このアクションで使用できるパラメーターに関する詳細情報は下記のURLを参考にしてください。 https://developers.google.com/google-ads/api/docs/query/interactive-gaql-builder​
アウトプット
タイプ
型
概要
例
JSON
オブジェクト
JSONレスポンス
※使用例のアウトプット参照
使用例
action>: GetGoogleAdsReport
  customer_id: 123456789
  manager_id:  123456780
  query:  SELECT  campaign.id, campaign.name, ad_group.id, ad_group.name, ad_group_criterion.criterion_id, ad_group_criterion.keyword.text,
                  ad_group_criterion.keyword.match_type, metrics.impressions, metrics.engagements,  metrics.clicks, metrics.cost_micros
          FROM    keyword_view
# {
#   "resultsList": [
#     {
#       "campaign": {
#         "resourceName": "customers/123456789/campaigns/2037742724",
#         "id": 2037742724,
#         "name": "テストキャンペーン"
#       },
#       "adGroup": {
#         "resourceName": "customers/123456789/adGroups/72421289499",
#         "id": 72421289499,
#         "name": "テスト広告グループ"
#       },
#       "adGroupCriterion": {
#         "resourceName": "customers/123456789/adGroupCriteria/72421289499~12073940",
#         "criterionId": 12073940,
#         "keyword": {
#           "text": "テスト",
#           "matchType": 4
#         }
#       },
#       "metrics": {
#         "impressions": 0,
#         "engagements": 0,
#         "clicks": 0,
#         "costMicros": 0
#       }
#     }
#   ]
# }
GetSearchAnalytics
概要
GetSearchAnalyticsは、Google Search Consoleで管理しているプロパティの検索パフォーマンスデータを取得するアクションです。返却されるレスポンスはデフォルトで最大1-25,000行まで設定できます。
パラメーター
*は、必須パラメーター
名前
型
概要
例
provider*
文字列
プロバイダーID
searchconsole_e7502c3b8b8147410ce2
siteUrl*
文字列
対象のURLまたはドメイン名
autoro.io
startDate*
文字列
リクエスト期間の開始日付
2019-12-01
endDate*
文字列
リクエスト期間の終了日付
2019-12-08
dimensions
配列
取得するデータの種類
['query', 'page']
filters
配列
取得するデータのフィルタ
[{"dimension":"query","operator":"contains","expression":"rpa"}]
rowLimit
整数
取得する行数。1-25,000内
20000
filters についての補足
filters を設定することで取得するデータの値を制限することができます。フィルタはリストで挿入可能ですが、dimensionFilterGroups[].filters[] の形式で入力する必要があります。 詳細は、こちらを参照してください。
● 入力例
filters 入力方法
● フィルタオブジェクトの説明
名前
型
概要
例
dimension
文字列
フィルタが適用されるデータの種類
"query"
operator
文字列
dimension と expression を比較する方法。次の中から選択。『"contains"』『"equals"』『"notContains"』『"notEquals"』
"contains"
expression
文字列
フィルタを設定したい値
"rpa"
● フィルタを複数設定したい場合
複数フィルタを設定したい場合は、フィルタオブジェクトを追加してください。
[{ "dimension": "query", "operator": "contains", "expression": "rpa"},{ "dimension": "page", "operator": "notContains", "expression": "rpa"}]
アウトプット
タイプ
型
概要
例
JSON
オブジェクト
JSONレスポンス
※使用例のアウトプット参照
使用例
action>: GetSearchAnalytics
  provider: searchconsole_********************
  siteUrl: 'autoro.io'
  startDate: '2019-12-01'
  endDate: '2019-12-08'
  dimensions: ['query', 'page']
  filters: [{"dimension":"query","operator':"contains","expression":"rpa"}]
  rowLimit: 1000
# {
#   "rows": [
#     {
#       "keys": [
#         "ホゲ rpa",
#         "https://hoge.co.jp/"
#       ],
#       "clicks": 10,
#       "impressions": 10,
#       "ctr": 0.141421356,
#       "position": 1
#     },
#     {
#       "keys": [
#         "rpa ホゲ 使い方",
#         "https://hoge.co.jp/"
#       ],
#       "clicks": 10,
#       "impressions": 10,
#       "ctr": 0.141421356,
#       "position": 1
#     },
#     {
#       "keys": [
#         "rpa ホゲ",
#         "https://hoge.co.jp/"
#       ],
#       "clicks": 10,
#       "impressions": 10,
#       "ctr": 0.141421356,
#       "position": 1
#     },
#     .............
#   ]
# }
GetFacebookAdsReport
概要
GetFacebookAdsReportは、Facebook広告からレポートを取得するアクションです。広告アカウントIDを入力することで、そのアカウントで運用している広告レポートを取得できます。
パラメーター
*は、必須パラメーター
名前
型
概要
例
provider*
文字列
Facebook Ads からデータを取得するのに必要なプロバイダーID
fbads_****************
accountId*
文字列
アカウントID
1234567890123456
level*
セレクト
レポートのレベル
ad, account, campaign, adset
startDate*
文字列
レポートの開始日付
2020-05-01
endDate*
文字列
レポートの終了日付
2020-05-07
fields
文字列
データ項目をカンマ区切りで入力。入力可能な値はこちらのfieldsを参照してください。
ad_name, reach, impressions, spend
breakdowns
文字列
取得したい内訳をカンマ区切りで入力。入力可能な値はこちらを参照してください。
gender, age
actionBreakdowns
文字列
取得したいアクション内訳をカンマ区切りで入力。入力可能な値はこちらを参照してください。
action_device, action_type
actionAttributionWindows
文字列
取得したいアトリビューション期間をカンマ区切りで入力。
7d_click, 1d_view
useUnifiedAttributionSetting
真理値
広告セットに設定のアトリビューションのデータを取得するかを選択。
false (デフォルト)
timeIncrement
数値
取得するデータの集計単位を日数で入力してください。日別にするには、1を入力してください。何も入力していない時は、全ての期間の集計値になります。
1
limit*
数値
取得する広告数の上限
3000 (デフォルト値)
アウトプット
タイプ
型
概要
例
JSON
オブジェクト
JSONレスポンス
※使用例のアウトプット参照
使用例
+get_facebook_ads_report_1:
  action>: GetFacebookAdsReport
  provider: fbads_****************
  accountId: 1234567890123456
  level: ad
  startDate: '2020-05-01'
  endDate: '2020-05-07'
  fields: 'ad_id, ad_name, reach, impressions, clicks, ctr'
  breakdowns: ''
  actionBreakdowns: ''
  actionAttributionWindows: ''
  useUnifiedAttributionSetting: false
  limit: 3000
# {
#   "data": [
#     {
#       "ad_id": "10000000000000001",
#       "ad_name": "広告A",
#       "reach": "3279",
#       "impressions": "4565",
#       "clicks": "52",
#       "ctr": "1.139102",
#       "date_start": "2020-05-01",
#       "date_stop": "2020-05-07"
#     },
#     {
#       "ad_id": "10000000000000002",
#       "ad_name": "広告B",
#       "reach": "2278",
#       "impressions": "2800",
#       "clicks": "13",
#       "ctr": "0.464286",
#       "date_start": "2020-05-01",
#       "date_stop": "2020-05-07"
#     }
#   ],
#   "paging": {
#     "cursors": {
#       "before": "MAZDZD",
#       "after": "NwZDZD"
#     },
#   }
# }
GetYahooSearchAdsReport
概要
GetYahooSearchAdsReportは、Yahoo検索広告からレポートを取得するアクションです。広告アカウントIDを入力することで、そのアカウントで運用している広告レポートを取得できます。
パラメーター
*は、必須パラメーター
※reportType パラメーターに BID_MODIFIER を選択した場合、startDate パラメーターと endDate パラメーターは入力不要です。
名前
型
概要
例
provider*
文字列
Yahoo Ads からデータを取得するのに必要なプロバイダーID
yahooads_****************
accountId*
文字列
アカウントID
1234567890123456
startDate*
文字列
レポートの集計の開始日付
20200801
endDate*
文字列
レポートの集計の終了日
20200807
reportName*
文字列
レポート名称
test_report
reportType*
セレクト
レポートの種類
ACCOUNT、CAMPAIGN、ADGROUP、AD、KEYWORDS、SEARCH_QUERY、GEO、FEED_ITEM、GEO_TARGET、SCHEDULE_TARGET、BID_STRATEGY、CAMPAIGN_TARGET_LIST、ADGROUP_TARGET_LIST、LANDING_PAGE_URL、KEYWORDLESS_QUERY、WEBPAGE_CRITERION、BID_MODIFIER、CAMPAIGN_ASSET、ADGROUP_ASSET、RESPONSIVE_ADS_FOR_SEARCH_ASSET
fields*
文字列
レポートの出力項目名をカンマ区切りで入力。入力可能な値は以下URLのfieldsを参照ください。
https://github.com/yahoojp-marketing/sponsored-search-api-documents/tree/master/docs/ja/api_reference/appendix/reports
ACCOUNT_ID, ACCOUNT_NAME, IMPS, CLICKS
reportDownloadFormat
セレクト
ダウンロードレポートのファイル形式。未設定の場合は、CSV形式で出力します。
CSV, XML, TSV
reportLanguage
セレクト
レポート定義の言語選択。未設定の場合はJAで出力します。
JA, EN
アウトプット
タイプ
型
概要
例
File
ファイル
ダウンロードしたファイル
/tmp/ac44342d-d956-4818-b3ee-e3d4990b06c8/yahooads/testreport.csv
使用例
+get_yahoo_search_ads_report_1:
  action>: GetYahooSearchAdsReport
  provider: yahooads_****************
  accountId: 1234567890123456
  startDate: '20200501'
  endDate: '20200507'
  reportName: 'testreport'
  reportType: AD
  fields: 'ACCOUNT_ID,AD_NAME,IMPS,CLICKS'
  reportDownloadFormat: CSV
  reportLanguage: EN
  # => "/tmp/ac44342d-d956-4818-b3ee-e3d4990b06c8/yahooads/testreport.csv"
GetYahooDisplayAdsReport
概要
GetYahooDisplayAdsReportは、Yahooディスプレイ広告からレポートを取得するアクションです。広告アカウントIDを入力することで、そのアカウントで運用している広告レポートを取得できます。
パラメーター
*は、必須パラメーター
名前
型
概要
例
provider*
文字列
Yahoo Ads からデータを取得するのに必要なプロバイダーID
yahooads_****************
accountId*
文字列
アカウントID
1234567890123456
startDate*
文字列
レポートの集計の開始日付
20200801
endDate*
文字列
レポートの集計の終了日
20200807
reportType
セレクト
レポートの種類。現在、 CONVERSION_PATH, CROSS_CAMPAIGN_REACHES, FREQUENCY, REACH は未対応です。
AD, AUDIENCE_CATEGORY, AUDIENCE_LIST_TARGET, SEARCH_TARGET, PLACEMENT_TARGET, LABEL, SITE_CATEGORY, URL
reportName*
文字列
レポート名称
test_report
fields*
文字列
レポートの出力項目名をカンマ区切りで入力
ACCOUNT_ID, ACCOUNT_NAME, IMPS, CLICKS
reportDownloadFormat
セレクト
ダウンロードレポートのファイル形式。未設定の場合は、CSV形式で出力します。
CSV, XML, TSV
reportLanguage
セレクト
レポート定義の言語選択。未設定の場合はJAで出力します。
JA, EN
アウトプット
タイプ
型
概要
例
File
ファイル
ダウンロードしたファイル
/tmp/ac44342d-d956-4818-b3ee-e3d4990b06c8/yahooads/testreport.csv
使用例
+get_yahoo_display_ads_report_1:
  action>: GetYahooDisplayAdsReport
  provider: yahooads_****************
  accountId: 1234567890123456
  startDate: '20200801'
  endDate: '20200807'
  reportType: AD
  reportName: 'testreport'
  fields: 'ACCOUNT_ID,AD_NAME,IMPS,CLICKS'
  reportDownloadFormat: CSV
  reportLanguage: EN
  # => "/tmp/ac44342d-d956-4818-b3ee-e3d4990b06c8/yahooads/testreport.csv"
GetTwitterAdsReport
概要
GetTwitterAdsReportは、Twitter広告からレポートを取得するアクションです。広告アカウントIDと取得したいエンティティのIDを入力することで、そのアカウントで運用しているレポートを取得できます。
パラメーター
*は、必須パラメーター
名前
型
概要
例
provider*
文字列
Twitter Ads からデータを取得するのに必要なプロバイダーID
twads_****************
reportType*
セレクト
取得するレポートタイプ。キャンペーンのリーチとフリークエンシーを取得したい場合は Reach and Average Frequency を選択し、その他の値を取得したい場合は Analytics を選択してください。Analytics で取得する値は metricGroups の指定により変わります。
※現在 Reach and Average Frequency はTwitter社よりベータ版として提供されており、広告アカウントによっては利用できない場合があります。また、この機能は今後変更される可能性があります。
Analytics
accountId*
文字列
アカウントID
1234567890123456
startDate*
文字列
レポートの集計の開始日付。endDate まで最大90日の時間範囲。
2020-08-01
endDate*
文字列
レポートの集計の終了日
2020-08-07
entity
セレクト
取得するレポートのエンティティ。ACCOUNT, CAMPAIGN, PROMOTED_TWEET の3種類から選択。Reach and Average Frequency の場合、この設定は結果に影響しません。
CAMPAIGN
campaignId
文字列
キャンペーンID。カンマ区切りで複数指定できます。
abcde
promotedTweetIds
文字列
プロモツイートID。カンマ区切りで複数指定できます。Reach and Average Frequency の場合、この設定は結果に影響しません。
abcde
granularity
セレクト
レポートの粒度。TOTAL を選択すると指定期間内のデータの総計を取得し、DAY を選択すると日別値を取得します。Reach and Average Frequency の場合、この設定は結果に影響しません。
TOTAL
metricGroups
文字列
取得するレポートのメトリックグループをカンマ区切りで入力。指定できる項目は ENGAGEMENT, BILLING, VIDEO, MEDIA, WEB_CONVERSION, MOBILE_CONVERSION, LIFE_TIME_VALUE_MOBILE_CONVERSION 。以下URLをご参照の上、取得したい値に合わせて metricGroups を選択してください。
https://developer.twitter.com/en/docs/twitter-ads-api/analytics/overview/metrics-and-segmentation
Reach and Average Frequencyの場合、この設定は結果に影響しません。
ENGAGEMENT, BILLING
placement
セレクト
取得したデータを特定の場所にスコープします。ALL_ON_TWITTER, PUBLISHER_NETWORK の2種類から選択。TwitterとTwitter Audience Platform の両方のプレースメントを持つエンティティの場合は、プレースメント値ごとに別々のリクエストが必要になります。Reach and Average Frequency の場合、この設定は結果に影響しません。
ALL_ON_TWITTER
returnArray
真理値
true のとき、JSONではなく二次元配列をアウトプットします
false (default)
入力するパラメーターについての補足
GetTwitterAdsReportは、reportType 及び entity の入力により必要なパラメータが変化します。以下表の「○」で示されるパラメータが必要な項目です。
項目
パラメータ
Text
Text
Text
reportType
Analytics
​
Reach and Average Frequency
​
entity
ACCOUNT
CAMPAIGN
PROMOTED_TWEET
-
accountId
○
○
○
○
startDate
○
○
○
○
endDate
○
○
○
○
campaignId
-
○
-
○

名前	型	概要	例
provider*	文字列	google analyticsからデータを取得するのに必要なプロバイダーID	ga_e7502c3b8b8147410ce2
mcf_report*	真理値	取得するレポートの種類を切り替えます。trueの場合、マルチチャネルレポートデータを取得します。	false
viewId*	文字列	ユーザーID	12345678
startDate*	文字列	リクエスト期間の開始日付	2019-04-01
endDate*	文字列	リクエスト期間の終了日付	2019-04-30
metrics*	文字列	指標(定量化されたデータ)。カンマ区切りで10個まで指定可能。
dimensions	文字列	ディメンション(データの属性)。カンマ区切りで7個まで指定可能	ga:browser
filters	文字列	リクエストで返されるデータを制限するディメンションまたは指標のフィルタ	ga:browser==Chrome
pageSize	数値	リクエストで返されるデータの数。最大で、100,000行。	1000 (デフォルト値)

名前	型	概要	例
customer_id*	文字列	Google Adsからデータを取得するのに必要なお客様ID	123456789
manager_id	文字列	MCCアカウントでアクションを利用する場合、このパラメーターにMCCアカウントのお客様IDを入力します。MCCアカウントで利用しない場合は、空欄にしておいてください。	123456780
query*	文字列	取得したいレポートを「Google Ads Query Language」で入力します。	※使用例の入力例を参照

名前	型	概要	例
provider*	文字列	プロバイダーID	searchconsole_e7502c3b8b8147410ce2
siteUrl*	文字列	対象のURLまたはドメイン名	autoro.io
startDate*	文字列	リクエスト期間の開始日付	2019-12-01
endDate*	文字列	リクエスト期間の終了日付	2019-12-08
dimensions	配列	取得するデータの種類	['query', 'page']
filters	配列	取得するデータのフィルタ	[{"dimension":"query","operator":"contains","expression":"rpa"}]
rowLimit	整数	取得する行数。1-25,000内	20000

名前	型	概要	例
dimension	文字列	フィルタが適用されるデータの種類	"query"
operator	文字列	dimension と expression を比較する方法。次の中から選択。『"contains"』『"equals"』『"notContains"』『"notEquals"』	"contains"
expression	文字列	フィルタを設定したい値	"rpa"

名前	型	概要	例
provider*	文字列	Facebook Ads からデータを取得するのに必要なプロバイダーID	fbads_****************
accountId*	文字列	アカウントID	1234567890123456
level*	セレクト	レポートのレベル	ad, account, campaign, adset
startDate*	文字列	レポートの開始日付	2020-05-01
endDate*	文字列	レポートの終了日付	2020-05-07
fields	文字列	データ項目をカンマ区切りで入力。入力可能な値はこちらのfieldsを参照してください。	ad_name, reach, impressions, spend
breakdowns	文字列	取得したい内訳をカンマ区切りで入力。入力可能な値はこちらを参照してください。	gender, age
actionBreakdowns	文字列	取得したいアクション内訳をカンマ区切りで入力。入力可能な値はこちらを参照してください。	action_device, action_type
actionAttributionWindows	文字列	取得したいアトリビューション期間をカンマ区切りで入力。	7d_click, 1d_view
useUnifiedAttributionSetting	真理値	広告セットに設定のアトリビューションのデータを取得するかを選択。	false (デフォルト)
timeIncrement	数値	取得するデータの集計単位を日数で入力してください。日別にするには、1を入力してください。何も入力していない時は、全ての期間の集計値になります。	1
limit*	数値	取得する広告数の上限	3000 (デフォルト値)

名前	型	概要	例
provider*	文字列	Yahoo Ads からデータを取得するのに必要なプロバイダーID	yahooads_****************
accountId*	文字列	アカウントID	1234567890123456
startDate*	文字列	レポートの集計の開始日付	20200801
endDate*	文字列	レポートの集計の終了日	20200807
reportName*	文字列	レポート名称	test_report
reportType*	セレクト	レポートの種類	ACCOUNT、CAMPAIGN、ADGROUP、AD、KEYWORDS、SEARCH_QUERY、GEO、FEED_ITEM、GEO_TARGET、SCHEDULE_TARGET、BID_STRATEGY、CAMPAIGN_TARGET_LIST、ADGROUP_TARGET_LIST、LANDING_PAGE_URL、KEYWORDLESS_QUERY、WEBPAGE_CRITERION、BID_MODIFIER、CAMPAIGN_ASSET、ADGROUP_ASSET、RESPONSIVE_ADS_FOR_SEARCH_ASSET
fields*	文字列	レポートの出力項目名をカンマ区切りで入力。入力可能な値は以下URLのfieldsを参照ください。 https://github.com/yahoojp-marketing/sponsored-search-api-documents/tree/master/docs/ja/api_reference/appendix/reports	ACCOUNT_ID, ACCOUNT_NAME, IMPS, CLICKS
reportDownloadFormat	セレクト	ダウンロードレポートのファイル形式。未設定の場合は、CSV形式で出力します。	CSV, XML, TSV
reportLanguage	セレクト	レポート定義の言語選択。未設定の場合はJAで出力します。	JA, EN

名前	型	概要	例
provider*	文字列	Twitter Ads からデータを取得するのに必要なプロバイダーID	twads_****************
reportType*	セレクト	取得するレポートタイプ。キャンペーンのリーチとフリークエンシーを取得したい場合は Reach and Average Frequency を選択し、その他の値を取得したい場合は Analytics を選択してください。Analytics で取得する値は metricGroups の指定により変わります。 ※現在 Reach and Average Frequency はTwitter社よりベータ版として提供されており、広告アカウントによっては利用できない場合があります。また、この機能は今後変更される可能性があります。	Analytics
accountId*	文字列	アカウントID	1234567890123456
startDate*	文字列	レポートの集計の開始日付。endDate まで最大90日の時間範囲。	2020-08-01
endDate*	文字列	レポートの集計の終了日	2020-08-07
entity	セレクト	取得するレポートのエンティティ。ACCOUNT, CAMPAIGN, PROMOTED_TWEET の3種類から選択。Reach and Average Frequency の場合、この設定は結果に影響しません。	CAMPAIGN
campaignId	文字列	キャンペーンID。カンマ区切りで複数指定できます。	abcde
promotedTweetIds	文字列	プロモツイートID。カンマ区切りで複数指定できます。Reach and Average Frequency の場合、この設定は結果に影響しません。	abcde
granularity	セレクト	レポートの粒度。TOTAL を選択すると指定期間内のデータの総計を取得し、DAY を選択すると日別値を取得します。Reach and Average Frequency の場合、この設定は結果に影響しません。	TOTAL
metricGroups	文字列	取得するレポートのメトリックグループをカンマ区切りで入力。指定できる項目は ENGAGEMENT, BILLING, VIDEO, MEDIA, WEB_CONVERSION, MOBILE_CONVERSION, LIFE_TIME_VALUE_MOBILE_CONVERSION 。以下URLをご参照の上、取得したい値に合わせて metricGroups を選択してください。 https://developer.twitter.com/en/docs/twitter-ads-api/analytics/overview/metrics-and-segmentation Reach and Average Frequencyの場合、この設定は結果に影響しません。	ENGAGEMENT, BILLING
placement	セレクト	取得したデータを特定の場所にスコープします。ALL_ON_TWITTER, PUBLISHER_NETWORK の2種類から選択。TwitterとTwitter Audience Platform の両方のプレースメントを持つエンティティの場合は、プレースメント値ごとに別々のリクエストが必要になります。Reach and Average Frequency の場合、この設定は結果に影響しません。	ALL_ON_TWITTER
returnArray	真理値	true のとき、JSONではなく二次元配列をアウトプットします	false (default)

項目	パラメータ	Text	Text	Text
reportType	Analytics		Reach and Average Frequency
entity	ACCOUNT	CAMPAIGN	PROMOTED_TWEET	-
accountId	○	○	○	○
startDate	○	○	○	○
endDate	○	○	○	○
campaignId	-	○	-	○