- function main() {
const ID1 = ‘**ここにスプレッドシートのディレクトリを記入**’;
const SHEET_NAME1 = ‘**シート内のタブ名**’;
const sheet1 = SpreadsheetApp.openById(ID1).getSheetByName(SHEET_NAME1);
const query1 = “SELECT segments.month, campaign.name, metrics.impressions, metrics.clicks, metrics.cost_micros, metrics.conversions ” +
“FROM campaign WHERE segments.month BETWEEN ‘2022-01-01’ AND ‘2022-12-01’ ORDER BY segments.month”;
var report = AdsApp.report(query1);
report.exportToSheet(sheet1)
上記は「キャンペーン」の出力例ですが、それとあわせて「広告グループ」「キーワード」などの別の属性のコードも一覧で下記に記します。
広告グループ
const query2 = “SELECT segments.month, campaign.name, ad_group.name, segments.device, metrics.impressions, metrics.clicks, metrics.cost_micros, metrics.conversions ” +“FROM ad_group WHERE segments.month BETWEEN ‘2022-01-01’ AND ‘2022-12-01’ ORDER BY segments.month”;
キーワード
const query3 = “SELECT segments.month, campaign.name, ad_group.name, ad_group_criterion.keyword.text, metrics.impressions, metrics.clicks, metrics.cost_micros, metrics.conversions ” +“FROM keyword_view WHERE segments.month BETWEEN ‘2022-01-01’ AND ‘2022-12-01’ ORDER BY segments.month”;
Google広告で設定する時は、該当箇所をそれぞれ置き換えて前後を整えれば、適正に出力されます。
■良くある質問、最新情報
Q)期間はどれを選んだら良いでしょうか？A)使う目的やデータ量にもよりますが、最初は下記の基準で考えることをお勧めします。
・将来的に過去のデータを保存しながら、この機能を使おうと考えている→「今年の1月1日～12月31日（←未来）」で1年に1回だけ更新します
・データを保存するつもりはなく、直近のデータを見るだけで良い→「LAST_7_DAYS」「LAST_30_DAYS」で設定すれば、上記の翌年に書き直す作業も発生しません
Q)Big Queryなど他の方法で出力するのではどう違いますか？
A)記事「Google広告のレポート自動化に向けて3つの方法を比較してみた」に比較表をまとめましたので、ご覧ください。
Adwords API（旧仕様の場合）
2021年にAdwords APIからGoogle Ads APIへの仕様変更がGoogleより正式に発表されました。これによりAdwords APIは段階的に制限されて、一部は出力されなくなり非推奨とされるようになりました。
特にこの時期は、拡張テキスト広告→レスポンシブ検索広告への変更で、広告内部の結果が見れなくなった頃でもあります。
下記のAdwords APIは今では使わないほうが良いですが、本記事の更新にあたっては念のために残します。
※※↓くれぐれも旧式なので、使わないようにお願いします。※※
広告グループ旧仕様（FROM ADGROUP_PERFORMANCE_REPORT）
- ‘SELECT Month, CampaignName, AdGroupName, Device, Impressions, Clicks, Cost, Conversions, AllConversions, AveragePosition, SearchImpressionShare ‘
キーワード旧仕様（FROM KEYWORDS_PERFORMANCE_REPORT）
- ‘SELECT Month, Criteria, CampaignName, AdGroupName, KeywordMatchType, FinalUrls, Impressions, Clicks, Cost, Conversions, AveragePosition, QualityScore, SearchImpressionShare, HistoricalCreativeQualityScore, HistoricalSearchPredictedCtr, HistoricalLandingPageQualityScore’
検索クエリ旧仕様（FROM SEARCH_QUERY_PERFORMANCE_REPORT）
- ‘SELECT Month, Query, CampaignName, AdGroupName, Impressions, Clicks, Cost, Conversions, AllConversions, AveragePosition’
広告カスタマイザ旧仕様（FROM AD_CUSTOMIZERS_FEED_ITEM_REPORT）
- ‘SELECT CampaignName, AdGroupName, FeedId, FeedItemId, FeedItemAttributes, GeoTargetingCriterionId, KeywordTargetingText, Impressions, Clicks, Cost, Conversions, AllConversions, AveragePosition’
地域別旧仕様（FROM GEO_PERFORMANCE_REPORT）
- ‘SELECT CountryCriteriaId, RegionCriteriaId, CityCriteriaId, Month, AdGroupName, CampaignName, Impressions, Clicks, Cost, Conversions, AllConversions, AveragePosition’
プレースメント別旧仕様（FROM PLACEMENT_PERFORMANCE_REPORT）
- ‘SELECT Month, Domain, DisplayName, IsBidOnPath, IsPathExcluded, CampaignName, AdGroupName, Impressions, Clicks, Cost, Conversions, ViewThroughConversions ‘
1営業日以内に返信します
WEBマーケティング、広告運用代行のご相談はこちら →
また、SPENDAはGoogle広告の運用改善が得意な会社です。
現在の運用でまだ伸ばせるところはあるか、広告アカウントの無料診断を実施しています。
ご興味がある方は是非こちらからお問い合わせください。
SPENDAのGoogle広告運用についてはこちらのサービスページをご覧ください。
