حداقل عملکرد مورد نیاز (RMF) به ویژگیها و سایر قابلیتهایی اشاره دارد که توسعهدهندگان ابزارهای خاص باید هنگام استفاده از API تبلیغات گوگل ارائه دهند. همانطور که در زیر آمده است، قوانین RMF به سه دسته تقسیم میشوند: عملکرد ایجاد، عملکرد مدیریت و عملکرد گزارشدهی. رعایت این قوانین توسط شما به نحوه استفاده شما از API تبلیغات گوگل بستگی دارد (عبارت "RMF اعمال میشود" به این معنی است که RMF برای شما اعمال میشود):
| قابلیت ایجاد | عملکرد مدیریت | عملکرد گزارشدهی | |
|---|---|---|---|
ابزار کامل
| RMF اعمال میشود | RMF اعمال میشود | RMF اعمال میشود |
فقط گزارش
| RMF اعمال نمیشود | RMF اعمال نمیشود | RMF اعمال میشود |
فقط برای استفاده داخلی
| RMF اعمال نمیشود | RMF اعمال نمیشود | RMF اعمال نمیشود |
اگر ابزار شما قابلیتهای بسیار محدود و تخصصی ارائه میدهد و نمیتوان از آن برای ایجاد و مدیریت کمپینها، گروههای تبلیغاتی و تبلیغات استفاده کرد، ممکن است واجد شرایط یک ابزار با خدمات کامل نباشد. در این صورت، RMF ایجاد و مدیریت اعمال نمیشود. اگر مطمئن نیستید که آیا سیاست RMF برای ابزار شما اعمال میشود یا خیر، با تیم انطباق با API تبلیغات گوگل تماس بگیرید . تیم انطباق با API تبلیغات گوگل تصمیم خواهد گرفت که آیا ابزار شما خدمات کامل دارد یا خیر. در صورت تغییر قابل توجه عملکرد، ابزار شما ممکن است دوباره ارزیابی شود.
توجه داشته باشید که RMF فقط برای توکنهای توسعهدهندگان با سطح دسترسی استاندارد اعمال میشود.
افزونه یکبار مصرف برای بهروزرسانیهای عمده
با توجه به این واقعیت که ابزارهای API ممکن است به صورت دورهای ارتقاءهای گسترده فناوری را انجام دهند، ابزارهایی که حداقل به مدت ۲ سال متوالی تمام مهلتهای RMF را رعایت کردهاند، میتوانند برای اجرای چنین ارتقاءهایی در پلتفرم خود، درخواست تمدید ۶ ماهه RMF بدهند. در صورت اعطای تمدید، در طول دوره تمدید، این ابزارها از نظر انطباق با الزامات RMF بررسی نخواهند شد. در پایان دوره تمدید، ابزار باید کاملاً با تمام الزامات RMF که در آخرین تاریخ دوره تمدید یا قبل از آن مهلت داشتند، مطابقت داشته باشد. تمام الزامات RMF که پس از پایان تمدید مهلت دارند، در تاریخ مشخص شده در جدول زیر سررسید خواهند شد.
یک ابزار API میتواند حداکثر هر چهار سال یک بار تمدید شود (تمدید دوم باید حداقل ۴ سال پس از پایان تمدید اول آغاز شود).
اگر مایل به درخواست تمدید برای ابزار خود هستید، با تماس با ما از طریق آدرس https://support.google.com/adspolicy/contact/contact_ads_api فرم درخواست را درخواست کنید. درخواست شما باید توسط یکی از مدیران اجرایی (مدیر عامل، مدیر ارشد فناوری یا معاون ارشد) شرکت شما امضا و ارسال شود. توجه داشته باشید که تضمینی برای تأیید درخواست شما وجود ندارد.
الزامات مربوط به ابزارهای API مخصوص خرید، مخصوص تبلیغات اپلیکیشن و مخصوص هتل
اگر ابزار شما فقط برای ایجاد و مدیریت یکی از انواع کمپینهای زیر طراحی شده است، فقط لازم است ویژگیها و گزارشهای ایجاد و مدیریت API تبلیغات گوگل را در RMF پیادهسازی کنید که با آن نوع کمپین کار میکنند.
- کمپین تبلیغاتی اپلیکیشن
- کمپینهای هتل ( فقط در API تبلیغات گوگل موجود است )
- کمپینهای Performance Max ( فقط در API تبلیغات گوگل موجود است )
- کمپینهای هوشمند ( فقط در API تبلیغات گوگل موجود است )
- کمپینهای خرید استاندارد
الزامات مربوط به کلاینتهای API تبلیغات گوگل که فقط گزارش میدهند
برای مطابقت با الزامات RMF، یک کلاینت API تبلیغات گوگل که فقط برای گزارشدهی طراحی شده است، باید قابلیت گزارشدهی را برای هر یک از سطوح سلسله مراتب تبلیغات گوگل که در رابط گزارشدهی آن نمایش داده میشود، نشان دهد. منظور از سطح سلسله مراتب تبلیغات گوگل، یکی از سطوح حساب، کمپین، گروه تبلیغاتی، تبلیغ یا کلمه کلیدی است. به عنوان مثال، اگر یک کلاینت تبلیغات گوگل که فقط برای گزارشدهی طراحی شده است، گروههای تبلیغاتی را نشان دهد، باید تمام قابلیتهای گزارشدهی سطح «گروه تبلیغاتی» را که در زیر با عنوان «الزامی» مشخص شده است، پیادهسازی کند.
یک کلاینت API تبلیغات گوگل که فقط گزارش میدهد، میتواند سطوح خاصی از سلسله مراتب تبلیغات گوگل را در رابط گزارشدهی خود نشان ندهد. برای مثال، اگر یک کلاینت API تبلیغات گوگل که فقط گزارش میدهد، هیچ داده عملکرد گروه تبلیغاتی را در رابط خود نشان ندهد، نیازی به پیادهسازی هیچ یک از RMF گزارشدهی در سطح "گروه تبلیغاتی" ندارد.
سیاست فوق در مورد سایر انواع گزارشها نیز اعمال میشود، اگرچه آنها سطوح سلسله مراتب گوگل ادز نیستند. در صورت تمایل به پیادهسازی هر یک از این گزارشها، باید تمام فیلدهای مورد نیاز برای هر گزارش مربوطه را نمایش دهید.
برای مطابقت با الزامات RMF، Google Ads API Client باید تمام ستونهای علامتگذاری شده در ستون Object/Field/Guide را برای هر گزارش، به صورت پیشفرض نمایش دهد. سایر ستونهای Metric باید به عنوان یک گزینه برای کاربران Google Ads API Client در دسترس قرار گیرند. دادههای گزارش Google Ads باید به طور معقولی برجسته و برای کاربران نهایی قابل دسترسی باشند.
گزارشهای قابل دانلود
اگر ابزار شما به جای نمایش قابلیت گزارشگیری در رابط کاربری، گزینه دانلود، مثلاً CSV، را ارائه میدهد، لینک دانلود باید به طور برجسته نمایش داده شود و به طور شهودی برچسبگذاری شود. فایل دانلود شده باید شامل تمام فیلدهای گزارشدهی مورد نیاز باشد و به وضوح برچسبگذاری شود.
محدودههای تاریخ گزارش
توصیه میکنیم به کاربران اجازه دهید دادههای گزارش را بر اساس محدوده تاریخ فیلتر کنند. اگر ابزار شما از محدودههای تاریخ سفارشی پشتیبانی نمیکند، حداقل باید دادههای 30 روز گذشته را برای هر فیلد گزارش مورد نیاز ارائه دهد.
الزامات مربوط به کلاینتهای API که قابلیت ایجاد یا قابلیت مدیریت را ارائه میدهند
برای مطابقت با الزامات RMF، یک کلاینت API تبلیغات گوگل با سرویس کامل باید تمام ویژگیهای ایجاد و مدیریت مورد نیاز در جدول زیر را پیادهسازی کند و قابلیت گزارشدهی را برای هر یک از گزارشهای زیر نشان دهد. علاوه بر این، شما باید تلاش معقولی انجام دهید تا اطمینان حاصل کنید که هر یک از ویژگیها به راحتی در دسترس و برای تبلیغکنندگان نهایی، بر اساس میزان استفاده از آن ویژگیها، کاربردی هستند.
الزامات مربوط به مشتریان API که خدمات برنامهریزی ارائه میدهند
اگر یک کلاینت API تبلیغات گوگل هرگونه قابلیتی مربوط به KeywordPlanIdeaService یا KeywordPlanService را ارائه دهد، باید قابلیت ایجاد، قابلیت مدیریت و قابلیت گزارشدهی مورد نیاز که در جدول زیر با عنوان «الزامی» مشخص شدهاند را بهطور کامل پیادهسازی کند.
الزامات مربوط به مشتریان API که خدمات توصیه ارائه میدهند
همه کلاینتهای API مجاز به استفاده از GoogleAdsService و RecommendationService برای بازیابی توصیهها هستند.
استفاده از RecommendationService.ApplyRecommendation() و RecommendationService.DismissRecommendation() به انواع زیر از کلاینتهای API گوگل ادز محدود میشود:
- ابزارهای کامل
- ابزارهای داخلی
- ابزارهای API مخصوص خرید، فقط خرید هوشمند/پرفورمنس مکس، فقط تبلیغات اپلیکیشن و فقط هتل
- ابزارهای ویژه که قابلیت مدیریت کمپین را ارائه میدهند
اگر یک کلاینت API گوگل ادز قابلیت اعمال یا رد توصیهها با استفاده از RecommendationService را ارائه دهد، باید الزامات زیر را برآورده کند:
- باید به طور کامل قابلیتهای ایجاد، مدیریت و گزارشدهی مورد نیاز را برای دسته ابزار خود پیادهسازی کند.
- تمام توصیههای گوگل ادز که به کاربران نهایی نشان داده میشود، باید در رابط کاربری ابزار به عنوان «توصیههای گوگل ادز» ارائه شوند.
- کاربران نهایی باید بتوانند تمام توصیههای گوگل ادز که توسط کلاینت API گوگل ادز ارائه میشوند را مشاهده و اعمال کنند.
الزامات تعدیل پیشنهاد قیمت
تمام کلاینتهای API که قابلیت ایجاد یا مدیریت را ارائه میدهند، باید الزامات زیر را در رابطه با تنظیمات پیشنهاد قیمت برآورده کنند:
- کاربران نهایی باید مجاز به وارد کردن کل محدوده مقادیر مجاز باشند.
- کاربران نهایی باید بتوانند تنظیمات پیشنهاد قیمت را قبل از اینکه توسط Google Ads API Client تنظیم شود، بررسی و ویرایش کنند.
- تعدیلات پیشنهاد قیمت باید فقط به عنوان تعدیلاتی در پیشنهادها ارائه شوند و نمیتوانند برای فعال کردن یا تقریب سایر ویژگیها، مانند هدفگذاری یا حذف، استفاده شوند.
پیادهسازی ویژگی
مگر اینکه در زیر طور دیگری مشخص شده باشد، یک ویژگی تنها در صورتی پیادهسازی میشود که تمام زیرویژگیها و پارامترهای موجود نیز پیادهسازی شوند. مرجع API، پارامترها و زیرویژگیهای موجود را مستند میکند. به عنوان مثال، ویژگی "ورود/خروج از شبکهها" به معنای پشتیبانی از ورود/خروج از جستجوی گوگل، شرکای جستجو و شبکه نمایش است. علاوه بر این، اگر در Google Ads API Client خود ویژگیای مشابه هر ویژگی که مورد نیاز گوگل نیست را پیادهسازی کنید، باید ویژگی مشابه گوگل را در Google Ads API Client خود نیز پیادهسازی کنید. به عنوان مثال، اگر نسخه شخصی خود از "Keyword Ideas" را در Google Ads API Client خود پیادهسازی میکنید، باید عملکرد "Keyword Ideas" گوگل را نیز در Google Ads API Client خود پیادهسازی کنید.
برای حفظ انطباق با RMF، هرگونه ویژگی جدید مورد نیاز باید تا تاریخ سررسید (که در کنار هر ویژگی با عنوان سررسید: YYYY-MM-DD نشان داده شده است) اضافه شود. هرگونه RMF که تاریخ سررسید مشخصی نداشته باشد، سررسید گذشته محسوب میشود. علاوه بر این، ما از شما میخواهیم که حداقل دو هفته قبل از اعمال این تغییرات، با استفاده از فرم تغییر ابزار، اسکرینشاتها و/یا ماکتهایی از تغییرات پیشنهادی را برای Google Ads API Client ارسال کنید. برای شفافسازی، پس از گذشت این دوره دو هفتهای، نیازی نیست قبل از اعمال این تغییرات اساسی، منتظر پاسخی از گوگل باشید.
فهرست ویژگیهای ابزار کامل
| شماره کالا | عملکرد | شیء/زمینه/راهنما | مورد نیاز | ||||||||||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
قابلیت ایجاد | |||||||||||||||||||||||||||||||||||
| ج.10 | ایجاد کمپین | campaign | مورد نیاز | ||||||||||||||||||||||||||||||||
| ج.20 | فعال کردن هدفگیری جغرافیایی | هدفگذاری مکانی | الزامی. در صورت مرتبط بودن فقط یک کشور با پایگاه کاربر، نمایش آن به کاربر اختیاری است. | ||||||||||||||||||||||||||||||||
| ج.30 | فعال کردن هدفگیری زبانی | campaign_criterion.language | الزامی. در صورت نیاز به نمایش فقط یک زبان برای کاربر، اختیاری است. | ||||||||||||||||||||||||||||||||
| ج.۶۵ | تبدیل وبسایت/تماس را ایجاد کنید و قطعه کد تولید کنید | ردیابی تبدیل | حداقل به یک نوع ردیابی تبدیل نیاز دارد. | ||||||||||||||||||||||||||||||||
| ج.۷۵ | افزونههای فراخوان | محل قرارگیری فید فراخوان خدمات تنظیم افزونه خدمات تغذیه | الزامی. این مورد فقط باید در سطح حساب کاربری پشتیبانی شود. | ||||||||||||||||||||||||||||||||
| ج.۹۶ | گزینه پیشنهاد قیمت را تنظیم کنید: CPA هدف (پورتفولیو و استاندارد) | campaign.target_cpa (استاندارد)bidding_strategy.target_cpa (نمونه کارها) | الزامی. هر دو استراتژی پورتفولیو و استاندارد باید در سطح کمپین پشتیبانی شوند. | ||||||||||||||||||||||||||||||||
| ج.۹۷ | گزینه پیشنهاد قیمت را تنظیم کنید: ROAS هدف (پورتفولیو و استاندارد) | campaign.target_roas (استاندارد)bidding_strategy.target_roas (نمونه کارها) | الزامی. هر دو استراتژی پورتفولیو و استاندارد باید در سطح کمپین پشتیبانی شوند. | ||||||||||||||||||||||||||||||||
| ج.۹۸ | تنظیم گزینه پیشنهاد قیمت: حداکثر کردن تبدیلها (استاندارد) | campaign.maximize_conversions (استاندارد) | مورد نیاز | ||||||||||||||||||||||||||||||||
| ج.۱۲۰ | بودجه تعیین کنید | campaign_budget | مورد نیاز | ||||||||||||||||||||||||||||||||
| ج.۱۹۰ | ایجاد گروه تبلیغاتی | ad_group | الزامی. اختیاری: امکان ایجاد چندین گروه تبلیغاتی. | ||||||||||||||||||||||||||||||||
| ج.۲۶۰ | اضافه کردن کلمه کلیدی | ad_group_criterion.keyword | مورد نیاز | ||||||||||||||||||||||||||||||||
| ج.۲۷۰ | کلمات کلیدی منفی کمپین را اضافه کنید | campaign_criterion.negative | مورد نیاز | ||||||||||||||||||||||||||||||||
| سی.۳۰۰ | تنظیم نوع تطابق کلمه کلیدی | ad_group_criterion.keyword | مورد نیاز | ||||||||||||||||||||||||||||||||
عملکرد مدیریت م.10 | ویرایش تنظیمات کمپین | | campaign.*setting الزامی. فقط تنظیماتی که در زمان ایجاد لازم هستند، در زمان تغییر لازم خواهند بود. | م.96 | گزینه پیشنهاد قیمت را ویرایش کنید: CPA هدف (پورتفولیو و استاندارد) | | campaign.target_cpa (استاندارد)bidding_strategy.target_cpa (نمونه کارها) الزامی. هر دو استراتژی پورتفولیو و استاندارد باید در سطح کمپین پشتیبانی شوند. | م.97 | گزینه پیشنهاد قیمت را ویرایش کنید: هدف قرار دادن بازگشت سرمایه (نمونه کارها و استاندارد) | | campaign.target_roas (استاندارد)bidding_strategy.target_roas (نمونه کارها) الزامی. هر دو استراتژی پورتفولیو و استاندارد باید در سطح کمپین پشتیبانی شوند. | م.98 | گزینه پیشنهاد قیمت را ویرایش کنید: حداکثر کردن تبدیلها (استاندارد) | | campaign.maximize_conversions (استاندارد) مورد نیاز | م.۱۱۰ | مکث/فعال/حذف کمپین | | campaign.status مورد نیاز | م.۱۳۰ | مکث / فعال / حذف تبلیغ | | ad_group_ad.status مورد نیاز | م.۱۴۰ | مکث/فعال کردن/حذف کلمه کلیدی | | ad_group_criterion.status مورد نیاز | عملکرد گزارشدهی | |||||||
| ۱۰ روپیه | مشتری | metrics.clicksmetrics.cost_microsmetrics.impressionsmetrics.conversionsmetrics.all_conversions | مورد نیاز | ||||||||||||||||||||||||||||||||
| ۲۰ راند | کمپین | metrics.clicksmetrics.cost_microsmetrics.impressionsmetrics.conversionsmetrics.all_conversions | مورد نیاز | ||||||||||||||||||||||||||||||||
campaign.status | در صورت نمایش کمپینهای متوقفشده، فعال و حذفشده، الزامی است. اختیاری است اگر فقط کمپینهای فعال را نشان دهد. | ||||||||||||||||||||||||||||||||||
| ۴۰ راند | تبلیغ گروه تبلیغاتی | metrics.clicksmetrics.cost_microsmetrics.impressionsmetrics.conversions | مورد نیاز | ||||||||||||||||||||||||||||||||
ad_group_ad.status | در صورت نمایش تبلیغات متوقف شده، فعال و حذف شده، الزامی است. اختیاری اگر فقط تبلیغات فعال را نشان میدهد. | ||||||||||||||||||||||||||||||||||
| ۵۰ راند | مشاهده کلمات کلیدی | metrics.clicksmetrics.cost_microsmetrics.impressionsmetrics.conversionsad_group_criterionad_group_criterion | مورد نیاز | ||||||||||||||||||||||||||||||||
ad_group_criterion.status | در صورت نمایش کلمات کلیدی متوقف شده، فعال و حذف شده، الزامی است. اختیاری است اگر فقط کلمات کلیدی فعال را نشان دهد. | ||||||||||||||||||||||||||||||||||
| ۷۰ راند | نمایش عبارت جستجو | search_term_view.search_termsegments.search_term_match_typemetrics.clicksmetrics.cost_microsmetrics.impressions | مورد نیاز | ||||||||||||||||||||||||||||||||
| ۱۰۰ راند | نمایش عبارت جستجو در تبلیغات جستجوی پویا | dynamic_search_ads_search_term_view.search_termmetrics.clicksmetrics.cost_microsmetrics.impressionsmetrics.conversions | فقط در صورت پیادهسازی تبلیغات جستجوی پویا (Dynamic Search Ads) الزامی است. | ||||||||||||||||||||||||||||||||
| ۱۳۰ راند | استراتژی پیشنهاد قیمت | bidding_strategy.typemetrics.clicksmetrics.cost_microsmetrics.cost_per_conversionmetrics.impressionsmetrics.average_cpcmetrics.conversions | مورد نیاز | ||||||||||||||||||||||||||||||||
bidding_strategy.status | در صورت نمایش استراتژیهای متوقفشده، فعال و حذفشده، الزامی است. اختیاری است اگر فقط استراتژیهای فعال را نشان دهد. | ||||||||||||||||||||||||||||||||||
فهرست ویژگیهای ابزار کمپین اپلیکیشن
| شماره کالا | عملکرد | شیء/زمینه/راهنما | مورد نیاز |
|---|---|---|---|
قابلیت ایجاد | |||
| ج.20 | فعال کردن هدفگیری جغرافیایی | هدفگذاری مکانی | الزامی. در صورت مرتبط بودن فقط یک کشور با پایگاه کاربر، نمایش آن به کاربر اختیاری است. |
| ج.30 | فعال کردن هدفگیری زبانی | campaign_criterion.language | الزامی. در صورت نیاز به نمایش فقط یک زبان برای کاربر، اختیاری است. |
| ج.۶۵ | تبدیل وبسایت/تماس را ایجاد کنید و قطعه کد تولید کنید | ردیابی تبدیل | حداقل به یک نوع ردیابی تبدیل نیاز دارد. |
| ج.۹۶ | گزینه پیشنهاد قیمت را تنظیم کنید: CPA هدف (پورتفولیو و استاندارد) | campaign.target_cpa (استاندارد)bidding_strategy.target_cpa (نمونه کارها) | الزامی. هر دو استراتژی پورتفولیو و استاندارد باید در سطح کمپین پشتیبانی شوند. |
| گزینه پیشنهاد قیمت را تنظیم کنید: پیشثبتنام | تبلیغات اپلیکیشن برای پیشثبتنام | برای کمپینهای اپلیکیشن، پیشثبتنام الزامی است. | |
| ج.۱۹۰ | ایجاد گروه تبلیغاتی | ad_group | الزامی. اختیاری: امکان ایجاد چندین گروه تبلیغاتی. |
| افزودن داراییها به گروه تبلیغاتی | ad_group | الزامی: فایلهای متنی. اختیاری برای فایلهای تصویری و ویدیویی. | |
| سی.۶۰۱ | ایجاد کمپینهای نصب یا تعامل مجدد با اپلیکیشن | | الزامی: نصب کمپین اپلیکیشن یا تعامل مجدد با کمپین اپلیکیشن، اما نه هر دو. |
| سی.۶۰۲ | تنظیمات کمپین برنامه را فعال کنید | AppCampaignSetting | الزامی: امکان انتخاب اپلیکیشن برای تبلیغ یا اضافه کردن لینکهای عمیق برای تعامل. |
عملکرد مدیریت | |||
| م.۶۰۱ | مکث/فعال کردن/حذف کمپین برنامه | campaign.status | مورد نیاز |
| م.۶۰۲ | تنظیمات کمپین اپلیکیشن را ویرایش کنید | campaign.*setting | مورد نیاز |
عملکرد گزارشدهی | |||
| ۱۰ روپیه | عملکرد حساب | metrics.clicksmetrics.cost_microsmetrics.impressionsmetrics.conversionsmetrics.all_conversions | مورد نیاز |
| ۲۰ راند | عملکرد کمپین | metrics.clicksmetrics.cost_microsmetrics.impressionsmetrics.conversionsmetrics.all_conversions | در صورت نمایش کمپینهای متوقفشده، فعال و حذفشده، الزامی است. اختیاری است اگر فقط کمپینهای فعال را نشان دهد. |
فهرست ویژگیهای ابزار مخصوص هتل
| شماره کالا | عملکرد | شیء/زمینه/راهنما | مورد نیاز |
|---|---|---|---|
قابلیت ایجاد | |||
| ج.۱۱ | ایجاد کمپین هتل | کمپین هتل | مورد نیاز |
| ج.۱۲ | شناسه مرکز هتل را برای کمپین هتل تنظیم کنید | HotelSettingInfo | مورد نیاز |
| ج.20 | فعال کردن هدفگیری جغرافیایی | هدفگذاری مکانی | الزامی، اختیاری، برای نمایش به کاربر در صورتی که فقط یک کشور برای پایگاه کاربر مرتبط باشد. |
| ج.30 | فعال کردن هدفگیری زبانی | campaign_criterion.language | الزامی. در صورت نیاز به نمایش فقط یک زبان برای کاربر، اختیاری است. |
| ج.۶۵ | تبدیل وبسایت/تماس را ایجاد کنید و قطعه کد تولید کنید | ردیابی تبدیل | حداقل به یک نوع ردیابی تبدیل نیاز دارد. |
| ج.۱۲۰ | بودجه تعیین کنید | campaign_budget | مورد نیاز |
| تنظیم استراتژی پیشنهاد قیمت | پیشنهاد قیمت هتل | اختیاری است تا به کاربر اجازه دهد یک استراتژی پیشنهاد قیمت خاص را انتخاب کند و یک هدف تعیین کند. | |
| ج.۱۹۰ | ایجاد گروه تبلیغاتی هتل | ad_group | الزامی. اختیاری: امکان ایجاد چندین گروه تبلیغاتی. |
| سی.۵۲۶ | اضافه کردن پارتیشن اول (ریشه) به پارتیشن گروه هتل | گروههای فهرست هتل | برای اجرای کمپین تبلیغات هتل الزامی است، اما لازم نیست که به کاربر نمایش داده شود. |
عملکرد مدیریت | |||
| م.10 | ویرایش تنظیمات کمپین | campaign.*setting | مورد نیاز |
| م.۱۱۰ | مکث/فعال/حذف کمپین | campaign.status | مورد نیاز |
| م.۱۶۱ | تقسیمبندی (اضافه کردن پارتیشن گروه هتل) | گروههای فهرست هتل | مورد نیاز |
| م.۱۹۱ | گروه هتل را حذف کنید | AdGroupCriterion | مورد نیاز |
عملکرد گزارشدهی | |||
| ۱۰ روپیه | عملکرد حساب | metrics.clicksmetrics.cost_microsmetrics.impressionsmetrics.conversionsmetrics.all_conversions | مورد نیاز |
| ۲۰ راند | عملکرد کمپین | metrics.clicksmetrics.cost_microsmetrics.impressionsmetrics.conversionsmetrics.all_conversions | در صورت نمایش کمپینهای متوقفشده، فعال و حذفشده، الزامی است. اختیاری است اگر فقط کمپینهای فعال را نشان دهد. |
| ر.۱۱۱ | گزارش عملکرد هتل | hotel_performance_view | مورد نیاز |
فهرست ویژگیهای کمپین Performance Max
| شماره کالا | عملکرد | شیء/زمینه/راهنما | مورد نیاز |
|---|---|---|---|
قابلیت ایجاد | |||
| ج.10 | ایجاد کمپین | campaign | الزامی. اختیاری: امکان ایجاد چندین کمپین. |
| ج.20 | فعال کردن هدفگیری جغرافیایی | هدفگذاری مکانی | الزامی. در صورت مرتبط بودن فقط یک کشور با پایگاه کاربر، نمایش آن به کاربر اختیاری است. |
| ج.30 | فعال کردن هدفگیری زبانی | campaign_criterion.language | الزامی. در صورت نیاز به نمایش فقط یک زبان برای کاربر، اختیاری است. |
| ج.۶۵ | تبدیل وبسایت/تماس را ایجاد کنید و قطعه کد تولید کنید | ردیابی تبدیل | حداقل به یک نوع ردیابی تبدیل نیاز دارد. |
| ج.۱۲۰ | بودجه تعیین کنید | campaign_budget | مورد نیاز |
| تنظیم استراتژی پیشنهاد قیمت | اختیاری است تا به کاربر اجازه دهد یک استراتژی پیشنهاد قیمت خاص را انتخاب کند و یک هدف تعیین کند. | ||
عملکرد مدیریت | |||
| م.10 | ویرایش تنظیمات کمپین | campaign.*setting | الزامی. فقط تنظیماتی که در زمان ایجاد لازم هستند، در زمان تغییر لازم خواهند بود. |
| م.۱۱۰ | مکث/فعال/حذف کمپین | campaign.status | مورد نیاز |
عملکرد گزارشدهی | |||
| ۱۰ روپیه | مشتری | metrics.clicksmetrics.cost_microsmetrics.conversions | الزامی. اختیاری اگر فقط یک کمپین را نشان میدهد. |
| ۲۰ راند | کمپین | metrics.clicksmetrics.cost_microsmetrics.conversions | مورد نیاز |
فهرست ویژگیهای کمپین هوشمند
جدول زیر حداقل مجموعه قابلیتهای مورد نیاز برای پیادهسازی کمپینهای هوشمند را تعریف میکند. اگر ابزار شما اصلاً کمپینهای هوشمند را پیادهسازی میکند، باید حداقل این مجموعه ویژگیها را پیادهسازی کنید. اگر ابزار شما کمپینهای هوشمند را پیادهسازی نمیکند، نیازی به این ویژگیها نیست.
| شماره کالا | عملکرد | شیء/زمینه/راهنما | مورد نیاز |
|---|---|---|---|
قابلیت ایجاد | |||
| ج.10 | ایجاد کمپین هوشمند | کمپین هوشمند | مورد نیاز |
| اضافه کردن تم کلمات کلیدی | اطلاعات تم کلمات کلیدی | برای ایجاد کمپین الزامی است، اما نمایش آن به کاربر اختیاری است. | |
| ج.20 | فعال کردن هدفگیری جغرافیایی | هدفگذاری مکانی | برای ایجاد کمپین الزامی است، اما نمایش آن به کاربر اختیاری است. |
| ج.70 | داراییهای مکان | داراییهای مکان | فقط در صورت ادغام با نمایه تجاری الزامی است. |
| ج.۱۲۰ | بودجه تعیین کنید | campaign_budget | مورد نیاز |
| سی.۲۰۰ | اضافه کردن آگهی | ایجاد آگهی | برای ایجاد کمپین الزامی است، اما نمایش آن به کاربر اختیاری است. |
عملکرد مدیریت | |||
| م.10 | ویرایش تنظیمات کمپین (تمام تنظیمات ایجاد کمپین برای تبلیغکننده نمایش داده میشود) | campaign.*setting | مورد نیاز |
| م.۱۱۰ | مکث/فعال/حذف کمپین | campaign.status | مورد نیاز |
| م.۱۳۰ | مکث / فعال / حذف تبلیغ | ad_group_ad.status | مورد نیاز |
| تنظیم/ویرایش برنامه کمپین | ad_schedule | مورد نیاز | |
| حذف/اضافه کردن تم کلمه کلیدی | KeywordThemeInfo | برای ایجاد کمپین الزامی است، اما نمایش آن به کاربر اختیاری است. | |
| اضافه/حذف کردن تم کلمات کلیدی منفی | KeywordThemeInfo | برای ایجاد کمپین الزامی است، اما نمایش آن به کاربر اختیاری است. | |
عملکرد گزارشدهی | |||
| ۲۰ راند | عملکرد کمپین | metrics.clicksmetrics.cost_microsmetrics.impressionsmetrics.conversionsmetrics.all_conversions | در صورت نمایش کمپینهای متوقفشده، فعال و حذفشده، الزامی است. در صورت نمایش فقط کمپینهای فعال، اختیاری است. |
SMART_CAMPAIGN_MAP_CLICKS_TO_CALLSMART_CAMPAIGN_MAP_DIRECTIONS | فقط در صورت ادغام با نمایه تجاری الزامی است. | ||
| ۷۰ راند | نمایش عبارت جستجوی هوشمند کمپین | metrics.clicksmetrics.cost_micros | مورد نیاز |
فهرست ویژگیهای ابزار استاندارد کمپین خرید
| شماره کالا | عملکرد | شیء/زمینه/راهنما | مورد نیاز |
|---|---|---|---|
قابلیت ایجاد | |||
| ج.10 | ایجاد کمپین | campaign | مورد نیاز |
| ج.20 | فعال کردن هدفگیری جغرافیایی | هدفگذاری مکانی | الزامی. در صورت مرتبط بودن فقط یک کشور با پایگاه کاربر، نمایش آن به کاربر اختیاری است. |
| ج.۶۵ | تبدیل وبسایت/تماس را ایجاد کنید و قطعه کد تولید کنید | ردیابی تبدیل | حداقل به یک نوع ردیابی تبدیل نیاز دارد. |
| ج.۹۷ | گزینه پیشنهاد قیمت را تنظیم کنید: ROAS هدف (پورتفولیو و استاندارد) | campaign.target_roas (استاندارد)bidding_strategy.target_roas (نمونه کارها) | الزامی. هر دو استراتژی پورتفولیو و استاندارد باید در سطح کمپین پشتیبانی شوند. |
| ج.۱۲۰ | بودجه تعیین کنید | campaign_budget | مورد نیاز |
| ج.۱۹۰ | ایجاد گروه تبلیغاتی | ad_group | الزامی. اختیاری: امکان ایجاد چندین گروه تبلیغاتی. |
| ج.۲۷۰ | کلمات کلیدی منفی کمپین را اضافه کنید | campaign_criterion.negative | مورد نیاز |
| سی.۳۰۰ | تنظیم نوع تطابق کلمه کلیدی | ad_group_criterion.keyword | مورد نیاز |
| سی.۵۰۵ | تنظیم شناسه فروشنده | | مورد نیاز |
| سی.۵۰۶ | کشور فروش را تنظیم کنید | | مورد نیاز |
| سی.۵۱۰ | تنظیم فیلتر موجودی | | مورد نیاز |
| سی.۵۲۰ | ایجاد تبلیغ محصول | | مورد نیاز |
| سی.۵۲۵ | اولین پارتیشن محصول (ریشه) را اضافه کنید | | مورد نیاز |
| سی.۵۳۰ | تبلیغات موجودی محلی ایجاد کنید | | مورد نیاز |
عملکرد مدیریت | |||
| م.10 | ویرایش تنظیمات کمپین | campaign.*setting | الزامی. فقط تنظیماتی که در زمان ایجاد لازم هستند، در زمان تغییر لازم خواهند بود. |
| م.97 | گزینه پیشنهاد قیمت را ویرایش کنید: هدف قرار دادن بازگشت سرمایه (نمونه کارها و استاندارد) | campaign.target_roas (استاندارد)bidding_strategy.target_roas (نمونه کارها) | الزامی. هر دو استراتژی پورتفولیو و استاندارد باید در سطح کمپین پشتیبانی شوند. |
| م.۱۱۰ | مکث/فعال/حذف کمپین | campaign.status | مورد نیاز |
| م.۱۵۰ | ویرایش فیلتر موجودی | | مورد نیاز |
| م.۱۶۰ | تقسیمبندی (اضافه کردن پارتیشن محصول) | | مورد نیاز |
| م.۱۷۰ | حذف پارتیشن محصول | | مورد نیاز |
| م.۱۹۰ | حذف پارتیشن محصول | | مورد نیاز |
عملکرد گزارشدهی | |||
| ۱۰ روپیه | مشتری | metrics.clicksmetrics.cost_microsmetrics.impressionsmetrics.conversion_value | الزامی. اختیاری اگر فقط یک کمپین را نشان میدهد. |
| ۲۰ راند | کمپین | metrics.clicksmetrics.cost_microsmetrics.impressionsmetrics.conversion_value | مورد نیاز |
| ۷۰ راند | نمایش عبارت جستجو | search_term_view.search_termsegments.search_term_match_typemetrics.clicksmetrics.cost_microsmetrics.impressions | مورد نیاز |
| ر.۱۱۰ | عملکرد خرید | metrics.clicksmetrics.cost_microsmetrics.impressionsmetrics.conversion_value | فقط در صورت پیادهسازی تبلیغات جستجوی پویا (Dynamic Search Ads) الزامی است. |
| ۱۲۰ راند | پارتیشن محصول | metrics.clicksmetrics.cost_microsmetrics.impressionsmetrics.conversion_value | الزامی. در صورت عدم تقسیمبندی محصولات، اختیاری است. |
| ۱۳۰ راند | عملکرد استراتژی پیشنهاد قیمت | | الزامی. در صورت عدم تقسیمبندی محصولات، اختیاری است. |
حداقل عملکرد مورد نیاز (RMF) به ویژگیها و سایر قابلیتهایی اشاره دارد که توسعهدهندگان ابزارهای خاص باید هنگام استفاده از API تبلیغات گوگل ارائه دهند. همانطور که در زیر آمده است، قوانین RMF به سه دسته تقسیم میشوند: عملکرد ایجاد، عملکرد مدیریت و عملکرد گزارشدهی. رعایت این قوانین توسط شما به نحوه استفاده شما از API تبلیغات گوگل بستگی دارد (عبارت "RMF اعمال میشود" به این معنی است که RMF برای شما اعمال میشود):
| قابلیت ایجاد | عملکرد مدیریت | عملکرد گزارشدهی | |
|---|---|---|---|
ابزار کامل
| RMF اعمال میشود | RMF اعمال میشود | RMF اعمال میشود |
فقط گزارش
| RMF اعمال نمیشود | RMF اعمال نمیشود | RMF اعمال میشود |
فقط برای استفاده داخلی
| RMF اعمال نمیشود | RMF اعمال نمیشود | RMF اعمال نمیشود |
اگر ابزار شما قابلیتهای بسیار محدود و تخصصی ارائه میدهد و نمیتوان از آن برای ایجاد و مدیریت کمپینها، گروههای تبلیغاتی و تبلیغات استفاده کرد، ممکن است واجد شرایط یک ابزار با خدمات کامل نباشد. در این صورت، RMF ایجاد و مدیریت اعمال نمیشود. اگر مطمئن نیستید که آیا سیاست RMF برای ابزار شما اعمال میشود یا خیر، با تیم انطباق با API تبلیغات گوگل تماس بگیرید . تیم انطباق با API تبلیغات گوگل تصمیم خواهد گرفت که آیا ابزار شما خدمات کامل دارد یا خیر. در صورت تغییر قابل توجه عملکرد، ابزار شما ممکن است دوباره ارزیابی شود.
توجه داشته باشید که RMF فقط برای توکنهای توسعهدهندگان با سطح دسترسی استاندارد اعمال میشود.
افزونه یکبار مصرف برای بهروزرسانیهای عمده
با توجه به این واقعیت که ابزارهای API ممکن است به صورت دورهای ارتقاءهای گسترده فناوری را انجام دهند، ابزارهایی که حداقل به مدت ۲ سال متوالی تمام مهلتهای RMF را رعایت کردهاند، میتوانند برای اجرای چنین ارتقاءهایی در پلتفرم خود، درخواست تمدید ۶ ماهه RMF بدهند. در صورت اعطای تمدید، در طول دوره تمدید، این ابزارها از نظر انطباق با الزامات RMF بررسی نخواهند شد. در پایان دوره تمدید، ابزار باید کاملاً با تمام الزامات RMF که در آخرین تاریخ دوره تمدید یا قبل از آن مهلت داشتند، مطابقت داشته باشد. تمام الزامات RMF که پس از پایان تمدید مهلت دارند، در تاریخ مشخص شده در جدول زیر سررسید خواهند شد.
یک ابزار API میتواند حداکثر هر چهار سال یک بار تمدید شود (تمدید دوم باید حداقل ۴ سال پس از پایان تمدید اول آغاز شود).
اگر مایل به درخواست تمدید برای ابزار خود هستید، با تماس با ما از طریق آدرس https://support.google.com/adspolicy/contact/contact_ads_api فرم درخواست را درخواست کنید. درخواست شما باید توسط یکی از مدیران اجرایی (مدیر عامل، مدیر ارشد فناوری یا معاون ارشد) شرکت شما امضا و ارسال شود. توجه داشته باشید که تضمینی برای تأیید درخواست شما وجود ندارد.
الزامات مربوط به ابزارهای API مخصوص خرید، مخصوص تبلیغات اپلیکیشن و مخصوص هتل
اگر ابزار شما فقط برای ایجاد و مدیریت یکی از انواع کمپینهای زیر طراحی شده است، فقط لازم است ویژگیها و گزارشهای ایجاد و مدیریت API تبلیغات گوگل را در RMF پیادهسازی کنید که با آن نوع کمپین کار میکنند.
- کمپین تبلیغاتی اپلیکیشن
- کمپینهای هتل ( فقط در API تبلیغات گوگل موجود است )
- کمپینهای Performance Max ( فقط در API تبلیغات گوگل موجود است )
- کمپینهای هوشمند ( فقط در API تبلیغات گوگل موجود است )
- کمپینهای خرید استاندارد
الزامات مربوط به کلاینتهای API تبلیغات گوگل که فقط گزارش میدهند
برای مطابقت با الزامات RMF، یک کلاینت API تبلیغات گوگل که فقط برای گزارشدهی طراحی شده است، باید قابلیت گزارشدهی را برای هر یک از سطوح سلسله مراتب تبلیغات گوگل که در رابط گزارشدهی آن نمایش داده میشود، نشان دهد. منظور از سطح سلسله مراتب تبلیغات گوگل، یکی از سطوح حساب، کمپین، گروه تبلیغاتی، تبلیغ یا کلمه کلیدی است. به عنوان مثال، اگر یک کلاینت تبلیغات گوگل که فقط برای گزارشدهی طراحی شده است، گروههای تبلیغاتی را نشان دهد، باید تمام قابلیتهای گزارشدهی سطح «گروه تبلیغاتی» را که در زیر با عنوان «الزامی» مشخص شده است، پیادهسازی کند.
یک کلاینت API تبلیغات گوگل که فقط گزارش میدهد، میتواند سطوح خاصی از سلسله مراتب تبلیغات گوگل را در رابط گزارشدهی خود نشان ندهد. برای مثال، اگر یک کلاینت API تبلیغات گوگل که فقط گزارش میدهد، هیچ داده عملکرد گروه تبلیغاتی را در رابط خود نشان ندهد، نیازی به پیادهسازی هیچ یک از RMFهای گزارشدهی سطح «گروه تبلیغاتی» ندارد.
سیاست فوق در مورد سایر انواع گزارشها نیز اعمال میشود، اگرچه آنها سطوح سلسله مراتب گوگل ادز نیستند. در صورت تمایل به پیادهسازی هر یک از این گزارشها، باید تمام فیلدهای مورد نیاز برای هر گزارش مربوطه را نمایش دهید.
برای انطباق با الزامات RMF، کلاینت API تبلیغات گوگل باید تمام ستونهای علامتگذاری شده در ستون Object/Field/Guide را برای هر گزارش، به صورت پیشفرض نمایش دهد. سایر ستونهای معیار باید به عنوان یک گزینه برای کاربران کلاینت API تبلیغات گوگل در دسترس قرار گیرند. دادههای گزارش تبلیغات گوگل باید به طور معقولی برجسته و برای کاربران نهایی قابل دسترسی باشند.
گزارشهای قابل دانلود
اگر ابزار شما به جای نمایش قابلیت گزارشگیری در رابط کاربری، گزینه دانلود، مثلاً CSV، را ارائه میدهد، لینک دانلود باید به طور برجسته نمایش داده شود و به طور شهودی برچسبگذاری شود. فایل دانلود شده باید شامل تمام فیلدهای گزارشدهی مورد نیاز باشد و به وضوح برچسبگذاری شود.
محدودههای تاریخ گزارش
توصیه میکنیم به کاربران اجازه دهید دادههای گزارش را بر اساس محدوده تاریخ فیلتر کنند. اگر ابزار شما از محدودههای تاریخ سفارشی پشتیبانی نمیکند، حداقل باید دادههای 30 روز گذشته را برای هر فیلد گزارش مورد نیاز ارائه دهد.
الزامات مربوط به کلاینتهای API که قابلیت ایجاد یا قابلیت مدیریت را ارائه میدهند
برای مطابقت با الزامات RMF، یک کلاینت API تبلیغات گوگل با سرویس کامل باید تمام ویژگیهای ایجاد و مدیریت مورد نیاز در جدول زیر را پیادهسازی کند و قابلیت گزارشدهی را برای هر یک از گزارشهای زیر نشان دهد. علاوه بر این، شما باید تلاش معقولی انجام دهید تا اطمینان حاصل کنید که هر یک از ویژگیها به راحتی در دسترس و برای تبلیغکنندگان نهایی، بر اساس میزان استفاده از آن ویژگیها، کاربردی هستند.
الزامات مربوط به مشتریان API که خدمات برنامهریزی ارائه میدهند
اگر یک کلاینت API گوگل ادز هرگونه قابلیتی مربوط به KeywordPlanIdeaService یا KeywordPlanService را ارائه دهد، باید قابلیت ایجاد، قابلیت مدیریت و قابلیت گزارشدهی مورد نیاز که در جدول زیر با عنوان «الزامی» مشخص شدهاند را بهطور کامل پیادهسازی کند.
الزامات مربوط به مشتریان API که خدمات توصیه ارائه میدهند
همه کلاینتهای API مجاز به استفاده از GoogleAdsService و RecommendationService برای بازیابی توصیهها هستند.
استفاده از RecommendationService.ApplyRecommendation() و RecommendationService.DismissRecommendation() به انواع زیر از کلاینتهای API گوگل ادز محدود میشود:
- ابزارهای کامل
- ابزارهای داخلی
- ابزارهای API مخصوص خرید، فقط خرید هوشمند/پرفورمنس مکس، فقط تبلیغات اپلیکیشن و فقط هتل
- ابزارهای ویژه که قابلیت مدیریت کمپین را ارائه میدهند
اگر یک کلاینت API گوگل ادز قابلیت اعمال یا رد توصیهها با استفاده از RecommendationService را ارائه دهد، باید الزامات زیر را برآورده کند:
- باید به طور کامل قابلیتهای ایجاد، مدیریت و گزارشدهی مورد نیاز را برای دسته ابزار خود پیادهسازی کند.
- تمام توصیههای گوگل ادز که به کاربران نهایی نشان داده میشود، باید در رابط کاربری ابزار به عنوان «توصیههای گوگل ادز» ارائه شوند.
- کاربران نهایی باید بتوانند تمام توصیههای گوگل ادز که توسط کلاینت API گوگل ادز ارائه میشوند را مشاهده و اعمال کنند.
الزامات تعدیل پیشنهاد قیمت
تمام کلاینتهای API که قابلیت ایجاد یا مدیریت را ارائه میدهند، باید الزامات زیر را در رابطه با تنظیمات پیشنهاد قیمت برآورده کنند:
- کاربران نهایی باید مجاز به وارد کردن کل محدوده مقادیر مجاز باشند.
- کاربران نهایی باید بتوانند تنظیمات پیشنهاد قیمت را قبل از اینکه توسط Google Ads API Client تنظیم شود، بررسی و ویرایش کنند.
- تعدیلات پیشنهاد قیمت باید فقط به عنوان تعدیلاتی در پیشنهادها ارائه شوند و نمیتوانند برای فعال کردن یا تقریب سایر ویژگیها، مانند هدفگذاری یا حذف، استفاده شوند.
پیادهسازی ویژگی
مگر اینکه در زیر طور دیگری مشخص شده باشد، یک ویژگی تنها در صورتی پیادهسازی میشود که تمام زیرویژگیها و پارامترهای موجود نیز پیادهسازی شوند. مرجع API، پارامترها و زیرویژگیهای موجود را مستند میکند. به عنوان مثال، ویژگی "ورود/خروج از شبکهها" به معنای پشتیبانی از ورود/خروج از جستجوی گوگل، شرکای جستجو و شبکه نمایش است. علاوه بر این، اگر در Google Ads API Client خود ویژگیای مشابه هر ویژگی که مورد نیاز گوگل نیست را پیادهسازی کنید، باید ویژگی مشابه گوگل را در Google Ads API Client خود نیز پیادهسازی کنید. به عنوان مثال، اگر نسخه شخصی خود از "Keyword Ideas" را در Google Ads API Client خود پیادهسازی میکنید، باید عملکرد "Keyword Ideas" گوگل را نیز در Google Ads API Client خود پیادهسازی کنید.
برای حفظ انطباق با RMF، هرگونه ویژگی جدید مورد نیاز باید تا تاریخ سررسید (که در کنار هر ویژگی با عنوان سررسید: YYYY-MM-DD نشان داده شده است) اضافه شود. هرگونه RMF که تاریخ سررسید مشخصی نداشته باشد، سررسید گذشته محسوب میشود. علاوه بر این، ما از شما میخواهیم که حداقل دو هفته قبل از اعمال این تغییرات، با استفاده از فرم تغییر ابزار، اسکرینشاتها و/یا ماکتهایی از تغییرات پیشنهادی را برای Google Ads API Client ارسال کنید. برای شفافسازی، پس از گذشت این دوره دو هفتهای، نیازی نیست قبل از اعمال این تغییرات اساسی، منتظر پاسخی از گوگل باشید.
فهرست ویژگیهای ابزار کامل
| شماره کالا | عملکرد | شیء/زمینه/راهنما | مورد نیاز | ||||||||||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
قابلیت ایجاد | |||||||||||||||||||||||||||||||||||
| ج.10 | ایجاد کمپین | campaign | مورد نیاز | ||||||||||||||||||||||||||||||||
| ج.20 | فعال کردن هدفگیری جغرافیایی | هدفگذاری مکانی | الزامی. در صورت مرتبط بودن فقط یک کشور با پایگاه کاربر، نمایش آن به کاربر اختیاری است. | ||||||||||||||||||||||||||||||||
| ج.30 | فعال کردن هدفگیری زبانی | campaign_criterion.language | الزامی. در صورت نیاز به نمایش فقط یک زبان برای کاربر، اختیاری است. | ||||||||||||||||||||||||||||||||
| ج.۶۵ | تبدیل وبسایت/تماس را ایجاد کنید و قطعه کد تولید کنید | ردیابی تبدیل | حداقل به یک نوع ردیابی تبدیل نیاز دارد. | ||||||||||||||||||||||||||||||||
| ج.۷۵ | افزونههای فراخوان | محل قرارگیری فید فراخوان خدمات تنظیم افزونه خدمات تغذیه | الزامی. این مورد فقط باید در سطح حساب کاربری پشتیبانی شود. | ||||||||||||||||||||||||||||||||
| ج.۹۶ | گزینه پیشنهاد قیمت را تنظیم کنید: CPA هدف (پورتفولیو و استاندارد) | campaign.target_cpa (استاندارد)bidding_strategy.target_cpa (نمونه کارها) | الزامی. هر دو استراتژی پورتفولیو و استاندارد باید در سطح کمپین پشتیبانی شوند. | ||||||||||||||||||||||||||||||||
| ج.۹۷ | گزینه پیشنهاد قیمت را تنظیم کنید: ROAS هدف (پورتفولیو و استاندارد) | campaign.target_roas (استاندارد)bidding_strategy.target_roas (نمونه کارها) | الزامی. هر دو استراتژی پورتفولیو و استاندارد باید در سطح کمپین پشتیبانی شوند. | ||||||||||||||||||||||||||||||||
| ج.۹۸ | تنظیم گزینه پیشنهاد قیمت: حداکثر کردن تبدیلها (استاندارد) | campaign.maximize_conversions (استاندارد) | مورد نیاز | ||||||||||||||||||||||||||||||||
| ج.۱۲۰ | بودجه تعیین کنید | campaign_budget | مورد نیاز | ||||||||||||||||||||||||||||||||
| ج.۱۹۰ | ایجاد گروه تبلیغاتی | ad_group | الزامی. اختیاری: امکان ایجاد چندین گروه تبلیغاتی. | ||||||||||||||||||||||||||||||||
| ج.۲۶۰ | اضافه کردن کلمه کلیدی | ad_group_criterion.keyword | مورد نیاز | ||||||||||||||||||||||||||||||||
| ج.۲۷۰ | کلمات کلیدی منفی کمپین را اضافه کنید | campaign_criterion.negative | مورد نیاز | ||||||||||||||||||||||||||||||||
| سی.۳۰۰ | تنظیم نوع تطابق کلمه کلیدی | ad_group_criterion.keyword | مورد نیاز | ||||||||||||||||||||||||||||||||
عملکرد مدیریت م.10 | ویرایش تنظیمات کمپین | | campaign.*setting الزامی. فقط تنظیماتی که در زمان ایجاد لازم هستند، در زمان تغییر لازم خواهند بود. | م.96 | گزینه پیشنهاد قیمت را ویرایش کنید: CPA هدف (پورتفولیو و استاندارد) | | campaign.target_cpa (استاندارد)bidding_strategy.target_cpa (نمونه کارها) الزامی. هر دو استراتژی پورتفولیو و استاندارد باید در سطح کمپین پشتیبانی شوند. | م.97 | گزینه پیشنهاد قیمت را ویرایش کنید: هدف قرار دادن بازگشت سرمایه (نمونه کارها و استاندارد) | | campaign.target_roas (استاندارد)bidding_strategy.target_roas (نمونه کارها) الزامی. هر دو استراتژی پورتفولیو و استاندارد باید در سطح کمپین پشتیبانی شوند. | م.98 | گزینه پیشنهاد قیمت را ویرایش کنید: حداکثر کردن تبدیلها (استاندارد) | | campaign.maximize_conversions (استاندارد) مورد نیاز | م.۱۱۰ | مکث/فعال/حذف کمپین | | campaign.status مورد نیاز | م.۱۳۰ | مکث / فعال / حذف تبلیغ | | ad_group_ad.status مورد نیاز | م.۱۴۰ | مکث/فعال کردن/حذف کلمه کلیدی | | ad_group_criterion.status مورد نیاز | عملکرد گزارشدهی | |||||||
| ۱۰ روپیه | مشتری | metrics.clicksmetrics.cost_microsmetrics.impressionsmetrics.conversionsmetrics.all_conversions | مورد نیاز | ||||||||||||||||||||||||||||||||
| ۲۰ راند | کمپین | metrics.clicksmetrics.cost_microsmetrics.impressionsmetrics.conversionsmetrics.all_conversions | مورد نیاز | ||||||||||||||||||||||||||||||||
campaign.status | در صورت نمایش کمپینهای متوقفشده، فعال و حذفشده، الزامی است. اختیاری است اگر فقط کمپینهای فعال را نشان دهد. | ||||||||||||||||||||||||||||||||||
| ۴۰ راند | تبلیغ گروه تبلیغاتی | metrics.clicksmetrics.cost_microsmetrics.impressionsmetrics.conversions | مورد نیاز | ||||||||||||||||||||||||||||||||
ad_group_ad.status | در صورت نمایش تبلیغات متوقف شده، فعال و حذف شده، الزامی است. اختیاری اگر فقط تبلیغات فعال را نشان میدهد. | ||||||||||||||||||||||||||||||||||
| ۵۰ راند | مشاهده کلمات کلیدی | metrics.clicksmetrics.cost_microsmetrics.impressionsmetrics.conversionsad_group_criterionad_group_criterion | مورد نیاز | ||||||||||||||||||||||||||||||||
ad_group_criterion.status | در صورت نمایش کلمات کلیدی متوقف شده، فعال و حذف شده، الزامی است. اختیاری است اگر فقط کلمات کلیدی فعال را نشان دهد. | ||||||||||||||||||||||||||||||||||
| ۷۰ راند | نمایش عبارت جستجو | search_term_view.search_termsegments.search_term_match_typemetrics.clicksmetrics.cost_microsmetrics.impressions | مورد نیاز | ||||||||||||||||||||||||||||||||
| ۱۰۰ راند | نمایش عبارت جستجو در تبلیغات جستجوی پویا | dynamic_search_ads_search_term_view.search_termmetrics.clicksmetrics.cost_microsmetrics.impressionsmetrics.conversions | فقط در صورت پیادهسازی تبلیغات جستجوی پویا (Dynamic Search Ads) الزامی است. | ||||||||||||||||||||||||||||||||
| ۱۳۰ راند | استراتژی پیشنهاد قیمت | bidding_strategy.typemetrics.clicksmetrics.cost_microsmetrics.cost_per_conversionmetrics.impressionsmetrics.average_cpcmetrics.conversions | مورد نیاز | ||||||||||||||||||||||||||||||||
bidding_strategy.status | در صورت نمایش استراتژیهای متوقفشده، فعال و حذفشده، الزامی است. اختیاری است اگر فقط استراتژیهای فعال را نشان دهد. | ||||||||||||||||||||||||||||||||||
فهرست ویژگیهای ابزار کمپین اپلیکیشن
| شماره کالا | عملکرد | شیء/زمینه/راهنما | مورد نیاز |
|---|---|---|---|
قابلیت ایجاد | |||
| ج.۲۰ | فعال کردن هدفگیری جغرافیایی | هدفگذاری مکانی | الزامی. در صورت مرتبط بودن فقط یک کشور با پایگاه کاربر، نمایش آن به کاربر اختیاری است. |
| ج.30 | فعال کردن هدفگیری زبانی | campaign_criterion.language | الزامی. در صورت نیاز به نمایش فقط یک زبان برای کاربر، اختیاری است. |
| ج.۶۵ | Create website / call conversion and generate code snippet | Conversion Tracking | Required at least one type of conversion tracking. |
| C.96 | Set bidding option: Target CPA (Portfolio and Standard) | campaign.target_cpa (Standard)bidding_strategy.target_cpa (Portfolio) | Required. Both the Portfolio and Standard strategies need to be supported at the campaign level. |
| Set bidding option: Pre-reg | App ads for pre-registration | Required for app campaigns for pre-registration. | |
| C.190 | Create ad group | ad_group | Required. Optional: ability to create multiple ad groups. |
| Add assets to ad group | ad_group | Required: text assets. Optional for image and video assets. | |
| C.601 | Create install or re-engagement app campaigns | | Required: app campaign install or app campaign re-engagement but not both. |
| C.602 | Enable app campaign settings | AppCampaignSetting | Required: ability to select the app to be advertised or add deep links for engagement. |
Management Functionality | |||
| M.601 | Pause / enable / remove app campaign | campaign.status | مورد نیاز |
| M.602 | Edit app campaign settings | campaign.*setting | مورد نیاز |
Reporting Functionality | |||
| R.10 | Account performance | metrics.clicksmetrics.cost_microsmetrics.impressionsmetrics.conversionsmetrics.all_conversions | مورد نیاز |
| R.20 | عملکرد کمپین | metrics.clicksmetrics.cost_microsmetrics.impressionsmetrics.conversionsmetrics.all_conversions | Required if showing paused, active, and removed campaigns. Optional if only showing active campaigns. |
Hotel-only Tool Feature List
| Item Number | عملکرد | Object/Field/Guide | مورد نیاز |
|---|---|---|---|
Creation Functionality | |||
| C.11 | Create hotel campaign | hotel campaign | مورد نیاز |
| C.12 | Set Hotel Center identifier for hotel campaign | HotelSettingInfo | مورد نیاز |
| C.20 | Enable geo targeting | Location Targeting | Required Optional to expose to the user if only one country is relevant for the user base. |
| C.30 | Enable language targeting | campaign_criterion.language | Required. Optional to expose to the user if only one language is relevant for the user base. |
| C.65 | Create website / call conversion and generate code snippet | Conversion Tracking | Required at least one type of conversion tracking. |
| C.120 | بودجه تعیین کنید | campaign_budget | مورد نیاز |
| Set bidding strategy | Hotel Bidding | Optional to allow the user to choose a specific bidding strategy and set a target. | |
| C.190 | Create hotel ad group | ad_group | Required. Optional: ability to create multiple Ad groups. |
| C.526 | Add first (root) partition hotel group partition | hotel listing groups | Required for Hotel Ads campaign to run, but not required to be exposed to the user. |
Management Functionality | |||
| M.10 | Edit campaign settings | campaign.*setting | مورد نیاز |
| M.110 | Pause / enable / remove campaign | campaign.status | مورد نیاز |
| M.161 | Subdivide (add hotel group partition) | hotel listing groups | مورد نیاز |
| M.191 | Exclude hotel group | AdGroupCriterion | مورد نیاز |
Reporting Functionality | |||
| R.10 | Account performance | metrics.clicksmetrics.cost_microsmetrics.impressionsmetrics.conversionsmetrics.all_conversions | مورد نیاز |
| R.20 | عملکرد کمپین | metrics.clicksmetrics.cost_microsmetrics.impressionsmetrics.conversionsmetrics.all_conversions | Required if showing paused, active, and removed campaigns. Optional if only showing active campaigns. |
| R.111 | Hotel Performance View report | hotel_performance_view | مورد نیاز |
Performance Max Campaign Feature List
| Item Number | عملکرد | Object/Field/Guide | مورد نیاز |
|---|---|---|---|
Creation Functionality | |||
| C.10 | Create campaign | campaign | Required. Optional: ability to create multiple campaigns. |
| C.20 | Enable geo targeting | Location Targeting | Required. Optional to expose to the user if only one country is relevant for the user base. |
| C.30 | Enable language targeting | campaign_criterion.language | Required. Optional to expose to the user if only one language is relevant for the user base. |
| C.65 | Create website / call conversion and generate code snippet | Conversion Tracking | Required at least one type of conversion tracking. |
| C.120 | بودجه تعیین کنید | campaign_budget | مورد نیاز |
| Set bidding strategy | Optional to allow the user to choose a specific bidding strategy and set a target. | ||
Management Functionality | |||
| M.10 | Edit campaign settings | campaign.*setting | Required. Only settings required at creation time would be required at change time. |
| M.110 | Pause / enable / remove campaign | campaign.status | مورد نیاز |
Reporting Functionality | |||
| R.10 | مشتری | metrics.clicksmetrics.cost_microsmetrics.conversions | Required. Optional if only showing only one campaign. |
| R.20 | کمپین | metrics.clicksmetrics.cost_microsmetrics.conversions | مورد نیاز |
Smart Campaign Feature List
The following table defines the minimum set of functionality required to implement Smart Campaigns . If your tool implements Smart Campaigns at all, you must implement at minimum this set of features. If your tool does not implement Smart Campaigns, then these features are not required.
| Item Number | عملکرد | Object/Field/Guide | مورد نیاز |
|---|---|---|---|
Creation Functionality | |||
| C.10 | Create Smart Campaign | Smart Campaign | مورد نیاز |
| Add keyword theme | KeywordThemeInfo | Required for campaign creation, but optional to expose to the user. | |
| C.20 | Enable geo targeting | Location Targeting | Required for campaign creation, but optional to expose to the user. |
| C.70 | Location assets | Location assets | Required only if integrating with a Business Profile . |
| C.120 | بودجه تعیین کنید | campaign_budget | مورد نیاز |
| C.200 | اضافه کردن آگهی | ایجاد آگهی | Required for campaign creation, but optional to expose to the user. |
Management Functionality | |||
| M.10 | Edit campaign settings (all campaign-creation settings displayed to advertiser) | campaign.*setting | مورد نیاز |
| M.110 | Pause / enable / remove campaign | campaign.status | مورد نیاز |
| M.130 | Pause / enable / remove ad | ad_group_ad.status | مورد نیاز |
| Set / Edit Campaign schedule | ad_schedule | مورد نیاز | |
| Remove / Add keyword theme | KeywordThemeInfo | Required for campaign creation, but optional to expose to the user. | |
| Add/Remove Negative Keyword Theme | KeywordThemeInfo | Required for campaign creation, but optional to expose to the user. | |
Reporting Functionality | |||
| R.20 | عملکرد کمپین | metrics.clicksmetrics.cost_microsmetrics.impressionsmetrics.conversionsmetrics.all_conversions | Required if showing paused, active, and removed campaigns. Optional if only showing active campaigns. |
SMART_CAMPAIGN_MAP_CLICKS_TO_CALLSMART_CAMPAIGN_MAP_DIRECTIONS | Required only if integrating with a Business Profile . | ||
| R.70 | Smart Campaign Search Term View | metrics.clicksmetrics.cost_micros | مورد نیاز |
Standard Shopping Campaign Tool Feature List
| Item Number | عملکرد | Object/Field/Guide | مورد نیاز |
|---|---|---|---|
Creation Functionality | |||
| C.10 | Create campaign | campaign | مورد نیاز |
| C.20 | Enable geo targeting | Location Targeting | Required. Optional to expose to the user if only one country is relevant for the user base. |
| C.65 | Create website / call conversion and generate code snippet | Conversion Tracking | Required at least one type of conversion tracking. |
| C.97 | Set bidding option: Target ROAS (Portfolio and Standard) | campaign.target_roas (Standard)bidding_strategy.target_roas (Portfolio) | Required. Both the Portfolio and Standard strategies need to be supported at the campaign level. |
| C.120 | بودجه تعیین کنید | campaign_budget | مورد نیاز |
| C.190 | Create ad group | ad_group | Required. Optional: ability to create multiple Ad groups. |
| C.270 | Add campaign negative keywords | campaign_criterion.negative | مورد نیاز |
| C.300 | Set keyword match type | ad_group_criterion.keyword | مورد نیاز |
| C.505 | Set merchant identifier | | مورد نیاز |
| C.506 | Set sales country | | مورد نیاز |
| C.510 | Set inventory filter | | مورد نیاز |
| C.520 | Create product ad | | مورد نیاز |
| C.525 | Add first (root) product partition | | مورد نیاز |
| C.530 | Create local inventory ads | | مورد نیاز |
Management Functionality | |||
| M.10 | Edit campaign settings | campaign.*setting | Required. Only settings required at creation time would be required at change time. |
| M.97 | Edit bidding option: Target ROAS (Portfolio and Standard) | campaign.target_roas (Standard)bidding_strategy.target_roas (Portfolio) | Required. Both the Portfolio and Standard strategies need to be supported at the campaign level. |
| M.110 | Pause / enable / remove campaign | campaign.status | مورد نیاز |
| M.150 | Edit inventory filter | | مورد نیاز |
| M.160 | Subdivide (add product partition) | | مورد نیاز |
| M.170 | Delete product partition | | مورد نیاز |
| M.190 | Exclude product partition | | مورد نیاز |
Reporting Functionality | |||
| R.10 | مشتری | metrics.clicksmetrics.cost_microsmetrics.impressionsmetrics.conversion_value | Required. Optional if only showing only one campaign. |
| R.20 | کمپین | metrics.clicksmetrics.cost_microsmetrics.impressionsmetrics.conversion_value | مورد نیاز |
| R.70 | Search Term View | search_term_view.search_termsegments.search_term_match_typemetrics.clicksmetrics.cost_microsmetrics.impressions | مورد نیاز |
| R.110 | Shopping performance | metrics.clicksmetrics.cost_microsmetrics.impressionsmetrics.conversion_value | Required only if implementing Dynamic Search Ads. |
| R.120 | Product partition | metrics.clicksmetrics.cost_microsmetrics.impressionsmetrics.conversion_value | Required. Optional if products not subdivided |
| R.130 | Bidding strategy performance | | Required. Optional if products not subdivided |