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