زبان جستجوی تبلیغات گوگل

پرس و جو برای اطلاعات منبع یا ابرداده

زبان جستجوی Google Ads می تواند از API Google Ads برای انواع اطلاعات زیر پرس و جو کند:

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

  اگر ویژگی یا معیاری درخواست شود، ردیف شامل آن فیلدها نیز می شود. اگر هر بخش درخواست شود، پاسخ همچنین یک ردیف اضافی برای هر بخش منبع-بخش نشان می دهد.

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

  نتیجه جستجوی GoogleAdsFieldService فهرستی از نمونه‌های GoogleAdsField است که هر GoogleAdsField حاوی جزئیات مربوط به فیلد درخواستی است.

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

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

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

این پرس و جو بر اساس شناسه کمپین مرتب می شود. هر GoogleAdsRow حاصل، یک شیء campaign پر شده با فیلدهای انتخابی، از جمله resource_name کمپین را نشان می‌دهد.

برای اطلاع از اینکه چه فیلدهای دیگری برای سؤالات کمپین موجود است، به مستندات مرجع 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 نمایش داشته اند، در حالی که با شناسه کمپین مرتب می شوند. هر GoogleAdsRow به دست آمده دارای یک فیلد metrics است که با معیارهای انتخاب شده پر شده است.

برای فهرستی از معیارهای قابل پرس و جو، به مستندات Metrics مراجعه کنید.

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

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

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 نمایش داشته اند فیلتر می کند. با این حال، این کوئری داده ها را بر اساس تاریخ تقسیم بندی می کند. این منجر به هر یک از GoogleAdsRow می‌شود که چندین کمپین و Segment تاریخ را نشان می‌دهد. بخش بندی معیارهای انتخاب شده را تقسیم می کند و بر اساس هر بخش در عبارت SELECT گروه بندی می شود.

برای فهرستی از بخش‌های قابل پرس‌وجو، به مستندات Segments مراجعه کنید.

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

در یک پرس و جو برای یک منبع معین، ممکن است بتوانید در صورت وجود، به منابع مرتبط دیگر بپیوندید. این منابع مرتبط با عنوان «منابع نسبت داده شده» شناخته می شوند. شما می توانید با انتخاب یک ویژگی در پرس و جو خود، به طور ضمنی به منابع نسبت داده شده بپیوندید.

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

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

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

جهش بر اساس نتایج پرس و جو

هنگام پرس و جو برای یک منبع معین، می توانید فوراً آن نتایج برگشتی را به عنوان اشیا بگیرید، آنها را اصلاح کنید و به متد mutate در سرویس آن منبع بازگردانید. در اینجا یک نمونه گردش کار آمده است: 1. یک پرس و جو برای همه کمپین هایی که در حال حاضر PAUSED اند و تعداد نمایش های آنها بیشتر از 1000 است، اجرا کنید. 1. شی Campaign را از فیلد campaign هر GoogleAdsRow در پاسخ دریافت کنید. 1. وضعیت هر کمپین را از PAUSED به ENABLED تغییر دهید. 1. CampaignService.MutateCampaigns با کمپین های اصلاح شده برای به روز رسانی تماس بگیرید.

فراداده میدانی

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

SELECT
  name,
  category,
  selectable,
  filterable,
  sortable,
  selectable_with,
  data_type,
  is_repeated
WHERE name = "<INSERT_RESOURCE_OR_FIELD>"

می‌توانید <INSERT_RESOURCE_OR_FIELD> در این عبارت با منبع (مانند customer یا campaign ) یا فیلد (مانند campaign.id ، metrics.impressions ، یا ad_group.id ) جایگزین کنید.

برای فهرستی از فیلدهای قابل پرس و جو، به اسناد GoogleAdsField مراجعه کنید.

نمونه های کد

کتابخانه های سرویس گیرنده نمونه هایی از استفاده از زبان جستجوی Google Ads در GoogleAdsService دارند. پوشه عملیات پایه دارای نمونه هایی مانند GetCampaigns ، GetKeywords و SearchForGoogleAdsFields است.