Google広告スクリプト「FROM」を理解し狙ったデータを取得

どうしました？

なるほど。
これはGoogle広告スクリプトの「FROM」句の沼にハマってしまったようですね。

では今回は
・「FROM」句とは
・データが分かれてしまう！？よくある「FROM」句のトラブル
・まとめ
ということで話していきたいと思います。

「FROM」句とは、SQLでテーブルを指定する句（決まり文句、固定の書き方）になります。
Google広告スクリプトでは、SQLの書き方でデータを取得することができるため、この「FROM」句を使うことがあります。

SQLは、簡単にいうとデータベース（表組・テーブル形式にまとまったデータ群）を操作するための言語です。
広告のデータは、内部的にはテーブル（表組）のようにまとまっているので、SQLで取得するのに適しています。

「FROM」句という今回のテーマは、
Google広告スクリプト　＞　SQL　＞　「FROM」句
という感じなので、かなりミクロな話しではありますね。

Google広告スクリプトで使うSQLの構造は、主に以下のような形で記載するケースが多いです。

「データの形」は、その指標がどんな状態の値を持っているかを示しています。
「campaign.name」なら、Google広告に設定してあるキャンペーン名、例えば「女性向け販促キャンペーン」や「首都圏ターゲットキャンペーン」など、”テキスト（文字列）” で登録されているはずです。
対して「metrics.impressions」では「10,000」、「6,500」など、”数値” が保存されています。
「gender_view.resource_name」と「age_range_view.resource_name」は少し特殊で、それ独自のIDが割り振られています。

続いて、本記事のメインテーマ「FROM」についてです。

はい。
「FROM」句では、数ある中から “どのテーブル（表組）” を選ぶかを指定しています。

よく使うテーブルの一例をまとめれば上の表のような感じです。
・・・例えば、家計簿のスプレッドシート を作ったとします。

そこには、
・支出のシート
・収入のシート
・固定費のシート
・貯蓄のシート
・収支をまとめたシート
と、色々なシートが、情報を流用しながら作成されているはずです。

Google広告でも同様に、色々なテーブルが、それぞれ情報を流用しながら存在しています。
・キャンペーンでまとめたテーブル
・広告グループでまとめたテーブル
・性別でまとめたテーブル
・年齢でまとめたテーブル
・全体の数値をまとめたテーブル
などですね。

なのでこの “テーブル” は、家計簿スプレッドシートの “シート” のことだと思ってもらえれば分かりやすいかと思います。
「FROM」句では、どのデータがまとまったテーブルを参照するかを指定しています。

「WHERE」句は、フィルタのような機能を持っています。

上のコードの場合だと、
「WHERE metrics.impressions <> 0」
すなわち
「表示回数が 0 以外のデータに抜粋して」
ということになります。

「ORDER BY」句はソートの役割を持っています。

上のコードの場合だと、
「ORDER BY segments.month DESC」
すなわち
「月で降順に並べて」
という意味になります。

例を見てみましょう。
例えば、以下のようなテーブルがあるとします。

これを以下内容の「ORDER BY」で並び替えます。
まずは 最初の並び替え 部分の動きをみてみます。

するとキャンペーン名の昇順で並び替えられます。
ここまではいいですよね？

続いて 後ろ側の並び替え の動きを見てみます。

すると、キャンペーン名はソート済み（固定）なので、同キャンペーン内でCV数の降順に並び替えられます。
仕上がりは以下の形です。

最後は「LIMIT」句ですね。
これは簡単です。

そうです。
「LIMIT」句の前の文までに処理されたデータを指定件数で抜粋する、といったところでしょうか。
上のコードの場合「50」件で抜粋（出力）ってことになります。

Google広告スクリプトでは、この「FROM」句が結構鬼門なようです。
「FROM」句の指定を間違えて、思ったようなデータを取れなかったり、プログラムがエラー などが起きてしまいます。

これは、「FROM」句で指定している「campaign」テーブルには、そもそも複数のcampaignがあるためだと思われます。

隠れている「campaign」列を表示するとこんな感じですね。
「FROM」句でこのテーブルを選択した場合、あくまでこのテーブルの中から、取得（表示・出力）する列を「SELECT」句で選択しているに過ぎないんですね。

なので、月でまとめたデータを取得したい場合は、「FROM」句には「customer」を指定するのが正しいです。

ちょっと脱線しますが、Google広告スクリプトでは「GROUP BY」句は使えないようです。

ま、考えてみれば当然ですよね。
隠れている（指定しなかった）列を表示させると下のようになるわけですから、いくら「GROUP　BY」句を使おうが統合できようがありません。

プログラムエラーが出る原因は、テーブルに無い指標 を指定しているからだと考えられます。

例えば、上のようなテーブルがあるとします。
このテーブルには「キャンペーン」、「月」、「表示回数」の指標があります。
しかし、「性別」を取得するよう指定した場合、当然このテーブルに無いのでエラーが返ってくる、ということです。

・・・ごめんなさい。
簡単に説明するつもりが、結構しっかりと（Google広告スクリプトの）SQLを解説してしまいました。

「FROM」句の説明のためにSQLの全体像を説明しました。

SQL自体には、もっと多くの句や書き方がありますが、
今回は、Google広告スクリプトでよく使う内容として紹介しました。