Search Ads 360 Reporting API مبتنی بر یک پلتفرم مدرن است و تعدادی از مفاهیم جدید را معرفی می کند. این موارد در بخش های بعدی توضیح داده شده است.
منابع
اشیاء منبع جایگزین انواع گزارش می شوند. به جای درخواست انواع گزارش های از پیش تعریف شده، اکنون می توانید همه منابع را با استفاده از یک زبان پرس و جوی جدید شبیه به SQL پرس و جو کنید. برای کسب اطلاعات بیشتر به ساختار API Reporting Search Ads 360 مراجعه کنید.
گزارش جستجو
جستجو در API جدید سرویس خاص خود را دارد. سرویس جستجو جایگزین سرویس گزارش‌های قدیمی می‌شود. همه پرسش‌ها از طریق SearchAds360Service انجام می‌شوند که دو روش SearchStream و Search را برای جستجو و بازیابی داده‌ها و معیارهای گزارش ارائه می‌کند. هر دو روش جستجو، تمام اشیاء SearchAds360Row را که با عبارت جستجوی شما مطابقت دارند، برمی گرداند. برای اطلاعات بیشتر به ایجاد گزارش های جستجو مراجعه کنید.
فراداده منابع
SearchAds360FieldService به شما امکان می دهد به صورت پویا کاتالوگ را برای منابع، فیلدهای منبع، کلیدهای تقسیم بندی و معیارهای موجود در روش های جستجوی SearchAds360Service درخواست کنید. برای کسب اطلاعات بیشتر به بازیابی ابرداده منبع مراجعه کنید.
نام رشته ها
API نام فیلدهای تودرتو را معرفی می کند که با علامت نقطه جدا شده اند. به عنوان مثال، campaign.id و ad_group.id . همچنین می‌توانید بیشتر لانه کنید، برای مثال ad_group.campaign.id . برای کسب اطلاعات بیشتر به ساختار API Reporting Search Ads 360 مراجعه کنید.
گزارش‌دهی در Search Ads 360 API قبلی بر اساس فیلدهای جداگانه در نهادهای مختلف برای مفاهیم مشابه است. به عنوان مثال، هر دو گزارش campaign و adgroup شامل یک قسمت campaignId جداگانه هستند.
زبان پرس و جو
API زبان جستجوی Search Ads 360 را معرفی می کند. این یک زبان انعطاف‌پذیر و شبیه به SQL است که به شما امکان می‌دهد پرس و جوهایی را برای بازیابی داده‌های گزارش خاص که به بهترین وجه مناسب کسب‌وکار شما است، تعریف کنید. برای کسب اطلاعات بیشتر به Search Ads 360 Query Language مراجعه کنید.
درخواست ها را دریافت کنید
در API جدید، جستجو سرویس خاص خود را دارد ( SearchAds360Service )، اما درخواست‌های GET هنوز در سرویس خاص هر موجودیت وجود دارد. برای مثال، می‌توانید اطلاعات ستون سفارشی را از CustomColumnService دریافت کنید. برای اطلاعات بیشتر به تغییرات قالب در Search Ads 360 Reporting API مراجعه کنید.
ستون های سفارشی
در Search Ads 360 جدید، ستون‌های فرمول و تبدیل‌های سفارشی ، ستون‌های سفارشی نامیده می‌شوند. درباره ستون های سفارشی بیشتر بیاموزید . CustomColumnService جدید ستون های سفارشی را فعال می کند. به شرط داشتن مجوزهای لازم، می توانید منابع CustomColumn را که متعلق به هر حسابی در درخت حساب است درخواست کنید.
مدیریت حساب
Search Ads 360 جدید حساب ها را در سلسله مراتبی از حساب های مدیر، حساب های مدیر فرعی و حساب های مشتری سازماندهی می کند. حساب مدیر نمایانگر حساب آژانس است و حساب‌های مدیر فرعی نشان‌دهنده حساب‌های تبلیغ‌کننده در Search Ads 360 قبلی است. برای اطلاعات بیشتر به حساب‌های مدیر Search Ads 360 مراجعه کنید.
می‌توانید درخت حساب را پرس و جو کنید و سپس برای هر حسابی که می‌خواهید اطلاعات را از آن گزارش کنید، درخواست ارسال کنید.
در نتیجه تغییر در سلسله مراتب حساب، فیلدهای مرتبط با مفهوم تبلیغ‌کننده/آژانس با جایگزین‌های مناسب جایگزین شده‌اند تا هرجا که ممکن است برابری عملکردی ارائه شود. برای فهرستی از فیلدهای آسیب‌دیده و جایگزین‌های آنها به نقشه‌های فیلدها مراجعه کنید.
هدر شناسه مشتری وارد شوید
login-customer-id یک هدر جدید است که هنگام استفاده از حساب مدیر برای دسترسی به حساب مدیر فرعی یا مشتری لازم است. برای اطلاعات بیشتر به سربرگ شناسه مشتری ورود به سیستم مراجعه کنید.
نسخه سازی
Search Ads 360 Reporting API از نسخه‌سازی معنایی استفاده می‌کند. نسخه های اصلی و فرعی وجود دارد که به صورت v MAJOR _ MINOR فرمت شده اند. برای اطلاعات بیشتر به نسخه سازی مراجعه کنید.