Search…
⌃K

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
-
-