ساختار API گزارش Search Ads 360

اجزای اصلی Search Ads 360 Reporting API منابع و خدمات هستند. یک منبع یک موجودیت Search Ads 360 را نشان می دهد و شما از یک سرویس برای بازیابی موجودیت های Search Ads 360 استفاده می کنید.

سلسله مراتب شی

حساب Search Ads 360 سلسله مراتبی از اشیاء است.

  • منبع سطح بالای یک حساب، مشتری است.

  • هر حساب شامل یک یا چند کمپین فعال است.

  • هر Campaign شامل یک یا چند گروه تبلیغاتی است که تبلیغات شما را در مجموعه های منطقی گروه بندی می کنند.

  • هر AdGroup حاوی یک یا چند آگهی گروه تبلیغاتی است.

  • می توانید یک یا چند AdGroupCriterion یا CampaignCriterion به یک گروه تبلیغاتی یا کمپین پیوست کنید. معیارها نحوه راه اندازی تبلیغات را مشخص می کنند.

    • انواع معیارهای زیادی وجود دارد، مانند کلمات کلیدی، محدوده سنی و مکان. معیارهای تعریف شده در سطح کمپین بر تمام منابع دیگر درون کمپین تأثیر می گذارد. شما همچنین می توانید بودجه و تاریخ کمپین را مشخص کنید.

منابع

منابع موجودیت‌های موجود در حساب Search Ads 360 شما را نشان می‌دهند. منابع مثال شامل Customer ، Campaign و AdGroup است.

شناسه های اشیاء

هر شی در Search Ads 360 با شناسه خود شناسایی می شود. برخی از شناسه‌ها در سراسر جهان منحصر به فرد هستند، یعنی در همه حساب‌های Search Ads 360، در حالی که برخی دیگر فقط در یک محدوده محدود منحصر به فرد هستند.

محدوده منحصر به فرد شناسه شی
شناسه بودجه جهانی
شناسه کمپین جهانی
شناسه AdGroup جهانی
شناسه آگهی گروه تبلیغات

هر جفت AdGroupId / AdId در سطح جهانی منحصر به فرد است.
AdGroupCriterion ID گروه تبلیغات

هر جفت AdGroupId / CriterionId در سطح جهانی منحصر به فرد است.
CampaignCriterion ID کمپین

هر جفت 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

خدمات

خدمات به شما امکان می دهند موجودیت ها و ابرداده های Search Ads 360 خود را بازیابی کنید. سه نوع خدمات وجود دارد:

سرویس جستجو
SearchAds360Service یک سرویس واحد و یکپارچه برای بازیابی همه اشیاء منابع و آمار عملکرد است. این دو روش را ارائه می دهد: Search و SearchStream . هر دو روش به یک پرس و جو نیاز دارند که منبع مورد نظر، ویژگی‌های منبع و معیارهای عملکرد برای بازیابی، مقدماتی برای فیلتر کردن درخواست و بخش‌هایی را که برای تجزیه بیشتر آمار عملکرد استفاده می‌شود، مشخص کند. برای اطلاعات بیشتر به ایجاد گزارش‌های جستجو و Search Ads 360 Query Language مراجعه کنید.
خدمات میدانی
SearchAds360FieldService ابرداده‌های مربوط به منابع، مانند ویژگی‌های موجود برای یک منبع و نوع داده آن را بازیابی می‌کند. می‌توانید کاتالوگ را برای منابع، فیلدهای منبع، کلیدهای تقسیم‌بندی، و معیارهای موجود در روش‌های جستجوی SearchAds360Service درخواست کنید. برای کسب اطلاعات بیشتر به بازیابی ابرداده منبع مراجعه کنید.
خدمات خاص نهاد

این سرویس ها یک روش درخواست GET را ارائه می کنند که یک نمونه منبع واحد را بازیابی می کند. این برای بررسی ساختار یک منبع مفید است.

نمونه‌هایی از خدمات خاص نهاد عبارتند از:

  • CustomColumnService که ستون سفارشی درخواستی را با جزئیات کامل برمی گرداند.