گزارش های فیلتر شده

API جدید Search Ads 360 Reporting اکنون در دسترس است. API جدید انعطاف‌پذیری بیشتری برای ایجاد گزارش‌های سفارشی و ادغام داده‌ها در برنامه‌ها و فرآیندهای گزارش‌دهی شما فراهم می‌کند. درباره انتقال و استفاده از Search Ads 360 Reporting API جدید بیشتر بیاموزید.

به طور پیش‌فرض، گزارش شما حاوی تمام داده‌های داخل ReportScope است که درخواست شما مشخص می‌کند. اگر می‌خواهید یک گزارش فقط حاوی داده‌هایی باشد که با مجموعه‌ای از معیارها مطابقت دارند، می‌توانید یک یا چند فیلتر را به یک گزارش اضافه کنید. فقط ردیف هایی که همه فیلترها را برآورده می کنند برگردانده می شوند.

به عنوان مثال، می توانید گزارشی از تمام کلمات کلیدی در یک آژانس درخواست کنید. سپس می‌توانید فیلتری را مشخص کنید تا فقط کلمات کلیدی با 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 را به مقدار عددی 0 و true را به 1 تبدیل می کند. اگر این فیلتر را برای ستون String مشخص کنید، API ترتیب واژگانی را مقایسه می کند.

برای انواع داده های لیست (مانند String list ) معتبر نیست.

 1
greaterThan

ستون باید حاوی مقداری باشد که بزرگتر از یکی از مقادیر موجود در لیست فیلتر باشد.

اگر این فیلتر را برای یک ستون Boolean مشخص کنید، API false به مقدار عددی 0 و true را به 1 تبدیل می کند. اگر این فیلتر را برای ستون String مشخص کنید، API ترتیب واژگانی را مقایسه می کند.

برای انواع داده های لیست (مانند String list ) معتبر نیست.

 1
lessThanOrEqual

ستون باید حاوی مقداری باشد که کمتر یا مساوی با یکی از مقادیر موجود در لیست فیلتر باشد.

اگر این فیلتر را برای یک ستون Boolean مشخص کنید، API false به مقدار عددی 0 و true را به 1 تبدیل می کند. اگر این فیلتر را برای ستون String مشخص کنید، API ترتیب واژگانی را مقایسه می کند.

برای انواع داده های لیست (مانند String list ) معتبر نیست.

 1
greaterThanOrEqual

ستون باید حاوی مقداری بزرگتر یا مساوی با یکی از مقادیر موجود در لیست فیلتر باشد.

اگر این فیلتر را برای یک ستون Boolean مشخص کنید، API false به مقدار عددی 0 و true را به 1 تبدیل می کند. اگر این فیلتر را برای ستون String مشخص کنید، API ترتیب واژگانی را مقایسه می کند.

برای انواع داده های لیست (مانند String list ) معتبر نیست.

 1
isNull ستون باید خالی باشد. به عنوان مثال، اگر در گزارش کلمه کلیدی، isNull برای ستون keywordMaxCpc مشخص کنید، گزارش فقط حاوی کلمات کلیدی خواهد بود که حداکثر CPC را تعیین نکرده اند. 0
isNotNull ستون باید حاوی یک مقدار باشد. 0
startsWith

ستون باید با یکی از رشته های موجود در لیست فیلتر شروع شود.

فقط برای ستون های String معتبر است.

 متغیر
containsSubstring

ستون باید شامل تمام یا بخشی از یکی از رشته های مشخص شده در لیست فیلتر باشد.

به عنوان مثال، یک فیلتر containsSubstring با مقادیر:
["ham", "cheese"]
سطرهایی با این مقدار برمی گرداند:
ham burger
cheese burger

اما سطرهایی با این مقادیر را بر نمی گرداند:
lobster roll
lettuce
hig h am plitude ( high amplitude شامل رشته فرعی "h am" است، اما همه کاراکترها - از جمله فاصله ها - توسط فیلتر ارزیابی می شوند)

فقط برای ستون های String معتبر است.

 متغیر
doesNotContainSubstring

ستون نباید دارای هیچ یک از رشته های موجود در لیست فیلتر باشد.

به عنوان مثال، یک فیلتر doesNotContainSubstring با مقادیر:
["ham", "cheese"]
سطرهایی با این مقدار برمی گرداند:
lobster roll
lettuce

اما سطرهایی با این مقادیر را بر نمی گرداند:
همبرگر
پنیر برگر

فقط برای ستون های String معتبر است.

 متغیر
containsElement

ستون باید حاوی حداقل یکی از مقادیر موجود در لیست فیلتر باشد. فقط برای ستون‌هایی با انواع داده‌های فهرست (مانند String list ) معتبر است.

برای مثال در گزارش campaign ، یک فیلتر containsElement با مقادیر:
["foo", "bar"]
فیلتر کردن روی ستون effectiveLabels فقط کمپین هایی را که با foo ، bar یا هر دو برچسب گذاری شده اند، برمی گرداند.

 متغیر