Google広告スクリプトのコード例(各レポートの指標部分)

  • 2022年6月17日
  • 2022年11月21日
  • WebAds
以前に「Google広告スクリプトでデータを自動出力する方法」をご紹介しました。
    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 ‘
最新情報をチェックしよう!