保存済みの列

新しい Search Ads 360 Reporting API をご利用いただけるようになりました。新しい API では 柔軟性の向上により、カスタム レポートを作成し、データをレポート アプリケーションに統合できます。 プロセスです。詳しくは、検索広告 360 リニューアル版レポートへの移行と使用方法をご確認ください。 API。

Floodlight アクティビティ、Google アナリティクス目標、またはカスタム 使用すると、広告主は検索広告 360 の管理画面にログインして、 その他の保存済みの列（Floodlight アクティビティ列、Google アナリティクス アクティビティ列など） 数式列を使用します。マイページ レポートのリクエストに保存済み列を含めて、データをダウンロードしたり、 レポートをフィルタします。

保存した列のリストを取得する

広告主が作成したすべての保存済みの列を表示するには、 SavedColumns.list() リクエストできます。レスポンスには、 広告主の列ごとに savedColumnName 。

保存した列のレポートをリクエストする

保存した列をレポート リクエストに含めるには、 列の名前に設定された savedColumnName 属性: 

{
  "reportType": "advertiser",
  "columns": [
    {
      "savedColumnName": string,
      "headerText": string,
    }
  ],
  "filters": [
    {
      "column": {
        "savedColumnName": string,
      },
      ...
    },
    ...
  ],
  ...
}

保存済みの列を使用する際は、次の点にご注意ください。

  • 保存される列は広告主レベルで定義されます。もし リクエストに保存した列を含め request.reportScope には広告主以下の値を指定してください あります。そのため、各レポートに含めることができるのは 単一の広告主

  • 保存された列名では、大文字と小文字、空白、空白が区別されます。 句読点は重要ではありません。「 savedColumnName 属性は、保存されている列名と一致する必要があります あります保存済みの列の名前が 同じリクエストの別の列がある場合、検索広告 360 では 一方または両方の列に対する一意の代替 headerText。

  • 保存した列は、検索広告 360 のキャンペーン管理で変更または削除できます UI をいつでも確認できます。保存済み列を指定するリクエストが失敗した場合は、 保存した列をリクエストから削除して再送信します。

  • 増分レポートには、明示的に指定されていない指標を含めることはできません。 API でサポートされているもの（Google アナリティクスのアクティビティ列など）です。イン 検索広告 360 のユーザーは保存済みの列を再定義できるため、 保存した列を含むレポートは正確でない可能性があります。