اجزای اصلی API گزارشدهی تبلیغات جستجو ۳۶۰، منابع و سرویسها هستند. یک منبع، یک موجودیت تبلیغات جستجو ۳۶۰ را نشان میدهد و شما از یک سرویس برای بازیابی موجودیتهای تبلیغات جستجو ۳۶۰ استفاده میکنید.
سلسله مراتب شیء
یک حساب کاربری Search Ads 360 سلسله مراتبی از اشیاء است.
منبع سطح بالای یک حساب، مشتری است.
هر حساب کاربری شامل یک یا چند کمپین فعال است.
هر
Campaignشامل یک یا چند گروه تبلیغاتی است که تبلیغات شما را در مجموعههای منطقی گروهبندی میکنند.هر
AdGroupشامل یک یا چند تبلیغ گروه تبلیغاتی است.شما میتوانید یک یا چند
AdGroupCriterionیاCampaignCriterionرا به یک گروه تبلیغاتی یا کمپین پیوست کنید. معیارها نحوهی نمایش تبلیغات را تعریف میکنند.- انواع معیارهای زیادی مانند کلمات کلیدی، محدوده سنی و مکانها وجود دارد. معیارهای تعریف شده در سطح کمپین بر سایر منابع درون کمپین تأثیر میگذارند. همچنین میتوانید بودجهها و تاریخهای کل کمپین را مشخص کنید.
منابع
منابع، موجودیتهای موجود در حساب تبلیغات جستجوی ۳۶۰ شما را نشان میدهند. منابع نمونه شامل Customer ، Campaign و AdGroup میشوند.
شناسههای شیء
هر شیء در Search Ads 360 با شناسه (ID) مخصوص به خود شناسایی میشود. برخی از شناسهها به صورت جهانی، یعنی در تمام حسابهای Search Ads 360، منحصر به فرد هستند، در حالی که برخی دیگر فقط در یک محدوده محدود منحصر به فرد هستند.
| دامنه منحصر به فرد بودن شناسه شیء | |
|---|---|
| شناسه بودجه | جهانی |
| شناسه کمپین | جهانی |
| شناسه گروه تبلیغاتی | جهانی |
| شناسه آگهی | گروه تبلیغاتی هر جفت AdGroupId / AdId به صورت جهانی منحصر به فرد است. |
| شناسه معیار گروه تبلیغاتی | گروه تبلیغاتی هر جفت AdGroupId / CriterionId به صورت جهانی منحصر به فرد است. |
| شناسه معیار کمپین | کمپین هر جفت CampaignId / CriterionId به صورت جهانی منحصر به فرد است. |
| افزونههای تبلیغاتی | کمپین هر جفت CampaignId / AdExtensionId در سطح جهانی منحصر به فرد است. |
| شناسه فید | جهانی |
| شناسه مورد فید | جهانی |
| شناسه ویژگی فید | خوراک |
| شناسه نقشهبرداری فید | جهانی |
| شناسه برچسب | جهانی |
| شناسه فهرست کاربران | جهانی |
این قوانین شناسه میتوانند هنگام طراحی فضای ذخیرهسازی محلی برای اشیاء Search Ads 360 شما مفید باشند.
انواع شیء
برخی از اشیاء میتوانند برای چندین نوع موجودیت استفاده شوند. در این صورت، شیء شامل یک فیلد type است که محتوای آن را توصیف میکند. برای مثال، AdGroupAd میتواند به یک تبلیغ متنی، تبلیغ هتل یا تبلیغ محلی اشاره کند. میتوانید از طریق فیلد AdGroupAd.ad.type به مقدار نوع دسترسی داشته باشید. مقدار آن در شمارش AdType بازگردانده میشود.
نام منابع
هر منبع به طور منحصر به فرد توسط یک رشته resource_name شناسایی میشود که منبع و والدینش را در یک مسیر به هم متصل میکند.
برای مثال، نام منابع کمپین به شکل زیر است:
customers/CUSTOMER_ID/campaigns/CAMPAIGN_ID
یک کمپین با شناسه 987654 در حساب Search Ads 360 با شناسه مشتری 1234567 ، دارای resource_name است:
customers/1234567/campaigns/987654
خدمات
سرویسها به شما امکان میدهند موجودیتها و فرادادههای تبلیغات جستجوی ۳۶۰ خود را بازیابی کنید. سه نوع سرویس وجود دارد:
- سرویس جستجو
-
SearchAds360Serviceیک سرویس واحد و یکپارچه برای بازیابی تمام اشیاء منبع و آمار عملکرد است. این سرویس دو روش ارائه میدهد:SearchوSearchStream. هر دو روش به یک پرسوجو نیاز دارند که منبع مورد نظر برای پرسوجو، ویژگیهای منبع و معیارهای عملکرد مورد نیاز برای بازیابی، گزارههای مورد استفاده برای فیلتر کردن درخواست و بخشهای مورد استفاده برای تجزیه و تحلیل بیشتر آمار عملکرد را مشخص میکند. برای اطلاعات بیشتر به بخش ایجاد گزارشهای جستجو و زبان پرسوجوی Search Ads 360 مراجعه کنید. - خدمات میدانی
-
SearchAds360FieldServiceفرادادههایی درباره منابع، مانند ویژگیهای موجود برای یک منبع و نوع داده آن، بازیابی میکند. میتوانید کاتالوگ منابع، فیلدهای منبع، کلیدهای تقسیمبندی و معیارهای موجود در روشهای جستجویSearchAds360Serviceرا درخواست کنید. برای کسب اطلاعات بیشتر به بازیابی فرادادههای منبع مراجعه کنید. - خدمات خاص نهاد
این سرویسها یک روش درخواست
GETارائه میدهند که یک نمونه منبع واحد را بازیابی میکند. این برای بررسی ساختار یک منبع مفید است.نمونههایی از خدمات خاص هر واحد تجاری عبارتند از:
- CustomColumnService که ستون سفارشی درخواستی را با جزئیات کامل برمیگرداند.