Search Ads 360 Query Language

Search Ads 360 Query Language به شما امکان می دهد با استفاده از Search Ads 360 Reporting API عبارت های جستجو را برای بازیابی داده های گزارش و ابرداده منابع ایجاد کنید.

خدمات جستجو

می‌توانید از زبان جستجوی Search Ads 360 برای جستجو در API با استفاده از:

SearchAds360Service

از این سرویس برای جستجو در منابع و ویژگی‌ها، بخش‌ها و معیارهای مرتبط با آنها استفاده کنید. دو روش وجود دارد، Search و SearchStream .

جستارهای SearchAds360Service فهرستی از نمونه های SearchAds360Row را برمی گرداند:

• هر ردیف نشان دهنده یک منبع است.
• در صورت درخواست، ردیف ها شامل ویژگی ها و فیلدهای متریک هستند.
• اگر بخش‌ها را درخواست می‌کنید، ردیف‌های اضافی برای هر بخش منبع بخش گنجانده می‌شود.

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

SearchAds360FieldService

از این سرویس برای پرس و جو برای فراداده در مورد زمینه ها و منابع موجود استفاده کنید. این سرویس فهرستی از فیلدهای قابل استعلام را با مشخصاتی در مورد سازگاری و نوع آنها ارائه می دهد.

SearchAds360FieldService فهرستی از نمونه های SearchAds360Field را برمی گرداند:

• هر فیلد حاوی جزئیات مربوط به فیلد درخواستی است.

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

نمونه های پرس و جو اولیه

بخش‌های زیر نمونه‌های پرس و جوی اولیه را ارائه می‌دهند که می‌توانید برای ساخت پرس‌و‌جوهای خود آن را تطبیق دهید.

پرس و جو برای ویژگی های یک منبع

این یک پرس و جو اساسی برای ویژگی های منبع campaign است که شناسه، نام و وضعیت کمپین را برمی گرداند:

SELECT
  campaign.id,
  campaign.name,
  campaign.status
FROM campaign
ORDER BY campaign.id

• هر SearchAds360Row بازگشتی نشان دهنده یک شیء campaign است.
• ردیف‌ها با فیلدهای انتخابی پر می‌شوند (شامل resource_name داده شده).
• پرس و جو بر اساس شناسه کمپین مرتب می شود.

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

پرس و جو برای معیارها

این یک پرسش اساسی برای معیارهای مربوط به ویژگی های منبع campaign است:

SELECT
  campaign.id,
  campaign.name,
  campaign.status,
  metrics.impressions
FROM campaign
WHERE campaign.status = 'PAUSED'
  AND metrics.impressions > 1000
ORDER BY campaign.id

• پرس و جو کمپین هایی را با وضعیت PAUSED و بیش از 1000 نمایش برمی گرداند.
• هر SearchAds360Row بازگشتی دارای یک فیلد metrics است که با معیارهای انتخابی پر شده است.
• پرس و جو بر اساس شناسه کمپین مرتب می شود.

برای سایر معیارهای موجود که می توانید در جستارهای خود از آنها استفاده کنید، metrics مشاهده کنید.

پرس و جو برای بخش ها

این یک پرس و جو اساسی برای بخش های مربوط به ویژگی های منبع campaign است:

SELECT
  campaign.id,
  campaign.name,
  campaign.status,
  metrics.impressions,
  segments.date,
FROM campaign
WHERE campaign.status = 'PAUSED'
  AND metrics.impressions > 1000
  AND segments.date during LAST_30_DAYS
ORDER BY campaign.id

• پرس و جو کمپین هایی را با وضعیت PAUSED و بیش از 1000 نمایش برمی گرداند.
• داده ها را بر اساس تاریخ تقسیم بندی می کند.
• در نتیجه تقسیم‌بندی، هر SearchAds360Row چندین کمپین و بخش تاریخ را نشان می‌دهد.
• پرس و جو بر اساس شناسه کمپین مرتب می شود.

segments برای فهرستی از بخش‌هایی که می‌توانید در جستارهای خود استفاده کنید و برای اطلاعات بیشتر درباره بخش‌بندی گزارش‌های خود ، بخش‌بندی را ببینید.

پرس و جو برای ویژگی های یک منبع مرتبط

این یک پرس و جو اساسی در منبع campaign است که در صورت موجود بودن به ویژگی های منبع bidding_strategy می پیوندد. این نوع از منابع مرتبط به عنوان یک منبع نسبت داده شده شناخته می شود.

SELECT
  campaign.id,
  campaign.name,
  campaign.status,
  bidding_strategy.name
FROM campaign
ORDER BY campaign.id

• پرس و جو ویژگی های کمپین و ویژگی های مرتبط را از هر کمپین انتخاب شده انتخاب می کند.
• هر SearchAds360Row بازگشتی نشان دهنده یک شیء campaign است که با ویژگی های کمپین انتخاب شده و همچنین ویژگی استراتژی مناقصه انتخاب شده، bidding_strategy.name پر شده است.

به campaign مراجعه کنید تا دریابید کدام منابع نسبت داده شده برای پرس و جوهای کمپین در دسترس هستند.

پرس و جو برای فراداده فیلد

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

این یک پرس و جو اساسی برای ابرداده فیلد است:

SELECT
  name,
  category,
  selectable,
  filterable,
  sortable,
  selectable_with,
  data_type,
  is_repeated
WHERE name = RESOURCE/FIELD

• RESOURCE OR FIELD را با یک منبع (مانند، customer یا campaign ) یا یک فیلد (مانند campaign.id ، metrics.impressions ، یا ad_group.id ) جایگزین کنید.

توجه: اینها هیچ عبارت FROM در پرس و جو برای ابرداده فیلد نیستند.

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

بیشتر بدانید

درباره نحوه ایجاد پرس و جو در Search Ads 360 Reporting API بیشتر بیاموزید:

• ساختار و بندهای پرس و جو
• محدوده تاریخ
• معیارهای صفر
• نمونه پرس و جو
• دستور زبان را پرس و جو کنید