フィルタしたレポート

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

デフォルトでは、レポートには reportScope 内の 指定します。指定した一連の条件に一致するデータのみをレポートに含める場合は、 レポートに 1 つ以上のフィルタを追加できます。すべてのフィルタを満たす行のみ 返されます。

たとえば、代理店内のすべてのキーワードのレポートをリクエストできます。その後 フィルタを指定することで、ランディング ページ URL が www.example.com と www. another-example.com がレポートに表示されます。

"filters": [
  {
    "column" : { "columnName": "keywordLandingPage" },
    "operator" : "startsWith",
    "values" : [
      "http://www.example.com",
      "http://www.another-example.com"
    ]
  }
]

各フィルタでは、フィルタする列、演算子、値のリストを指定します。 が指定された列にあることが想定されます。

"filters": [
  {
   "column" : column to filter on,
   "operator" : operator specifying the type of filter,
   "values" : list of values
  },
  { ... another filter can go here ... }
]
: 一部の列はフィルタできません。「レポートの種類」リファレンスでは、各列が Filterable の場合。

フィルタ演算子

すべてのフィルタでは大文字と小文字が区別されます。つまり、「www.Sprockets.com」を含むフィルタです。一致しない www.sprockets.com を含む列。

演算子 説明 サポートされる値の数
equals 列は指定された値と完全に一致する必要があります。 1
notEquals この列は、指定された値と一致してはいけません。 1
in

この列は、フィルタのリストのいずれかの値と完全に一致する必要があります。

リストデータ型(String list など)には無効です。

可変
lessThan

列には、指定された値より小さい値が含まれている必要があります。

Boolean 列にこのフィルタを指定すると、Search Ads 360 API は false を変換します。 0true の数値に変換して 1 にします。条件 String 列にこのフィルタを指定すると、API は 並べ替えられます。

リストデータ型(String list など)には無効です。

1
greaterThan

この列には、 フィルタのリスト内に表示されます。

Boolean 列にこのフィルタを指定すると、API は false を変換します。 0true の数値に変換して 1 にします。条件 String 列にこのフィルタを指定すると、API は 並べ替えられます。

リストデータ型(String list など)には無効です。

1
lessThanOrEqual

列には、いずれかの値以下の値が含まれている必要があります。 フィルタのリストにある値のみを指定します。

Boolean 列にこのフィルタを指定すると、API は false を変換します。 0true の数値に変換して 1 にします。条件 String 列にこのフィルタを指定すると、API は 並べ替えられます。

リストデータ型(String list など)には無効です。

1
greaterThanOrEqual

列には、いずれかの値以上の値が含まれている必要があります。 フィルタのリストにある値のみを指定します。

Boolean 列にこのフィルタを指定すると、API は false を変換します。 0true の数値に変換して 1 にします。条件 String 列にこのフィルタを指定すると、API は 並べ替えられます。

リストデータ型(String list など)には無効です。

1
isNull この列は空でなければなりません。たとえば、isNull を指定した場合は、 キーワード レポートkeywordMaxCpc 列を確認すると、 には、上限クリック単価を指定していないキーワードのみが含まれる。 0
isNotNull この列に値が入っている必要があります。 0
startsWith

列の先頭は、フィルタのリスト内にあるいずれかの文字列にする必要があります。

String 列でのみ有効です。

可変
containsSubstring

この列には、 フィルタのリストに追加します。

たとえば、次の値を持つ containsSubstring フィルタは次のようになります。
["ham", "cheese"]
この場合、次の値を持つ行が返されます。
hamburger
cheeseburger

ただし、次の値を持つ行は返されません。
lobster roll
lettuce
high amplitudehigh amplitude に含まれるもの 部分文字列「h am」。ただし、スペースを含むすべての文字がフィルタによって評価されます。

String 列でのみ有効です。

可変
doesNotContainSubstring

この列には、フィルタのリストのどの文字列も含めることができません。

たとえば、次の値を持つ doesNotContainSubstring フィルタの場合:
["ham", "cheese"]
この場合、次の値を持つ行が返されます。
lobster roll
lettuce

ただし、次の値を持つ行は返されません。
ハンバーガー
チーズバーガー

String 列でのみ有効です。

可変
containsElement

列には、フィルタのリストの値の少なくとも 1 つが含まれている必要があります。 リストデータ型(String list など)の列に対してのみ有効です。

たとえば campaign レポートでは、 次の値を持つ containsElement フィルタ:
["foo", "bar"]
effectiveLabels 列でフィルタリングする この場合、foobar、またはその両方のラベルが付いたキャンペーンのみが返されます。

可変