Package google.ads.searchads360.v0.common

فهرست

• AdScheduleInfo (پیام)
• AdTextAsset (پیام)
• AgeRangeInfo (پیام)
• AssetInteractionTarget (پیام)
• AssetUsage (پیام)
• AudienceInfo (پیام)
• BusinessProfileLocation (پیام)
• CallToActionAsset (پیام)
• CustomParameter (پیام)
• DeviceInfo (پیام)
• پیام EnhancedCpc
• FinalAppUrl (پیام)
• FrequencyCapEntry (پیام)
• GenderInfo (پیام)
• ImageAsset (پیام)
• ImageDimension (پیام)
• Keyword (پیام)
• KeywordInfo (پیام)
• LanguageInfo (پیام)
• ListingGroupInfo (پیام)
• LocationGroupInfo (پیام)
• LocationInfo (پیام)
• ManualCpa (پیام)
• پیام ManualCpc (Cpc)
• ManualCpm (پیام)
• MaximizeConversionValue (پیام)
• MaximizeConversions (پیام)
• Metrics (پیام)
• MobileAppAsset (پیام)
• PercentCpc (پیام)
• RealTimeBiddingSetting (پیام)
• SearchAds360ExpandedDynamicSearchAdInfo (پیام)
• SearchAds360ExpandedTextAdInfo (پیام)
• SearchAds360ProductAdInfo (پیام)
• SearchAds360ResponsiveSearchAdInfo (پیام)
• SearchAds360TextAdInfo (پیام)
• Segments (پیام)
• TargetCpa (پیام)
• TargetCpm (پیام)
• TargetImpressionShare (پیام)
• TargetOutrankShare (پیام)
• TargetRestriction (پیام)
• TargetRoas (پیام)
• TargetSpend (پیام)
• TargetingSetting (پیام)
• TextAsset (پیام)
• TextLabel (پیام)
• UnifiedCallAsset (پیام)
• UnifiedCalloutAsset (پیام)
• UnifiedLocationAsset (پیام)
• UnifiedPageFeedAsset (پیام)
• UnifiedSitelinkAsset (پیام)
• UserListInfo (پیام)
• Value (پیام)
• WebpageConditionInfo (پیام)
• WebpageInfo (پیام)
• YoutubeVideoAsset (پیام)

اطلاعات برنامه تبلیغات

نشان دهنده یک معیار AdSchedule است.

AdSchedule به عنوان روز هفته و بازه زمانی که تبلیغات در آن نمایش داده می‌شوند، مشخص می‌شود.

بیش از شش AdSchedule را نمی‌توان برای یک روز اضافه کرد.

فیلدها
start_minute	MinuteOfHour دقایقی پس از ساعت شروعی که این برنامه از آن شروع می‌شود. این فیلد برای عملیات CREATE الزامی است و در عملیات UPDATE ممنوع است.
end_minute	MinuteOfHour دقایقی پس از ساعت پایانی که این برنامه در آن به پایان می‌رسد. این برنامه بدون احتساب دقیقه پایانی است. این فیلد برای عملیات CREATE الزامی است و در عملیات UPDATE ممنوع است.
day_of_week	DayOfWeek روز هفته‌ای که برنامه مربوط به آن است. این فیلد برای عملیات CREATE الزامی است و در عملیات UPDATE ممنوع است.
start_hour	int32 ساعت شروع به صورت ۲۴ ساعته. این فیلد باید بین ۰ تا ۲۳ باشد. این فیلد برای عملیات CREATE الزامی است و در عملیات UPDATE ممنوع است.
end_hour	int32 ساعت پایان در زمان ۲۴ ساعته؛ عدد ۲۴ به معنای پایان روز است. این فیلد باید بین ۰ تا ۲۴ باشد. این فیلد برای عملیات CREATE الزامی است و در عملیات UPDATE ممنوع است.

دارایی متن تبلیغاتی

یک متن که درون یک تبلیغ استفاده می‌شود.

فیلدها
text	string متن دارایی.

اطلاعات محدوده سنی

معیار محدوده سنی.

فیلدها
type	AgeRangeType نوع محدوده سنی.

هدف تعامل دارایی

یک بخش AssetInteractionTarget.

فیلدها
asset	string نام منبع دارایی.
interaction_on_this_asset	bool فقط با معیارهای CustomerAsset، CampaignAsset و AdGroupAsset استفاده می‌شود. نشان می‌دهد که آیا معیارهای تعامل روی خود دارایی رخ داده است یا روی یک دارایی یا واحد تبلیغاتی متفاوت.

میزان استفاده از دارایی

شامل اطلاعات مربوط به نحوه استفاده از دارایی است.

فیلدها
asset	string نام منبع دارایی.
served_asset_field_type	ServedAssetFieldType نوع فیلد ارائه شده از دارایی.

اطلاعات مخاطب

معیار مخاطب.

فیلدها
audience	string نام منبع مخاطب.

مشخصات کسب و کارموقعیت مکانی

داده‌های مکان نمایه کسب‌وکار از حساب نمایه کسب‌وکار مرتبط همگام‌سازی شده‌اند.

فیلدها
labels[]	string برچسب مشخص‌شده توسط تبلیغ‌کننده برای مکان در حساب نمایه کسب‌وکار. این برچسب از حساب نمایه کسب‌وکار همگام‌سازی می‌شود.
store_code	string کد فروشگاه نمایه تجاری این مکان. این کد از حساب نمایه تجاری همگام‌سازی شده است.
listing_id	int64 شناسه فهرست این مکان نمایه کسب‌وکار. این از حساب نمایه کسب‌وکار مرتبط همگام‌سازی شده است.

دارایی فراخوان عمل

یک ابزار فراخوان برای اقدام.

فیلدها
call_to_action	CallToActionType فراخوان برای اقدام.

پارامتر سفارشی

نگاشتی که می‌تواند توسط تگ‌های پارامتر سفارشی در tracking_url_template ، final_urls یا mobile_final_urls استفاده شود.

فیلدها
key	string کلیدی که با نام تگ پارامتر مطابقت دارد.
value	string مقداری که قرار است جایگزین شود.

اطلاعات دستگاه

معیار دستگاه.

فیلدها
type	Device نوع دستگاه.

پیشرفتهCpc

این نوع هیچ فیلدی ندارد.

یک استراتژی پیشنهاد قیمت خودکار که پیشنهادها را برای کلیک‌هایی که به نظر می‌رسد احتمال بیشتری برای تبدیل شدن به مشتری دارند، افزایش می‌دهد و برای کلیک‌هایی که احتمال کمتری دارند، آنها را کاهش می‌دهد.

این استراتژی پیشنهاد قیمت منسوخ شده است و دیگر نمی‌توان آن را ایجاد کرد. برای عملکرد معادل، از ManualCpc با enhanced_cpc_enabled که روی true تنظیم شده است، استفاده کنید.

FinalAppUrl

یک URL برای لینک‌دهی عمیق به یک برنامه برای سیستم عامل مورد نظر.

فیلدها
os_type	AppUrlOperatingSystemType سیستم عامل مورد نظر این URL. الزامی.
url	string آدرس اینترنتی پیوند عمیق برنامه. پیوندهای عمیق، مکانی را در برنامه مشخص می‌کنند که با محتوایی که می‌خواهید نمایش دهید مطابقت دارد و باید به شکل {scheme}://{host_path} باشد. این طرح مشخص می‌کند کدام برنامه باز شود. برای برنامه خود، می‌توانید از یک طرح سفارشی که با نام برنامه شروع می‌شود استفاده کنید. میزبان و مسیر، مکان منحصر به فردی را در برنامه که محتوای شما در آن وجود دارد، مشخص می‌کنند. مثال: "exampleapp://productid_1234". الزامی.

ورودی با محدودیت فرکانس

این نوع هیچ فیلدی ندارد.

قانونی که حداکثر تعداد دفعاتی را که یک تبلیغ (یا مجموعه‌ای از تبلیغات) می‌تواند در یک بازه زمانی خاص به کاربر نمایش داده شود، مشخص می‌کند.

اطلاعات جنسیتی

معیار جنسیتی.

فیلدها
type	GenderType نوع جنسیت.

تصویر دارایی

یک دارایی تصویری.

فیلدها
mime_type	MimeType نوع MIME مربوط به تصویر.
full_size	ImageDimension فراداده برای این تصویر در اندازه اصلی آن.
file_size	int64 اندازه فایل تصویر به بایت.

ابعاد تصویر

فراداده برای یک تصویر در اندازه مشخص، چه تصویر اصلی و چه تصویر تغییر اندازه داده شده.

فیلدها
height_pixels	int64 ارتفاع تصویر.
width_pixels	int64 عرض تصویر.
url	string یک URL که تصویر را با این ارتفاع و عرض برمی‌گرداند.

کلمه کلیدی

یک بخش معیار کلمه کلیدی.

فیلدها
info	KeywordInfo اطلاعات کلمات کلیدی.
ad_group_criterion	string نام منبع AdGroupCriterion.

اطلاعات کلمات کلیدی

معیار کلمه کلیدی.

فیلدها
match_type	KeywordMatchType نوع تطابق کلمه کلیدی.
text	string متن کلمه کلیدی (حداکثر ۸۰ کاراکتر و ۱۰ کلمه).

اطلاعات زبان

معیار زبانی.

فیلدها
language_constant	string نام منبع ثابت زبان.

اطلاعات گروه آگهی

معیار گروه فهرست‌بندی.

فیلدها
type	ListingGroupType نوع گروه فهرست‌بندی.

اطلاعات گروه موقعیت مکانی

شعاعی در اطراف لیستی از مکان‌های مشخص شده از طریق یک فید.

فیلدها
geo_target_constants[]	string ثابت(های) هدف جغرافیایی که محدوده منطقه جغرافیایی درون فید را محدود می‌کند. در حال حاضر فقط یک ثابت هدف جغرافیایی مجاز است.
radius_units	LocationGroupRadiusUnits واحد شعاع. مایل و متر برای ثابت‌های هدف جغرافیایی پشتیبانی می‌شوند. میلی مایل و متر برای مجموعه‌های آیتم‌های فید پشتیبانی می‌شوند. این مورد الزامی است و باید در عملیات CREATE تنظیم شود.
feed_item_sets[]	string FeedItemSetهایی که FeedItemهای آنها هدف‌گیری شده‌اند. اگر چندین شناسه مشخص شود، تمام مواردی که حداقل در یک مجموعه ظاهر می‌شوند، هدف‌گیری می‌شوند. این فیلد را نمی‌توان با geo_target_constants استفاده کرد. این اختیاری است و فقط می‌توان آن را در عملیات CREATE تنظیم کرد.
radius	int64 فاصله بر حسب واحد، شعاع اطراف مکان‌های هدف را مشخص می‌کند. این مورد الزامی است و باید در عملیات CREATE تنظیم شود.

اطلاعات مکان

معیار مکان.

فیلدها
geo_target_constant	string نام منبع ثابت هدف جغرافیایی.

دستی سی پی ای

این نوع هیچ فیلدی ندارد.

استراتژی پیشنهاد قیمت دستی که به تبلیغ‌کننده اجازه می‌دهد برای هر اقدام مشخص‌شده توسط تبلیغ‌کننده، پیشنهاد قیمت تعیین کند.

دستیCpc

مناقصه دستی مبتنی بر کلیک که در آن کاربر به ازای هر کلیک هزینه پرداخت می‌کند.

فیلدها
enhanced_cpc_enabled	bool اینکه آیا قرار است پیشنهادها بر اساس داده‌های بهینه‌ساز تبدیل افزایش داده شوند یا خیر.

دستیCpm

این نوع هیچ فیلدی ندارد.

مناقصه دستی مبتنی بر نمایش که در آن کاربر به ازای هر هزار نمایش هزینه پرداخت می‌کند.

حداکثر کردن ارزش تبدیل

یک استراتژی پیشنهاد قیمت خودکار برای کمک به کسب بیشترین ارزش تبدیل برای کمپین‌های شما در عین صرفه‌جویی در بودجه‌تان.

فیلدها
cpc_bid_ceiling_micros	int64 حداکثر محدودیت پیشنهاد قیمت که می‌تواند توسط استراتژی پیشنهاد قیمت تعیین شود. این محدودیت برای همه کلمات کلیدی مدیریت شده توسط استراتژی اعمال می‌شود. فقط برای استراتژی‌های پیشنهاد قیمت سبد سهام قابل تغییر است.
cpc_bid_floor_micros	int64 حداقل محدودیت پیشنهاد قیمت که می‌تواند توسط استراتژی پیشنهاد قیمت تعیین شود. این محدودیت برای همه کلمات کلیدی مدیریت شده توسط استراتژی اعمال می‌شود. فقط برای استراتژی‌های پیشنهاد قیمت سبد سهام قابل تغییر است.
target_roas	double گزینه بازگشت سرمایه هدف از هزینه تبلیغات (ROAS). در صورت تنظیم، استراتژی پیشنهاد، درآمد را به حداکثر می‌رساند و در عین حال میانگین بازگشت سرمایه هدف از هزینه تبلیغات را محاسبه می‌کند. اگر ROAS هدف بالا باشد، استراتژی پیشنهاد ممکن است نتواند کل بودجه را خرج کند. اگر ROAS هدف تعیین نشده باشد، استراتژی پیشنهاد با هدف دستیابی به بالاترین ROAS ممکن برای بودجه خواهد بود.

به حداکثر رساندن تبدیل‌ها

یک استراتژی پیشنهاد قیمت خودکار برای کمک به کسب بیشترین تبدیل برای کمپین‌های شما در عین صرفه‌جویی در بودجه‌تان.

فیلدها
cpc_bid_ceiling_micros	int64 حداکثر محدودیت پیشنهاد قیمت که می‌تواند توسط استراتژی پیشنهاد قیمت تعیین شود. این محدودیت برای همه کلمات کلیدی مدیریت شده توسط استراتژی اعمال می‌شود. فقط برای استراتژی‌های پیشنهاد قیمت سبد سهام قابل تغییر است.
cpc_bid_floor_micros	int64 حداقل محدودیت پیشنهاد قیمت که می‌تواند توسط استراتژی پیشنهاد قیمت تعیین شود. این محدودیت برای همه کلمات کلیدی مدیریت شده توسط استراتژی اعمال می‌شود. فقط برای استراتژی‌های پیشنهاد قیمت سبد سهام قابل تغییر است.
target_cpa_micros	int64 گزینه هزینه به ازای هر اقدام (CPA) هدف. این میانگین مبلغی است که می‌خواهید برای هر اقدام تبدیل، بر حسب واحدهای خرد ارز استراتژی پیشنهاد، هزینه کنید. در صورت تنظیم، استراتژی پیشنهاد تا حد امکان تبدیل‌هایی با هزینه به ازای هر اقدام هدف یا کمتر از آن دریافت می‌کند. اگر CPA هدف تعیین نشده باشد، استراتژی پیشنهاد با توجه به بودجه، به کمترین CPA ممکن دست خواهد یافت.

معیارها

داده‌های معیارها.

فیلدها
all_conversions_value_by_conversion_date	double مقدار همه تبدیل‌ها. وقتی این ستون با تاریخ انتخاب شود، مقادیر موجود در ستون تاریخ به معنای تاریخ تبدیل هستند. جزئیات مربوط به ستون‌های by_conversion_date در https://support.google.com/sa360/answer/9250611 موجود است.
all_conversions_by_conversion_date	double تعداد کل تبدیل‌ها. این شامل تمام تبدیل‌ها صرف نظر از مقدار include_in_conversions_metric می‌شود. وقتی این ستون با تاریخ انتخاب می‌شود، مقادیر موجود در ستون date به معنای تاریخ تبدیل هستند. جزئیات ستون‌های by_conversion_date در https://support.google.com/sa360/answer/9250611 موجود است.
conversion_custom_metrics[]	Value معیارهای سفارشی تبدیل.
conversions_value_by_conversion_date	double مجموع مقادیر تبدیل‌های قابل پیشنهاد بر اساس تاریخ تبدیل. وقتی این ستون با تاریخ انتخاب می‌شود، مقادیر موجود در ستون تاریخ به معنای تاریخ تبدیل هستند.
conversions_by_conversion_date	double مجموع تبدیل‌ها بر اساس تاریخ تبدیل برای انواع تبدیل قابل پیشنهاد. به دلیل مدل‌سازی انتساب می‌تواند کسری باشد. وقتی این ستون با تاریخ انتخاب می‌شود، مقادیر موجود در ستون تاریخ به معنای تاریخ تبدیل هستند.
historical_creative_quality_score	QualityScoreBucket امتیاز کیفیت تاریخی خلاقانه.
historical_landing_page_quality_score	QualityScoreBucket کیفیت تجربه کاربری صفحات فرود (لندینگ پیج) در گذشته.
historical_search_predicted_ctr	QualityScoreBucket جستجوی تاریخی نرخ کلیک (CTR) را پیش‌بینی کرد.
interaction_event_types[]	InteractionEventType انواع تعاملات پولی و رایگان.
raw_event_conversion_metrics[]	Value معیارهای خام تبدیل رویداد.
absolute_top_impression_percentage	double سهم مطلق بالاترین نمایش جستجو، درصد نمایش‌های تبلیغ شما در جستجو است که در برجسته‌ترین موقعیت جستجو نشان داده می‌شوند.
all_conversions_from_interactions_rate	double تمام تبدیل‌های حاصل از تعاملات (برخلاف تبدیل‌های حاصل از مشاهده) تقسیم بر تعداد تعاملات تبلیغاتی.
all_conversions_value	double ارزش تمام تبدیل‌ها.
all_conversions	double تعداد کل تبدیل‌ها. این شامل تمام تبدیل‌ها صرف نظر از مقدار include_in_conversions_metric می‌شود.
all_conversions_value_per_cost	double ارزش تمام تبدیل‌ها تقسیم بر کل هزینه تعاملات تبلیغاتی (مانند کلیک برای تبلیغات متنی یا بازدید برای تبلیغات ویدیویی).
all_conversions_from_click_to_call	double تعداد دفعاتی که افراد در حین یا بعد از کلیک روی یک تبلیغ، روی دکمه «تماس» کلیک کرده‌اند تا با فروشگاه تماس بگیرند. این عدد شامل برقراری یا عدم برقراری تماس یا مدت زمان تماس‌ها نمی‌شود. این معیار فقط برای اقلام خوراک اعمال می‌شود.
all_conversions_from_directions	double تعداد دفعاتی که افراد پس از کلیک روی یک تبلیغ، روی دکمه «دریافت مسیر» کلیک کرده‌اند تا به فروشگاه مورد نظر هدایت شوند. این معیار فقط برای اقلام خوراک اعمال می‌شود.
all_conversions_from_interactions_value_per_interaction	double ارزش تمام تبدیل‌های حاصل از تعاملات تقسیم بر تعداد کل تعاملات.
all_conversions_from_menu	double تعداد دفعاتی که افراد پس از کلیک روی یک تبلیغ، روی لینکی برای مشاهده منوی فروشگاه کلیک کرده‌اند. این معیار فقط برای اقلام خوراک اعمال می‌شود.
all_conversions_from_order	double تعداد دفعاتی که افراد پس از کلیک روی یک تبلیغ، در فروشگاه سفارش ثبت کرده‌اند. این معیار فقط برای اقلام خوراک اعمال می‌شود.
all_conversions_from_other_engagement	double تعداد تبدیل‌های دیگر (مثلاً ارسال نظر یا ذخیره مکان فروشگاه) که پس از کلیک افراد روی یک تبلیغ رخ داده است. این معیار فقط برای اقلام خوراک اعمال می‌شود.
all_conversions_from_store_visit	double تعداد تخمینی دفعاتی که افراد پس از کلیک روی یک تبلیغ از یک فروشگاه بازدید کرده‌اند. این معیار فقط برای اقلام خوراک اعمال می‌شود.
visits	double کلیک‌هایی که Search Ads 360 با موفقیت ثبت و به صفحه فرود تبلیغ‌کننده هدایت کرده است.
all_conversions_from_store_website	double تعداد دفعاتی که افراد پس از کلیک روی یک تبلیغ به آدرس اینترنتی فروشگاه هدایت شده‌اند. این معیار فقط برای اقلام خوراک اعمال می‌شود.
average_cost	double میانگین مبلغی که به ازای هر تعامل پرداخت می‌کنید. این مبلغ برابر است با کل هزینه تبلیغات شما تقسیم بر تعداد کل تعاملات.
average_cpc	double هزینه کل همه کلیک‌ها تقسیم بر تعداد کل کلیک‌های دریافتی. این معیار یک مقدار پولی است و به طور پیش‌فرض به واحد پول مشتری برگردانده می‌شود. پارامتر metrics_currency را در https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause ببینید.
average_cpm	double میانگین هزینه به ازای هر هزار نمایش (CPM). این معیار یک مقدار پولی است و به طور پیش‌فرض به واحد پول مشتری برگردانده می‌شود. پارامتر metrics_currency را در https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause ببینید.
clicks	int64 تعداد کلیک‌ها.
content_budget_lost_impression_share	double درصد تخمینی دفعاتی که تبلیغ شما واجد شرایط نمایش در شبکه نمایش بوده اما به دلیل کم بودن بودجه شما نمایش داده نشده است. توجه: سهم نمایش از دست رفته بودجه محتوا در محدوده 0 تا 0.9 گزارش شده است. هر مقداری بالاتر از 0.9 به عنوان 0.9001 گزارش شده است.
content_impression_share	double تعداد نمایش‌هایی که در شبکه نمایش دریافت کرده‌اید تقسیم بر تعداد تخمینی نمایش‌هایی که واجد شرایط دریافت آنها بوده‌اید. توجه: سهم نمایش محتوا در محدوده ۰.۱ تا ۱ گزارش می‌شود. هر مقداری کمتر از ۰.۱ به صورت ۰.۰۹۹۹ گزارش می‌شود.
content_rank_lost_impression_share	double درصد تخمینی نمایش‌هایی که تبلیغات شما به دلیل رتبه تبلیغ ضعیف در شبکه نمایش دریافت نکرده‌اند. توجه: سهم نمایش از دست رفته رتبه محتوا در محدوده ۰ تا ۰.۹ گزارش می‌شود. هر مقداری بالاتر از ۰.۹ به صورت ۰.۹۰۰۱ گزارش می‌شود.
conversions_from_interactions_rate	double میانگین تبدیل‌های قابل پیشنهاد (از تعامل) به ازای هر تعامل واجد شرایط تبدیل. نشان می‌دهد که به طور متوسط، چند بار یک تعامل تبلیغاتی منجر به تبدیل قابل پیشنهاد می‌شود.
client_account_conversions_value	double مقدار تبدیل‌های حساب مشتری. این فقط شامل اقدامات تبدیلی می‌شود که ویژگی include_in_client_account_conversions_metric روی true تنظیم شده باشد. اگر از پیشنهاد قیمت مبتنی بر تبدیل استفاده کنید، استراتژی‌های پیشنهاد قیمت شما برای این تبدیل‌ها بهینه می‌شوند.
conversions_value_per_cost	double ارزش تبدیل قابل پیشنهاد تقسیم بر کل هزینه تعاملات واجد شرایط تبدیل.
conversions_from_interactions_value_per_interaction	double ارزش تبدیل‌های حاصل از تعاملات تقسیم بر تعداد تعاملات تبلیغاتی. این فقط شامل اقدامات تبدیلی می‌شود که ویژگی include_in_conversions_metric روی true تنظیم شده باشد. اگر از پیشنهاد قیمت مبتنی بر تبدیل استفاده کنید، استراتژی‌های پیشنهاد قیمت شما برای این تبدیل‌ها بهینه می‌شوند.
client_account_conversions	double تعداد تبدیل‌های حساب مشتری. این فقط شامل اقدامات تبدیلی می‌شود که ویژگی include_in_client_account_conversions_metric روی true تنظیم شده باشد. اگر از پیشنهاد قیمت مبتنی بر تبدیل استفاده کنید، استراتژی‌های پیشنهاد قیمت شما برای این تبدیل‌ها بهینه می‌شوند.
cost_micros	int64 مجموع هزینه‌های هزینه به ازای هر کلیک (CPC) و هزینه به ازای هر هزار نمایش (CPM) شما در این دوره. این معیار یک مقدار پولی است و به طور پیش‌فرض به واحد پول مشتری برگردانده می‌شود. پارامتر metrics_currency را در https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause مشاهده کنید.
cost_per_all_conversions	double هزینه تعاملات تبلیغاتی تقسیم بر تمام تبدیل‌ها.
cost_per_conversion	double میانگین هزینه قابل قبول تبدیل به ازای هر تبدیل قابل پیشنهاد.
cost_per_current_model_attributed_conversion	double هزینه تعاملات تبلیغاتی تقسیم بر تبدیل‌های نسبت داده شده به مدل فعلی. این فقط شامل اقدامات تبدیلی می‌شود که ویژگی include_in_conversions_metric روی true تنظیم شده باشد. اگر از پیشنهاد قیمت مبتنی بر تبدیل استفاده کنید، استراتژی‌های پیشنهاد قیمت شما برای این تبدیل‌ها بهینه می‌شوند.
cross_device_conversions	double تبدیل‌ها از زمانی که مشتری روی یک تبلیغ در یک دستگاه کلیک می‌کند و سپس در دستگاه یا مرورگر دیگری تبدیل می‌شود. تبدیل‌های بین دستگاهی از قبل در all_conversions لحاظ شده‌اند.
cross_device_conversions_by_conversion_date	double تعداد تبدیل‌های بین دستگاهی بر اساس تاریخ تبدیل. جزئیات مربوط به ستون‌های by_conversion_date در آدرس https://support.google.com/sa360/answer/9250611 موجود است.
cross_device_conversions_value	double مجموع ارزش تبدیل‌های بین دستگاهی.
cross_device_conversions_value_by_conversion_date	double مجموع مقادیر تبدیل‌های بین دستگاهی بر اساس تاریخ تبدیل. جزئیات مربوط به ستون‌های by_conversion_date در آدرس https://support.google.com/sa360/answer/9250611 موجود است.
ctr	double تعداد کلیک‌هایی که روی تبلیغ شما می‌شود (Clicks) تقسیم بر تعداد دفعاتی که تبلیغ شما نمایش داده می‌شود (Impressions).
conversions	double تعداد تبدیل‌ها. این فقط شامل اقدامات تبدیلی می‌شود که ویژگی include_in_conversions_metric روی true تنظیم شده باشد. اگر از پیشنهاد قیمت مبتنی بر تبدیل استفاده کنید، استراتژی‌های پیشنهاد قیمت شما برای این تبدیل‌ها بهینه می‌شوند.
conversions_value	double مجموع مقادیر تبدیل برای تبدیل‌های موجود در فیلد "تبدیل‌ها". این معیار فقط در صورتی مفید است که مقداری برای اقدامات تبدیل خود وارد کرده باشید.
average_quality_score	double میانگین امتیاز کیفیت.
historical_quality_score	int64 امتیاز کیفیت تاریخی.
impressions	int64 تعداد دفعاتی که تبلیغ شما در صفحه نتایج جستجو یا وب‌سایت در شبکه گوگل نمایش داده شده است.
interaction_rate	double تعداد دفعاتی که افراد پس از نمایش تبلیغ شما با آن تعامل دارند. این تعداد تعامل‌ها تقسیم بر تعداد دفعات نمایش تبلیغ شما است.
interactions	int64 تعداد تعاملات. تعامل، اقدام اصلی کاربر مرتبط با یک قالب تبلیغاتی است - کلیک برای تبلیغات متنی و خرید، بازدید برای تبلیغات ویدیویی و غیره.
invalid_click_rate	double درصد کلیک‌های فیلتر شده از کل تعداد کلیک‌های شما (کلیک‌های فیلتر شده + کلیک‌های فیلتر نشده) در طول دوره گزارش.
invalid_clicks	int64 تعداد کلیک‌هایی که گوگل آنها را نامشروع می‌داند و بابت آنها از شما هزینه‌ای دریافت نمی‌کند.
general_invalid_click_rate	double درصد کلیک‌هایی که به دلیل کلیک‌های نامعتبر عمومی، از کل کلیک‌های شما (کلیک‌های فیلتر شده + کلیک‌های فیلتر نشده) فیلتر شده‌اند. اینها کلیک‌هایی هستند که گوگل آنها را نامعتبر می‌داند و از طریق روش‌های معمول فیلترینگ (یعنی ترافیک نامعتبر شناخته شده مرکز داده، ربات‌ها و عنکبوت‌ها یا سایر خزنده‌ها، الگوهای نامنظم و غیره) شناسایی می‌شوند. برای آنها هزینه‌ای از شما دریافت نمی‌شود و بر آمار حساب شما تأثیری ندارند. برای جزئیات بیشتر به صفحه راهنما در https://support.google.com/campaignmanager/answer/6076504 مراجعه کنید.
general_invalid_clicks	int64 تعداد کلیک‌های نامعتبر عمومی. اینها زیرمجموعه‌ای از کلیک‌های نامعتبر شما هستند که از طریق روش‌های معمول فیلترینگ (مانند ترافیک نامعتبر شناخته‌شده مرکز داده، ربات‌ها و عنکبوت‌ها یا سایر خزنده‌ها، الگوهای نامنظم و غیره) شناسایی می‌شوند. برای آنها هزینه‌ای از شما دریافت نمی‌شود و بر آمار حساب شما تأثیری ندارند. برای جزئیات بیشتر به صفحه راهنما در https://support.google.com/campaignmanager/answer/6076504 مراجعه کنید.
mobile_friendly_clicks_percentage	double درصد کلیک‌های موبایلی که به یک صفحه سازگار با موبایل منتهی می‌شوند.
search_absolute_top_impression_share	double درصد نمایش تبلیغات خرید یا جستجوی مشتری که در برجسته‌ترین موقعیت خرید نشان داده می‌شود. برای جزئیات بیشتر به https://support.google.com/sa360/answer/9566729 مراجعه کنید. هر مقداری کمتر از ۰.۱ به صورت ۰.۰۹۹۹ گزارش می‌شود.
search_budget_lost_absolute_top_impression_share	double عددی که تخمین می‌زند تبلیغ شما چند بار به دلیل بودجه کم، اولین تبلیغ در بین تبلیغات برتر نتایج جستجو نبوده است. توجه: سهم مطلق از دست رفته از بودجه جستجو در محدوده 0 تا 0.9 گزارش می‌شود. هر مقداری بالاتر از 0.9 به صورت 0.9001 گزارش می‌شود.
search_budget_lost_impression_share	double درصد تخمینی دفعاتی که تبلیغ شما واجد شرایط نمایش در شبکه جستجو بوده اما به دلیل کم بودن بودجه شما نمایش داده نشده است. توجه: سهم نمایش از دست رفته بودجه جستجو در محدوده 0 تا 0.9 گزارش می‌شود. هر مقداری بالاتر از 0.9 به صورت 0.9001 گزارش می‌شود.
search_budget_lost_top_impression_share	double عددی که تخمین می‌زند تبلیغ شما به دلیل بودجه کم، چند وقت یکبار در کنار نتایج جستجوی ارگانیک برتر نمایش داده نمی‌شود. توجه: سهم نمایش برتر از دست رفته از بودجه جستجو در محدوده 0 تا 0.9 گزارش می‌شود. هر مقداری بالاتر از 0.9 به صورت 0.9001 گزارش می‌شود.
search_click_share	double تعداد کلیک‌هایی که در شبکه جستجو دریافت کرده‌اید تقسیم بر تعداد تخمینی کلیک‌هایی که واجد شرایط دریافت آنها بوده‌اید. توجه: سهم کلیک جستجو در محدوده ۰.۱ تا ۱ گزارش می‌شود. هر مقداری کمتر از ۰.۱ به صورت ۰.۰۹۹۹ گزارش می‌شود.
search_exact_match_impression_share	double تعداد نمایش‌هایی که دریافت کرده‌اید تقسیم بر تعداد تخمینی نمایش‌هایی که واجد شرایط دریافت آنها در شبکه جستجو برای عبارات جستجویی که دقیقاً با کلمات کلیدی شما مطابقت دارند (یا انواع نزدیک به کلمه کلیدی شما هستند)، صرف نظر از نوع تطابق کلمه کلیدی شما. توجه: سهم نمایش تطابق دقیق جستجو در محدوده 0.1 تا 1 گزارش می‌شود. هر مقداری کمتر از 0.1 به صورت 0.0999 گزارش می‌شود.
search_impression_share	double تعداد نمایش‌هایی که در شبکه جستجو دریافت کرده‌اید تقسیم بر تعداد تخمینی نمایش‌هایی که واجد شرایط دریافت آنها بوده‌اید. توجه: سهم نمایش جستجو در محدوده ۰.۱ تا ۱ گزارش می‌شود. هر مقداری کمتر از ۰.۱ به صورت ۰.۰۹۹۹ گزارش می‌شود.
search_rank_lost_absolute_top_impression_share	double عددی که تخمین می‌زند تبلیغ شما چند بار به دلیل رتبه پایین تبلیغ، اولین تبلیغ در بین تبلیغات برتر نتایج جستجو نبوده است. توجه: سهم مطلق از دست رفته رتبه جستجو در بازه 0 تا 0.9 گزارش می‌شود. هر مقداری بالاتر از 0.9 به صورت 0.9001 گزارش می‌شود.
search_rank_lost_impression_share	double درصد تخمینی نمایش‌هایی که تبلیغات شما در شبکه جستجو به دلیل رتبه تبلیغ ضعیف دریافت نکرده‌اند. توجه: سهم نمایش از دست رفته رتبه جستجو در محدوده 0 تا 0.9 گزارش می‌شود. هر مقداری بالاتر از 0.9 به صورت 0.9001 گزارش می‌شود.
search_rank_lost_top_impression_share	double عددی که تخمین می‌زند تبلیغ شما به دلیل رتبه پایین تبلیغ، چند وقت یکبار در کنار نتایج جستجوی ارگانیک برتر نمایش داده نمی‌شود. توجه: سهم نمایش بالای از دست رفته در رتبه جستجو در محدوده ۰ تا ۰.۹ گزارش می‌شود. هر مقداری بالاتر از ۰.۹ به صورت ۰.۹۰۰۱ گزارش می‌شود.
search_top_impression_share	double تعداد نمایش‌هایی که در بین تبلیغات برتر دریافت کرده‌اید در مقایسه با تعداد تخمینی نمایش‌هایی که واجد شرایط دریافت آنها در بین تبلیغات برتر بوده‌اید. توجه: سهم نمایش برتر جستجو در محدوده ۰.۱ تا ۱ گزارش می‌شود. هر مقداری کمتر از ۰.۱ به صورت ۰.۰۹۹۹ گزارش می‌شود. تبلیغات برتر معمولاً بالاتر از نتایج ارگانیک برتر هستند، اگرچه ممکن است در برخی از جستجوها، پایین‌تر از نتایج ارگانیک برتر نشان داده شوند.
top_impression_percentage	double درصد نمایش تبلیغات شما که در کنار نتایج جستجوی ارگانیک برتر نشان داده می‌شود.
value_per_all_conversions	double ارزش تمام تبدیل‌ها تقسیم بر تعداد تمام تبدیل‌ها.
value_per_all_conversions_by_conversion_date	double ارزش تمام تبدیل‌ها تقسیم بر تعداد تمام تبدیل‌ها. وقتی این ستون با تاریخ انتخاب می‌شود، مقادیر موجود در ستون تاریخ به معنای تاریخ تبدیل است. جزئیات ستون‌های by_conversion_date در https://support.google.com/sa360/answer/9250611 موجود است.
value_per_conversion	double ارزش تبدیل‌های قابل پیشنهاد تقسیم بر تعداد تبدیل‌های قابل پیشنهاد. نشان می‌دهد که به طور متوسط، هر یک از تبدیل‌های قابل پیشنهاد چقدر ارزش دارد.
value_per_conversions_by_conversion_date	double ارزش تبدیل‌های قابل پیشنهاد بر اساس تاریخ تبدیل تقسیم بر تبدیل‌های قابل پیشنهاد بر اساس تاریخ تبدیل. نشان می‌دهد که به طور متوسط، هر یک از تبدیل‌های قابل پیشنهاد چقدر ارزش دارد (بر اساس تاریخ تبدیل). وقتی این ستون با تاریخ انتخاب می‌شود، مقادیر موجود در ستون تاریخ به معنای تاریخ تبدیل هستند.
client_account_view_through_conversions	int64 تعداد کل تبدیل‌های مشاهده‌شده. این تبدیل‌ها زمانی اتفاق می‌افتند که مشتری یک تصویر یا تبلیغ رسانه‌ای غنی را می‌بیند، سپس بعداً بدون تعامل با (مثلاً کلیک کردن روی) تبلیغ دیگری، تبدیل را در سایت شما انجام می‌دهد.
client_account_cross_sell_cost_of_goods_sold_micros	int64 هزینه فروش متقابل کالاهای فروخته شده (COGS) حساب مشتری، کل هزینه محصولاتی است که در نتیجه تبلیغ یک محصول متفاوت فروخته شده‌اند. نحوه کار: شما تبدیل‌ها را با داده‌های سبد خرید برای خریدهای تکمیل شده در وب‌سایت خود گزارش می‌دهید. اگر تبلیغی که قبل از خرید با آن تعامل شده است، یک محصول مرتبط داشته باشد (به تبلیغات خرید مراجعه کنید)، این محصول به عنوان محصول تبلیغ شده در نظر گرفته می‌شود. هر محصولی که در سفارشی که مشتری قرار می‌دهد، گنجانده شده باشد، یک محصول فروخته شده است. اگر این محصولات مطابقت نداشته باشند، این فروش متقابل در نظر گرفته می‌شود. هزینه فروش متقابل کالاهای فروخته شده، کل هزینه محصولاتی است که فروخته شده‌اند و تبلیغ نشده‌اند. مثال: شخصی روی یک تبلیغ خرید برای یک کلاه کلیک کرده و سپس همان کلاه و یک پیراهن را خریداری کرده است. ارزش هزینه کالاهای فروخته شده برای کلاه ۳ دلار و برای پیراهن ۵ دلار است. هزینه فروش متقابل کالاهای فروخته شده برای این سفارش ۵ دلار است. این معیار فقط در صورتی در دسترس است که تبدیل‌ها را با داده‌های سبد خرید گزارش کنید. این معیار یک مقدار پولی است و به طور پیش‌فرض با واحد پول مشتری برگردانده می‌شود. پارامتر metrics_currency را در https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause ببینید
cross_sell_cost_of_goods_sold_micros	int64 هزینه فروش متقابل کالاهای فروخته شده (COGS) کل هزینه محصولاتی است که در نتیجه تبلیغ یک محصول متفاوت فروخته شده‌اند. نحوه کار: شما تبدیل‌ها را با داده‌های سبد خرید برای خریدهای تکمیل شده در وب‌سایت خود گزارش می‌دهید. اگر تبلیغی که قبل از خرید با آن تعامل شده است، یک محصول مرتبط داشته باشد (به تبلیغات خرید مراجعه کنید)، این محصول به عنوان محصول تبلیغ شده در نظر گرفته می‌شود. هر محصولی که در سفارشی که مشتری قرار می‌دهد گنجانده شده باشد، یک محصول فروخته شده است. اگر این محصولات مطابقت نداشته باشند، این فروش متقابل در نظر گرفته می‌شود. هزینه فروش متقابل کالاهای فروخته شده، کل هزینه محصولاتی است که فروخته شده‌اند و تبلیغ نشده‌اند. مثال: شخصی روی یک تبلیغ خرید برای یک کلاه کلیک کرده و سپس همان کلاه و یک پیراهن را خریداری کرده است. ارزش هزینه کالاهای فروخته شده برای کلاه ۳ دلار و برای پیراهن ۵ دلار است. هزینه فروش متقابل کالاهای فروخته شده برای این سفارش ۵ دلار است. این معیار فقط در صورتی در دسترس است که تبدیل‌ها را با داده‌های سبد خرید گزارش کنید. این معیار یک مقدار پولی است و به طور پیش‌فرض با واحد پول مشتری برگردانده می‌شود. پارامتر metrics_currency را در https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause ببینید
client_account_cross_sell_gross_profit_micros	int64 سود ناخالص فروش متقابل حساب مشتری، سودی است که شما از محصولات فروخته شده در نتیجه تبلیغ یک محصول متفاوت، منهای هزینه کالاهای فروخته شده (COGS) به دست آورده‌اید. نحوه کار: شما تبدیل‌ها را با داده‌های سبد خرید برای خریدهای تکمیل شده در وب‌سایت خود گزارش می‌دهید. اگر تبلیغی که قبل از خرید با آن تعامل شده است، یک محصول مرتبط داشته باشد (به تبلیغات خرید مراجعه کنید)، این محصول به عنوان محصول تبلیغ شده در نظر گرفته می‌شود. هر محصولی که در خرید گنجانده شده است، یک محصول فروخته شده است. اگر این محصولات مطابقت نداشته باشند، این فروش متقابل در نظر گرفته می‌شود. سود ناخالص فروش متقابل، درآمدی است که شما از فروش متقابل به تبلیغات خود منهای هزینه کالاهای فروخته شده به دست آورده‌اید. مثال: شخصی روی یک تبلیغ خرید برای یک کلاه کلیک کرده و سپس همان کلاه و یک پیراهن را خریداری کرده است. قیمت پیراهن 20 دلار است و ارزش هزینه کالاهای فروخته شده 5 دلار است. سود ناخالص فروش متقابل این سفارش 15 دلار = 20 دلار - 5 دلار است. این معیار فقط در صورتی در دسترس است که تبدیل‌ها را با داده‌های سبد خرید گزارش دهید. این معیار یک مقدار پولی است و به طور پیش‌فرض به واحد پول مشتری بازگردانده می‌شود. پارامتر metrics_currency را در https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause ببینید
cross_sell_gross_profit_micros	int64 سود ناخالص فروش متقابل، سودی است که شما از محصولات فروخته شده در نتیجه تبلیغ یک محصول متفاوت، منهای هزینه کالاهای فروخته شده (COGS) به دست آورده‌اید. نحوه کار: شما تبدیل‌ها را با داده‌های سبد خرید برای خریدهای تکمیل شده در وب‌سایت خود گزارش می‌دهید. اگر تبلیغی که قبل از خرید با آن تعامل شده است، یک محصول مرتبط داشته باشد (به تبلیغات خرید مراجعه کنید)، این محصول به عنوان محصول تبلیغ شده در نظر گرفته می‌شود. هر محصولی که در خرید گنجانده شده باشد، یک محصول فروخته شده است. اگر این محصولات مطابقت نداشته باشند، این فروش متقابل در نظر گرفته می‌شود. سود ناخالص فروش متقابل، درآمدی است که شما از فروش متقابل به تبلیغات خود منهای هزینه کالاهای فروخته شده به دست آورده‌اید. مثال: شخصی روی یک تبلیغ خرید برای یک کلاه کلیک کرده و سپس همان کلاه و یک پیراهن را خریداری کرده است. قیمت پیراهن 20 دلار است و ارزش هزینه کالاهای فروخته شده 5 دلار است. سود ناخالص فروش متقابل این سفارش 15 دلار = 20 دلار - 5 دلار است. این معیار فقط در صورتی در دسترس است که تبدیل‌ها را با داده‌های سبد خرید گزارش دهید. این معیار یک مقدار پولی است و به طور پیش‌فرض به واحد پول مشتری بازگردانده می‌شود. پارامتر metrics_currency را در https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause ببینید
client_account_cross_sell_revenue_micros	int64 درآمد فروش متقابل حساب مشتری، کل مبلغی است که شما از محصولات فروخته شده در نتیجه تبلیغ یک محصول متفاوت به دست آورده‌اید. نحوه کار: شما تبدیل‌ها را با داده‌های سبد خرید برای خریدهای تکمیل شده در وب‌سایت خود گزارش می‌دهید. اگر تبلیغی که قبل از خرید با آن تعامل شده است، یک محصول مرتبط داشته باشد (به تبلیغات خرید مراجعه کنید)، این محصول به عنوان محصول تبلیغ شده در نظر گرفته می‌شود. هر محصولی که در سفارشی که مشتری قرار می‌دهد، گنجانده شود، یک محصول فروخته شده است. اگر این محصولات مطابقت نداشته باشند، این فروش متقابل در نظر گرفته می‌شود. درآمد فروش متقابل، کل ارزشی است که شما از فروش متقابل نسبت به تبلیغات خود به دست آورده‌اید. مثال: شخصی روی یک تبلیغ خرید برای یک کلاه کلیک کرده و سپس همان کلاه و یک پیراهن را خریداری کرده است. قیمت کلاه 10 دلار و قیمت پیراهن 20 دلار است. درآمد فروش متقابل این سفارش 20 دلار است. این معیار فقط در صورتی در دسترس است که تبدیل‌ها را با داده‌های سبد خرید گزارش دهید. این معیار یک مقدار پولی است و به طور پیش‌فرض به واحد پول مشتری بازگردانده می‌شود. پارامتر metrics_currency را در https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause ببینید
cross_sell_revenue_micros	int64 درآمد فروش متقابل، کل مبلغی است که شما از محصولات فروخته شده در نتیجه تبلیغ یک محصول متفاوت به دست آورده‌اید. نحوه کار: شما تبدیل‌ها را با داده‌های سبد خرید برای خریدهای تکمیل شده در وب‌سایت خود گزارش می‌دهید. اگر تبلیغی که قبل از خرید با آن تعامل شده است، یک محصول مرتبط داشته باشد (به تبلیغات خرید مراجعه کنید)، این محصول به عنوان محصول تبلیغ شده در نظر گرفته می‌شود. هر محصولی که در سفارشی که مشتری قرار می‌دهد، گنجانده شده باشد، یک محصول فروخته شده است. اگر این محصولات مطابقت نداشته باشند، این فروش متقابل در نظر گرفته می‌شود. درآمد فروش متقابل، کل ارزشی است که شما از فروش متقابل نسبت به تبلیغات خود به دست آورده‌اید. مثال: شخصی روی یک تبلیغ خرید برای یک کلاه کلیک کرده و سپس همان کلاه و یک پیراهن را خریداری کرده است. قیمت کلاه 10 دلار و قیمت پیراهن 20 دلار است. درآمد فروش متقابل این سفارش 20 دلار است. این معیار فقط در صورتی در دسترس است که تبدیل‌ها را با داده‌های سبد خرید گزارش دهید. این معیار یک مقدار پولی است و به طور پیش‌فرض به واحد پول مشتری بازگردانده می‌شود. پارامتر metrics_currency را در https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause ببینید
client_account_cross_sell_units_sold	double واحدهای فروش متقابل حساب مشتری، تعداد کل محصولات فروخته شده در نتیجه تبلیغ یک محصول متفاوت است. نحوه کار: شما تبدیل‌ها را با داده‌های سبد خرید برای خریدهای تکمیل شده در وب‌سایت خود گزارش می‌دهید. اگر تبلیغی که قبل از خرید با آن تعامل شده است، یک محصول مرتبط داشته باشد (به تبلیغات خرید مراجعه کنید)، این محصول به عنوان محصول تبلیغ شده در نظر گرفته می‌شود. هر محصولی که در سفارشی که مشتری قرار می‌دهد، گنجانده شده باشد، یک محصول فروخته شده است. اگر این محصولات مطابقت نداشته باشند، این فروش متقابل در نظر گرفته می‌شود. واحدهای فروش متقابل فروخته شده، تعداد کل محصولات فروش متقابل از تمام سفارشات منتسب به تبلیغات شما است. مثال: شخصی روی یک تبلیغ خرید برای یک کلاه کلیک کرده و سپس همان کلاه، یک پیراهن و یک ژاکت را خریداری کرده است. واحدهای فروش متقابل فروخته شده در این سفارش ۲ است. این معیار فقط در صورتی در دسترس است که تبدیل‌ها را با داده‌های سبد خرید گزارش کنید.
cross_sell_units_sold	double واحدهای فروش متقابل، تعداد کل محصولات فروخته شده در نتیجه تبلیغ یک محصول متفاوت است. نحوه کار: شما تبدیل‌ها را با داده‌های سبد خرید برای خریدهای تکمیل شده در وب‌سایت خود گزارش می‌دهید. اگر تبلیغی که قبل از خرید با آن تعامل شده است، یک محصول مرتبط داشته باشد (به تبلیغات خرید مراجعه کنید)، این محصول به عنوان محصول تبلیغ شده در نظر گرفته می‌شود. هر محصولی که در سفارشی که مشتری قرار می‌دهد، گنجانده شده باشد، یک محصول فروخته شده است. اگر این محصولات مطابقت نداشته باشند، این فروش متقابل در نظر گرفته می‌شود. واحدهای فروش متقابل، تعداد کل محصولات فروش متقابل از تمام سفارشات منتسب به تبلیغات شما است. مثال: شخصی روی یک تبلیغ خرید برای یک کلاه کلیک کرده و سپس همان کلاه، یک پیراهن و یک ژاکت را خریداری کرده است. واحدهای فروش متقابل فروخته شده در این سفارش ۲ است. این معیار فقط در صورتی در دسترس است که تبدیل‌ها را با داده‌های سبد خرید گزارش کنید.
client_account_lead_cost_of_goods_sold_micros	int64 هزینه سرب کالاهای فروخته شده (COGS) حساب مشتری، کل هزینه محصولاتی است که در نتیجه تبلیغ همان محصول فروخته شده‌اند. نحوه کار: شما تبدیل‌ها را با داده‌های سبد خرید برای خریدهای تکمیل شده در وب‌سایت خود گزارش می‌دهید. اگر تبلیغی که با آن تعامل شده است، یک محصول مرتبط داشته باشد (به تبلیغات خرید مراجعه کنید)، این محصول، محصول تبلیغ شده در نظر گرفته می‌شود. هر محصولی که در سفارشی که مشتری قرار می‌دهد، گنجانده شود، یک محصول فروخته شده است. اگر محصولات تبلیغ شده و فروخته شده مطابقت داشته باشند، هزینه این کالاها تحت هزینه سرب کالاهای فروخته شده محاسبه می‌شود. مثال: شخصی روی یک تبلیغ خرید برای یک کلاه کلیک کرده و سپس همان کلاه و یک پیراهن را خریداری کرده است. ارزش هزینه کالای فروخته شده برای کلاه ۳ دلار و برای پیراهن ۵ دلار است. هزینه سرب کالاهای فروخته شده برای این سفارش ۳ دلار است. این معیار فقط در صورتی در دسترس است که تبدیل‌ها را با داده‌های سبد خرید گزارش کنید. این معیار یک مقدار پولی است و به طور پیش‌فرض با واحد پول مشتری برگردانده می‌شود. پارامتر metrics_currency را در https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause ببینید
lead_cost_of_goods_sold_micros	int64 هزینه سرب کالاهای فروخته شده (COGS) کل هزینه محصولات فروخته شده در نتیجه تبلیغ همان محصول است. نحوه کار: شما تبدیل‌ها را با داده‌های سبد خرید برای خریدهای تکمیل شده در وب‌سایت خود گزارش می‌دهید. اگر تبلیغی که با آن تعامل شده است، یک محصول مرتبط داشته باشد (به تبلیغات خرید مراجعه کنید)، این محصول، محصول تبلیغ شده در نظر گرفته می‌شود. هر محصولی که در سفارشی که مشتری قرار می‌دهد، گنجانده شود، یک محصول فروخته شده است. اگر محصولات تبلیغ شده و فروخته شده مطابقت داشته باشند، هزینه این کالاها تحت هزینه سرب کالاهای فروخته شده محاسبه می‌شود. مثال: شخصی روی یک تبلیغ خرید برای یک کلاه کلیک کرده و سپس همان کلاه و یک پیراهن را خریداری کرده است. ارزش هزینه کالای فروخته شده برای کلاه ۳ دلار و برای پیراهن ۵ دلار است. هزینه سرب کالاهای فروخته شده برای این سفارش ۳ دلار است. این معیار فقط در صورتی در دسترس است که تبدیل‌ها را با داده‌های سبد خرید گزارش کنید. این معیار یک مقدار پولی است و به طور پیش‌فرض با واحد پول مشتری برگردانده می‌شود. پارامتر metrics_currency را در https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause ببینید
client_account_lead_gross_profit_micros	int64 سود ناخالص سرنخ حساب مشتری، سودی است که شما از محصولات فروخته شده در نتیجه تبلیغ همان محصول، منهای هزینه کالاهای فروخته شده (COGS) به دست آورده‌اید. نحوه کار: شما تبدیل‌ها را با داده‌های سبد خرید برای خریدهای تکمیل شده در وب‌سایت خود گزارش می‌دهید. اگر تبلیغی که قبل از خرید با آن تعامل شده است، یک محصول مرتبط داشته باشد (به تبلیغات خرید مراجعه کنید)، این محصول، محصول تبلیغ شده در نظر گرفته می‌شود. هر محصولی که در سفارشی که مشتری قرار می‌دهد، گنجانده شود، یک محصول فروخته شده است. اگر محصولات تبلیغ شده و فروخته شده مطابقت داشته باشند، درآمدی که شما از این فروش‌ها منهای هزینه کالاهای فروخته شده به دست آورده‌اید، سود ناخالص سرنخ شما است. مثال: شخصی روی یک تبلیغ خرید برای یک کلاه کلیک کرده و سپس همان کلاه و یک پیراهن را خریداری کرده است. قیمت کلاه 10 دلار و ارزش هزینه کالاهای فروخته شده 3 دلار است. سود ناخالص سرنخ این سفارش 7 دلار = 10 دلار - 3 دلار است. این معیار فقط در صورتی در دسترس است که تبدیل‌ها را با داده‌های سبد خرید گزارش دهید. این معیار یک مقدار پولی است و به طور پیش‌فرض به واحد پول مشتری بازگردانده می‌شود. پارامتر metrics_currency را در https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause ببینید
lead_gross_profit_micros	int64 سود ناخالص سرنخ، سودی است که شما از محصولات فروخته شده در نتیجه تبلیغ همان محصول، منهای هزینه کالاهای فروخته شده (COGS) به دست آورده‌اید. نحوه کار: شما تبدیل‌ها را با داده‌های سبد خرید برای خریدهای تکمیل شده در وب‌سایت خود گزارش می‌دهید. اگر تبلیغی که قبل از خرید با آن تعامل شده است، یک محصول مرتبط داشته باشد (به تبلیغات خرید مراجعه کنید)، این محصول، محصول تبلیغ شده در نظر گرفته می‌شود. هر محصولی که در سفارشی که مشتری قرار می‌دهد، گنجانده شود، یک محصول فروخته شده است. اگر محصولات تبلیغ شده و فروخته شده مطابقت داشته باشند، درآمدی که شما از این فروش‌ها منهای هزینه کالاهای فروخته شده به دست آورده‌اید، سود ناخالص سرنخ شما است. مثال: شخصی روی یک تبلیغ خرید برای یک کلاه کلیک کرده و سپس همان کلاه و یک پیراهن را خریداری کرده است. قیمت کلاه 10 دلار و ارزش هزینه کالاهای فروخته شده 3 دلار است. سود ناخالص سرنخ این سفارش 7 دلار = 10 دلار - 3 دلار است. این معیار فقط در صورتی در دسترس است که تبدیل‌ها را با داده‌های سبد خرید گزارش دهید. این معیار یک مقدار پولی است و به طور پیش‌فرض به واحد پول مشتری بازگردانده می‌شود. پارامتر metrics_currency را در https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause ببینید
client_account_lead_revenue_micros	int64 درآمد حاصل از فروش سرنخ (lead income) حساب مشتری، کل مبلغی است که شما از محصولات فروخته شده در نتیجه تبلیغ همان محصول به دست آورده‌اید. نحوه کار: شما تبدیل‌ها را با داده‌های سبد خرید برای خریدهای تکمیل شده در وب‌سایت خود گزارش می‌دهید. اگر تبلیغی که قبل از خرید با آن تعامل شده است، یک محصول مرتبط داشته باشد (به تبلیغات خرید مراجعه کنید)، این محصول به عنوان محصول تبلیغ شده در نظر گرفته می‌شود. هر محصولی که در سفارشی که مشتری قرار می‌دهد، گنجانده شود، یک محصول فروخته شده است. اگر محصولات تبلیغ شده و فروخته شده با هم مطابقت داشته باشند، کل ارزشی که شما از فروش این محصولات به دست آورده‌اید، تحت عنوان درآمد سرنخ نشان داده می‌شود. مثال: شخصی روی یک تبلیغ خرید برای یک کلاه کلیک کرده و سپس همان کلاه و یک پیراهن را خریداری کرده است. قیمت کلاه 10 دلار و قیمت پیراهن 20 دلار است. درآمد سرنخ این سفارش 10 دلار است. این معیار فقط در صورتی در دسترس است که تبدیل‌ها را با داده‌های سبد خرید گزارش دهید. این معیار یک مقدار پولی است و به طور پیش‌فرض به واحد پول مشتری برگردانده می‌شود. پارامتر metrics_currency را در https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause مشاهده کنید.
lead_revenue_micros	int64 درآمد حاصل از فروش سرنخ، کل مبلغی است که شما از محصولات فروخته شده در نتیجه تبلیغ همان محصول به دست آورده‌اید. نحوه کار: شما تبدیل‌ها را با داده‌های سبد خرید برای خریدهای تکمیل شده در وب‌سایت خود گزارش می‌دهید. اگر تبلیغی که قبل از خرید با آن تعامل شده است، یک محصول مرتبط داشته باشد (به تبلیغات خرید مراجعه کنید)، این محصول به عنوان محصول تبلیغ شده در نظر گرفته می‌شود. هر محصولی که در سفارشی که مشتری قرار می‌دهد، گنجانده شود، یک محصول فروخته شده است. اگر محصولات تبلیغ شده و فروخته شده مطابقت داشته باشند، کل ارزشی که شما از فروش این محصولات به دست آورده‌اید، تحت عنوان درآمد سرنخ نشان داده می‌شود. مثال: شخصی روی یک تبلیغ خرید برای یک کلاه کلیک کرده و سپس همان کلاه و یک پیراهن را خریداری کرده است. قیمت کلاه 10 دلار و قیمت پیراهن 20 دلار است. درآمد سرنخ این سفارش 10 دلار است. این معیار فقط در صورتی در دسترس است که تبدیل‌ها را با داده‌های سبد خرید گزارش دهید. این معیار یک مقدار پولی است و به طور پیش‌فرض به واحد پول مشتری برگردانده می‌شود. پارامتر metrics_currency را در https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause مشاهده کنید.
client_account_lead_units_sold	double واحدهای فروش سرنخ حساب مشتری، تعداد کل محصولاتی است که در نتیجه تبلیغ همان محصول فروخته شده‌اند. نحوه کار: شما تبدیل‌ها را با داده‌های سبد خرید برای خریدهای تکمیل‌شده در وب‌سایت خود گزارش می‌دهید. اگر تبلیغی که قبل از خرید با آن تعامل شده است، یک محصول مرتبط داشته باشد (به تبلیغات خرید مراجعه کنید)، این محصول، محصول تبلیغ‌شده در نظر گرفته می‌شود. هر محصولی که در سفارشی که مشتری قرار می‌دهد، گنجانده شود، یک محصول فروخته‌شده است. اگر محصولات تبلیغ‌شده و فروخته‌شده مطابقت داشته باشند، تعداد کل این محصولات فروخته‌شده در زیر واحدهای فروش سرنخ نشان داده می‌شود. مثال: شخصی روی یک تبلیغ خرید برای یک کلاه کلیک کرده و سپس همان کلاه، یک پیراهن و یک ژاکت را خریداری کرده است. واحدهای فروش سرنخ در این سفارش ۱ است. این معیار فقط در صورتی در دسترس است که تبدیل‌ها را با داده‌های سبد خرید گزارش کنید.
lead_units_sold	double واحدهای سرنخ فروخته شده، تعداد کل محصولاتی است که در نتیجه تبلیغ همان محصول فروخته شده‌اند. نحوه کار: شما تبدیل‌ها را با داده‌های سبد خرید برای خریدهای تکمیل شده در وب‌سایت خود گزارش می‌دهید. اگر تبلیغی که قبل از خرید با آن تعامل شده است، یک محصول مرتبط داشته باشد (به تبلیغات خرید مراجعه کنید)، این محصول، محصول تبلیغ شده در نظر گرفته می‌شود. هر محصولی که در سفارشی که مشتری قرار می‌دهد، گنجانده شده باشد، یک محصول فروخته شده است. اگر محصولات تبلیغ شده و فروخته شده مطابقت داشته باشند، تعداد کل این محصولات فروخته شده در زیر واحدهای سرنخ فروخته شده نشان داده می‌شود. مثال: شخصی روی یک تبلیغ خرید برای یک کلاه کلیک کرده و سپس همان کلاه، یک پیراهن و یک ژاکت را خریداری کرده است. واحدهای سرنخ فروخته شده در این سفارش ۱ است. این معیار فقط در صورتی در دسترس است که تبدیل‌ها را با داده‌های سبد خرید گزارش کنید.
unique_users	int64 تعداد کاربران منحصر به فردی که تبلیغ شما را در بازه زمانی درخواستی مشاهده کرده‌اند. این معیار قابل تجمیع نیست و فقط برای بازه‌های زمانی ۹۲ روز یا کمتر قابل درخواست است. این معیار برای انواع کمپین‌های زیر در دسترس است - نمایش، ویدیو، کشف و اپلیکیشن.
average_impression_frequency_per_user	double میانگین تعداد دفعاتی که یک کاربر منحصر به فرد تبلیغ شما را در طول دوره زمانی درخواستی مشاهده کرده است. این معیار قابل تجمیع نیست و فقط برای بازه‌های زمانی ۹۲ روز یا کمتر قابل درخواست است. این معیار برای انواع کمپین‌های زیر در دسترس است - نمایش، ویدیو، کشف و برنامه.

MobileAppAsset

یک دارایی که نمایانگر یک برنامه تلفن همراه است.

فیلدها
app_id	string الزامی. رشته‌ای که به طور منحصر به فرد یک برنامه تلفن همراه را مشخص می‌کند. این رشته باید فقط شامل شناسه بومی پلتفرم باشد، مانند "com.android.ebay" برای اندروید یا "12345689" برای iOS.
app_store	MobileAppVendor الزامی. فروشگاه برنامه‌ای که این برنامه خاص را توزیع می‌کند.

درصدCpc

یک استراتژی پیشنهاد قیمت که در آن پیشنهادها کسری از قیمت تبلیغ‌شده برای یک کالا یا خدمات هستند.

فیلدها
cpc_bid_ceiling_micros	int64 حداکثر محدودیت پیشنهاد قیمت که می‌تواند توسط استراتژی پیشنهاد قیمت تعیین شود. این یک فیلد اختیاری است که توسط تبلیغ‌کننده وارد شده و در ریزمعیارهای محلی مشخص می‌شود. توجه: مقدار صفر به همان روشی تفسیر می‌شود که bid_ceiling تعریف نشده باشد.
enhanced_cpc_enabled	bool بسته به احتمال تبدیل، پیشنهاد قیمت برای هر حراج را به سمت بالا یا پایین تنظیم می‌کند. پیشنهادهای تکی ممکن است از cpc_bid_ceiling_micros تجاوز کنند، اما میانگین مبلغ پیشنهاد برای یک کمپین نباید بیشتر شود.

تنظیمات پیشنهاد قیمت لحظه‌ای

تنظیمات مربوط به پیشنهاد قیمت آنی، قابلیتی که فقط برای کمپین‌هایی که شبکه‌ی تبادل تبلیغات (Ad Exchange) را هدف قرار می‌دهند، در دسترس است.

فیلدها
opt_in	bool اینکه آیا کمپین به مناقصه‌ی بلادرنگ (real-time) اختصاص داده شده است یا خیر.

جستجوی تبلیغات ۳۶۰گسترش‌یافتهجستجوی پویااطلاعات تبلیغات

یک تبلیغ جستجوی پویای توسعه‌یافته.

فیلدها
description1	string خط اول توضیحات آگهی.
description2	string خط دوم توضیحات آگهی.
ad_tracking_id	int64 شناسه ردیابی تبلیغ.

جستجوی تبلیغات۳۶۰ متن گسترده اطلاعات تبلیغات

یک تبلیغ متنی گسترش‌یافته ۳۶۰ درجه در Search Ads.

فیلدها
headline	string تیتر آگهی.
headline2	string تیتر دوم آگهی.
headline3	string تیتر سوم آگهی.
description1	string خط اول توضیحات آگهی.
description2	string خط دوم توضیحات آگهی.
path1	string متنی که به همراه یک جداکننده به آدرس اینترنتی قابل مشاهده‌ی خودکار تولید شده اضافه می‌شود.
path2	string متن با جداکننده به مسیر ۱ اضافه شده است.
ad_tracking_id	int64 شناسه ردیابی تبلیغ.

جستجوی تبلیغات۳۶۰محصولاطلاعات تبلیغات

این نوع هیچ فیلدی ندارد.

یک تبلیغ محصول در Search Ads 360.

SearchAds360 واکنش‌گرا SearchAdInfo

یک تبلیغ جستجوی واکنش‌گرای ۳۶۰ درجه برای تبلیغات جستجو.

فیلدها
headlines[]	AdTextAsset فهرست منابع متنی برای تیترها. وقتی تبلیغ نمایش داده می‌شود، تیترها از این فهرست انتخاب می‌شوند.
descriptions[]	AdTextAsset فهرست منابع متنی برای توضیحات. وقتی تبلیغ نمایش داده می‌شود، توضیحات از این فهرست انتخاب می‌شوند.
path1	string متنی که به همراه یک جداکننده به آدرس اینترنتی قابل مشاهده‌ی خودکار تولید شده اضافه می‌شود.
path2	string متن با جداکننده به مسیر ۱ اضافه شده است.
ad_tracking_id	int64 شناسه ردیابی تبلیغ.

جستجوی تبلیغات۳۶۰متناطلاعات تبلیغات

یک تبلیغ متنی ۳۶۰ درجه برای تبلیغات جستجو.

فیلدها
headline	string تیتر آگهی.
description1	string خط اول توضیحات آگهی.
description2	string خط دوم توضیحات آگهی.
display_url	string آدرس اینترنتی (URL) نمایش داده شده برای تبلیغ.
display_mobile_url	string آدرس اینترنتی (URL) موبایل نمایش داده شده برای تبلیغ.
ad_tracking_id	int64 شناسه ردیابی تبلیغ.

بخش‌ها

فقط فیلدهای بخش‌بندی‌شده.

فیلدها
ad_network_type	AdNetworkType نوع شبکه تبلیغاتی
conversion_action_category	ConversionActionCategory دسته بندی اقدامات تبدیل.
conversion_custom_dimensions[]	Value ابعاد سفارشی تبدیل.
day_of_week	DayOfWeek روز هفته، مثلاً دوشنبه.
device	Device دستگاهی که معیارها در مورد آن اعمال می‌شود.
keyword	Keyword معیار کلمه کلیدی.
product_channel	ProductChannel کانال محصول.
product_channel_exclusivity	ProductChannelExclusivity انحصاری بودن محصول در کانال.
product_condition	ProductCondition وضعیت محصول.
product_sold_condition	ProductCondition وضعیت محصول فروخته شده.
raw_event_conversion_dimensions[]	Value ابعاد تبدیل رویداد خام.
conversion_action	string نام منبعِ عمل تبدیل.
conversion_action_name	string نام اقدام تبدیل
date	string تاریخی که معیارها برای آن اعمال می‌شوند. قالب yyyy-MM-dd، برای مثال، 2018-04-17.
geo_target_city	string نام منبع ثابت هدف جغرافیایی که نشان دهنده یک شهر است.
geo_target_country	string نام منبع ثابت هدف جغرافیایی که نشان دهنده یک کشور است.
geo_target_metro	string نام منبع ثابت هدف جغرافیایی که نشان دهنده یک کلان شهر است.
geo_target_region	string نام منبع ثابت هدف جغرافیایی که نشان دهنده یک منطقه است.
hour	int32 ساعت روز به صورت عددی بین ۰ تا ۲۳، شامل.
month	string ماه که با تاریخ اولین روز ماه نشان داده می‌شود. قالب‌بندی آن به صورت yyyy-MM-dd است.
product_bidding_category_level1	string دسته بندی پیشنهاد قیمت (سطح ۱) محصول.
product_bidding_category_level2	string دسته بندی پیشنهاد قیمت (سطح ۲) محصول.
product_bidding_category_level3	string دسته بندی پیشنهاد قیمت (سطح ۳) محصول.
product_bidding_category_level4	string دسته بندی پیشنهاد قیمت (سطح ۴) محصول.
product_bidding_category_level5	string دسته بندی پیشنهاد قیمت (سطح ۵) محصول.
product_brand	string برند محصول.
product_country	string نام منبع ثابت هدف جغرافیایی برای کشور فروش محصول.
product_custom_attribute0	string ویژگی سفارشی ۰ برای محصول.
product_custom_attribute1	string ویژگی سفارشی ۱ محصول.
product_custom_attribute2	string ویژگی سفارشی ۲ محصول.
product_custom_attribute3	string ویژگی سفارشی ۳ محصول.
product_custom_attribute4	string ویژگی سفارشی ۴ محصول.
product_item_id	string شناسه کالا (ID) محصول.
product_language	string نام منبعِ ثابت زبان برای زبان محصول.
product_sold_bidding_category_level1	string دسته بندی پیشنهاد قیمت (سطح ۱) محصول فروخته شده.
product_sold_bidding_category_level2	string دسته بندی پیشنهاد قیمت (سطح ۲) محصول فروخته شده.
product_sold_bidding_category_level3	string دسته بندی پیشنهاد قیمت (سطح ۳) محصول فروخته شده.
product_sold_bidding_category_level4	string دسته بندی پیشنهاد قیمت (سطح ۴) محصول فروخته شده.
product_sold_bidding_category_level5	string دسته بندی پیشنهاد قیمت (سطح ۵) محصول فروخته شده.
product_sold_brand	string برند محصول فروخته شده.
product_sold_custom_attribute0	string ویژگی سفارشی ۰ از محصول فروخته شده.
product_sold_custom_attribute1	string ویژگی سفارشی ۱ از محصول فروخته شده.
product_sold_custom_attribute2	string ویژگی سفارشی ۲ از محصول فروخته شده.
product_sold_custom_attribute3	string ویژگی سفارشی ۳ از محصول فروخته شده.
product_sold_custom_attribute4	string ویژگی سفارشی ۴ از محصول فروخته شده.
product_sold_item_id	string شناسه کالای فروخته شده.
product_sold_title	string عنوان محصول فروخته شده
product_sold_type_l1	string نوع (سطح ۱) محصول فروخته شده.
product_sold_type_l2	string نوع (سطح ۲) محصول فروخته شده.
product_sold_type_l3	string نوع (سطح ۳) محصول فروخته شده.
product_sold_type_l4	string نوع (سطح ۴) محصول فروخته شده.
product_sold_type_l5	string نوع (سطح ۵) محصول فروخته شده.
product_store_id	string شناسه فروشگاه محصول.
product_title	string عنوان محصول.
product_type_l1	string نوع (سطح ۱) محصول.
product_type_l2	string نوع (سطح ۲) محصول.
product_type_l3	string نوع (سطح ۳) محصول.
product_type_l4	string نوع (سطح ۴) محصول.
product_type_l5	string نوع (سطح ۵) محصول.
quarter	string ربع (Quarter) که با تاریخ اولین روز از یک ربع نشان داده می‌شود. برای ربع‌ها از سال تقویمی استفاده می‌کند، برای مثال، ربع دوم سال ۲۰۱۸ از ۲۰۱۸-۰۴-۰۱ شروع می‌شود. به صورت yyyy-MM-dd قالب‌بندی می‌شود.
week	string هفته‌ای که از دوشنبه تا یکشنبه تعریف می‌شود و با تاریخ دوشنبه نمایش داده می‌شود. قالب‌بندی آن به صورت yyyy-MM-dd است.
year	int32 سال، با فرمت yyyy.
asset_interaction_target	AssetInteractionTarget فقط با معیارهای CustomerAsset، CampaignAsset و AdGroupAsset استفاده می‌شود. نشان می‌دهد که آیا معیارهای تعامل روی خودِ تبلیغ رخ داده است یا روی یک تبلیغ یا واحد تبلیغاتی متفاوت. تعاملات (به عنوان مثال، کلیک‌ها) در تمام بخش‌های تبلیغ ارائه شده (به عنوان مثال، خود تبلیغ و سایر اجزا مانند Sitelinks) هنگامی که با هم ارائه می‌شوند، شمارش می‌شوند. وقتی interaction_on_this_asset برابر با true باشد، به این معنی است که تعاملات روی این تبلیغ خاص هستند و وقتی interaction_on_this_asset برابر با false باشد، به این معنی است که تعاملات روی این تبلیغ خاص نیستند، بلکه روی بخش‌های دیگر تبلیغ ارائه شده‌ای هستند که این تبلیغ با آن ارائه می‌شود.

تارگت سی پی ای

یک استراتژی پیشنهاد قیمت خودکار که پیشنهادهایی را تنظیم می‌کند تا به شما کمک کند تا با توجه به هزینه به ازای هر جذب (CPA) هدفی که تعیین کرده‌اید، تا حد امکان تبدیل‌های بیشتری داشته باشید.

فیلدها
target_cpa_micros	int64 میانگین هدف CPA. این هدف باید بزرگتر یا مساوی حداقل واحد قابل پرداخت بر اساس ارز حساب باشد.
cpc_bid_ceiling_micros	int64 حداکثر محدودیت پیشنهاد قیمت که می‌تواند توسط استراتژی پیشنهاد قیمت تعیین شود. این محدودیت برای تمام کلمات کلیدی مدیریت شده توسط استراتژی اعمال می‌شود. این فقط باید برای استراتژی‌های پیشنهاد قیمت سبد سهام تعیین شود.
cpc_bid_floor_micros	int64 حداقل محدودیت پیشنهاد قیمت که می‌تواند توسط استراتژی پیشنهاد قیمت تعیین شود. این محدودیت برای تمام کلمات کلیدی مدیریت شده توسط استراتژی اعمال می‌شود. این فقط باید برای استراتژی‌های پیشنهاد قیمت سبد سهام تعیین شود.

هدف سی پی ام

این نوع هیچ فیلدی ندارد.

هدف‌گذاری CPM (هزینه به ازای هر هزار نمایش) یک استراتژی پیشنهاد قیمت خودکار است که با توجه به هدف‌گذاری CPM که تعیین می‌کنید، پیشنهادها را برای بهینه‌سازی عملکرد تنظیم می‌کند.

تارگت ایمپرشن‌شیر

یک استراتژی پیشنهاد قیمت خودکار که پیشنهادها را طوری تنظیم می‌کند که درصد مشخصی از تبلیغات جستجو در بالای صفحه اول (یا مکان هدفمند دیگر) نشان داده شوند.

فیلدها
location	TargetImpressionShareLocation مکان مورد نظر در صفحه نتایج جستجو.
location_fraction_micros	int64 کسر انتخاب‌شده از تبلیغات که باید در مکان مورد نظر نمایش داده شوند (به میکرومتر). برای مثال، ۱٪ برابر با ۱۰۰۰۰ است.
cpc_bid_ceiling_micros	int64 بالاترین پیشنهاد CPC که سیستم پیشنهاد قیمت خودکار مجاز به تعیین آن است. این یک فیلد الزامی است که توسط تبلیغ‌کننده وارد می‌شود و سقف را تعیین می‌کند و در ریزنمرات محلی مشخص شده است.

TargetOutrankShare

یک استراتژی پیشنهاد قیمت خودکار که پیشنهادها را بر اساس بخش هدف مزایده‌ها تنظیم می‌کند که در آن تبلیغ‌کننده باید از یک رقیب خاص پیشی بگیرد. این استراتژی منسوخ شده است.

فیلدها
cpc_bid_ceiling_micros	Int64Value حداکثر محدودیت پیشنهاد قیمت که می‌تواند توسط استراتژی پیشنهاد قیمت تعیین شود. این محدودیت برای همه کلمات کلیدی مدیریت شده توسط استراتژی اعمال می‌شود.

محدودیت هدف

فهرست تنظیمات هدف‌گیری به ازای هر بُعد هدف‌گیری.

فیلدها
targeting_dimension	TargetingDimension بُعد هدف‌گیری که این تنظیمات روی آن اعمال می‌شود.
bid_only	bool نشان می‌دهد که آیا تبلیغات خود را فقط برای معیارهایی که برای این targeting_dimension انتخاب کرده‌اید، محدود کنید یا همه مقادیر را برای این targeting_dimension هدف قرار دهید و تبلیغات را بر اساس هدف‌گذاری شما در سایر TargetingDimensions نشان دهید. مقدار true به این معنی است که این معیارها فقط اصلاح‌کننده‌های پیشنهاد قیمت را اعمال می‌کنند و بر هدف‌گذاری تأثیری ندارند. مقدار false به این معنی است که این معیارها علاوه بر اعمال اصلاح‌کننده‌های پیشنهاد قیمت، هدف‌گذاری را نیز محدود می‌کنند.

تارگت رواس

یک استراتژی پیشنهاد قیمت خودکار که به شما کمک می‌کند تا درآمد خود را به حداکثر برسانید و در عین حال میانگین بازگشت سرمایه هدف مشخصی را برای هزینه تبلیغات (ROAS) تعیین کنید.

فیلدها
target_roas	double الزامی. درآمد انتخاب شده (بر اساس داده‌های تبدیل) به ازای هر واحد هزینه. مقدار باید بین 0.01 تا 1000.0 باشد، شامل.
cpc_bid_ceiling_micros	int64 حداکثر محدودیت پیشنهاد قیمت که می‌تواند توسط استراتژی پیشنهاد قیمت تعیین شود. این محدودیت برای تمام کلمات کلیدی مدیریت شده توسط استراتژی اعمال می‌شود. این فقط باید برای استراتژی‌های پیشنهاد قیمت سبد سهام تعیین شود.
cpc_bid_floor_micros	int64 حداقل محدودیت پیشنهاد قیمت که می‌تواند توسط استراتژی پیشنهاد قیمت تعیین شود. این محدودیت برای تمام کلمات کلیدی مدیریت شده توسط استراتژی اعمال می‌شود. این فقط باید برای استراتژی‌های پیشنهاد قیمت سبد سهام تعیین شود.

هزینه هدف

یک استراتژی پیشنهاد قیمت خودکار که پیشنهادهای شما را طوری تنظیم می‌کند که به شما کمک کند تا حد امکان کلیک‌های بیشتری را در محدوده بودجه خود دریافت کنید.

فیلدها
target_spend_micros (deprecated)	int64 این کالا منسوخ شده است! منسوخ‌شده: هدف هزینه‌ای که تحت آن می‌توان کلیک‌ها را به حداکثر رساند. پیشنهاددهنده‌ی TargetSpend سعی می‌کند کمترین مقدار از این مقدار یا مقدار هزینه‌ی طبیعیِ محدودکننده را خرج کند. در صورت عدم تعیین، از بودجه به عنوان هدف هزینه استفاده می‌شود. این فیلد منسوخ شده است و دیگر نباید استفاده شود. برای جزئیات بیشتر به https://ads-developers.googleblog.com/2020/05/reminder-about-sunset-creation-of.html مراجعه کنید.
cpc_bid_ceiling_micros	int64 حداکثر محدودیت پیشنهاد قیمت که می‌تواند توسط استراتژی پیشنهاد قیمت تعیین شود. این محدودیت برای همه کلمات کلیدی مدیریت شده توسط استراتژی اعمال می‌شود.

تنظیمات هدف‌گیری

تنظیمات مربوط به ویژگی‌های مرتبط با هدف‌گیری، در سطوح کمپین و گروه تبلیغاتی. برای جزئیات بیشتر در مورد تنظیمات هدف‌گیری، به https://support.google.com/google-ads/answer/7365594 مراجعه کنید.

فیلدها
target_restrictions[]	TargetRestriction تنظیم هر بُعد هدف‌گیری برای محدود کردن دسترسی به کمپین یا گروه تبلیغاتی شما.

متن دارایی

یک دارایی متنی.

فیلدها
text	string محتوای متنیِ دارایی متنی.

برچسب متن

نوعی برچسب که متن را روی پس‌زمینه رنگی نمایش می‌دهد.

فیلدها
background_color	string رنگ پس‌زمینه برچسب با فرمت HEX. این رشته باید با عبارت منظم '^#([a-fA-F0-9]{6}|[a-fA-F0-9]{3})$' مطابقت داشته باشد. توجه: ممکن است رنگ پس‌زمینه برای حساب‌های مدیریتی قابل مشاهده نباشد.
description	string توضیح کوتاهی از برچسب. طول آن نباید بیش از ۲۰۰ کاراکتر باشد.

UnifiedCallAsset

یک دارایی تماس یکپارچه.

فیلدها
country_code	string کد کشور دو حرفی شماره تلفن. مثال‌ها: «ایالات متحده»، «ما».
phone_number	string شماره تلفن خام تبلیغ‌کننده. مثال‌ها: '1234567890'، '[phone]'
call_conversion_reporting_state	CallConversionReportingState نشان می‌دهد که آیا این CallAsset باید از تنظیمات تبدیل تماس مخصوص به خود استفاده کند، از تنظیمات سطح حساب پیروی کند یا تبدیل تماس را غیرفعال کند.
call_conversion_action	string عمل تبدیلی که تبدیل فراخوانی را به آن نسبت می‌دهد. اگر تنظیم نشده باشد، از عمل تبدیل پیش‌فرض استفاده می‌شود. این فیلد فقط در صورتی مؤثر است که call_conversion_reporting_state روی USE_RESOURCE_LEVEL_CALL_CONVERSION_ACTION تنظیم شده باشد.
ad_schedule_targets[]	AdScheduleInfo فهرست برنامه‌های غیرهمپوشان که تمام فواصل زمانی که دارایی ممکن است در آنها خدمت‌رسانی کند را مشخص می‌کند. حداکثر ۶ برنامه در روز، در مجموع ۴۲ برنامه، می‌تواند وجود داشته باشد.
call_only	bool اینکه آیا تماس فقط شماره تلفن را بدون لینک به وب‌سایت نشان می‌دهد یا خیر. این مورد در مورد تبلیغات مایکروسافت صدق می‌کند.
call_tracking_enabled	bool اینکه آیا تماس باید در ردیابی تماس فعال باشد یا خیر. برای تبلیغات مایکروسافت اعمال می‌شود.
use_searcher_time_zone	bool اینکه آیا افزونه تماس در منطقه زمانی کاربر جستجو نمایش داده شود یا خیر. این مورد برای تبلیغات مایکروسافت اعمال می‌شود.
start_date	string تاریخ شروع اعتبار و شروع به کار این دارایی، با فرمت yyyy-MM-dd.
end_date	string آخرین تاریخ اعتبار و استفاده از این دارایی، با فرمت yyyy-MM-dd.

دارایی یکپارچه Callout

یک دارایی فراخوان یکپارچه.

فیلدها
callout_text	string متن فراخوان. طول این رشته باید بین ۱ تا ۲۵ باشد، شامل همه.
start_date	string تاریخ شروع اعتبار و شروع به کار این دارایی، با فرمت yyyy-MM-dd.
end_date	string آخرین تاریخ اعتبار و استفاده از این دارایی، با فرمت yyyy-MM-dd.
ad_schedule_targets[]	AdScheduleInfo فهرست برنامه‌های غیرهمپوشان که تمام فواصل زمانی که دارایی ممکن است در آنها خدمت‌رسانی کند را مشخص می‌کند. حداکثر ۶ برنامه در روز، در مجموع ۴۲ برنامه، می‌تواند وجود داشته باشد.
use_searcher_time_zone	bool نمایش محتوا در منطقه زمانی کاربر جستجو. این مورد برای تبلیغات مایکروسافت اعمال می‌شود.

دارایی UnifiedLocation

یک دارایی مکانی یکپارچه.

فیلدها
place_id	string شناسه‌های مکان، یک مکان را به طور منحصر به فرد در پایگاه داده Google Places و در Google Maps مشخص می‌کنند. این فیلد برای یک شناسه مشتری و نوع دارایی مشخص، منحصر به فرد است. برای کسب اطلاعات بیشتر در مورد شناسه مکان، به https://developers.google.com/places/web-service/place-id مراجعه کنید.
business_profile_locations[]	BusinessProfileLocation فهرست مکان‌های تجاری برای مشتری. این فهرست فقط در صورتی برگردانده می‌شود که دارایی مکان از حساب نمایه تجاری همگام‌سازی شود. می‌توان چندین فهرست نمایه تجاری را تحت یک حساب کاربری داشت که به یک شناسه مکان اشاره می‌کنند.
location_ownership_type	LocationOwnershipType نوع مالکیت مکان. اگر نوع آن BUSINESS_OWNER باشد، به عنوان یک افزونه مکان ارائه می‌شود. اگر نوع آن AFFILIATE باشد، به عنوان یک مکان وابسته ارائه می‌شود.

UnifiedPageFeedAsset

یک منبع فید صفحه یکپارچه.

فیلدها
page_url	string صفحه وبی که تبلیغ‌کنندگان می‌خواهند آن را هدف قرار دهند.
labels[]	string برچسب‌هایی که برای گروه‌بندی آدرس‌های اینترنتی صفحات استفاده می‌شوند.

دارایی UnifiedSitelink

یک دارایی یکپارچه برای لینک‌های سایت.

فیلدها
link_text	string متن نمایشی URL برای لینک سایت. طول این رشته باید بین ۱ تا ۲۵ باشد.
description1	string خط اول توضیحات برای لینک سایت. در صورت تنظیم، طول آن باید بین ۱ تا ۳۵ باشد، شامل همه، و description2 نیز باید تنظیم شود.
description2	string خط دوم توضیحات برای لینک سایت. در صورت تنظیم، طول آن باید بین ۱ تا ۳۵ باشد، شامل همه، و description1 نیز باید تنظیم شود.
start_date	string تاریخ شروع اعتبار و شروع به کار این دارایی، با فرمت yyyy-MM-dd.
end_date	string آخرین تاریخ اعتبار و استفاده از این دارایی، با فرمت yyyy-MM-dd.
ad_schedule_targets[]	AdScheduleInfo فهرست برنامه‌های غیرهمپوشان که تمام فواصل زمانی که دارایی ممکن است در آنها خدمت‌رسانی کند را مشخص می‌کند. حداکثر ۶ برنامه در روز، در مجموع ۴۲ برنامه، می‌تواند وجود داشته باشد.
tracking_id	int64 شناسه‌ای که برای ردیابی کلیک‌ها برای دارایی لینک سایت استفاده می‌شود. این فیلد فقط برای یاهو! ژاپن است.
use_searcher_time_zone	bool نمایش یا عدم نمایش لینک سایت در منطقه زمانی کاربر جستجو. این مورد برای تبلیغات مایکروسافت اعمال می‌شود.
mobile_preferred	bool اینکه آیا ترجیح می‌دهید محتوای لینک سایت در دستگاه‌های تلفن همراه نمایش داده شود یا خیر. این مورد برای تبلیغات مایکروسافت اعمال می‌شود.

اطلاعات لیست کاربران

معیار فهرست کاربران. نشان‌دهنده فهرست کاربرانی است که توسط تبلیغ‌کننده برای هدف‌گیری تعریف شده‌اند.

فیلدها
user_list	string نام منبع فهرست کاربران.

ارزش

یک ظرف داده عمومی.

فیلدها
value فیلد Union. یک مقدار. value می‌تواند فقط یکی از موارد زیر باشد:
boolean_value	bool یک مقدار بولی.
int64_value	int64 یک عدد صحیح ۶۴.
float_value	float یک شناور.
double_value	double یک دوبل.
string_value	string یک رشته.

اطلاعات وضعیت صفحه وب

عبارت منطقی برای هدف قرار دادن صفحات وب وب‌سایت یک تبلیغ‌کننده.

فیلدها
operand	WebpageConditionOperand عملوند شرط هدف‌گیری صفحه وب.
operator	WebpageConditionOperator اپراتور شرط هدف‌گیری صفحه وب.
argument	string آرگومان شرط هدف‌گیری صفحه وب.

اطلاعات صفحه وب

معیاری برای هدف قرار دادن صفحات وب وب‌سایت تبلیغ‌کننده را نشان می‌دهد.

فیلدها
conditions[]	WebpageConditionInfo شرط‌ها یا عبارات منطقی برای هدف‌گیری صفحات وب. فهرست شرط‌های هدف‌گیری صفحات وب هنگام ارزیابی برای هدف‌گیری، با هم جمع می‌شوند. فهرست خالی شرط‌ها نشان می‌دهد که تمام صفحات وب‌سایت کمپین هدف‌گیری شده‌اند. این فیلد برای عملیات CREATE الزامی است و در عملیات UPDATE ممنوع است.
coverage_percentage	double Website criteria coverage percentage. This is the computed percentage of website coverage based on the website target, negative website target and negative keywords in the ad group and campaign. For instance, when coverage returns as 1, it indicates it has 100% coverage. This field is read-only.
criterion_name	string The name of the criterion that is defined by this parameter. The name value will be used for identifying, sorting and filtering criteria with this type of parameters. This field is required for CREATE operations and is prohibited on UPDATE operations.

YoutubeVideoAsset

A YouTube asset.

فیلدها
youtube_video_title	string YouTube video title.
youtube_video_id	string YouTube video id. This is the 11 character string value used in the YouTube video URL.