レポートの作成と実行

このガイドでは、レポートの作成と実行の方法、および結果の表示方法について説明します。

レポートを作成する

アナリストとスーパーユーザーはレポートを作成して編集できます。詳しくは、Ads Data Hub のアクセス制御をご確認ください。

  1. Ads Data Hub で、[レポート] ページを開きます。
  2. [+ レポートを作成] をクリックします。[新しいレポートを作成する] ページが開きます。
    • テンプレートは、検索、プロダクト アイコンの選択、プルダウン オプションの選択によってフィルタできます。
  3. テンプレートを選択して [テンプレートを使用] をクリックするか、[SQL] をクリックして新規に作成します。
    • テンプレートの詳細と SQL コードを確認するには、展開アイコン expand_content をクリックします。
  4. レポートを編集するには、[クエリを編集] をクリックします。クエリエディタを使用して、次の操作を行います。
    • BigQuery 互換の SQL を使用してレポートをカスタマイズします。
    • [プロパティ] タブでパラメータを構成します。
    • [Google Tables] タブで、使用可能なテーブルとフィールドのリストを表示します。
    • [1P テーブル] タブで、インポートされた 1P テーブルとそのスキーマのリストを表示します。
    • [実行] をクリックして SQL クエリを実行します。SQL クエリ エディタから開始された実行は、レポートの実行履歴に反映されず、[ホーム] ページの [最近のアクティビティ] セクションにも表示されません。
    • [完了] をクリックしてクエリの変更を確定し、レポートの設定ページに戻ります。
  5. レポートの名前を入力します。
  6. 必要に応じて、[設定] カードでパラメータ値を設定します。
  7. このレポートで実行されるジョブの入出力を構成します。
    • [広告データの取得元] フィールドでデータソースを選択します。ここでは、クエリの対象とする広告データに関連付けられた Ads Data Hub アカウント ID を選択してください。（サンドボックス データに対してクエリを実行する場合は、[ADH サンドボックス顧客] を選択します）。
    • マッチテーブルを使用する場合は、[マッチテーブル アカウント] フィールドでマッチテーブルを選択します。
    • レポートの期間とタイムゾーンを選択します。レポートのタイムゾーンは、リンクされた広告アカウント（Google 広告アカウントなど）のタイムゾーンと一致している必要があります。注: クエリ テストのカスタム期間は、SQL エディタ画面からクエリを実行する場合にのみサポートされます。
    • 省略可: プライバシー設定を変更し、フィルタされた行の概要を設定します。
    • レポートの結果を保存する BigQuery のプロジェクト、データセット、テーブルを選択します。
  8. 省略可: スケジュールに沿って実行するようレポートを設定します。
  9. [保存] をクリックします。

パラメータ

パラメータを使用すると、特定のレポートの実行方法を指定できます。SQL を使用してレポートを作成する場合（またはレポート テンプレートから SQL を編集する場合）、パラメータを使用すると、レポート間で同じ SQL コードを再利用し、レポートの各コピーに異なるパラメータ値を設定できます。たとえば、同じ SQL クエリまたはテンプレートを共有する 2 つのレポートを、レポートの詳細ページの [設定] セクションでパラメータを構成して値を設定することで、異なるキャンペーン ID のセットに対して実行できます。パラメータを使用すると、SQL コードを簡潔に保ち、編集によるエラーの発生を防ぐとともに、SQL 自体の値を編集することなく、レポート間で同じ SQL クエリを再利用することが可能です。

次の例では、レポートに campaign_ids というパラメータが含まれています。このパラメータは、int64 個のキャンペーン ID の array を受け取ります。

  /* Parameters:
   *   @campaign_ids (ARRAY of INT64):
   *   A list of campaign IDs to analyze
   */

  WITH user_reach AS (
  SELECT
    user_id,
    count(*) AS num_views
  FROM
    adh.google_ads_impressions
  WHERE
    campaign_id in UNNEST(@campaign_ids)
  GROUP BY
    user_id
  )
  SELECT
  COUNT(*) AS unique_users,
  COUNTIF(num_views = 1) AS one_view,
  COUNTIF(num_views > 1 AND num_views <= 5) AS less_or_equal_five_views,
  COUNTIF(num_views > 5) AS more_than_five_views
  FROM
    user_reach

パラメータのタイプ

次のタイプのパラメータを使用できます。

  • int64
  • float64
  • bool
  • string
  • date
  • timestamp
  • array（任意の使用可能なタイプ）

レポートにパラメータを追加する

  1. 保存済みのレポートを開くか、新たに作成します。
  2. [クエリを編集] をクリックします。
  3. [プロパティ] で [パラメータを追加] をクリックします。
  4. [名前] フィールドに名前を入力します。レポートのコードでパラメータを指定する際はこの名前を使用します。
  5. プルダウン メニューでパラメータのタイプを選択します。
    • 配列のタイプを選択すると、追加のプルダウン メニューが表示されます。このプルダウン メニューで配列のタイプを選択します。
  6. SQL クエリで、標準 SQL パラメータ形式（@PARAMETER_NAME）を使用してパラメータを追加します。次の手順の例を参照してください。
  7. [完了]、[保存] の順にクリックします。

パラメータを使用する

  1. パラメータが構成されているレポートを開きます。
  2. [設定] ペインで、定義した各パラメータの値を入力します。
  3. [保存] をクリックして、パラメータ値を保持します。

パラメータを削除する

  1. パラメータが構成されているレポートを開きます。
  2. [クエリを編集] をクリックして、SQL エディタを開きます。
  3. [プロパティ] で、削除するパラメータの横にある [削除] をクリックします。
  4. [完了]、[保存] の順にクリックします。

予約されているパラメータ

次の表は、Ads Data Hub によって予約済みのパラメータの一覧です。予約済みのパラメータはレポート内で使用できますが、同じ名前のパラメータを新たに作成することはできません。

start_date date

レポートジョブの開始日（指定した日も期間に含む）。この名前のユーザー定義パラメータは無視され、[新しいジョブ] ダイアログで設定した値に置換されます。
end_date date

レポートジョブの終了日（指定した日も期間に含む）。この名前のユーザー定義パラメータは無視され、[新しいジョブ] ダイアログで設定した値に置換されます。
time_zone string

レポートジョブのタイムゾーン。この名前のユーザー定義パラメータは無視され、[新しいジョブ] ダイアログで設定した値に置換されます。
params string

エクスポートされたテーブルの命名に使用する Namespace。次の形式で使用して、クエリにプレースホルダを作成します。レポートを実行するときにテーブル名を指定します。params.TABLE_NAME（他のパラメータで使用される @ は使用しないでください）。このパラメータの使用方法と例については、単一のクエリによる複数のテーブルのエクスポートをご覧ください。

フィルタされた行の概要

フィルタされた行の概要では、差分チェックによって除外されたデータが集計されます。フィルタされた行のデータが合計され、キャッチオール行に追加されます。フィルタされたデータはこれ以上分析できませんが、結果から除外されたデータの量の概要を把握することができます。差分チェックのプライバシー モードを使用するクエリの場合、Ads Data Hub ではフィルタされた行の概要が自動的に有効になり、構成されます。クエリを編集すると、Ads Data Hub によって、選択した列を基に設定が自動的に調整されます。フィルタされた行の概要の詳細や、手動で構成する方法については、フィルタされた行の概要をご覧ください。

レポートを編集する

  1. Ads Data Hub で、[レポート] ページを開きます。
  2. 編集するレポートの名前をクリックします。
  3. レポートに変更を加えます。たとえば、SQL の編集、パラメータ値の管理、スケジュールの設定などを行うことができます。
  4. [保存] をクリックします。

レポートを実行する

レポートを実行する前に、結合の出力が含まれるデータセットへの dataEditor 権限がサービス アカウントに付与されていることを確認してください。詳細: BigQuery でのアクセス制御について

  1. Ads Data Hub で、[レポート] ページを開きます。
  2. 実行するレポートの名前をクリックします。
  3. [実行] をクリックします。

スケジュールに従ってレポートを実行する

  1. Ads Data Hub で、[レポート] ページを開きます。
  2. スケジュールを設定するレポートの名前をクリックします。
    • 新しいレポートのスケジュールを設定するには、レポートを作成して [保存] をクリックします。
  3. [+ スケジュールを設定] をクリックします。
  4. [スケジュール] ペインで、[このレポートを以下の詳細情報に沿って実行するようスケジュール設定] 切り替えボタンをクリックしてオンにします。
  5. [頻度] で、間隔と時刻を選択し、タイムゾーンを入力します。
    • 代わりに cron 式を使用するには、[cron 式を使用してスケジュールを設定する] 切り替えボタンをオンにして、ボックスに式を入力します。
  6. [完了] をクリックします。
  7. [保存] をクリックして、レポートへの変更を確定します。

[ホーム] ページにスケジュールされたジョブを表示するには、[オーナー] フィルタ リストから [全員] を選択します。

結果を表示する

レポートの実行が完了したら、レポートの詳細ページで結果をプレビューできます。結果を後で確認するには、[ホーム] ページからレポートを開きます。BigQuery、Google スプレッドシート、またはデータポータルでデータを詳しく調べることもできます。

プレビュー

完了したジョブ内で [プレビュー] をクリックします。結果の最初の 20 件がジョブの下に表示されます。

BigQuery

結果は、デフォルトで BigQuery にエクスポートされます。[表を表示] をクリックすると、BigQuery が新しいウィンドウで開きます。

Google スプレッドシートとデータポータル

[探索] プルダウン メニューを開き、[スプレッドシートで調べる] または [データポータルで調べる] を選択します。新しいウィンドウでデータが開きます。