شاخص
-
AdScheduleInfo
(پیام) -
AdTextAsset
(پیام) -
AgeRangeInfo
(پیام) -
AssetInteractionTarget
(پیام) -
AssetUsage
(پیام) -
AudienceInfo
(پیام) -
BusinessProfileLocation
(پیام) -
CallToActionAsset
(پیام) -
CustomParameter
(پیام) -
DeviceInfo
(پیام) -
EnhancedCpc
(پیام) -
FrequencyCapEntry
(پیام) -
GenderInfo
(پیام) -
ImageAsset
(پیام) -
ImageDimension
(پیام) -
Keyword
(پیام) -
KeywordInfo
(پیام) -
LanguageInfo
(پیام) -
ListingGroupInfo
(پیام) -
LocationGroupInfo
(پیام) -
LocationInfo
(پیام) -
ManualCpa
(پیام) -
ManualCpc
(پیام) -
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
(پیام)
AdScheduleInfo
یک معیار AdSchedule را نشان می دهد.
AdSchedule به عنوان روز هفته و بازه زمانی مشخص شده است که در آن تبلیغات نمایش داده می شود.
نمی توان بیش از شش AdSchedule را برای یک روز اضافه کرد.
فیلدها | |
---|---|
start_minute | چند دقیقه پس از ساعت شروع که این برنامه در آن شروع می شود. این فیلد برای عملیات CREATE لازم است و در عملیات UPDATE ممنوع است. |
end_minute | چند دقیقه پس از ساعت پایانی که این برنامه در آن به پایان می رسد. برنامه منحصر به دقیقه پایانی است. این فیلد برای عملیات CREATE لازم است و در عملیات UPDATE ممنوع است. |
day_of_week | روز هفته برنامه برای آن اعمال می شود. این فیلد برای عملیات CREATE لازم است و در عملیات UPDATE ممنوع است. |
start_hour | شروع ساعت در 24 ساعت این فیلد باید بین 0 تا 23 باشد. این فیلد برای عملیات CREATE لازم است و در عملیات UPDATE ممنوع است. |
end_hour | ساعت پایان در 24 ساعت زمان؛ 24 به معنای پایان روز است. این فیلد باید بین 0 تا 24 باشد. این فیلد برای عملیات CREATE لازم است و در عملیات UPDATE ممنوع است. |
AdTextAsset
دارایی متنی که در یک آگهی استفاده می شود.
فیلدها | |
---|---|
text | متن دارایی |
AgeRangeInfo
یک معیار محدوده سنی
فیلدها | |
---|---|
type | نوع محدوده سنی |
AssetInteractionTarget
یک بخش AssetInteractionTarget.
فیلدها | |
---|---|
asset | نام منبع دارایی |
interaction_on_this_asset | فقط با معیارهای CustomerAsset، CampaignAsset و AdGroupAsset استفاده می شود. نشان می دهد که آیا معیارهای تعامل در خود دارایی رخ داده است یا یک دارایی یا واحد تبلیغاتی دیگر. |
AssetUsage
حاوی اطلاعات استفاده از دارایی است.
فیلدها | |
---|---|
asset | نام منبع دارایی |
served_asset_field_type | نوع فیلد ارائه شده دارایی. |
AudienceInfo
یک معیار مخاطب
فیلدها | |
---|---|
audience | نام منبع مخاطب. |
Business ProfileLocation
دادههای مکان نمایه کسبوکار از حساب نمایه کسبوکار مرتبط همگامسازی شده است.
فیلدها | |
---|---|
labels[] | برچسب مشخص شده توسط تبلیغ کننده برای مکان در حساب نمایه کسب و کار. این از حساب نمایه کسبوکار همگامسازی شده است. |
store_code | کد فروشگاه نمایه کسبوکار این مکان. این از حساب نمایه کسبوکار همگامسازی شده است. |
listing_id | شناسه فهرست این مکان نمایه کسب و کار. این از حساب پیوند کسب و کار نمایه همگامسازی شده است. |
CallToActionAsset
دارایی دعوت به اقدام
فیلدها | |
---|---|
call_to_action | فراخوان به اقدام. |
پارامتر سفارشی
نقشهبرداری که میتواند توسط برچسبهای پارامتر سفارشی در tracking_url_template
، final_urls
، یا mobile_final_urls
استفاده شود.
فیلدها | |
---|---|
key | کلیدی که با نام تگ پارامتر مطابقت دارد. |
value | مقداری که باید جایگزین شود. |
اطلاعات دستگاه
یک معیار دستگاه
فیلدها | |
---|---|
type | نوع دستگاه. |
EnhancedCpc
این نوع هیچ فیلدی ندارد.
یک استراتژی قیمتگذاری خودکار که قیمتها را برای کلیکهایی که به نظر میرسد بیشتر منجر به تبدیل میشوند، افزایش میدهد و برای کلیکهایی که احتمال کمتری به نظر میرسد، آنها را کاهش میدهد.
این استراتژی مناقصه منسوخ شده است و دیگر نمی توان آن را ایجاد کرد. از ManualCpc با تنظیم شده به true_cpc_enabled از Manual برای عملکرد معادل استفاده کنید.
FrequencyCapEntry
این نوع هیچ فیلدی ندارد.
قاعده ای که حداکثر تعداد دفعاتی که یک تبلیغ (یا مجموعه ای از تبلیغات) می تواند به کاربر در یک بازه زمانی خاص نشان داده شود را مشخص می کند.
اطلاعات جنسیتی
یک معیار جنسیتی
فیلدها | |
---|---|
type | نوع جنسیت |
ImageAsset
دارایی تصویر
فیلدها | |
---|---|
mime_type | نوع MIME دارایی تصویر. |
full_size | فراداده این تصویر در اندازه اصلی آن. |
file_size | اندازه فایل دارایی تصویر بر حسب بایت. |
ابعاد تصویر
متادیتا برای یک تصویر در اندازه معین، اعم از اصلی یا تغییر اندازه.
فیلدها | |
---|---|
height_pixels | ارتفاع تصویر. |
width_pixels | عرض تصویر. |
url | URL که تصویر را با این ارتفاع و عرض برمی گرداند. |
کلمه کلیدی
بخش معیار کلمه کلیدی
فیلدها | |
---|---|
info | اطلاعات کلمه کلیدی |
ad_group_criterion | نام منبع AdGroupCriterion. |
KeywordInfo
معیار کلمه کلیدی
فیلدها | |
---|---|
match_type | نوع مطابقت کلمه کلیدی. |
text | متن کلمه کلیدی (حداکثر 80 کاراکتر و 10 کلمه). |
LanguageInfo
یک معیار زبان
فیلدها | |
---|---|
language_constant | نام منبع ثابت زبان. |
ListingGroupInfo
یک معیار گروه فهرست بندی
فیلدها | |
---|---|
type | نوع گروه لیست |
LocationGroupInfo
شعاع اطراف فهرستی از مکانهای مشخص شده از طریق فید.
فیلدها | |
---|---|
geo_target_constants[] | ثابت(های) هدف جغرافیایی که محدوده منطقه جغرافیایی را در خوراک محدود می کند. در حال حاضر فقط یک ثابت هدف جغرافیایی مجاز است. |
radius_units | واحد شعاع. مایل ها و متر ها برای ثابت های هدف جغرافیایی پشتیبانی می شوند. میلی مایل و متر برای مجموعه اقلام خوراک پشتیبانی می شود. این مورد نیاز است و باید در عملیات CREATE تنظیم شود. |
feed_item_sets[] | FeedItemSets که FeedItems آنها هدف قرار می گیرند. اگر چندین شناسه مشخص شده باشد، تمام مواردی که حداقل در یک مجموعه ظاهر می شوند، هدف قرار می گیرند. این فیلد با geo_target_constants قابل استفاده نیست. این اختیاری است و فقط در عملیات CREATE قابل تنظیم است. |
radius | فاصله در واحدهایی که شعاع اطراف مکان های مورد نظر را مشخص می کند. این مورد نیاز است و باید در عملیات CREATE تنظیم شود. |
LocationInfo
یک معیار مکان.
فیلدها | |
---|---|
geo_target_constant | نام منبع ثابت هدف جغرافیایی. |
ManualCpa
این نوع هیچ فیلدی ندارد.
استراتژی مناقصه دستی که به تبلیغ کننده اجازه می دهد قیمت پیشنهادی را برای هر اقدام مشخص شده توسط تبلیغ کننده تنظیم کند.
ManualCpc
مناقصه مبتنی بر کلیک دستی که در آن کاربر به ازای هر کلیک پرداخت می کند.
فیلدها | |
---|---|
enhanced_cpc_enabled | اینکه آیا پیشنهادها قرار است بر اساس دادههای بهینهساز تبدیل افزایش یابد یا خیر. |
ManualCpm
این نوع هیچ فیلدی ندارد.
مناقصه مبتنی بر نمایش دستی که در آن کاربر به ازای هر هزار بار نمایش پرداخت می کند.
MaximizeConversionValue
یک استراتژی مناقصه خودکار برای کمک به به دست آوردن بیشترین ارزش تبدیل برای کمپین های خود در حالی که بودجه خود را خرج می کنید.
فیلدها | |
---|---|
cpc_bid_ceiling_micros | حداکثر حد پیشنهادی که می تواند توسط استراتژی پیشنهاد تعیین شود. این محدودیت برای همه کلمات کلیدی مدیریت شده توسط استراتژی اعمال می شود. فقط برای استراتژی های مناقصه نمونه کارها قابل تغییر است. |
cpc_bid_floor_micros | حداقل حد پیشنهادی که می تواند توسط استراتژی پیشنهاد تعیین شود. این محدودیت برای همه کلمات کلیدی مدیریت شده توسط استراتژی اعمال می شود. فقط برای استراتژی های مناقصه نمونه کارها قابل تغییر است. |
target_roas | گزینه بازده هدف تبلیغات (ROAS). اگر تنظیم شود، استراتژی پیشنهاد قیمت درآمد را به حداکثر میرساند و در عین حال میانگین بازده هدف در هزینه تبلیغات را به دست میآورد. اگر ROAS هدف بالا باشد، استراتژی پیشنهادی ممکن است نتواند کل بودجه را خرج کند. اگر ROAS هدف تعیین نشده باشد، هدف استراتژی پیشنهادی دستیابی به بالاترین ROAS ممکن برای بودجه خواهد بود. |
MaximizeConversions
یک استراتژی مناقصه خودکار برای کمک به دریافت بیشترین تبدیل برای کمپین های خود در حالی که بودجه خود را خرج می کنید.
فیلدها | |
---|---|
cpc_bid_ceiling_micros | حداکثر حد پیشنهادی که می تواند توسط استراتژی پیشنهاد تعیین شود. این محدودیت برای همه کلمات کلیدی مدیریت شده توسط استراتژی اعمال می شود. فقط برای استراتژی های مناقصه نمونه کارها قابل تغییر است. |
cpc_bid_floor_micros | حداقل حد پیشنهادی که می تواند توسط استراتژی پیشنهاد تعیین شود. این محدودیت برای همه کلمات کلیدی مدیریت شده توسط استراتژی اعمال می شود. فقط برای استراتژی های مناقصه نمونه کارها قابل تغییر است. |
target_cpa_micros | گزینه هزینه به ازای هر اقدام (CPA) هدف. این میانگین مبلغی است که میخواهید برای هر اقدام تبدیل مشخص شده در واحدهای خرد ارز استراتژی مناقصه هزینه کنید. در صورت تنظیم، استراتژی پیشنهاد قیمت تا حد ممکن تبدیل به مقدار هزینه به ازای هر اقدام هدف یا کمتر خواهد شد. اگر CPA هدف تعیین نشده باشد، هدف استراتژی پیشنهادی دستیابی به کمترین CPA ممکن با توجه به بودجه است. |
معیارها
داده های متریک
فیلدها | |
---|---|
all_conversions_value_by_conversion_date | ارزش همه تبدیل ها وقتی این ستون با تاریخ انتخاب می شود، مقادیر در ستون تاریخ به معنای تاریخ تبدیل است. جزئیات ستونهای by_conversion_date در https://support.google.com/sa360/answer/9250611 موجود است. |
all_conversions_by_conversion_date | تعداد کل تبدیل. این شامل همه تبدیلها بدون توجه به مقدار include_in_conversions_metric میشود. وقتی این ستون با تاریخ انتخاب می شود، مقادیر در ستون تاریخ به معنای تاریخ تبدیل است. جزئیات ستونهای by_conversion_date در https://support.google.com/sa360/answer/9250611 موجود است. |
conversion_custom_metrics[] | معیارهای سفارشی تبدیل |
conversions_value_by_conversion_date | مجموع ارزش تبدیل های قابل پیشنهاد بر اساس تاریخ تبدیل. وقتی این ستون با تاریخ انتخاب می شود، مقادیر در ستون تاریخ به معنای تاریخ تبدیل است. |
conversions_by_conversion_date | مجموع تبدیلها بر اساس تاریخ تبدیل برای انواع تبدیلهای قابل پیشنهاد. به دلیل مدل سازی اسناد می تواند کسری باشد. وقتی این ستون با تاریخ انتخاب می شود، مقادیر در ستون تاریخ به معنای تاریخ تبدیل است. |
historical_creative_quality_score | امتیاز کیفی تاریخی خلاق. |
historical_landing_page_quality_score | کیفیت تجربه صفحه فرود تاریخی |
historical_search_predicted_ctr | جستجوی تاریخی نرخ کلیک (CTR) را پیشبینی میکرد. |
interaction_event_types[] | انواع تعاملات قابل پرداخت و رایگان. |
raw_event_conversion_metrics[] | معیارهای تبدیل رویداد خام |
absolute_top_impression_percentage | سهم تأثیر مطلق جستجو در بالای صفحه، درصدی از نمایشهای آگهی جستجوی شما است که در برجستهترین موقعیت جستجو نشان داده میشود. |
all_conversions_from_interactions_rate | همه تبدیلهای حاصل از تعاملات (برخلاف مشاهده از طریق تبدیل) تقسیم بر تعداد تعاملات تبلیغاتی. |
all_conversions_value | ارزش همه تبدیل ها |
all_conversions | تعداد کل تبدیل. این شامل همه تبدیلها بدون توجه به مقدار include_in_conversions_metric میشود. |
all_conversions_value_per_cost | ارزش تمام تبدیل ها تقسیم بر هزینه کل تعاملات تبلیغاتی (مانند کلیک برای تبلیغات متنی یا بازدید برای تبلیغات ویدیویی). |
all_conversions_from_click_to_call | تعداد دفعاتی که افراد روی دکمه «تماس» برای تماس با فروشگاه در حین یا پس از کلیک بر روی آگهی کلیک کردند. این شماره شامل متصل بودن یا نبودن تماسها یا مدت تماس نیست. این معیار فقط برای موارد فید اعمال می شود. |
all_conversions_from_directions | تعداد دفعاتی که افراد روی دکمه «دریافت مسیرها» کلیک کردند تا پس از کلیک بر روی یک آگهی به فروشگاه بروید. این معیار فقط برای موارد فید اعمال می شود. |
all_conversions_from_interactions_value_per_interaction | ارزش همه تبدیلهای حاصل از تعاملات تقسیم بر تعداد کل تعاملات. |
all_conversions_from_menu | تعداد دفعاتی که افراد پس از کلیک بر روی یک تبلیغ، برای مشاهده منوی فروشگاه روی یک پیوند کلیک کردند. این معیار فقط برای موارد فید اعمال می شود. |
all_conversions_from_order | تعداد دفعاتی که افراد پس از کلیک کردن بر روی تبلیغ، در فروشگاهی سفارش دادند. این معیار فقط برای موارد فید اعمال می شود. |
all_conversions_from_other_engagement | تعداد تبدیلهای دیگر (به عنوان مثال، ارسال نظر یا ذخیره یک مکان برای یک فروشگاه) که پس از کلیک افراد روی یک آگهی رخ داده است. این معیار فقط برای موارد فید اعمال می شود. |
all_conversions_from_store_visit | تعداد تخمینی تعداد دفعاتی که افراد پس از کلیک بر روی یک تبلیغ از یک فروشگاه بازدید می کنند. این معیار فقط برای موارد فید اعمال می شود. |
visits | کلیکهایی که Search Ads 360 با موفقیت ثبت کرده و به صفحه مقصد تبلیغکننده ارسال شده است. |
all_conversions_from_store_website | تعداد دفعاتی که افراد پس از کلیک کردن بر روی یک تبلیغ به آدرس اینترنتی فروشگاه منتقل شدند. این معیار فقط برای موارد فید اعمال می شود. |
average_cost | میانگین مبلغی که برای هر تعامل پرداخت می کنید. این مبلغ کل هزینه تبلیغات شما تقسیم بر تعداد کل تعاملات است. |
average_cpc | هزینه کل همه کلیک ها تقسیم بر تعداد کل کلیک های دریافت شده. این معیار یک ارزش پولی است و به صورت پیشفرض به واحد پول مشتری بازگردانده میشود. پارامتر metrics_currency را در https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause ببینید |
average_cpm | میانگین هزینه به ازای هر هزار نمایش (CPM). این معیار یک ارزش پولی است و به صورت پیشفرض به واحد پول مشتری بازگردانده میشود. پارامتر metrics_currency را در https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause ببینید |
clicks | تعداد کلیک ها. |
content_budget_lost_impression_share | درصد تخمینی مواقعی که تبلیغ شما واجد شرایط نمایش در شبکه نمایش بود اما به دلیل پایین بودن بودجه شما واجد شرایط نبود. توجه: سهم برداشت از دست رفته بودجه محتوا در محدوده 0 تا 0.9 گزارش شده است. هر مقدار بالاتر از 0.9 به عنوان 0.9001 گزارش می شود. |
content_impression_share | نمایشهایی که در Display Network دریافت کردهاید تقسیم بر تعداد تخمینی نمایشهایی که واجد شرایط دریافت آن بودید. توجه: سهم نمایش محتوا در محدوده 0.1 تا 1 گزارش می شود. هر مقدار کمتر از 0.1 به عنوان 0.0999 گزارش می شود. |
content_rank_lost_impression_share | درصد تخمینی نمایشهایی در شبکه نمایش که تبلیغات شما به دلیل رتبه پایین آگهی دریافت نکرده است. توجه: رتبه محتوا سهم برداشت از دست رفته در محدوده 0 تا 0.9 گزارش شده است. هر مقدار بالاتر از 0.9 به عنوان 0.9001 گزارش می شود. |
conversions_from_interactions_rate | میانگین تبدیلهای قابل پیشنهاد (از تعامل) به ازای هر تعامل واجد شرایط تبدیل. نشان می دهد که به طور متوسط هر چند وقت یک تعامل تبلیغاتی منجر به تبدیل قابل پیشنهاد می شود. |
client_account_conversions_value | ارزش تبدیل حساب مشتری این فقط شامل اقدامات تبدیلی میشود که شامل_in_client_account_conversions_metric مشخصه روی درست تنظیم شده است. اگر از مناقصه مبتنی بر تبدیل استفاده میکنید، استراتژیهای پیشنهادی شما برای این تبدیلها بهینه میشوند. |
conversions_value_per_cost | ارزش تبدیل قابل پیشنهاد تقسیم بر هزینه کل تعاملات واجد شرایط تبدیل. |
conversions_from_interactions_value_per_interaction | ارزش تبدیلهای حاصل از تعاملات تقسیم بر تعداد تعاملات تبلیغاتی. این فقط شامل اقدامات تبدیلی میشود که ویژگی include_in_conversions_metric روی درست تنظیم شده است. اگر از مناقصه مبتنی بر تبدیل استفاده میکنید، استراتژیهای پیشنهادی شما برای این تبدیلها بهینه میشوند. |
client_account_conversions | تعداد تبدیل حساب مشتری این فقط شامل اقدامات تبدیلی میشود که شامل_in_client_account_conversions_metric مشخصه روی درست تنظیم شده است. اگر از مناقصه مبتنی بر تبدیل استفاده میکنید، استراتژیهای پیشنهادی شما برای این تبدیلها بهینه میشوند. |
cost_micros | مجموع هزینههای هزینه هر کلیک (CPC) و هزینه به ازای هر هزار نمایش (CPM) شما در این دوره. این معیار یک ارزش پولی است و به صورت پیشفرض به واحد پول مشتری بازگردانده میشود. پارامتر metrics_currency را در https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause ببینید |
cost_per_all_conversions | هزینه تعاملات تبلیغاتی تقسیم بر همه تبدیل ها. |
cost_per_conversion | میانگین هزینه واجد شرایط تبدیل به ازای هر تبدیل قابل پیشنهاد. |
cost_per_current_model_attributed_conversion | هزینه تعاملات تبلیغاتی تقسیم بر تبدیل های نسبت داده شده به مدل فعلی. این فقط شامل اقدامات تبدیلی میشود که ویژگی include_in_conversions_metric روی درست تنظیم شده است. اگر از مناقصه مبتنی بر تبدیل استفاده میکنید، استراتژیهای پیشنهادی شما برای این تبدیلها بهینه میشوند. |
cross_device_conversions | تبدیل ها از زمانی که مشتری روی یک تبلیغ در یک دستگاه کلیک می کند، سپس در دستگاه یا مرورگر دیگری تبدیل می کند. تبدیلهای بین دستگاهی قبلاً در all_conversions گنجانده شده است. |
cross_device_conversions_by_conversion_date | تعداد تبدیلهای بین دستگاهی بر اساس تاریخ تبدیل. جزئیات ستونهای by_conversion_date در https://support.google.com/sa360/answer/9250611 موجود است. |
cross_device_conversions_value | مجموع مقدار تبدیل های متقابل دستگاه. |
cross_device_conversions_value_by_conversion_date | مجموع ارزش تبدیلهای بین دستگاهی بر اساس تاریخ تبدیل. جزئیات ستونهای by_conversion_date در https://support.google.com/sa360/answer/9250611 موجود است. |
ctr | تعداد کلیکهایی که تبلیغ شما دریافت میکند (کلیکها) تقسیم بر تعداد دفعاتی که تبلیغ شما نشان داده میشود (Impressions). |
conversions | تعداد تبدیل. این فقط شامل اقدامات تبدیلی میشود که ویژگی include_in_conversions_metric روی درست تنظیم شده است. اگر از مناقصه مبتنی بر تبدیل استفاده میکنید، استراتژیهای پیشنهادی شما برای این تبدیلها بهینه میشوند. |
conversions_value | مجموع مقادیر تبدیل برای تبدیل های موجود در قسمت "تبدیل ها". این معیار فقط در صورتی مفید است که مقداری را برای اقدامات تبدیل خود وارد کرده باشید. |
average_quality_score | نمره کیفیت متوسط. |
historical_quality_score | امتیاز کیفیت تاریخی |
impressions | تعداد دفعاتی که تبلیغ شما در یک صفحه نتایج جستجو یا وب سایت در شبکه Google ظاهر شده است. |
interaction_rate | هر چند وقت یکبار افراد پس از نمایش آگهی شما با آنها تعامل برقرار می کنند. این تعداد تعاملات تقسیم بر تعداد دفعاتی است که تبلیغ شما نشان داده می شود. |
interactions | تعداد تعاملات تعامل، اقدام اصلی کاربر است که با قالب تبلیغ مرتبط است - کلیکها برای تبلیغات متنی و خرید، بازدیدها برای تبلیغات ویدیویی و غیره. |
invalid_click_rate | درصد کلیکهای فیلتر شده از تعداد کل کلیکهای شما (کلیکهای فیلتر شده + فیلتر نشده) در طول دوره گزارش. |
invalid_clicks | تعداد کلیکهایی که گوگل نامشروع میداند و هزینهای را از شما دریافت نمیکند. |
general_invalid_click_rate | درصد کلیکهایی که از تعداد کل کلیکهای شما (کلیکهای فیلتر شده + فیلتر نشده) به دلیل کلیکلیکهای نامعتبر فیلتر شدهاند. اینها کلیکهایی هستند که Google آنها را غیرقانونی میداند و از طریق روشهای معمول فیلتر کردن (یعنی ترافیک نامعتبر مرکز داده، رباتها و عنکبوتها یا سایر خزندهها، الگوهای نامنظم و غیره) شناسایی میشوند. برای آنها هزینه ای از شما دریافت نمی شود و آنها بر آمار حساب شما تأثیر نمی گذارند. برای جزئیات به صفحه راهنما در https://support.google.com/campaignmanager/answer/6076504 مراجعه کنید. |
general_invalid_clicks | تعداد کلیکهای نامعتبر عمومی اینها زیرمجموعهای از کلیکهای نامعتبر شما هستند که از طریق روشهای معمول فیلتر کردن (مانند ترافیک نامعتبر مرکز داده، رباتها و عنکبوتها یا سایر خزندهها، الگوهای نامنظم و غیره) شناسایی میشوند. برای آنها هزینه ای از شما دریافت نمی شود و آنها بر آمار حساب شما تأثیر نمی گذارند. برای جزئیات به صفحه راهنما در https://support.google.com/campaignmanager/answer/6076504 مراجعه کنید. |
mobile_friendly_clicks_percentage | درصد کلیک های موبایلی که به یک صفحه سازگار با موبایل می رود. |
search_absolute_top_impression_share | درصدی از آگهیهای خرید یا جستجوی مشتری که در برجستهترین موقعیت خرید نشان داده میشوند. برای جزئیات به https://support.google.com/sa360/answer/9566729 مراجعه کنید. هر مقدار کمتر از 0.1 به عنوان 0.0999 گزارش می شود. |
search_budget_lost_absolute_top_impression_share | عددی که تخمین میزند که چقدر تبلیغ شما به دلیل بودجه کم، اولین تبلیغ در بین آگهیهای برتر در نتایج جستجو نیست. توجه: بودجه جست و جو از دست رفته سهم نمایش برتر مطلق در محدوده 0 تا 0.9 گزارش شده است. هر مقدار بالاتر از 0.9 به عنوان 0.9001 گزارش می شود. |
search_budget_lost_impression_share | درصد تخمینی مواقعی که تبلیغ شما واجد شرایط نمایش در شبکه جستجو بود اما به دلیل پایین بودن بودجه شما واجد شرایط نبود. توجه: سهم برداشت از دست رفته بودجه جستجو در محدوده 0 تا 0.9 گزارش شده است. هر مقدار بالاتر از 0.9 به عنوان 0.9001 گزارش می شود. |
search_budget_lost_top_impression_share | عددی که تخمین میزند چند بار تبلیغ شما به دلیل بودجه کم در مجاورت نتایج جستجوی ارگانیک برتر نمایش داده نمیشود. توجه: بودجه جستجو از دست رفته سهم نمایش برتر در محدوده 0 تا 0.9 گزارش شده است. هر مقدار بالاتر از 0.9 به عنوان 0.9001 گزارش می شود. |
search_click_share | تعداد کلیکهایی که در شبکه جستجو دریافت کردهاید تقسیم بر تعداد تخمینی کلیکهایی که واجد شرایط دریافت آن بودید. توجه: سهم کلیک جستجو در محدوده 0.1 تا 1 گزارش می شود. هر مقدار زیر 0.1 به عنوان 0.0999 گزارش می شود. |
search_exact_match_impression_share | نمایشهایی که دریافت کردهاید تقسیم بر تعداد تخمینی نمایشهایی که واجد شرایط دریافت آنها در شبکه جستجو بودید برای عبارات جستجویی که دقیقاً با کلمات کلیدی شما مطابقت داشتند (یا انواع نزدیک کلمه کلیدی شما بودند)، صرف نظر از نوع تطبیق کلمه کلیدی شما. توجه: سهم نمایش منطبق دقیق جستجو در محدوده 0.1 تا 1 گزارش می شود. هر مقدار کمتر از 0.1 به عنوان 0.0999 گزارش می شود. |
search_impression_share | نمایشهایی که در شبکه جستجو دریافت کردهاید تقسیم بر تعداد تخمینی نمایشهایی که واجد شرایط دریافت آن بودید. توجه: سهم نمایش جستجو در محدوده 0.1 تا 1 گزارش می شود. هر مقدار کمتر از 0.1 به عنوان 0.0999 گزارش می شود. |
search_rank_lost_absolute_top_impression_share | عددی که تخمین میزند چقدر تبلیغ شما به دلیل رتبه پایین آگهی، اولین آگهی در بین آگهیهای برتر در نتایج جستجو نبوده است. توجه: رتبه جستجو از دست رفته سهم برداشت مطلق در محدوده 0 تا 0.9 گزارش شده است. هر مقدار بالاتر از 0.9 به عنوان 0.9001 گزارش می شود. |
search_rank_lost_impression_share | درصد تخمینی نمایشهایی در شبکه جستجو که تبلیغات شما به دلیل رتبه پایین آگهی دریافت نکرده است. توجه: رتبه جستجو سهم برداشت از دست رفته در محدوده 0 تا 0.9 گزارش شده است. هر مقدار بالاتر از 0.9 به عنوان 0.9001 گزارش می شود. |
search_rank_lost_top_impression_share | عددی که تخمین میزند چند بار تبلیغ شما به دلیل رتبه پایین آگهی در مجاورت نتایج جستجوی ارگانیک برتر نمایش داده نمیشود. توجه: رتبه جستجو از دست رفته سهم نمایش برتر در محدوده 0 تا 0.9 گزارش شده است. هر مقدار بالاتر از 0.9 به عنوان 0.9001 گزارش می شود. |
search_top_impression_share | نمایشهایی که در بین آگهیهای برتر دریافت کردهاید در مقایسه با تعداد تخمینی نمایشهایی که واجد شرایط دریافت در بین آگهیهای برتر بودید. توجه: سهم نمایش برتر جستجو در محدوده 0.1 تا 1 گزارش می شود. هر مقدار کمتر از 0.1 به عنوان 0.0999 گزارش می شود. تبلیغات برتر عموماً بالاتر از نتایج ارگانیک برتر هستند، اگرچه ممکن است در زیر نتایج ارگانیک برتر در مورد جستجوهای خاص نشان داده شوند. |
top_impression_percentage | درصد درج آگهی شما که در مجاورت نتایج جستجوی ارگانیک برتر نشان داده می شود. |
value_per_all_conversions | ارزش همه تبدیلها تقسیم بر تعداد همه تبدیلها. |
value_per_all_conversions_by_conversion_date | ارزش همه تبدیلها تقسیم بر تعداد همه تبدیلها. وقتی این ستون با تاریخ انتخاب می شود، مقادیر در ستون تاریخ به معنای تاریخ تبدیل است. جزئیات ستونهای by_conversion_date در https://support.google.com/sa360/answer/9250611 موجود است. |
value_per_conversion | ارزش تبدیل قابل مناقصه تقسیم بر تعداد تبدیلهای قابل پیشنهاد. نشان می دهد که به طور متوسط هر یک از تبدیل های قابل پیشنهاد چقدر ارزش دارد. |
value_per_conversions_by_conversion_date | ارزش تبدیلهای قابل پیشنهاد بر اساس تاریخ تبدیل تقسیم بر تبدیلهای قابل پیشنهاد بر اساس تاریخ تبدیل. نشان می دهد که به طور متوسط هر یک از تبدیل های قابل پیشنهاد قیمت (بر اساس تاریخ تبدیل) چقدر است. وقتی این ستون با تاریخ انتخاب می شود، مقادیر در ستون تاریخ به معنای تاریخ تبدیل است. |
client_account_view_through_conversions | تعداد کل تبدیلهای بازدید از طریق. اینها زمانی اتفاق میافتند که مشتری یک تبلیغ تصویری یا رسانهای غنی را میبیند، سپس بعداً یک تبدیل را در سایت شما بدون تعامل با یک آگهی دیگر (مثلاً کلیک کردن روی) انجام میدهد. |
client_account_cross_sell_cost_of_goods_sold_micros | هزینه فروش متقابل کالاهای فروخته شده حساب مشتری (COGS) کل هزینه محصولات فروخته شده در نتیجه تبلیغات یک محصول متفاوت است. چگونه کار می کند: شما تبدیل ها را با داده های سبد خرید برای خریدهای تکمیل شده در وب سایت خود گزارش می دهید. اگر تبلیغی که قبل از خرید با آن تعامل داشتهاید، محصول مرتبطی داشته باشد (به آگهیهای خرید مراجعه کنید)، این محصول به عنوان محصول تبلیغشده در نظر گرفته میشود. هر محصولی که در سفارشی که مشتری قرار می دهد گنجانده شود، محصول فروخته شده است. اگر این محصولات مطابقت نداشته باشند، این فروش متقابل در نظر گرفته می شود. هزینه فروش متقابل کالاهای فروخته شده، کل هزینه محصولات فروخته شده است که تبلیغ نشده اند. مثال: شخصی روی یک آگهی خرید کلاه کلیک کرد و سپس همان کلاه و یک پیراهن را خرید. کلاه دارای بهای تمام شده کالای فروخته شده 3 دلار است، پیراهن دارای بهای تمام شده کالای فروخته شده 5 دلار است. هزینه فروش متقابل کالاهای فروخته شده برای این سفارش 5 دلار است. این معیار فقط در صورتی در دسترس است که تبدیلها را با دادههای سبد خرید گزارش دهید. این معیار یک ارزش پولی است و به صورت پیشفرض به واحد پول مشتری بازگردانده میشود. پارامتر metrics_currency را در https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause ببینید |
cross_sell_cost_of_goods_sold_micros | هزینه فروش متقابل کالاهای فروخته شده (COGS) کل بهای تمام شده محصولات فروخته شده در نتیجه تبلیغات یک محصول متفاوت است. چگونه کار می کند: شما تبدیل ها را با داده های سبد خرید برای خریدهای تکمیل شده در وب سایت خود گزارش می دهید. اگر تبلیغی که قبل از خرید با آن تعامل داشتهاید، محصول مرتبطی داشته باشد (به آگهیهای خرید مراجعه کنید)، این محصول به عنوان محصول تبلیغشده در نظر گرفته میشود. هر محصولی که در سفارشی که مشتری قرار می دهد گنجانده شود، محصول فروخته شده است. اگر این محصولات مطابقت نداشته باشند، این فروش متقابل در نظر گرفته می شود. هزینه فروش متقابل کالاهای فروخته شده، کل هزینه محصولات فروخته شده است که تبلیغ نشده اند. مثال: شخصی روی یک آگهی خرید کلاه کلیک کرد و سپس همان کلاه و یک پیراهن را خرید. کلاه دارای بهای تمام شده کالای فروخته شده 3 دلار است، پیراهن دارای بهای تمام شده کالای فروخته شده 5 دلار است. هزینه فروش متقابل کالاهای فروخته شده برای این سفارش 5 دلار است. این معیار فقط در صورتی در دسترس است که تبدیلها را با دادههای سبد خرید گزارش دهید. این معیار یک ارزش پولی است و به صورت پیشفرض به واحد پول مشتری بازگردانده میشود. پارامتر metrics_currency را در https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause ببینید |
client_account_cross_sell_gross_profit_micros | سود ناخالص فروش متقابل حساب مشتری، سودی است که از محصولات فروخته شده در نتیجه تبلیغات یک محصول متفاوت، منهای هزینه کالای فروخته شده (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 | سود ناخالص فروش متقابل، سودی است که شما از محصولات فروخته شده در نتیجه تبلیغات یک محصول متفاوت، منهای هزینه کالای فروخته شده (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 | درآمد حاصل از فروش متقابل حساب مشتری کل مبلغی است که شما از محصولات فروخته شده در نتیجه تبلیغات یک محصول دیگر به دست آورده اید. چگونه کار می کند: شما تبدیل ها را با داده های سبد خرید برای خریدهای تکمیل شده در وب سایت خود گزارش می دهید. اگر تبلیغی که قبل از خرید با آن تعامل داشتهاید، محصول مرتبطی داشته باشد (به آگهیهای خرید مراجعه کنید)، این محصول به عنوان محصول تبلیغشده در نظر گرفته میشود. هر محصولی که در سفارشی که مشتری قرار می دهد گنجانده شود، محصول فروخته شده است. اگر این محصولات مطابقت نداشته باشند، این فروش متقابل در نظر گرفته می شود. درآمد حاصل از فروش متقابل کل ارزشی است که شما از فروش متقابل به تبلیغات خود نسبت داده اید. مثال: شخصی روی یک آگهی خرید کلاه کلیک کرد و سپس همان کلاه و یک پیراهن را خرید. قیمت کلاه 10 دلار و قیمت پیراهن 20 دلار است. درآمد متقابل فروش این سفارش 20 دلار است. این معیار فقط در صورتی در دسترس است که تبدیلها را با دادههای سبد خرید گزارش دهید. این معیار یک ارزش پولی است و به صورت پیشفرض به واحد پول مشتری بازگردانده میشود. پارامتر metrics_currency را در https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause ببینید |
cross_sell_revenue_micros | درآمد حاصل از فروش متقابل کل مبلغی است که شما از محصولات فروخته شده در نتیجه تبلیغات یک محصول دیگر به دست آورده اید. چگونه کار می کند: شما تبدیل ها را با داده های سبد خرید برای خریدهای تکمیل شده در وب سایت خود گزارش می دهید. اگر تبلیغی که قبل از خرید با آن تعامل داشتهاید، محصول مرتبطی داشته باشد (به آگهیهای خرید مراجعه کنید)، این محصول به عنوان محصول تبلیغشده در نظر گرفته میشود. هر محصولی که در سفارشی که مشتری قرار می دهد گنجانده شود، محصول فروخته شده است. اگر این محصولات مطابقت نداشته باشند، این فروش متقابل در نظر گرفته می شود. درآمد حاصل از فروش متقابل کل ارزشی است که شما از فروش متقابل به تبلیغات خود نسبت داده اید. مثال: شخصی روی یک آگهی خرید کلاه کلیک کرد و سپس همان کلاه و یک پیراهن را خرید. قیمت کلاه 10 دلار و قیمت پیراهن 20 دلار است. درآمد متقابل فروش این سفارش 20 دلار است. این معیار فقط در صورتی در دسترس است که تبدیلها را با دادههای سبد خرید گزارش دهید. این معیار یک ارزش پولی است و به صورت پیشفرض به واحد پول مشتری بازگردانده میشود. پارامتر metrics_currency را در https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause ببینید |
client_account_cross_sell_units_sold | واحدهای فروش متقابل حساب مشتری فروخته شده تعداد کل محصولات فروخته شده در نتیجه تبلیغات یک محصول متفاوت است. چگونه کار می کند: شما تبدیل ها را با داده های سبد خرید برای خریدهای تکمیل شده در وب سایت خود گزارش می دهید. اگر تبلیغی که قبل از خرید با آن تعامل داشتهاید، محصول مرتبطی داشته باشد (به آگهیهای خرید مراجعه کنید)، این محصول به عنوان محصول تبلیغشده در نظر گرفته میشود. هر محصولی که در سفارشی که مشتری قرار می دهد گنجانده شود، محصول فروخته شده است. اگر این محصولات مطابقت نداشته باشند، این فروش متقابل در نظر گرفته می شود. واحدهای فروش متقابل فروخته شده، تعداد کل محصولات متقابل فروخته شده از تمام سفارشات منتسب به تبلیغات شما است. مثال: شخصی روی یک آگهی خرید برای یک کلاه کلیک کرد و سپس همان کلاه، یک پیراهن و یک ژاکت را خرید. واحدهای فروش متقابل فروخته شده در این ترتیب 2 است. این معیار فقط در صورتی در دسترس است که تبدیلها را با دادههای سبد خرید گزارش دهید. |
cross_sell_units_sold | واحدهای فروش متقابل، تعداد کل محصولات فروخته شده در نتیجه تبلیغات یک محصول متفاوت است. چگونه کار می کند: شما تبدیل ها را با داده های سبد خرید برای خریدهای تکمیل شده در وب سایت خود گزارش می دهید. اگر تبلیغی که قبل از خرید با آن تعامل داشتهاید، محصول مرتبطی داشته باشد (به آگهیهای خرید مراجعه کنید)، این محصول به عنوان محصول تبلیغشده در نظر گرفته میشود. هر محصولی که در سفارشی که مشتری قرار می دهد گنجانده شود، محصول فروخته شده است. اگر این محصولات مطابقت نداشته باشند، این فروش متقابل در نظر گرفته می شود. واحدهای فروش متقابل فروخته شده، تعداد کل محصولات متقابل فروخته شده از تمام سفارشات منتسب به تبلیغات شما است. مثال: شخصی روی یک آگهی خرید برای یک کلاه کلیک کرد و سپس همان کلاه، یک پیراهن و یک ژاکت را خرید. واحدهای فروش متقابل فروخته شده در این ترتیب 2 است. این معیار فقط در صورتی در دسترس است که تبدیلها را با دادههای سبد خرید گزارش دهید. |
client_account_lead_cost_of_goods_sold_micros | بهای تمام شده کالاهای فروخته شده حساب مشتری (COGS) کل هزینه محصولات فروخته شده در نتیجه تبلیغات همان محصول است. چگونه کار می کند: شما تبدیل ها را با داده های سبد خرید برای خریدهای تکمیل شده در وب سایت خود گزارش می دهید. اگر تبلیغی که با آن تعامل داشتهاید، محصول مرتبطی داشته باشد (به آگهیهای خرید مراجعه کنید)، این محصول به عنوان محصول تبلیغشده در نظر گرفته میشود. هر محصولی که در سفارشی که مشتری قرار می دهد گنجانده شود، محصول فروخته شده است. اگر محصولات تبلیغ شده و فروخته شده مطابقت داشته باشند، بهای تمام شده این کالاها تحت عنوان بهای تمام شده سرب کالای فروخته شده محاسبه می شود. مثال: شخصی روی یک آگهی خرید کلاه کلیک کرد و سپس همان کلاه و یک پیراهن را خرید. کلاه دارای بهای تمام شده کالای فروخته شده 3 دلار است، پیراهن دارای بهای تمام شده کالای فروخته شده 5 دلار است. هزینه سرب کالاهای فروخته شده برای این سفارش 3 دلار است. این معیار فقط در صورتی در دسترس است که تبدیلها را با دادههای سبد خرید گزارش دهید. این معیار یک ارزش پولی است و به صورت پیشفرض به واحد پول مشتری بازگردانده میشود. پارامتر metrics_currency را در https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause ببینید |
lead_cost_of_goods_sold_micros | هزینه سرب کالاهای فروخته شده (COGS) کل هزینه محصولات فروخته شده در نتیجه تبلیغات همان محصول است. چگونه کار می کند: شما تبدیل ها را با داده های سبد خرید برای خریدهای تکمیل شده در وب سایت خود گزارش می دهید. اگر تبلیغی که با آن تعامل داشتهاید، محصول مرتبطی داشته باشد (به آگهیهای خرید مراجعه کنید)، این محصول به عنوان محصول تبلیغشده در نظر گرفته میشود. هر محصولی که در سفارشی که مشتری قرار می دهد گنجانده شود، محصول فروخته شده است. اگر محصولات تبلیغ شده و فروخته شده مطابقت داشته باشند، بهای تمام شده این کالاها تحت عنوان بهای تمام شده سرب کالای فروخته شده محاسبه می شود. مثال: شخصی روی یک آگهی خرید کلاه کلیک کرد و سپس همان کلاه و یک پیراهن را خرید. کلاه دارای بهای تمام شده کالای فروخته شده 3 دلار است، پیراهن دارای بهای تمام شده کالای فروخته شده 5 دلار است. هزینه سرب کالاهای فروخته شده برای این سفارش 3 دلار است. این معیار فقط در صورتی در دسترس است که تبدیلها را با دادههای سبد خرید گزارش دهید. این معیار یک ارزش پولی است و به صورت پیشفرض به واحد پول مشتری بازگردانده میشود. به پارامتر metrics_currency در https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause مراجعه کنید |
client_account_lead_gross_profit_micros | حساب مشتری سود ناخالص سود شما از محصولات فروخته شده در نتیجه تبلیغات همان محصول ، منهای هزینه کالاهای فروخته شده (COGS) است. نحوه عملکرد آن: شما تبدیل ها را با داده های سبد خرید برای خریدهای تکمیل شده در وب سایت خود گزارش می دهید. اگر تبلیغی که قبل از خرید با آن تعامل داشته باشد ، یک محصول مرتبط داشته باشد (به تبلیغات خرید مراجعه کنید) ، این محصول محصول تبلیغ شده در نظر گرفته می شود. هر محصولی که به ترتیب مشتری قرار می گیرد ، محصولی فروخته شده است. اگر محصولات تبلیغاتی و فروخته شده مطابقت داشته باشند ، پس از درآمد شما از این فروش منهای هزینه کالاهای فروخته شده سود ناخالص شما است. مثال: شخصی روی یک تبلیغ خرید برای کلاه کلیک کرد و سپس همان کلاه و پیراهن را خریداری کرد. این کلاه 10 دلار قیمت دارد و هزینه کالاهای فروخته شده 3 دلار را دارد. سود ناخالص این سفارش 7 دلار = 10 دلار - 3 دلار است. این متریک فقط در صورتی در دسترس است که تبدیل ها را با داده های سبد خرید گزارش می دهید. این متریک یک ارزش پولی است و به طور پیش فرض در ارز مشتری بازگردانده می شود. به پارامتر metrics_currency در https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause مراجعه کنید |
lead_gross_profit_micros | سود ناخالص سرب سود شما از محصولات فروخته شده در نتیجه تبلیغات همان محصول ، منهای هزینه کالاهای فروخته شده (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 | درآمد سرب حساب مشتری کل مبلغی است که شما از محصولات فروخته شده در نتیجه تبلیغات همان محصول ساخته اید. نحوه عملکرد آن: شما تبدیل ها را با داده های سبد خرید برای خریدهای تکمیل شده در وب سایت خود گزارش می دهید. اگر تبلیغی که قبل از خرید با آن تعامل داشته باشد ، یک محصول مرتبط داشته باشد (به تبلیغات خرید مراجعه کنید) ، این محصول محصول تبلیغ شده در نظر گرفته می شود. هر محصولی که به ترتیب مشتری قرار می گیرد ، محصولی فروخته شده است. اگر محصولات تبلیغاتی و فروخته شده مطابقت داشته باشند ، ارزش کل شما از فروش این محصولات با درآمد سرب نشان داده شده است. مثال: شخصی روی یک تبلیغ خرید برای کلاه کلیک کرد و سپس همان کلاه و پیراهن را خریداری کرد. این کلاه 10 دلار قیمت دارد و پیراهن 20 دلار قیمت دارد. درآمد سرب این سفارش 10 دلار است. این متریک فقط در صورتی در دسترس است که تبدیل ها را با داده های سبد خرید گزارش می دهید. این متریک یک ارزش پولی است و به طور پیش فرض در ارز مشتری بازگردانده می شود. به پارامتر metrics_currency در https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause مراجعه کنید |
lead_revenue_micros | درآمد سرب کل مبلغی است که شما از محصولات فروخته شده در نتیجه تبلیغات همان محصول ساخته اید. نحوه عملکرد آن: شما تبدیل ها را با داده های سبد خرید برای خریدهای تکمیل شده در وب سایت خود گزارش می دهید. اگر تبلیغی که قبل از خرید با آن تعامل داشته باشد ، یک محصول مرتبط داشته باشد (به تبلیغات خرید مراجعه کنید) ، این محصول محصول تبلیغ شده در نظر گرفته می شود. هر محصولی که به ترتیب مشتری قرار می گیرد ، محصولی فروخته شده است. اگر محصولات تبلیغاتی و فروخته شده مطابقت داشته باشند ، ارزش کل شما از فروش این محصولات با درآمد سرب نشان داده شده است. مثال: شخصی روی یک تبلیغ خرید برای کلاه کلیک کرد و سپس همان کلاه و پیراهن را خریداری کرد. این کلاه 10 دلار قیمت دارد و پیراهن 20 دلار قیمت دارد. درآمد سرب این سفارش 10 دلار است. این متریک فقط در صورتی در دسترس است که تبدیل ها را با داده های سبد خرید گزارش می دهید. این متریک یک ارزش پولی است و به طور پیش فرض در ارز مشتری بازگردانده می شود. به پارامتر metrics_currency در https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause مراجعه کنید |
client_account_lead_units_sold | واحدهای سرب حساب مشتری فروخته شده تعداد کل محصولات فروخته شده در نتیجه تبلیغات همان محصول است. نحوه عملکرد آن: شما تبدیل ها را با داده های سبد خرید برای خریدهای تکمیل شده در وب سایت خود گزارش می دهید. اگر تبلیغی که قبل از خرید با آن تعامل داشته باشد ، یک محصول مرتبط داشته باشد (به تبلیغات خرید مراجعه کنید) ، این محصول محصول تبلیغ شده در نظر گرفته می شود. هر محصولی که به ترتیب مشتری قرار می گیرد ، محصولی فروخته شده است. اگر محصولات تبلیغاتی و فروخته شده مطابقت داشته باشند ، تعداد کل این محصولات فروخته شده تحت واحدهای سرب فروخته شده نشان داده می شود. مثال: شخصی روی یک تبلیغ خرید برای کلاه کلیک کرد و سپس همان کلاه ، پیراهن و یک ژاکت را خریداری کرد. واحدهای سرب فروخته شده به این ترتیب 1. است. این متریک فقط در صورتی که تبدیل را با داده های سبد خرید گزارش می دهید در دسترس است. |
lead_units_sold | واحدهای سرب فروخته شده تعداد کل محصولات فروخته شده در نتیجه تبلیغات همان محصول است. نحوه عملکرد آن: شما تبدیل ها را با داده های سبد خرید برای خریدهای تکمیل شده در وب سایت خود گزارش می دهید. اگر تبلیغی که قبل از خرید با آن تعامل داشته باشد ، یک محصول مرتبط داشته باشد (به تبلیغات خرید مراجعه کنید) ، این محصول محصول تبلیغ شده در نظر گرفته می شود. هر محصولی که به ترتیب مشتری قرار می گیرد ، محصولی فروخته شده است. اگر محصولات تبلیغاتی و فروخته شده مطابقت داشته باشند ، تعداد کل این محصولات فروخته شده تحت واحدهای سرب فروخته شده نشان داده می شود. مثال: شخصی روی یک تبلیغ خرید برای کلاه کلیک کرد و سپس همان کلاه ، پیراهن و یک ژاکت را خریداری کرد. واحدهای سرب فروخته شده به این ترتیب 1. است. این متریک فقط در صورتی که تبدیل را با داده های سبد خرید گزارش می دهید در دسترس است. |
موبایل
دارایی که یک برنامه تلفن همراه را نشان می دهد.
فیلدها | |
---|---|
app_id | مورد نیاز. رشته ای که منحصر به فرد یک برنامه تلفن همراه را مشخص می کند. این فقط باید شناسه بومی پلتفرم مانند "com.android.ebay" برای Android یا "12345689" برای iOS باشد. |
app_store | مورد نیاز. فروشگاه برنامه ای که این برنامه خاص را توزیع می کند. |
درصد Cpc
یک استراتژی مناقصه که در آن پیشنهادات بخشی از قیمت تبلیغ شده برای برخی از خدمات خوب یا خدمات است.
فیلدها | |
---|---|
cpc_bid_ceiling_micros | حداکثر حد پیشنهاد که می تواند توسط استراتژی پیشنهاد تعیین شود. این یک فیلد اختیاری است که توسط تبلیغ کننده وارد شده و در Micros محلی مشخص شده است. توجه: یک مقدار صفر به همان روشی که BID_CEILING نامشخص است تفسیر می شود. |
enhanced_cpc_enabled | بسته به احتمال تبدیل ، پیشنهاد برای هر حراج را به سمت بالا یا رو به پایین تنظیم می کند. پیشنهادات فردی ممکن است از CPC_BID_CEILING_MICRO فراتر رود ، اما میانگین پیشنهاد برای یک کمپین نباید. |
در زمان بندی در زمان بندی
تنظیمات برای مناقصه در زمان واقعی ، ویژگی ای که فقط برای کمپین های هدفمند شبکه تبادل آگهی موجود است.
فیلدها | |
---|---|
opt_in | این که آیا این کمپین به مناقصه در زمان واقعی انتخاب شده است. |
SearchAds360expandedDynamicsearchAdinfo
یک آگهی جستجوی پویا گسترده.
فیلدها | |
---|---|
description1 | خط اول توضیحات تبلیغات. |
description2 | خط دوم توضیحات آگهی. |
ad_tracking_id | شناسه ردیابی آگهی. |
SearchAds360expandedTextAdinfo
تبلیغات جستجو 360 آگهی متن گسترش یافته.
فیلدها | |
---|---|
headline | تیتر تبلیغ. |
headline2 | عنوان دوم تبلیغ. |
headline3 | عنوان سوم تبلیغ. |
description1 | خط اول توضیحات تبلیغات. |
description2 | خط دوم توضیحات آگهی. |
path1 | متن ضمیمه شده به URL قابل مشاهده به صورت خودکار با تعیین کننده. |
path2 | متن ضمیمه شده به PATH1 با تعیین کننده. |
ad_tracking_id | شناسه ردیابی آگهی. |
searchads360productadinfo
این نوع فیلدهایی ندارد.
تبلیغات ADS 360 AD.
SearchAds360rounsivesearchAdinfo
تبلیغات جستجو 360 آگهی جستجوی پاسخگو.
فیلدها | |
---|---|
headlines[] | لیست دارایی های متنی برای عناوین. هنگامی که تبلیغ در خدمت عناوین از این لیست انتخاب می شود. |
descriptions[] | لیست دارایی های متنی برای توضیحات. هنگامی که تبلیغ در خدمت توضیحات از این لیست انتخاب می شود. |
path1 | متن ضمیمه شده به URL قابل مشاهده به صورت خودکار با تعیین کننده. |
path2 | متن ضمیمه شده به PATH1 با تعیین کننده. |
ad_tracking_id | شناسه ردیابی آگهی. |
searchAds360TextAdinfo
تبلیغات جستجو 360 آگهی متن.
فیلدها | |
---|---|
headline | تیتر تبلیغ. |
description1 | خط اول توضیحات تبلیغات. |
description2 | خط دوم توضیحات آگهی. |
display_url | URL نمایش داده شده از تبلیغ. |
display_mobile_url | URL موبایل نمایش داده شده از آگهی. |
ad_tracking_id | شناسه ردیابی آگهی. |
بخش ها
قسمت های فقط بخش.
فیلدها | |
---|---|
ad_network_type | نوع شبکه تبلیغاتی. |
conversion_action_category | دسته اقدام تبدیل. |
conversion_custom_dimensions[] | ابعاد سفارشی تبدیل. |
day_of_week | به عنوان مثال ، روز هفته ، دوشنبه. |
device | دستگاهی که معیارها در آن اعمال می شوند. |
keyword | معیار کلمه کلیدی. |
product_channel | کانال محصول. |
product_channel_exclusivity | انحصار کانال محصول. |
product_condition | شرط محصول. |
product_sold_condition | شرط محصول فروخته شده. |
raw_event_conversion_dimensions[] | ابعاد تبدیل رویداد خام. |
conversion_action | نام منبع عمل تبدیل. |
conversion_action_name | نام اقدام تبدیل. |
date | تاریخ استفاده از معیارها. فرمت YYYY-MM-DD ، به عنوان مثال ، 2018-04-17. |
geo_target_city | نام منابع ثابت هدف GEO که نمایانگر یک شهر است. |
geo_target_country | نام منابع ثابت هدف GEO که نمایانگر یک کشور است. |
geo_target_metro | نام منابع ثابت هدف GEO که نشان دهنده یک مترو است. |
geo_target_region | نام منابع ثابت هدف GEO که نشان دهنده یک منطقه است. |
hour | ساعت روز به عنوان تعداد بین 0 تا 23 ، فراگیر. |
month | ماه که در تاریخ روز اول یک ماه نشان داده شده است. به عنوان yyyy-mm-dd فرمت شده است. |
product_bidding_category_level1 | دسته مناقصه (سطح 1) محصول. |
product_bidding_category_level2 | دسته مناقصه (سطح 2) محصول. |
product_bidding_category_level3 | دسته مناقصه (سطح 3) محصول. |
product_bidding_category_level4 | دسته مناقصه (سطح 4) محصول. |
product_bidding_category_level5 | دسته مناقصه (سطح 5) محصول. |
product_brand | مارک محصول. |
product_country | نام منابع هدف GEO برای کشور فروش محصول ثابت است. |
product_custom_attribute0 | ویژگی سفارشی 0 محصول. |
product_custom_attribute1 | ویژگی سفارشی 1 محصول. |
product_custom_attribute2 | ویژگی سفارشی 2 محصول. |
product_custom_attribute3 | ویژگی سفارشی 3 محصول. |
product_custom_attribute4 | ویژگی سفارشی 4 محصول. |
product_item_id | شناسه مورد محصول. |
product_language | نام منبع زبان ثابت برای زبان محصول. |
product_sold_bidding_category_level1 | دسته مناقصه (سطح 1) محصول فروخته شده. |
product_sold_bidding_category_level2 | دسته مناقصه (سطح 2) محصول فروخته شده. |
product_sold_bidding_category_level3 | دسته مناقصه (سطح 3) محصول فروخته شده. |
product_sold_bidding_category_level4 | دسته مناقصه (سطح 4) محصول فروخته شده. |
product_sold_bidding_category_level5 | دسته مناقصه (سطح 5) محصول فروخته شده. |
product_sold_brand | مارک محصول فروخته شده. |
product_sold_custom_attribute0 | ویژگی سفارشی 0 محصول فروخته شده. |
product_sold_custom_attribute1 | ویژگی سفارشی 1 محصول فروخته شده. |
product_sold_custom_attribute2 | ویژگی سفارشی 2 محصول فروخته شده. |
product_sold_custom_attribute3 | ویژگی سفارشی 3 محصول فروخته شده. |
product_sold_custom_attribute4 | ویژگی سفارشی 4 محصول فروخته شده. |
product_sold_item_id | شناسه مورد محصول فروخته شده. |
product_sold_title | عنوان محصول فروخته شده. |
product_sold_type_l1 | نوع (سطح 1) محصول فروخته شده را تایپ کنید. |
product_sold_type_l2 | نوع (سطح 2) محصول فروخته شده را تایپ کنید. |
product_sold_type_l3 | نوع (سطح 3) محصول فروخته شده را تایپ کنید. |
product_sold_type_l4 | نوع (سطح 4) محصول فروخته شده. |
product_sold_type_l5 | نوع (سطح 5) محصول فروخته شده. |
product_store_id | شناسه محصول را ذخیره کنید. |
product_title | عنوان محصول. |
product_type_l1 | نوع (سطح 1) محصول را تایپ کنید. |
product_type_l2 | نوع (سطح 2) محصول. |
product_type_l3 | نوع (سطح 3) محصول. |
product_type_l4 | نوع (سطح 4) محصول. |
product_type_l5 | نوع (سطح 5) محصول. |
quarter | سه ماهه که در تاریخ روز اول یک چهارم نشان داده شده است. به عنوان مثال ، از سال تقویم برای چهارم استفاده می کند ، به عنوان مثال ، سه ماهه دوم سال 2018 از 2018-04-01 آغاز می شود. به عنوان yyyy-mm-dd فرمت شده است. |
week | هفته همانطور که دوشنبه تا یکشنبه تعریف شده است ، و تا تاریخ دوشنبه نشان داده شده است. به عنوان yyyy-mm-dd فرمت شده است. |
year | سال ، به عنوان yyyy. |
asset_interaction_target | فقط با معیارهای CustomerAsseSt ، CompunsaSset و AdGroupAsset استفاده می شود. نشان می دهد که آیا معیارهای تعامل بر روی خود دارایی یا یک دارایی متفاوت یا واحد تبلیغاتی رخ داده است. تعامل (به عنوان مثال ، کلیک) در تمام قسمتهای تبلیغاتی (به عنوان مثال ، خود تبلیغ و سایر اجزای مانند Sitelinks) در هنگام ارائه آنها به حساب می آیند. هنگامی که تعامل_ون_تیز_ست صحیح است ، به این معنی است که تعامل بر روی این دارایی خاص است و وقتی تعامل_ون_تیز_ است نادرست است ، به این معنی است که تعامل بر روی این دارایی خاص نیست بلکه در سایر قسمت های تبلیغاتی این دارایی با آن سرو می شود. |
TargetCpa
یک استراتژی پیشنهادی خودکار که پیشنهاداتی را برای کمک به دستیابی به هرچه بیشتر تبدیل در هزینه هدف در هر منطقه (CPA) که تعیین کرده اید ، تعیین می کند.
فیلدها | |
---|---|
target_cpa_micros | هدف متوسط CPA. این هدف باید بر اساس ارز برای حساب بیشتر یا مساوی با حداقل واحد قابل پرداخت باشد. |
cpc_bid_ceiling_micros | حداکثر حد پیشنهاد که می تواند توسط استراتژی پیشنهاد تعیین شود. حد مربوط به کلیه کلمات کلیدی که توسط استراتژی اداره می شوند اعمال می شود. این فقط باید برای استراتژی های پیشنهادات نمونه کارها تنظیم شود. |
cpc_bid_floor_micros | حداقل حد پیشنهاد که می تواند توسط استراتژی پیشنهاد تعیین شود. حد مربوط به کلیه کلمات کلیدی که توسط استراتژی اداره می شوند اعمال می شود. این فقط باید برای استراتژی های پیشنهادات نمونه کارها تنظیم شود. |
TargetCPM
این نوع فیلدهایی ندارد.
CPM Target (هزینه در هر هزار برداشت) یک استراتژی پیشنهادی خودکار است که با توجه به CPM هدف شما تنظیم شده ، پیشنهادات را برای بهینه سازی عملکرد تعیین می کند.
هدف گیری
لیست تنظیمات هدفمند در هر هدف.
فیلدها | |
---|---|
targeting_dimension | بعد هدفگذاری که این تنظیمات برای آن اعمال می شود. |
bid_only | نشان می دهد که آیا تبلیغات خود را محدود کنید تا فقط برای معیارهایی که برای این هدف قرار داده اید نشان دهید ، یا اینکه تمام مقادیر را برای این هدف قرار دهید تا هدف قرار دهید و تبلیغات را بر اساس هدفگذاری خود در سایر موارد هدفمند نشان دهید. مقدار |
TargetRoas
یک استراتژی مناقصه خودکار که به شما کمک می کند تا ضمن میانگین بازده هدف خاص در هزینه های تبلیغاتی (ROAS) ، درآمد را به حداکثر برسانید.
فیلدها | |
---|---|
target_roas | مورد نیاز. درآمد انتخاب شده (بر اساس داده های تبدیل) در هر واحد هزینه. مقدار باید بین 0.01 تا 1000.0 باشد ، فراگیر. |
cpc_bid_ceiling_micros | حداکثر حد پیشنهاد که می تواند توسط استراتژی پیشنهاد تعیین شود. حد مربوط به کلیه کلمات کلیدی که توسط استراتژی اداره می شوند اعمال می شود. این فقط باید برای استراتژی های پیشنهادات نمونه کارها تنظیم شود. |
cpc_bid_floor_micros | حداقل حد پیشنهاد که می تواند توسط استراتژی پیشنهاد تعیین شود. حد مربوط به کلیه کلمات کلیدی که توسط استراتژی اداره می شوند اعمال می شود. این فقط باید برای استراتژی های پیشنهادات نمونه کارها تنظیم شود. |
هدف
یک استراتژی پیشنهادی خودکار که پیشنهادات شما را برای کمک به دریافت هرچه بیشتر کلیک در بودجه شما تعیین می کند.
فیلدها | |
---|---|
target_spend_micros | کاهش یافته: هدف هزینه ای که برای حداکثر کلیک ها در آن قرار دارد. یک پیشنهاد دهنده Targetspend سعی خواهد کرد که کوچکتر از این ارزش یا مبلغ هزینه های طبیعی را خرج کند. اگر مشخص نشده باشد ، بودجه به عنوان هدف هزینه استفاده می شود. این قسمت مستهلک می شود و دیگر نباید مورد استفاده قرار گیرد. برای جزئیات بیشتر به https://ads-developers.googleblog.com/2020/05/reminder-about-sunset-creation-of.html مراجعه کنید. |
cpc_bid_ceiling_micros | حداکثر حد پیشنهاد که می تواند توسط استراتژی پیشنهاد تعیین شود. حد مربوط به کلیه کلمات کلیدی که توسط استراتژی اداره می شوند اعمال می شود. |
هدف گیری
تنظیمات مربوط به ویژگی های مرتبط با هدف ، در سطح کمپین و گروه AD. برای اطلاعات بیشتر در مورد تنظیم هدف ، به https://support.google.com/google-ads/answer/7365594 مراجعه کنید
فیلدها | |
---|---|
target_restrictions[] | تنظیم در هر هدف برای محدود کردن دسترسی به کمپین یا گروه تبلیغاتی شما. |
TextAsset
یک دارایی متنی
فیلدها | |
---|---|
text | محتوای متن دارایی متن. |
TextLabel
نوعی از برچسب نمایش متن در پس زمینه رنگی.
فیلدها | |
---|---|
background_color | رنگ پس زمینه برچسب در قالب hex. این رشته باید با عبارت معمولی مطابقت داشته باشد '^#([A-FA-F0-9] {6} | [A-FA-F0-9] {3}) $'. توجه: ممکن است رنگ پس زمینه برای حساب های مدیر قابل مشاهده نباشد. |
description | شرح کوتاهی از برچسب. طول نباید بیش از 200 کاراکتر باشد. |
یکپارچه
یک دارایی تماس یکپارچه.
فیلدها | |
---|---|
country_code | کد کشور دو حرف شماره تلفن. مثالها: "ما" ، "ما". |
phone_number | شماره تلفن خام تبلیغ کننده. مثال: '1234567890' ، '(123) 456-7890' |
call_conversion_reporting_state | نشان می دهد که آیا این Callasset باید از تنظیمات تبدیل تماس خود استفاده کند ، تنظیم سطح حساب را دنبال کنید یا تبدیل تماس را غیرفعال کنید. |
call_conversion_action | اقدام تبدیل برای نسبت دادن یک تماس به. در صورت عدم تنظیم ، از عمل تبدیل پیش فرض استفاده می شود. این قسمت فقط در صورتی که call_conversion_reporting_state روی use_resource_level_call_conversion_action تنظیم شده باشد ، تأثیر دارد. |
ad_schedule_targets[] | لیست برنامه های غیر همپوشانی که تمام فواصل زمانی را که ممکن است دارایی در آن باشد ، مشخص می کند. حداکثر 6 برنامه در روز وجود دارد ، در کل 42. |
call_only | این که آیا تماس فقط شماره تلفن را بدون پیوند به وب سایت نشان می دهد. برای تبلیغات مایکروسافت اعمال می شود. |
call_tracking_enabled | آیا تماس باید در ردیابی تماس فعال باشد. برای تبلیغات مایکروسافت اعمال می شود. |
use_searcher_time_zone | آیا می توان پسوند تماس را در منطقه زمانی کاربر جستجو نشان داد. برای تبلیغات مایکروسافت اعمال می شود. |
start_date | تاریخ شروع زمانی که این دارایی مؤثر است و می تواند با فرمت YYYY-MM-DD شروع به خدمت کند. |
end_date | آخرین تاریخ زمانی که این دارایی مؤثر است و هنوز هم در حال خدمت است ، در قالب YYYY-MM-DD. |
یکپارچه
یک دارایی فراخوانی یکپارچه.
فیلدها | |
---|---|
callout_text | متن فراخوانی طول این رشته باید بین 1 تا 25 باشد ، فراگیر. |
start_date | تاریخ شروع زمانی که این دارایی مؤثر است و می تواند با فرمت YYYY-MM-DD شروع به خدمت کند. |
end_date | آخرین تاریخ زمانی که این دارایی مؤثر است و هنوز هم در حال خدمت است ، در قالب YYYY-MM-DD. |
ad_schedule_targets[] | لیست برنامه های غیر همپوشانی که تمام فواصل زمانی را که ممکن است دارایی در آن باشد ، مشخص می کند. حداکثر 6 برنامه در روز وجود دارد ، در کل 42. |
use_searcher_time_zone | آیا می توان دارایی را در منطقه زمانی کاربر جستجو نشان داد. برای تبلیغات مایکروسافت اعمال می شود. |
یکپارچه یکپارچه
یک دارایی مکان یکپارچه.
فیلدها | |
---|---|
place_id | شناسه های منحصر به فرد مکانی را در پایگاه داده Google Places و در Google Maps قرار دهید. این قسمت برای شناسه مشتری خاص و نوع دارایی بی نظیر است. برای کسب اطلاعات بیشتر در مورد شناسه مکان ، به https://developers.google.com/places/web-service/place-id مراجعه کنید. |
business_profile_locations[] | لیست مکان های تجاری برای مشتری. این تنها درصورتی بازگردانده می شود که دارایی مکان از حساب پروفایل تجاری همگام سازی شود. می توان چندین لیست پروفایل تجاری را تحت همان حساب که به همان شناسه مکان اشاره دارد ، داشته باشید. |
location_ownership_type | نوع مالکیت مکان. اگر این نوع Business_owner باشد ، به عنوان یک برنامه افزودنی محل خدمت می شود. اگر نوع وابسته باشد ، به عنوان یک مکان وابسته خدمت می شود. |
یکپارچه
یک دارایی یک صفحه یکپارچه.
فیلدها | |
---|---|
page_url | صفحه وب که تبلیغ کنندگان می خواهند هدف قرار دهند. |
labels[] | برچسب های مورد استفاده برای گروه بندی URL های صفحه. |
unifiedSitelinkAsset
یک دارایی یکپارچه Sitelink.
فیلدها | |
---|---|
link_text | متن نمایش URL برای SiteLink. طول این رشته باید بین 1 تا 25 باشد ، فراگیر. |
description1 | خط اول توضیحات برای Sitelink. در صورت تنظیم ، طول باید بین 1 تا 35 باشد ، فراگیر و توضیحات 2 نیز باید تنظیم شود. |
description2 | خط دوم توضیحات برای Sitelink. در صورت تنظیم ، طول باید بین 1 تا 35 باشد ، فراگیر و توضیحات 1 نیز باید تنظیم شود. |
start_date | تاریخ شروع زمانی که این دارایی مؤثر است و می تواند با فرمت YYYY-MM-DD شروع به خدمت کند. |
end_date | آخرین تاریخ زمانی که این دارایی مؤثر است و هنوز هم در حال خدمت است ، در قالب YYYY-MM-DD. |
ad_schedule_targets[] | لیست برنامه های غیر همپوشانی که تمام فواصل زمانی را که ممکن است دارایی در آن باشد ، مشخص می کند. حداکثر 6 برنامه در روز وجود دارد ، در کل 42. |
tracking_id | شناسه برای ردیابی کلیک برای دارایی SiteLink استفاده می شود. این یک یاهو است! فقط میدان ژاپن. |
use_searcher_time_zone | آیا می توان دارایی SiteLink را در منطقه زمانی کاربر جستجو نشان داد. برای تبلیغات مایکروسافت اعمال می شود. |
mobile_preferred | این که آیا ترجیح این است که دارایی Sitelink در دستگاه های تلفن همراه نمایش داده شود. برای تبلیغات مایکروسافت اعمال می شود. |
userlistinfo
معیار لیست کاربر. یک لیست کاربر را نشان می دهد که توسط تبلیغ کننده برای هدف قرار می گیرد.
فیلدها | |
---|---|
user_list | نام منابع لیست کاربر. |
ارزش
یک ظرف داده عمومی.
فیلدها | |
---|---|
value میدان اتحادیه. یک مقدار value فقط می تواند یکی از موارد زیر باشد: | |
boolean_value | یک بولی |
int64_value | int64. |
float_value | یک شناور |
double_value | یک دوتایی |
string_value | یک رشته |
صفحه اصلی
بیان منطقی برای هدف قرار دادن صفحات وب وب سایت تبلیغ کننده.
فیلدها | |
---|---|
operand | عملکرد هدف قرار دادن صفحه وب. |
operator | اپراتور وضعیت هدف قرار دادن صفحه. |
argument | استدلال وضعیت هدف گذاری صفحه وب. |
صفحه وب
معیار هدف قرار دادن صفحات وب وب سایت تبلیغ کننده را نشان می دهد.
فیلدها | |
---|---|
conditions[] | شرایط یا عبارات منطقی برای هدف قرار دادن صفحه وب. لیست شرایط هدف گذاری صفحه وب هنگام ارزیابی برای هدف قرار دادن ، با هم جمع می شوند. لیست خالی از شرایط نشان می دهد که تمام صفحات وب سایت کمپین مورد هدف قرار گرفته است. این قسمت برای ایجاد عملیات مورد نیاز است و در عملیات به روزرسانی ممنوع است. |
coverage_percentage | درصد پوشش معیارهای وب سایت. این درصد محاسبه شده از پوشش وب سایت بر اساس هدف وب سایت ، هدف منفی وب سایت و کلمات کلیدی منفی در گروه تبلیغات و کمپین است. به عنوان مثال ، هنگامی که پوشش به عنوان 1 باز می گردد ، نشان می دهد که 100 ٪ پوشش دارد. این قسمت فقط خواندنی است. |
criterion_name | نام معیاری که توسط این پارامتر تعریف شده است. از مقدار نام برای شناسایی ، مرتب سازی و معیارهای فیلتر با این نوع پارامترها استفاده می شود. این قسمت برای ایجاد عملیات مورد نیاز است و در عملیات به روزرسانی ممنوع است. |
YouTubeVideoAsset
یک دارایی یوتیوب.
فیلدها | |
---|---|
youtube_video_title | عنوان ویدیوی YouTube. |
youtube_video_id | شناسه ویدیوی YouTube. این 11 مقدار رشته کاراکتر است که در URL ویدیوی YouTube استفاده می شود. |
شاخص
-
AdScheduleInfo
(پیام) -
AdTextAsset
(پیام) -
AgeRangeInfo
(پیام) -
AssetInteractionTarget
(پیام) -
AssetUsage
(پیام) -
AudienceInfo
(پیام) -
BusinessProfileLocation
(پیام) -
CallToActionAsset
(پیام) -
CustomParameter
(پیام) -
DeviceInfo
(پیام) -
EnhancedCpc
(پیام) -
FrequencyCapEntry
(پیام) -
GenderInfo
(پیام) -
ImageAsset
(پیام) -
ImageDimension
(پیام) -
Keyword
(پیام) -
KeywordInfo
(پیام) -
LanguageInfo
(پیام) -
ListingGroupInfo
(پیام) -
LocationGroupInfo
(پیام) -
LocationInfo
(پیام) -
ManualCpa
(پیام) -
ManualCpc
(پیام) -
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
(پیام)
adscheduleinfo
معیار adschedule را نشان می دهد.
Adschedule به عنوان روز هفته و بازه زمانی مشخص شده است که در آن تبلیغات نشان داده می شود.
بیش از شش Adschedules را نمی توان برای همان روز اضافه کرد.
فیلدها | |
---|---|
start_minute | دقایقی بعد از ساعت شروع که این برنامه شروع می شود. این قسمت برای ایجاد عملیات مورد نیاز است و در عملیات به روزرسانی ممنوع است. |
end_minute | دقایقی بعد از ساعت پایان که این برنامه به پایان می رسد. برنامه منحصر به فرد از دقیقه پایان است. این قسمت برای ایجاد عملیات مورد نیاز است و در عملیات به روزرسانی ممنوع است. |
day_of_week | روز هفته برنامه مربوط می شود. این قسمت برای ایجاد عملیات مورد نیاز است و در عملیات به روزرسانی ممنوع است. |
start_hour | ساعت شروع در زمان 24 ساعت. این قسمت باید بین 0 تا 23 باشد ، فراگیر. این قسمت برای ایجاد عملیات مورد نیاز است و در عملیات به روزرسانی ممنوع است. |
end_hour | ساعت پایان در زمان 24 ساعت ؛ 24 نشانگر پایان روز است. این قسمت باید بین 0 تا 24 باشد ، فراگیر. این قسمت برای ایجاد عملیات مورد نیاز است و در عملیات به روزرسانی ممنوع است. |
یدکست
دارایی متنی که در داخل یک تبلیغ استفاده می شود.
فیلدها | |
---|---|
text | متن دارایی |
alerangeinfo
معیار دامنه سنی.
فیلدها | |
---|---|
type | نوع دامنه سنی. |
دارایی
یک بخش AssetInteractionTarget.
فیلدها | |
---|---|
asset | نام منابع دارایی. |
interaction_on_this_asset | فقط با معیارهای CustomerAsseSt ، CompunsaSset و AdGroupAsset استفاده می شود. نشان می دهد که آیا معیارهای تعامل بر روی خود دارایی یا یک دارایی متفاوت یا واحد تبلیغاتی رخ داده است. |
دارایی
حاوی اطلاعات استفاده از دارایی است.
فیلدها | |
---|---|
asset | نام منابع دارایی. |
served_asset_field_type | نوع میدان خدمت دارایی. |
مخاطبان
معیار مخاطبان.
فیلدها | |
---|---|
audience | نام منابع مخاطب. |
تجارت
داده های مکان مشخصات کسب و کار از حساب پروفایل کسب و کار پیوند یافته همگام سازی شده است.
فیلدها | |
---|---|
labels[] | تبلیغ کننده برچسب مشخص شده برای مکان در حساب پروفایل تجاری. این از حساب پروفایل تجاری همگام سازی شده است. |
store_code | کد فروشگاه پروفایل تجاری این مکان. این از حساب پروفایل تجاری همگام سازی شده است. |
listing_id | شناسه لیست این مکان پروفایل تجاری. این از حساب پروفایل کسب و کار مرتبط است. |
calltoactionasset
فراخوانی به دارایی اقدام.
فیلدها | |
---|---|
call_to_action | فراخوان به اقدام. |
سفارشی
نقشه برداری که می تواند توسط برچسب های پارامتر سفارشی در یک tracking_url_template
، final_urls
یا mobile_final_urls
استفاده شود.
فیلدها | |
---|---|
key | کلیدی مطابق با نام برچسب پارامتر. |
value | مقدار جایگزین |
اطلاعات دستگاه
یک معیار دستگاه
فیلدها | |
---|---|
type | نوع دستگاه |
EnhancedCpc
این نوع فیلدهایی ندارد.
یک استراتژی خودکار مناقصه که پیشنهاداتی را برای کلیک هایی ایجاد می کند که به نظر می رسد بیشتر منجر به تبدیل می شوند و آنها را برای کلیک هایی که به نظر می رسد کمتر است ، پایین می آورد.
این استراتژی مناقصه مستهلک می شود و دیگر نمی توان ایجاد کرد. برای عملکرد معادل آن از manualcpc با Edvanced_cpc_enabled استفاده کنید.
فرکانس
این نوع فیلدهایی ندارد.
یک قانون که حداکثر تعداد دفعات تبلیغ (یا برخی از تبلیغات) را می توان در یک دوره زمانی خاص به کاربر نشان داد.
جنس جنسیت
معیار جنسیتی.
فیلدها | |
---|---|
type | نوع جنسیت. |
تصویر
یک دارایی تصویر
فیلدها | |
---|---|
mime_type | نوع MIME دارایی تصویر. |
full_size | ابرداده برای این تصویر در اندازه اصلی آن. |
file_size | اندازه پرونده دارایی تصویر در بایت. |
تصویر
ابرداده برای یک تصویر در اندازه خاص ، یا اصلی یا اندازه گیری شده.
فیلدها | |
---|---|
height_pixels | ارتفاع تصویر. |
width_pixels | عرض تصویر. |
url | URL که تصویر را با این ارتفاع و عرض برمی گرداند. |
کلمه کلیدی
یک بخش معیار کلمه کلیدی.
فیلدها | |
---|---|
info | اطلاعات کلمه کلیدی |
ad_group_criterion | نام منبع AdGroupCriterion. |
کلمه کلیدی
یک معیار کلمه کلیدی.
فیلدها | |
---|---|
match_type | نوع مسابقه کلمه کلیدی. |
text | متن کلمه کلیدی (حداکثر 80 کاراکتر و 10 کلمه). |
زبان
یک معیار زبان.
فیلدها | |
---|---|
language_constant | نام منبع ثابت زبان. |
ListingGroupInfo
معیار گروه لیست.
فیلدها | |
---|---|
type | نوع گروه لیست. |
موقعیت مکانی
شعاع اطراف لیستی از مکان های مشخص شده از طریق یک خوراک.
فیلدها | |
---|---|
geo_target_constants[] | GEO ثابت (های) هدف محدود کننده دامنه منطقه جغرافیایی در خوراک. در حال حاضر فقط یک ثابت هدف GEO مجاز است. |
radius_units | واحد شعاع. مایل و متر برای ثابت های هدف GEO پشتیبانی می شوند. مایل و متر برای مجموعه های مورد تغذیه پشتیبانی می شود. این مورد نیاز است و باید در ایجاد عملیات تنظیم شود. |
feed_item_sets[] | تغذیه ای که فیدیم ها مورد هدف قرار می گیرند. اگر چندین شناسه مشخص شده باشد ، تمام مواردی که حداقل در یک مجموعه ظاهر می شوند هدف قرار می گیرند. این قسمت با GEO_TARGET_CONSTANTS قابل استفاده نیست. این اختیاری است و فقط می تواند در ایجاد عملیات تنظیم شود. |
radius | فاصله در واحدهایی که شعاع اطراف مکان های هدفمند را مشخص می کند. این مورد نیاز است و باید در ایجاد عملیات تنظیم شود. |
LocationInfo
یک معیار مکان
فیلدها | |
---|---|
geo_target_constant | نام منبع ثابت GEO. |
manualcpa
این نوع فیلدهایی ندارد.
استراتژی مناقصه دستی که به تبلیغ کننده اجازه می دهد تا پیشنهاد را برای هر تبلیغ مشخص شده تنظیم کند.
ManualCpc
مناقصه مبتنی بر کلیک دستی که کاربر در هر کلیک پرداخت می کند.
فیلدها | |
---|---|
enhanced_cpc_enabled | این که آیا پیشنهادات بر اساس داده های بهینه ساز تبدیل می شوند. |
ManualCpm
این نوع فیلدهایی ندارد.
مناقصه مبتنی بر تصور دستی که کاربر در هر هزار برداشت می پردازد.
حداکثر
یک استراتژی پیشنهادی خودکار برای کمک به کسب بیشترین ارزش تبدیل برای کمپین های خود ضمن صرف بودجه خود.
فیلدها | |
---|---|
cpc_bid_ceiling_micros | حداکثر حد پیشنهاد که می تواند توسط استراتژی پیشنهاد تعیین شود. حد مربوط به کلیه کلمات کلیدی که توسط استراتژی اداره می شوند اعمال می شود. فقط برای استراتژی های مناقصه نمونه کارها قابل تغییر است. |
cpc_bid_floor_micros | حداقل حد پیشنهاد که می تواند توسط استراتژی پیشنهاد تعیین شود. حد مربوط به کلیه کلمات کلیدی که توسط استراتژی اداره می شوند اعمال می شود. فقط برای استراتژی های مناقصه نمونه کارها قابل تغییر است. |
target_roas | گزینه Return On Ad Devent (ROAS) گزینه. در صورت تنظیم ، استراتژی پیشنهاد در حالی که میانگین بازده هدف در تبلیغات را دارد ، درآمد را به حداکثر می رساند. اگر ROAS هدف بالا باشد ، ممکن است استراتژی پیشنهاد نتواند بودجه کامل را خرج کند. اگر ROA های هدف تعیین نشده باشد ، استراتژی پیشنهاد برای دستیابی به بالاترین ROAS ممکن برای بودجه خواهد بود. |
حداکثر
یک استراتژی پیشنهادی خودکار برای کمک به کسب بیشترین تبدیل برای کمپین های خود ضمن صرف بودجه خود.
فیلدها | |
---|---|
cpc_bid_ceiling_micros | حداکثر حد پیشنهاد که می تواند توسط استراتژی پیشنهاد تعیین شود. حد مربوط به کلیه کلمات کلیدی که توسط استراتژی اداره می شوند اعمال می شود. فقط برای استراتژی های مناقصه نمونه کارها قابل تغییر است. |
cpc_bid_floor_micros | حداقل حد پیشنهاد که می تواند توسط استراتژی پیشنهاد تعیین شود. حد مربوط به کلیه کلمات کلیدی که توسط استراتژی اداره می شوند اعمال می شود. فقط برای استراتژی های مناقصه نمونه کارها قابل تغییر است. |
target_cpa_micros | گزینه Cost-Action Target (CPA). این میانگین مبلغی است که شما می خواهید در هر اقدام تبدیل شده در واحدهای خرد از ارز استراتژی مناقصه هزینه کنید. در صورت تنظیم ، استراتژی پیشنهاد هرچه بیشتر ممکن است در هر یا پایین تر از هزینه هر عمل در هر عمل دریافت کند. اگر CPA هدف تعیین نشده باشد ، استراتژی پیشنهاد برای دستیابی به کمترین CPA ممکن با توجه به بودجه خواهد بود. |
معیارها
داده های معیارها.
فیلدها | |
---|---|
all_conversions_value_by_conversion_date | ارزش همه تبدیل ها. هنگامی که این ستون با تاریخ انتخاب می شود ، مقادیر ستون تاریخ به معنای تاریخ تبدیل است. جزئیات مربوط به ستون های by_conversion_date در https://support.google.com/sa360/answer/9250611 در دسترس است. |
all_conversions_by_conversion_date | تعداد کل تبدیل ها. این شامل تمام تبدیل ها بدون در نظر گرفتن مقدار شامل_ین_کونسورها_متریک است. هنگامی که این ستون با تاریخ انتخاب می شود ، مقادیر ستون تاریخ به معنای تاریخ تبدیل است. جزئیات مربوط به ستون های by_conversion_date در https://support.google.com/sa360/answer/9250611 در دسترس است. |
conversion_custom_metrics[] | معیارهای سفارشی تبدیل. |
conversions_value_by_conversion_date | مبلغ تبدیل قابل تبدیل به تاریخ تبدیل. هنگامی که این ستون با تاریخ انتخاب می شود ، مقادیر ستون تاریخ به معنای تاریخ تبدیل است. |
conversions_by_conversion_date | مجموع تبدیل ها توسط تاریخ تبدیل برای انواع تبدیل قابل پیشنهاد. به دلیل مدل سازی انتساب می تواند کسری باشد. هنگامی که این ستون با تاریخ انتخاب می شود ، مقادیر ستون تاریخ به معنای تاریخ تبدیل است. |
historical_creative_quality_score | نمره کیفیت تاریخی خلاق. |
historical_landing_page_quality_score | کیفیت تجربه صفحه فرود تاریخی. |
historical_search_predicted_ctr | جستجوی تاریخی پیش بینی شده با کلیک از طریق نرخ (CTR). |
interaction_event_types[] | انواع تعامل قابل پرداخت و رایگان. |
raw_event_conversion_metrics[] | معیارهای تبدیل رویداد خام. |
absolute_top_impression_percentage | جستجوی سهم مطلق بالا ، درصد از برداشت های تبلیغاتی جستجوی شما است که در برجسته ترین موقعیت جستجو نشان داده شده است. |
all_conversions_from_interactions_rate | تمام تبدیل ها از تعامل (در مقابل مشاهده از طریق تبدیل) تقسیم بر تعداد تعامل AD. |
all_conversions_value | ارزش همه تبدیل ها. |
all_conversions | تعداد کل تبدیل ها. این شامل تمام تبدیل ها بدون در نظر گرفتن مقدار شامل_ین_کونسورها_متریک است. |
all_conversions_value_per_cost | ارزش کلیه تبدیل های تقسیم شده بر کل هزینه تعامل AD (مانند کلیک برای تبلیغات متنی یا نمایش برای تبلیغات ویدیویی). |
all_conversions_from_click_to_call | تعداد دفعاتی که مردم روی دکمه "تماس" کلیک می کردند تا در حین یا بعد از کلیک بر روی یک آگهی با یک فروشگاه تماس بگیرند. این شماره شامل اتصال یا عدم تماس یا مدت زمان تماس نیست. این متریک فقط برای موارد خوراک اعمال می شود. |
all_conversions_from_directions | تعداد دفعاتی که مردم روی دکمه "Get Directions" کلیک کردند تا بعد از کلیک بر روی یک آگهی به یک فروشگاه حرکت کنند. این متریک فقط برای موارد خوراک اعمال می شود. |
all_conversions_from_interactions_value_per_interaction | مقدار کلیه تبدیل ها از تعامل تقسیم بر تعداد کل تعامل ها. |
all_conversions_from_menu | تعداد دفعاتی که مردم پس از کلیک بر روی یک آگهی ، روی یک لینک کلیک کردند تا منوی فروشگاه را مشاهده کنند. این متریک فقط برای موارد خوراک اعمال می شود. |
all_conversions_from_order | تعداد دفعاتی که مردم بعد از کلیک بر روی یک آگهی ، سفارش را در یک فروشگاه قرار داده اند. این متریک فقط برای موارد خوراک اعمال می شود. |
all_conversions_from_other_engagement | تعداد سایر تبدیل ها (به عنوان مثال ، ارسال یک بررسی یا صرفه جویی در مکان برای یک فروشگاه) که پس از کلیک افراد در یک آگهی رخ داده است. این متریک فقط برای موارد خوراک اعمال می شود. |
all_conversions_from_store_visit | تعداد تخمین زده شده تعداد دفعاتی که مردم پس از کلیک بر روی یک آگهی از یک فروشگاه بازدید کرده اند. این متریک فقط برای موارد خوراک اعمال می شود. |
visits | Clicks that Search Ads 360 has successfully recorded and forwarded to an advertiser's landing page. |
all_conversions_from_store_website | The number of times that people were taken to a store's URL after clicking an ad. This metric applies to feed items only. |
average_cost | The average amount you pay per interaction. This amount is the total cost of your ads divided by the total number of interactions. |
average_cpc | The total cost of all clicks divided by the total number of clicks received. This metric is a monetary value and returned in the customer's currency by default. See the metrics_currency parameter at https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause |
average_cpm | Average cost-per-thousand impressions (CPM). This metric is a monetary value and returned in the customer's currency by default. See the metrics_currency parameter at https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause |
clicks | The number of clicks. |
content_budget_lost_impression_share | The estimated percent of times that your ad was eligible to show on the Display Network but didn't because your budget was too low. Note: Content budget lost impression share is reported in the range of 0 to 0.9. Any value above 0.9 is reported as 0.9001. |
content_impression_share | The impressions you've received on the Display Network divided by the estimated number of impressions you were eligible to receive. Note: Content impression share is reported in the range of 0.1 to 1. Any value below 0.1 is reported as 0.0999. |
content_rank_lost_impression_share | The estimated percentage of impressions on the Display Network that your ads didn't receive due to poor Ad Rank. Note: Content rank lost impression share is reported in the range of 0 to 0.9. Any value above 0.9 is reported as 0.9001. |
conversions_from_interactions_rate | Average biddable conversions (from interaction) per conversion eligible interaction. Shows how often, on average, an ad interaction leads to a biddable conversion. |
client_account_conversions_value | The value of client account conversions. This only includes conversion actions which include_in_client_account_conversions_metric attribute is set to true. If you use conversion-based bidding, your bid strategies will optimize for these conversions. |
conversions_value_per_cost | The value of biddable conversion divided by the total cost of conversion eligible interactions. |
conversions_from_interactions_value_per_interaction | The value of conversions from interactions divided by the number of ad interactions. This only includes conversion actions which include_in_conversions_metric attribute is set to true. If you use conversion-based bidding, your bid strategies will optimize for these conversions. |
client_account_conversions | The number of client account conversions. This only includes conversion actions which include_in_client_account_conversions_metric attribute is set to true. If you use conversion-based bidding, your bid strategies will optimize for these conversions. |
cost_micros | The sum of your cost-per-click (CPC) and cost-per-thousand impressions (CPM) costs during this period. This metric is a monetary value and returned in the customer's currency by default. See the metrics_currency parameter at https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause |
cost_per_all_conversions | The cost of ad interactions divided by all conversions. |
cost_per_conversion | Average conversion eligible cost per biddable conversion. |
cost_per_current_model_attributed_conversion | The cost of ad interactions divided by current model attributed conversions. This only includes conversion actions which include_in_conversions_metric attribute is set to true. If you use conversion-based bidding, your bid strategies will optimize for these conversions. |
cross_device_conversions | Conversions from when a customer clicks on an ad on one device, then converts on a different device or browser. Cross-device conversions are already included in all_conversions. |
cross_device_conversions_by_conversion_date | The number of cross-device conversions by conversion date. Details for the by_conversion_date columns are available at https://support.google.com/sa360/answer/9250611 . |
cross_device_conversions_value | The sum of the value of cross-device conversions. |
cross_device_conversions_value_by_conversion_date | The sum of cross-device conversions value by conversion date. Details for the by_conversion_date columns are available at https://support.google.com/sa360/answer/9250611 . |
ctr | The number of clicks your ad receives (Clicks) divided by the number of times your ad is shown (Impressions). |
conversions | The number of conversions. This only includes conversion actions which include_in_conversions_metric attribute is set to true. If you use conversion-based bidding, your bid strategies will optimize for these conversions. |
conversions_value | The sum of conversion values for the conversions included in the "conversions" field. This metric is useful only if you entered a value for your conversion actions. |
average_quality_score | The average quality score. |
historical_quality_score | The historical quality score. |
impressions | Count of how often your ad has appeared on a search results page or website on the Google Network. |
interaction_rate | How often people interact with your ad after it is shown to them. This is the number of interactions divided by the number of times your ad is shown. |
interactions | The number of interactions. An interaction is the main user action associated with an ad format-clicks for text and shopping ads, views for video ads, and so on. |
invalid_click_rate | The percentage of clicks filtered out of your total number of clicks (filtered + non-filtered clicks) during the reporting period. |
invalid_clicks | Number of clicks Google considers illegitimate and doesn't charge you for. |
general_invalid_click_rate | The percentage of clicks that have been filtered out of your total number of clicks (filtered + non-filtered clicks) due to being general invalid clicks. These are clicks Google considers illegitimate that are detected through routine means of filtration (that is, known invalid data-center traffic, bots and spiders or other crawlers, irregular patterns, etc). You're not charged for them, and they don't affect your account statistics. See the help page at https://support.google.com/campaignmanager/answer/6076504 for details. |
general_invalid_clicks | Number of general invalid clicks. These are a subset of your invalid clicks that are detected through routine means of filtration (such as known invalid data-center traffic, bots and spiders or other crawlers, irregular patterns, etc.). You're not charged for them, and they don't affect your account statistics. See the help page at https://support.google.com/campaignmanager/answer/6076504 for details. |
mobile_friendly_clicks_percentage | The percentage of mobile clicks that go to a mobile-friendly page. |
search_absolute_top_impression_share | The percentage of the customer's Shopping or Search ad impressions that are shown in the most prominent Shopping position. See https://support.google.com/sa360/answer/9566729 for details. Any value below 0.1 is reported as 0.0999. |
search_budget_lost_absolute_top_impression_share | The number estimating how often your ad wasn't the very first ad among the top ads in the search results due to a low budget. Note: Search budget lost absolute top impression share is reported in the range of 0 to 0.9. Any value above 0.9 is reported as 0.9001. |
search_budget_lost_impression_share | The estimated percent of times that your ad was eligible to show on the Search Network but didn't because your budget was too low. Note: Search budget lost impression share is reported in the range of 0 to 0.9. Any value above 0.9 is reported as 0.9001. |
search_budget_lost_top_impression_share | The number estimating how often your ad didn't show adjacent to the top organic search results due to a low budget. Note: Search budget lost top impression share is reported in the range of 0 to 0.9. Any value above 0.9 is reported as 0.9001. |
search_click_share | The number of clicks you've received on the Search Network divided by the estimated number of clicks you were eligible to receive. Note: Search click share is reported in the range of 0.1 to 1. Any value below 0.1 is reported as 0.0999. |
search_exact_match_impression_share | The impressions you've received divided by the estimated number of impressions you were eligible to receive on the Search Network for search terms that matched your keywords exactly (or were close variants of your keyword), regardless of your keyword match types. Note: Search exact match impression share is reported in the range of 0.1 to 1. Any value below 0.1 is reported as 0.0999. |
search_impression_share | The impressions you've received on the Search Network divided by the estimated number of impressions you were eligible to receive. Note: Search impression share is reported in the range of 0.1 to 1. Any value below 0.1 is reported as 0.0999. |
search_rank_lost_absolute_top_impression_share | The number estimating how often your ad wasn't the very first ad among the top ads in the search results due to poor Ad Rank. Note: Search rank lost absolute top impression share is reported in the range of 0 to 0.9. Any value above 0.9 is reported as 0.9001. |
search_rank_lost_impression_share | The estimated percentage of impressions on the Search Network that your ads didn't receive due to poor Ad Rank. Note: Search rank lost impression share is reported in the range of 0 to 0.9. Any value above 0.9 is reported as 0.9001. |
search_rank_lost_top_impression_share | The number estimating how often your ad didn't show adjacent to the top organic search results due to poor Ad Rank. Note: Search rank lost top impression share is reported in the range of 0 to 0.9. Any value above 0.9 is reported as 0.9001. |
search_top_impression_share | The impressions you've received among the top ads compared to the estimated number of impressions you were eligible to receive among the top ads. Note: Search top impression share is reported in the range of 0.1 to 1. Any value below 0.1 is reported as 0.0999. Top ads are generally above the top organic results, although they may show below the top organic results on certain queries. |
top_impression_percentage | The percent of your ad impressions that are shown adjacent to the top organic search results. |
value_per_all_conversions | The value of all conversions divided by the number of all conversions. |
value_per_all_conversions_by_conversion_date | The value of all conversions divided by the number of all conversions. When this column is selected with date, the values in date column means the conversion date. Details for the by_conversion_date columns are available at https://support.google.com/sa360/answer/9250611 . |
value_per_conversion | The value of biddable conversion divided by the number of biddable conversions. Shows how much, on average, each of the biddable conversions is worth. |
value_per_conversions_by_conversion_date | Biddable conversions value by conversion date divided by biddable conversions by conversion date. Shows how much, on average, each of the biddable conversions is worth (by conversion date). When this column is selected with date, the values in date column means the conversion date. |
client_account_view_through_conversions | The total number of view-through conversions. These happen when a customer sees an image or rich media ad, then later completes a conversion on your site without interacting with (for example, clicking on) another ad. |
client_account_cross_sell_cost_of_goods_sold_micros | Client account cross-sell cost of goods sold (COGS) is the total cost of products sold as a result of advertising a different product. How it works: You report conversions with cart data for completed purchases on your website. If the ad that was interacted with before the purchase has an associated product (see Shopping Ads) then this product is considered the advertised product. Any product included in the order the customer places is a sold product. If these products don't match then this is considered cross-sell. Cross-sell cost of goods sold is the total cost of the products sold that weren't advertised. Example: Someone clicked on a Shopping ad for a hat then bought the same hat and a shirt. The hat has a cost of goods sold value of $3, the shirt has a cost of goods sold value of $5. The cross-sell cost of goods sold for this order is $5. This metric is only available if you report conversions with cart data. This metric is a monetary value and returned in the customer's currency by default. See the metrics_currency parameter at https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause |
cross_sell_cost_of_goods_sold_micros | Cross-sell cost of goods sold (COGS) is the total cost of products sold as a result of advertising a different product. How it works: You report conversions with cart data for completed purchases on your website. If the ad that was interacted with before the purchase has an associated product (see Shopping Ads) then this product is considered the advertised product. Any product included in the order the customer places is a sold product. If these products don't match then this is considered cross-sell. Cross-sell cost of goods sold is the total cost of the products sold that weren't advertised. Example: Someone clicked on a Shopping ad for a hat then bought the same hat and a shirt. The hat has a cost of goods sold value of $3, the shirt has a cost of goods sold value of $5. The cross-sell cost of goods sold for this order is $5. This metric is only available if you report conversions with cart data. This metric is a monetary value and returned in the customer's currency by default. See the metrics_currency parameter at https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause |
client_account_cross_sell_gross_profit_micros | Client account cross-sell gross profit is the profit you made from products sold as a result of advertising a different product, minus cost of goods sold (COGS). How it works: You report conversions with cart data for completed purchases on your website. If the ad that was interacted with before the purchase has an associated product (see Shopping Ads) then this product is considered the advertised product. Any product included in the purchase is a sold product. If these products don't match then this is considered cross-sell. Cross-sell gross profit is the revenue you made from cross-sell attributed to your ads minus the cost of the goods sold. Example: Someone clicked on a Shopping ad for a hat then bought the same hat and a shirt. The shirt is priced $20 and has a cost of goods sold value of $5. The cross-sell gross profit of this order is $15 = $20 - $5. This metric is only available if you report conversions with cart data. This metric is a monetary value and returned in the customer's currency by default. See the metrics_currency parameter at https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause |
cross_sell_gross_profit_micros | Cross-sell gross profit is the profit you made from products sold as a result of advertising a different product, minus cost of goods sold (COGS). How it works: You report conversions with cart data for completed purchases on your website. If the ad that was interacted with before the purchase has an associated product (see Shopping Ads) then this product is considered the advertised product. Any product included in the purchase is a sold product. If these products don't match then this is considered cross-sell. Cross-sell gross profit is the revenue you made from cross-sell attributed to your ads minus the cost of the goods sold. Example: Someone clicked on a Shopping ad for a hat then bought the same hat and a shirt. The shirt is priced $20 and has a cost of goods sold value of $5. The cross-sell gross profit of this order is $15 = $20 - $5. This metric is only available if you report conversions with cart data. This metric is a monetary value and returned in the customer's currency by default. See the metrics_currency parameter at https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause |
client_account_cross_sell_revenue_micros | Client account cross-sell revenue is the total amount you made from products sold as a result of advertising a different product. How it works: You report conversions with cart data for completed purchases on your website. If the ad that was interacted with before the purchase has an associated product (see Shopping Ads) then this product is considered the advertised product. Any product included in the order the customer places is a sold product. If these products don't match then this is considered cross-sell. Cross-sell revenue is the total value you made from cross-sell attributed to your ads. Example: Someone clicked on a Shopping ad for a hat then bought the same hat and a shirt. The hat is priced $10 and the shirt is priced $20. The cross-sell revenue of this order is $20. This metric is only available if you report conversions with cart data. This metric is a monetary value and returned in the customer's currency by default. See the metrics_currency parameter at https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause |
cross_sell_revenue_micros | Cross-sell revenue is the total amount you made from products sold as a result of advertising a different product. How it works: You report conversions with cart data for completed purchases on your website. If the ad that was interacted with before the purchase has an associated product (see Shopping Ads) then this product is considered the advertised product. Any product included in the order the customer places is a sold product. If these products don't match then this is considered cross-sell. Cross-sell revenue is the total value you made from cross-sell attributed to your ads. Example: Someone clicked on a Shopping ad for a hat then bought the same hat and a shirt. The hat is priced $10 and the shirt is priced $20. The cross-sell revenue of this order is $20. This metric is only available if you report conversions with cart data. This metric is a monetary value and returned in the customer's currency by default. See the metrics_currency parameter at https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause |
client_account_cross_sell_units_sold | Client account cross-sell units sold is the total number of products sold as a result of advertising a different product. How it works: You report conversions with cart data for completed purchases on your website. If the ad that was interacted with before the purchase has an associated product (see Shopping Ads) then this product is considered the advertised product. Any product included in the order the customer places is a sold product. If these products don't match then this is considered cross-sell. Cross-sell units sold is the total number of cross-sold products from all orders attributed to your ads. Example: Someone clicked on a Shopping ad for a hat then bought the same hat, a shirt and a jacket. The cross-sell units sold in this order is 2. This metric is only available if you report conversions with cart data. |
cross_sell_units_sold | Cross-sell units sold is the total number of products sold as a result of advertising a different product. How it works: You report conversions with cart data for completed purchases on your website. If the ad that was interacted with before the purchase has an associated product (see Shopping Ads) then this product is considered the advertised product. Any product included in the order the customer places is a sold product. If these products don't match then this is considered cross-sell. Cross-sell units sold is the total number of cross-sold products from all orders attributed to your ads. Example: Someone clicked on a Shopping ad for a hat then bought the same hat, a shirt and a jacket. The cross-sell units sold in this order is 2. This metric is only available if you report conversions with cart data. |
client_account_lead_cost_of_goods_sold_micros | Client account lead cost of goods sold (COGS) is the total cost of products sold as a result of advertising the same product. How it works: You report conversions with cart data for completed purchases on your website. If the ad that was interacted with has an associated product (see Shopping Ads) then this product is considered the advertised product. Any product included in the order the customer places is a sold product. If the advertised and sold products match, then the cost of these goods is counted under lead cost of goods sold. Example: Someone clicked on a Shopping ad for a hat then bought the same hat and a shirt. The hat has a cost of goods sold value of $3, the shirt has a cost of goods sold value of $5. The lead cost of goods sold for this order is $3. This metric is only available if you report conversions with cart data. This metric is a monetary value and returned in the customer's currency by default. See the metrics_currency parameter at https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause |
lead_cost_of_goods_sold_micros | Lead cost of goods sold (COGS) is the total cost of products sold as a result of advertising the same product. How it works: You report conversions with cart data for completed purchases on your website. If the ad that was interacted with has an associated product (see Shopping Ads) then this product is considered the advertised product. Any product included in the order the customer places is a sold product. If the advertised and sold products match, then the cost of these goods is counted under lead cost of goods sold. Example: Someone clicked on a Shopping ad for a hat then bought the same hat and a shirt. The hat has a cost of goods sold value of $3, the shirt has a cost of goods sold value of $5. The lead cost of goods sold for this order is $3. This metric is only available if you report conversions with cart data. This metric is a monetary value and returned in the customer's currency by default. See the metrics_currency parameter at https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause |
client_account_lead_gross_profit_micros | Client account lead gross profit is the profit you made from products sold as a result of advertising the same product, minus cost of goods sold (COGS). How it works: You report conversions with cart data for completed purchases on your website. If the ad that was interacted with before the purchase has an associated product (see Shopping Ads) then this product is considered the advertised product. Any product included in the order the customer places is a sold product. If the advertised and sold products match, then the revenue you made from these sales minus the cost of goods sold is your lead gross profit. Example: Someone clicked on a Shopping ad for a hat then bought the same hat and a shirt. The hat is priced $10 and has a cost of goods sold value of $3. The lead gross profit of this order is $7 = $10 - $3. This metric is only available if you report conversions with cart data. This metric is a monetary value and returned in the customer's currency by default. See the metrics_currency parameter at https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause |
lead_gross_profit_micros | Lead gross profit is the profit you made from products sold as a result of advertising the same product, minus cost of goods sold (COGS). How it works: You report conversions with cart data for completed purchases on your website. If the ad that was interacted with before the purchase has an associated product (see Shopping Ads) then this product is considered the advertised product. Any product included in the order the customer places is a sold product. If the advertised and sold products match, then the revenue you made from these sales minus the cost of goods sold is your lead gross profit. Example: Someone clicked on a Shopping ad for a hat then bought the same hat and a shirt. The hat is priced $10 and has a cost of goods sold value of $3. The lead gross profit of this order is $7 = $10 - $3. This metric is only available if you report conversions with cart data. This metric is a monetary value and returned in the customer's currency by default. See the metrics_currency parameter at https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause |
client_account_lead_revenue_micros | Client account lead revenue is the total amount you made from products sold as a result of advertising the same product. How it works: You report conversions with cart data for completed purchases on your website. If the ad that was interacted with before the purchase has an associated product (see Shopping Ads) then this product is considered the advertised product. Any product included in the order the customer places is a sold product. If the advertised and sold products match, then the total value you made from the sales of these products is shown under lead revenue. Example: Someone clicked on a Shopping ad for a hat then bought the same hat and a shirt. The hat is priced $10 and the shirt is priced $20. The lead revenue of this order is $10. This metric is only available if you report conversions with cart data. This metric is a monetary value and returned in the customer's currency by default. See the metrics_currency parameter at https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause |
lead_revenue_micros | Lead revenue is the total amount you made from products sold as a result of advertising the same product. How it works: You report conversions with cart data for completed purchases on your website. If the ad that was interacted with before the purchase has an associated product (see Shopping Ads) then this product is considered the advertised product. Any product included in the order the customer places is a sold product. If the advertised and sold products match, then the total value you made from the sales of these products is shown under lead revenue. Example: Someone clicked on a Shopping ad for a hat then bought the same hat and a shirt. The hat is priced $10 and the shirt is priced $20. The lead revenue of this order is $10. This metric is only available if you report conversions with cart data. This metric is a monetary value and returned in the customer's currency by default. See the metrics_currency parameter at https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause |
client_account_lead_units_sold | Client account lead units sold is the total number of products sold as a result of advertising the same product. How it works: You report conversions with cart data for completed purchases on your website. If the ad that was interacted with before the purchase has an associated product (see Shopping Ads) then this product is considered the advertised product. Any product included in the order the customer places is a sold product. If the advertised and sold products match, then the total number of these products sold is shown under lead units sold. Example: Someone clicked on a Shopping ad for a hat then bought the same hat, a shirt and a jacket. The lead units sold in this order is 1. This metric is only available if you report conversions with cart data. |
lead_units_sold | Lead units sold is the total number of products sold as a result of advertising the same product. How it works: You report conversions with cart data for completed purchases on your website. If the ad that was interacted with before the purchase has an associated product (see Shopping Ads) then this product is considered the advertised product. Any product included in the order the customer places is a sold product. If the advertised and sold products match, then the total number of these products sold is shown under lead units sold. Example: Someone clicked on a Shopping ad for a hat then bought the same hat, a shirt and a jacket. The lead units sold in this order is 1. This metric is only available if you report conversions with cart data. |
MobileAppAsset
An asset representing a mobile app.
فیلدها | |
---|---|
app_id | مورد نیاز. A string that uniquely identifies a mobile application. It should just contain the platform native id, like "com.android.ebay" for Android or "12345689" for iOS. |
app_store | مورد نیاز. The application store that distributes this specific app. |
درصد Cpc
A bidding strategy where bids are a fraction of the advertised price for some good or service.
فیلدها | |
---|---|
cpc_bid_ceiling_micros | Maximum bid limit that can be set by the bid strategy. This is an optional field entered by the advertiser and specified in local micros. Note: A zero value is interpreted in the same way as having bid_ceiling undefined. |
enhanced_cpc_enabled | Adjusts the bid for each auction upward or downward, depending on the likelihood of a conversion. Individual bids may exceed cpc_bid_ceiling_micros, but the average bid amount for a campaign should not. |
RealTimeBiddingSetting
Settings for Real-Time Bidding, a feature only available for campaigns targeting the Ad Exchange network.
فیلدها | |
---|---|
opt_in | Whether the campaign is opted in to real-time bidding. |
SearchAds360ExpandedDynamicSearchAdInfo
An expanded dynamic search ad.
فیلدها | |
---|---|
description1 | The first line of the ad's description. |
description2 | The second line of the ad's description. |
ad_tracking_id | The tracking id of the ad. |
SearchAds360ExpandedTextAdInfo
A Search Ads 360 expanded text ad.
فیلدها | |
---|---|
headline | The headline of the ad. |
headline2 | The second headline of the ad. |
headline3 | The third headline of the ad. |
description1 | The first line of the ad's description. |
description2 | The second line of the ad's description. |
path1 | Text appended to the auto-generated visible URL with a delimiter. |
path2 | Text appended to path1 with a delimiter. |
ad_tracking_id | The tracking id of the ad. |
SearchAds360ProductAdInfo
This type has no fields.
A Search Ads 360 product ad.
SearchAds360ResponsiveSearchAdInfo
A Search Ads 360 responsive search ad.
فیلدها | |
---|---|
headlines[] | List of text assets for headlines. When the ad serves the headlines will be selected from this list. |
descriptions[] | List of text assets for descriptions. When the ad serves the descriptions will be selected from this list. |
path1 | Text appended to the auto-generated visible URL with a delimiter. |
path2 | Text appended to path1 with a delimiter. |
ad_tracking_id | The tracking id of the ad. |
SearchAds360TextAdInfo
A Search Ads 360 text ad.
فیلدها | |
---|---|
headline | The headline of the ad. |
description1 | The first line of the ad's description. |
description2 | The second line of the ad's description. |
display_url | The displayed URL of the ad. |
display_mobile_url | The displayed mobile URL of the ad. |
ad_tracking_id | The tracking id of the ad. |
بخش ها
Segment only fields.
فیلدها | |
---|---|
ad_network_type | Ad network type. |
conversion_action_category | Conversion action category. |
conversion_custom_dimensions[] | The conversion custom dimensions. |
day_of_week | Day of the week, for example, MONDAY. |
device | Device to which metrics apply. |
keyword | Keyword criterion. |
product_channel | Channel of the product. |
product_channel_exclusivity | Channel exclusivity of the product. |
product_condition | Condition of the product. |
product_sold_condition | Condition of the product sold. |
raw_event_conversion_dimensions[] | The raw event conversion dimensions. |
conversion_action | Resource name of the conversion action. |
conversion_action_name | Conversion action name. |
date | Date to which metrics apply. yyyy-MM-dd format, for example, 2018-04-17. |
geo_target_city | Resource name of the geo target constant that represents a city. |
geo_target_country | Resource name of the geo target constant that represents a country. |
geo_target_metro | Resource name of the geo target constant that represents a metro. |
geo_target_region | Resource name of the geo target constant that represents a region. |
hour | Hour of day as a number between 0 and 23, inclusive. |
month | Month as represented by the date of the first day of a month. Formatted as yyyy-MM-dd. |
product_bidding_category_level1 | Bidding category (level 1) of the product. |
product_bidding_category_level2 | Bidding category (level 2) of the product. |
product_bidding_category_level3 | Bidding category (level 3) of the product. |
product_bidding_category_level4 | Bidding category (level 4) of the product. |
product_bidding_category_level5 | Bidding category (level 5) of the product. |
product_brand | Brand of the product. |
product_country | Resource name of the geo target constant for the country of sale of the product. |
product_custom_attribute0 | Custom attribute 0 of the product. |
product_custom_attribute1 | Custom attribute 1 of the product. |
product_custom_attribute2 | Custom attribute 2 of the product. |
product_custom_attribute3 | Custom attribute 3 of the product. |
product_custom_attribute4 | Custom attribute 4 of the product. |
product_item_id | Item ID of the product. |
product_language | Resource name of the language constant for the language of the product. |
product_sold_bidding_category_level1 | Bidding category (level 1) of the product sold. |
product_sold_bidding_category_level2 | Bidding category (level 2) of the product sold. |
product_sold_bidding_category_level3 | Bidding category (level 3) of the product sold. |
product_sold_bidding_category_level4 | Bidding category (level 4) of the product sold. |
product_sold_bidding_category_level5 | Bidding category (level 5) of the product sold. |
product_sold_brand | Brand of the product sold. |
product_sold_custom_attribute0 | Custom attribute 0 of the product sold. |
product_sold_custom_attribute1 | Custom attribute 1 of the product sold. |
product_sold_custom_attribute2 | Custom attribute 2 of the product sold. |
product_sold_custom_attribute3 | Custom attribute 3 of the product sold. |
product_sold_custom_attribute4 | Custom attribute 4 of the product sold. |
product_sold_item_id | Item ID of the product sold. |
product_sold_title | Title of the product sold. |
product_sold_type_l1 | Type (level 1) of the product sold. |
product_sold_type_l2 | Type (level 2) of the product sold. |
product_sold_type_l3 | Type (level 3) of the product sold. |
product_sold_type_l4 | Type (level 4) of the product sold. |
product_sold_type_l5 | Type (level 5) of the product sold. |
product_store_id | Store ID of the product. |
product_title | Title of the product. |
product_type_l1 | Type (level 1) of the product. |
product_type_l2 | Type (level 2) of the product. |
product_type_l3 | Type (level 3) of the product. |
product_type_l4 | Type (level 4) of the product. |
product_type_l5 | Type (level 5) of the product. |
quarter | Quarter as represented by the date of the first day of a quarter. Uses the calendar year for quarters, for example, the second quarter of 2018 starts on 2018-04-01. Formatted as yyyy-MM-dd. |
week | Week as defined as Monday through Sunday, and represented by the date of Monday. Formatted as yyyy-MM-dd. |
year | Year, formatted as yyyy. |
asset_interaction_target | Only used with CustomerAsset, CampaignAsset and AdGroupAsset metrics. Indicates whether the interaction metrics occurred on the asset itself or a different asset or ad unit. Interactions (for example, clicks) are counted across all the parts of the served ad (for example, Ad itself and other components like Sitelinks) when they are served together. When interaction_on_this_asset is true, it means the interactions are on this specific asset and when interaction_on_this_asset is false, it means the interactions is not on this specific asset but on other parts of the served ad this asset is served with. |
TargetCpa
An automated bid strategy that sets bids to help get as many conversions as possible at the target cost-per-acquisition (CPA) you set.
فیلدها | |
---|---|
target_cpa_micros | Average CPA target. This target should be greater than or equal to minimum billable unit based on the currency for the account. |
cpc_bid_ceiling_micros | Maximum bid limit that can be set by the bid strategy. The limit applies to all keywords managed by the strategy. This should only be set for portfolio bid strategies. |
cpc_bid_floor_micros | Minimum bid limit that can be set by the bid strategy. The limit applies to all keywords managed by the strategy. This should only be set for portfolio bid strategies. |
TargetCpm
This type has no fields.
Target CPM (cost per thousand impressions) is an automated bidding strategy that sets bids to optimize performance given the target CPM you set.
TargetRestriction
The list of per-targeting-dimension targeting settings.
فیلدها | |
---|---|
targeting_dimension | The targeting dimension that these settings apply to. |
bid_only | Indicates whether to restrict your ads to show only for the criteria you have selected for this targeting_dimension, or to target all values for this targeting_dimension and show ads based on your targeting in other TargetingDimensions. A value of |
TargetRoas
An automated bidding strategy that helps you maximize revenue while averaging a specific target return on ad spend (ROAS).
فیلدها | |
---|---|
target_roas | مورد نیاز. The chosen revenue (based on conversion data) per unit of spend. Value must be between 0.01 and 1000.0, inclusive. |
cpc_bid_ceiling_micros | Maximum bid limit that can be set by the bid strategy. The limit applies to all keywords managed by the strategy. This should only be set for portfolio bid strategies. |
cpc_bid_floor_micros | Minimum bid limit that can be set by the bid strategy. The limit applies to all keywords managed by the strategy. This should only be set for portfolio bid strategies. |
TargetSpend
An automated bid strategy that sets your bids to help get as many clicks as possible within your budget.
فیلدها | |
---|---|
target_spend_micros | Deprecated: The spend target under which to maximize clicks. A TargetSpend bidder will attempt to spend the smaller of this value or the natural throttling spend amount. If not specified, the budget is used as the spend target. This field is deprecated and should no longer be used. See https://ads-developers.googleblog.com/2020/05/reminder-about-sunset-creation-of.html for details. |
cpc_bid_ceiling_micros | Maximum bid limit that can be set by the bid strategy. The limit applies to all keywords managed by the strategy. |
TargetingSetting
Settings for the targeting-related features, at the campaign and ad group levels. For more details about the targeting setting, visit https://support.google.com/google-ads/answer/7365594
فیلدها | |
---|---|
target_restrictions[] | The per-targeting-dimension setting to restrict the reach of your campaign or ad group. |
TextAsset
A Text asset.
فیلدها | |
---|---|
text | Text content of the text asset. |
TextLabel
A type of label displaying text on a colored background.
فیلدها | |
---|---|
background_color | Background color of the label in HEX format. This string must match the regular expression '^#([a-fA-F0-9]{6}|[a-fA-F0-9]{3})$'. Note: The background color may not be visible for manager accounts. |
description | A short description of the label. The length must be no more than 200 characters. |
UnifiedCallAsset
A unified call asset.
فیلدها | |
---|---|
country_code | Two-letter country code of the phone number. Examples: 'US', 'us'. |
phone_number | The advertiser's raw phone number. Examples: '1234567890', '(123)456-7890' |
call_conversion_reporting_state | Indicates whether this CallAsset should use its own call conversion setting, follow the account level setting, or disable call conversion. |
call_conversion_action | The conversion action to attribute a call conversion to. If not set, the default conversion action is used. This field only has effect if call_conversion_reporting_state is set to USE_RESOURCE_LEVEL_CALL_CONVERSION_ACTION. |
ad_schedule_targets[] | List of non-overlapping schedules specifying all time intervals for which the asset may serve. There can be a maximum of 6 schedules per day, 42 in total. |
call_only | Whether the call only shows the phone number without a link to the website. Applies to Microsoft Ads. |
call_tracking_enabled | Whether the call should be enabled on call tracking. Applies to Microsoft Ads. |
use_searcher_time_zone | Whether to show the call extension in search user's time zone. Applies to Microsoft Ads. |
start_date | Start date of when this asset is effective and can begin serving, in yyyy-MM-dd format. |
end_date | Last date of when this asset is effective and still serving, in yyyy-MM-dd format. |
UnifiedCalloutAsset
A unified callout asset.
فیلدها | |
---|---|
callout_text | The callout text. The length of this string should be between 1 and 25, inclusive. |
start_date | Start date of when this asset is effective and can begin serving, in yyyy-MM-dd format. |
end_date | Last date of when this asset is effective and still serving, in yyyy-MM-dd format. |
ad_schedule_targets[] | List of non-overlapping schedules specifying all time intervals for which the asset may serve. There can be a maximum of 6 schedules per day, 42 in total. |
use_searcher_time_zone | Whether to show the asset in search user's time zone. Applies to Microsoft Ads. |
UnifiedLocationAsset
A unified location asset.
فیلدها | |
---|---|
place_id | Place IDs uniquely identify a place in the Google Places database and on Google Maps. This field is unique for a given customer ID and asset type. See https://developers.google.com/places/web-service/place-id to learn more about Place ID. |
business_profile_locations[] | The list of business locations for the customer. This will only be returned if the Location Asset is syncing from the Business Profile account. It is possible to have multiple Business Profile listings under the same account that point to the same Place ID. |
location_ownership_type | The type of location ownership. If the type is BUSINESS_OWNER, it will be served as a location extension. If the type is AFFILIATE, it will be served as an affiliate location. |
UnifiedPageFeedAsset
A Unified Page Feed asset.
فیلدها | |
---|---|
page_url | The webpage that advertisers want to target. |
labels[] | Labels used to group the page urls. |
UnifiedSitelinkAsset
A unified sitelink asset.
فیلدها | |
---|---|
link_text | URL display text for the sitelink. The length of this string should be between 1 and 25, inclusive. |
description1 | First line of the description for the sitelink. If set, the length should be between 1 and 35, inclusive, and description2 must also be set. |
description2 | Second line of the description for the sitelink. If set, the length should be between 1 and 35, inclusive, and description1 must also be set. |
start_date | Start date of when this asset is effective and can begin serving, in yyyy-MM-dd format. |
end_date | Last date of when this asset is effective and still serving, in yyyy-MM-dd format. |
ad_schedule_targets[] | List of non-overlapping schedules specifying all time intervals for which the asset may serve. There can be a maximum of 6 schedules per day, 42 in total. |
tracking_id | ID used for tracking clicks for the sitelink asset. This is a Yahoo! Japan only field. |
use_searcher_time_zone | Whether to show the sitelink asset in search user's time zone. Applies to Microsoft Ads. |
mobile_preferred | Whether the preference is for the sitelink asset to be displayed on mobile devices. Applies to Microsoft Ads. |
UserListInfo
A User List criterion. Represents a user list that is defined by the advertiser to be targeted.
فیلدها | |
---|---|
user_list | The User List resource name. |
ارزش
A generic data container.
فیلدها | |
---|---|
Union field value . A value. value can be only one of the following: | |
boolean_value | یک بولی |
int64_value | An int64. |
float_value | A float. |
double_value | یک دوتایی |
string_value | یک رشته |
WebpageConditionInfo
Logical expression for targeting webpages of an advertiser's website.
فیلدها | |
---|---|
operand | Operand of webpage targeting condition. |
operator | Operator of webpage targeting condition. |
argument | Argument of webpage targeting condition. |
WebpageInfo
Represents a criterion for targeting webpages of an advertiser's website.
فیلدها | |
---|---|
conditions[] | Conditions, or logical expressions, for webpage targeting. The list of webpage targeting conditions are and-ed together when evaluated for targeting. An empty list of conditions indicates all pages of the campaign's website are targeted. This field is required for CREATE operations and is prohibited on UPDATE operations. |
coverage_percentage | 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 | 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 | YouTube video title. |
youtube_video_id | YouTube video id. This is the 11 character string value used in the YouTube video URL. |
شاخص
-
AdScheduleInfo
(message) -
AdTextAsset
(message) -
AgeRangeInfo
(message) -
AssetInteractionTarget
(message) -
AssetUsage
(message) -
AudienceInfo
(message) -
BusinessProfileLocation
(message) -
CallToActionAsset
(message) -
CustomParameter
(message) -
DeviceInfo
(message) -
EnhancedCpc
(message) -
FrequencyCapEntry
(message) -
GenderInfo
(message) -
ImageAsset
(message) -
ImageDimension
(message) -
Keyword
(message) -
KeywordInfo
(message) -
LanguageInfo
(message) -
ListingGroupInfo
(message) -
LocationGroupInfo
(message) -
LocationInfo
(message) -
ManualCpa
(message) -
ManualCpc
(message) -
ManualCpm
(message) -
MaximizeConversionValue
(message) -
MaximizeConversions
(message) -
Metrics
(message) -
MobileAppAsset
(message) -
PercentCpc
(message) -
RealTimeBiddingSetting
(message) -
SearchAds360ExpandedDynamicSearchAdInfo
(message) -
SearchAds360ExpandedTextAdInfo
(message) -
SearchAds360ProductAdInfo
(message) -
SearchAds360ResponsiveSearchAdInfo
(message) -
SearchAds360TextAdInfo
(message) -
Segments
(message) -
TargetCpa
(message) -
TargetCpm
(message) -
TargetImpressionShare
(message) -
TargetOutrankShare
(message) -
TargetRestriction
(message) -
TargetRoas
(message) -
TargetSpend
(message) -
TargetingSetting
(message) -
TextAsset
(message) -
TextLabel
(message) -
UnifiedCallAsset
(message) -
UnifiedCalloutAsset
(message) -
UnifiedLocationAsset
(message) -
UnifiedPageFeedAsset
(message) -
UnifiedSitelinkAsset
(message) -
UserListInfo
(message) -
Value
(message) -
WebpageConditionInfo
(message) -
WebpageInfo
(message) -
YoutubeVideoAsset
(message)
AdScheduleInfo
Represents an AdSchedule criterion.
AdSchedule is specified as the day of the week and a time interval within which ads will be shown.
No more than six AdSchedules can be added for the same day.
فیلدها | |
---|---|
start_minute | Minutes after the start hour at which this schedule starts. This field is required for CREATE operations and is prohibited on UPDATE operations. |
end_minute | Minutes after the end hour at which this schedule ends. The schedule is exclusive of the end minute. This field is required for CREATE operations and is prohibited on UPDATE operations. |
day_of_week | Day of the week the schedule applies to. This field is required for CREATE operations and is prohibited on UPDATE operations. |
start_hour | Starting hour in 24 hour time. This field must be between 0 and 23, inclusive. This field is required for CREATE operations and is prohibited on UPDATE operations. |
end_hour | Ending hour in 24 hour time; 24 signifies end of the day. This field must be between 0 and 24, inclusive. This field is required for CREATE operations and is prohibited on UPDATE operations. |
AdTextAsset
A text asset used inside an ad.
فیلدها | |
---|---|
text | Asset text. |
AgeRangeInfo
An age range criterion.
فیلدها | |
---|---|
type | Type of the age range. |
AssetInteractionTarget
An AssetInteractionTarget segment.
فیلدها | |
---|---|
asset | The asset resource name. |
interaction_on_this_asset | Only used with CustomerAsset, CampaignAsset and AdGroupAsset metrics. Indicates whether the interaction metrics occurred on the asset itself or a different asset or ad unit. |
AssetUsage
Contains the usage information of the asset.
فیلدها | |
---|---|
asset | Resource name of the asset. |
served_asset_field_type | The served field type of the asset. |
AudienceInfo
An audience criterion.
فیلدها | |
---|---|
audience | The Audience resource name. |
BusinessProfileLocation
Business Profile location data synced from the linked Business Profile account.
فیلدها | |
---|---|
labels[] | Advertiser specified label for the location on the Business Profile account. This is synced from the Business Profile account. |
store_code | Business Profile store code of this location. This is synced from the Business Profile account. |
listing_id | Listing ID of this Business Profile location. This is synced from the linked Business Profile account. |
CallToActionAsset
A call to action asset.
فیلدها | |
---|---|
call_to_action | فراخوان به اقدام. |
CustomParameter
A mapping that can be used by custom parameter tags in a tracking_url_template
, final_urls
, or mobile_final_urls
.
فیلدها | |
---|---|
key | The key matching the parameter tag name. |
value | The value to be substituted. |
اطلاعات دستگاه
A device criterion.
فیلدها | |
---|---|
type | Type of the device. |
EnhancedCpc
This type has no fields.
An automated bidding strategy that raises bids for clicks that seem more likely to lead to a conversion and lowers them for clicks where they seem less likely.
This bidding strategy is deprecated and cannot be created anymore. Use ManualCpc with enhanced_cpc_enabled set to true for equivalent functionality.
FrequencyCapEntry
This type has no fields.
A rule specifying the maximum number of times an ad (or some set of ads) can be shown to a user over a particular time period.
GenderInfo
A gender criterion.
فیلدها | |
---|---|
type | Type of the gender. |
ImageAsset
An Image asset.
فیلدها | |
---|---|
mime_type | MIME type of the image asset. |
full_size | Metadata for this image at its original size. |
file_size | File size of the image asset in bytes. |
ImageDimension
Metadata for an image at a certain size, either original or resized.
فیلدها | |
---|---|
height_pixels | Height of the image. |
width_pixels | Width of the image. |
url | A URL that returns the image with this height and width. |
کلمه کلیدی
A Keyword criterion segment.
فیلدها | |
---|---|
info | اطلاعات کلمه کلیدی |
ad_group_criterion | The AdGroupCriterion resource name. |
KeywordInfo
A keyword criterion.
فیلدها | |
---|---|
match_type | The match type of the keyword. |
text | The text of the keyword (at most 80 characters and 10 words). |
LanguageInfo
A language criterion.
فیلدها | |
---|---|
language_constant | The language constant resource name. |
ListingGroupInfo
A listing group criterion.
فیلدها | |
---|---|
type | Type of the listing group. |
LocationGroupInfo
A radius around a list of locations specified through a feed.
فیلدها | |
---|---|
geo_target_constants[] | Geo target constant(s) restricting the scope of the geographic area within the feed. Currently only one geo target constant is allowed. |
radius_units | Unit of the radius. Miles and meters are supported for geo target constants. Milli miles and meters are supported for feed item sets. This is required and must be set in CREATE operations. |
feed_item_sets[] | FeedItemSets whose FeedItems are targeted. If multiple IDs are specified, then all items that appear in at least one set are targeted. This field cannot be used with geo_target_constants. This is optional and can only be set in CREATE operations. |
radius | Distance in units specifying the radius around targeted locations. This is required and must be set in CREATE operations. |
LocationInfo
A location criterion.
فیلدها | |
---|---|
geo_target_constant | The geo target constant resource name. |
ManualCpa
This type has no fields.
Manual bidding strategy that allows advertiser to set the bid per advertiser-specified action.
ManualCpc
Manual click-based bidding where user pays per click.
فیلدها | |
---|---|
enhanced_cpc_enabled | Whether bids are to be enhanced based on conversion optimizer data. |
ManualCpm
This type has no fields.
Manual impression-based bidding where user pays per thousand impressions.
MaximizeConversionValue
An automated bidding strategy to help get the most conversion value for your campaigns while spending your budget.
فیلدها | |
---|---|
cpc_bid_ceiling_micros | Maximum bid limit that can be set by the bid strategy. The limit applies to all keywords managed by the strategy. Mutable for portfolio bidding strategies only. |
cpc_bid_floor_micros | Minimum bid limit that can be set by the bid strategy. The limit applies to all keywords managed by the strategy. Mutable for portfolio bidding strategies only. |
target_roas | The target return on ad spend (ROAS) option. If set, the bid strategy will maximize revenue while averaging the target return on ad spend. If the target ROAS is high, the bid strategy may not be able to spend the full budget. If the target ROAS is not set, the bid strategy will aim to achieve the highest possible ROAS for the budget. |
MaximizeConversions
An automated bidding strategy to help get the most conversions for your campaigns while spending your budget.
فیلدها | |
---|---|
cpc_bid_ceiling_micros | Maximum bid limit that can be set by the bid strategy. The limit applies to all keywords managed by the strategy. Mutable for portfolio bidding strategies only. |
cpc_bid_floor_micros | Minimum bid limit that can be set by the bid strategy. The limit applies to all keywords managed by the strategy. Mutable for portfolio bidding strategies only. |
target_cpa_micros | The target cost-per-action (CPA) option. This is the average amount that you would like to spend per conversion action specified in micro units of the bidding strategy's currency. If set, the bid strategy will get as many conversions as possible at or below the target cost-per-action. If the target CPA is not set, the bid strategy will aim to achieve the lowest possible CPA given the budget. |
معیارها
Metrics data.
فیلدها | |
---|---|
all_conversions_value_by_conversion_date | The value of all conversions. When this column is selected with date, the values in date column means the conversion date. Details for the by_conversion_date columns are available at https://support.google.com/sa360/answer/9250611 . |
all_conversions_by_conversion_date | The total number of conversions. This includes all conversions regardless of the value of include_in_conversions_metric. When this column is selected with date, the values in date column means the conversion date. Details for the by_conversion_date columns are available at https://support.google.com/sa360/answer/9250611 . |
conversion_custom_metrics[] | The conversion custom metrics. |
conversions_value_by_conversion_date | The sum of biddable conversions value by conversion date. When this column is selected with date, the values in date column means the conversion date. |
conversions_by_conversion_date | The sum of conversions by conversion date for biddable conversion types. Can be fractional due to attribution modeling. When this column is selected with date, the values in date column means the conversion date. |
historical_creative_quality_score | The creative historical quality score. |
historical_landing_page_quality_score | The quality of historical landing page experience. |
historical_search_predicted_ctr | The historical search predicted click through rate (CTR). |
interaction_event_types[] | The types of payable and free interactions. |
raw_event_conversion_metrics[] | The raw event conversion metrics. |
absolute_top_impression_percentage | Search absolute top impression share is the percentage of your Search ad impressions that are shown in the most prominent Search position. |
all_conversions_from_interactions_rate | All conversions from interactions (as oppose to view through conversions) divided by the number of ad interactions. |
all_conversions_value | The value of all conversions. |
all_conversions | The total number of conversions. This includes all conversions regardless of the value of include_in_conversions_metric. |
all_conversions_value_per_cost | The value of all conversions divided by the total cost of ad interactions (such as clicks for text ads or views for video ads). |
all_conversions_from_click_to_call | The number of times people clicked the "Call" button to call a store during or after clicking an ad. This number doesn't include whether or not calls were connected, or the duration of any calls. This metric applies to feed items only. |
all_conversions_from_directions | The number of times people clicked a "Get directions" button to navigate to a store after clicking an ad. This metric applies to feed items only. |
all_conversions_from_interactions_value_per_interaction | The value of all conversions from interactions divided by the total number of interactions. |
all_conversions_from_menu | The number of times people clicked a link to view a store's menu after clicking an ad. This metric applies to feed items only. |
all_conversions_from_order | The number of times people placed an order at a store after clicking an ad. This metric applies to feed items only. |
all_conversions_from_other_engagement | The number of other conversions (for example, posting a review or saving a location for a store) that occurred after people clicked an ad. This metric applies to feed items only. |
all_conversions_from_store_visit | Estimated number of times people visited a store after clicking an ad. This metric applies to feed items only. |
visits | Clicks that Search Ads 360 has successfully recorded and forwarded to an advertiser's landing page. |
all_conversions_from_store_website | The number of times that people were taken to a store's URL after clicking an ad. This metric applies to feed items only. |
average_cost | The average amount you pay per interaction. This amount is the total cost of your ads divided by the total number of interactions. |
average_cpc | The total cost of all clicks divided by the total number of clicks received. This metric is a monetary value and returned in the customer's currency by default. See the metrics_currency parameter at https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause |
average_cpm | Average cost-per-thousand impressions (CPM). This metric is a monetary value and returned in the customer's currency by default. See the metrics_currency parameter at https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause |
clicks | The number of clicks. |
content_budget_lost_impression_share | The estimated percent of times that your ad was eligible to show on the Display Network but didn't because your budget was too low. Note: Content budget lost impression share is reported in the range of 0 to 0.9. Any value above 0.9 is reported as 0.9001. |
content_impression_share | The impressions you've received on the Display Network divided by the estimated number of impressions you were eligible to receive. Note: Content impression share is reported in the range of 0.1 to 1. Any value below 0.1 is reported as 0.0999. |
content_rank_lost_impression_share | The estimated percentage of impressions on the Display Network that your ads didn't receive due to poor Ad Rank. Note: Content rank lost impression share is reported in the range of 0 to 0.9. Any value above 0.9 is reported as 0.9001. |
conversions_from_interactions_rate | Average biddable conversions (from interaction) per conversion eligible interaction. Shows how often, on average, an ad interaction leads to a biddable conversion. |
client_account_conversions_value | The value of client account conversions. This only includes conversion actions which include_in_client_account_conversions_metric attribute is set to true. If you use conversion-based bidding, your bid strategies will optimize for these conversions. |
conversions_value_per_cost | The value of biddable conversion divided by the total cost of conversion eligible interactions. |
conversions_from_interactions_value_per_interaction | The value of conversions from interactions divided by the number of ad interactions. This only includes conversion actions which include_in_conversions_metric attribute is set to true. If you use conversion-based bidding, your bid strategies will optimize for these conversions. |
client_account_conversions | The number of client account conversions. This only includes conversion actions which include_in_client_account_conversions_metric attribute is set to true. If you use conversion-based bidding, your bid strategies will optimize for these conversions. |
cost_micros | The sum of your cost-per-click (CPC) and cost-per-thousand impressions (CPM) costs during this period. This metric is a monetary value and returned in the customer's currency by default. See the metrics_currency parameter at https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause |
cost_per_all_conversions | The cost of ad interactions divided by all conversions. |
cost_per_conversion | Average conversion eligible cost per biddable conversion. |
cost_per_current_model_attributed_conversion | The cost of ad interactions divided by current model attributed conversions. This only includes conversion actions which include_in_conversions_metric attribute is set to true. If you use conversion-based bidding, your bid strategies will optimize for these conversions. |
cross_device_conversions | Conversions from when a customer clicks on an ad on one device, then converts on a different device or browser. Cross-device conversions are already included in all_conversions. |
cross_device_conversions_by_conversion_date | The number of cross-device conversions by conversion date. Details for the by_conversion_date columns are available at https://support.google.com/sa360/answer/9250611 . |
cross_device_conversions_value | The sum of the value of cross-device conversions. |
cross_device_conversions_value_by_conversion_date | The sum of cross-device conversions value by conversion date. Details for the by_conversion_date columns are available at https://support.google.com/sa360/answer/9250611 . |
ctr | The number of clicks your ad receives (Clicks) divided by the number of times your ad is shown (Impressions). |
conversions | The number of conversions. This only includes conversion actions which include_in_conversions_metric attribute is set to true. If you use conversion-based bidding, your bid strategies will optimize for these conversions. |
conversions_value | The sum of conversion values for the conversions included in the "conversions" field. This metric is useful only if you entered a value for your conversion actions. |
average_quality_score | The average quality score. |
historical_quality_score | The historical quality score. |
impressions | Count of how often your ad has appeared on a search results page or website on the Google Network. |
interaction_rate | How often people interact with your ad after it is shown to them. This is the number of interactions divided by the number of times your ad is shown. |
interactions | The number of interactions. An interaction is the main user action associated with an ad format-clicks for text and shopping ads, views for video ads, and so on. |
invalid_click_rate | The percentage of clicks filtered out of your total number of clicks (filtered + non-filtered clicks) during the reporting period. |
invalid_clicks | Number of clicks Google considers illegitimate and doesn't charge you for. |
general_invalid_click_rate | The percentage of clicks that have been filtered out of your total number of clicks (filtered + non-filtered clicks) due to being general invalid clicks. These are clicks Google considers illegitimate that are detected through routine means of filtration (that is, known invalid data-center traffic, bots and spiders or other crawlers, irregular patterns, etc). You're not charged for them, and they don't affect your account statistics. See the help page at https://support.google.com/campaignmanager/answer/6076504 for details. |
general_invalid_clicks | Number of general invalid clicks. These are a subset of your invalid clicks that are detected through routine means of filtration (such as known invalid data-center traffic, bots and spiders or other crawlers, irregular patterns, etc.). You're not charged for them, and they don't affect your account statistics. See the help page at https://support.google.com/campaignmanager/answer/6076504 for details. |
mobile_friendly_clicks_percentage | The percentage of mobile clicks that go to a mobile-friendly page. |
search_absolute_top_impression_share | The percentage of the customer's Shopping or Search ad impressions that are shown in the most prominent Shopping position. See https://support.google.com/sa360/answer/9566729 for details. Any value below 0.1 is reported as 0.0999. |
search_budget_lost_absolute_top_impression_share | The number estimating how often your ad wasn't the very first ad among the top ads in the search results due to a low budget. Note: Search budget lost absolute top impression share is reported in the range of 0 to 0.9. Any value above 0.9 is reported as 0.9001. |
search_budget_lost_impression_share | The estimated percent of times that your ad was eligible to show on the Search Network but didn't because your budget was too low. Note: Search budget lost impression share is reported in the range of 0 to 0.9. Any value above 0.9 is reported as 0.9001. |
search_budget_lost_top_impression_share | The number estimating how often your ad didn't show adjacent to the top organic search results due to a low budget. Note: Search budget lost top impression share is reported in the range of 0 to 0.9. Any value above 0.9 is reported as 0.9001. |
search_click_share | The number of clicks you've received on the Search Network divided by the estimated number of clicks you were eligible to receive. Note: Search click share is reported in the range of 0.1 to 1. Any value below 0.1 is reported as 0.0999. |
search_exact_match_impression_share | The impressions you've received divided by the estimated number of impressions you were eligible to receive on the Search Network for search terms that matched your keywords exactly (or were close variants of your keyword), regardless of your keyword match types. Note: Search exact match impression share is reported in the range of 0.1 to 1. Any value below 0.1 is reported as 0.0999. |
search_impression_share | The impressions you've received on the Search Network divided by the estimated number of impressions you were eligible to receive. Note: Search impression share is reported in the range of 0.1 to 1. Any value below 0.1 is reported as 0.0999. |
search_rank_lost_absolute_top_impression_share | The number estimating how often your ad wasn't the very first ad among the top ads in the search results due to poor Ad Rank. Note: Search rank lost absolute top impression share is reported in the range of 0 to 0.9. Any value above 0.9 is reported as 0.9001. |
search_rank_lost_impression_share | The estimated percentage of impressions on the Search Network that your ads didn't receive due to poor Ad Rank. Note: Search rank lost impression share is reported in the range of 0 to 0.9. Any value above 0.9 is reported as 0.9001. |
search_rank_lost_top_impression_share | The number estimating how often your ad didn't show adjacent to the top organic search results due to poor Ad Rank. Note: Search rank lost top impression share is reported in the range of 0 to 0.9. Any value above 0.9 is reported as 0.9001. |
search_top_impression_share | The impressions you've received among the top ads compared to the estimated number of impressions you were eligible to receive among the top ads. Note: Search top impression share is reported in the range of 0.1 to 1. Any value below 0.1 is reported as 0.0999. Top ads are generally above the top organic results, although they may show below the top organic results on certain queries. |
top_impression_percentage | The percent of your ad impressions that are shown adjacent to the top organic search results. |
value_per_all_conversions | The value of all conversions divided by the number of all conversions. |
value_per_all_conversions_by_conversion_date | The value of all conversions divided by the number of all conversions. When this column is selected with date, the values in date column means the conversion date. Details for the by_conversion_date columns are available at https://support.google.com/sa360/answer/9250611 . |
value_per_conversion | The value of biddable conversion divided by the number of biddable conversions. Shows how much, on average, each of the biddable conversions is worth. |
value_per_conversions_by_conversion_date | Biddable conversions value by conversion date divided by biddable conversions by conversion date. Shows how much, on average, each of the biddable conversions is worth (by conversion date). When this column is selected with date, the values in date column means the conversion date. |
client_account_view_through_conversions | The total number of view-through conversions. These happen when a customer sees an image or rich media ad, then later completes a conversion on your site without interacting with (for example, clicking on) another ad. |
client_account_cross_sell_cost_of_goods_sold_micros | Client account cross-sell cost of goods sold (COGS) is the total cost of products sold as a result of advertising a different product. How it works: You report conversions with cart data for completed purchases on your website. If the ad that was interacted with before the purchase has an associated product (see Shopping Ads) then this product is considered the advertised product. Any product included in the order the customer places is a sold product. If these products don't match then this is considered cross-sell. Cross-sell cost of goods sold is the total cost of the products sold that weren't advertised. Example: Someone clicked on a Shopping ad for a hat then bought the same hat and a shirt. The hat has a cost of goods sold value of $3, the shirt has a cost of goods sold value of $5. The cross-sell cost of goods sold for this order is $5. This metric is only available if you report conversions with cart data. This metric is a monetary value and returned in the customer's currency by default. See the metrics_currency parameter at https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause |
cross_sell_cost_of_goods_sold_micros | Cross-sell cost of goods sold (COGS) is the total cost of products sold as a result of advertising a different product. How it works: You report conversions with cart data for completed purchases on your website. If the ad that was interacted with before the purchase has an associated product (see Shopping Ads) then this product is considered the advertised product. Any product included in the order the customer places is a sold product. If these products don't match then this is considered cross-sell. Cross-sell cost of goods sold is the total cost of the products sold that weren't advertised. Example: Someone clicked on a Shopping ad for a hat then bought the same hat and a shirt. The hat has a cost of goods sold value of $3, the shirt has a cost of goods sold value of $5. The cross-sell cost of goods sold for this order is $5. This metric is only available if you report conversions with cart data. This metric is a monetary value and returned in the customer's currency by default. See the metrics_currency parameter at https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause |
client_account_cross_sell_gross_profit_micros | Client account cross-sell gross profit is the profit you made from products sold as a result of advertising a different product, minus cost of goods sold (COGS). How it works: You report conversions with cart data for completed purchases on your website. If the ad that was interacted with before the purchase has an associated product (see Shopping Ads) then this product is considered the advertised product. Any product included in the purchase is a sold product. If these products don't match then this is considered cross-sell. Cross-sell gross profit is the revenue you made from cross-sell attributed to your ads minus the cost of the goods sold. Example: Someone clicked on a Shopping ad for a hat then bought the same hat and a shirt. The shirt is priced $20 and has a cost of goods sold value of $5. The cross-sell gross profit of this order is $15 = $20 - $5. This metric is only available if you report conversions with cart data. This metric is a monetary value and returned in the customer's currency by default. See the metrics_currency parameter at https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause |
cross_sell_gross_profit_micros | Cross-sell gross profit is the profit you made from products sold as a result of advertising a different product, minus cost of goods sold (COGS). How it works: You report conversions with cart data for completed purchases on your website. If the ad that was interacted with before the purchase has an associated product (see Shopping Ads) then this product is considered the advertised product. Any product included in the purchase is a sold product. If these products don't match then this is considered cross-sell. Cross-sell gross profit is the revenue you made from cross-sell attributed to your ads minus the cost of the goods sold. Example: Someone clicked on a Shopping ad for a hat then bought the same hat and a shirt. The shirt is priced $20 and has a cost of goods sold value of $5. The cross-sell gross profit of this order is $15 = $20 - $5. This metric is only available if you report conversions with cart data. This metric is a monetary value and returned in the customer's currency by default. See the metrics_currency parameter at https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause |
client_account_cross_sell_revenue_micros | Client account cross-sell revenue is the total amount you made from products sold as a result of advertising a different product. How it works: You report conversions with cart data for completed purchases on your website. If the ad that was interacted with before the purchase has an associated product (see Shopping Ads) then this product is considered the advertised product. Any product included in the order the customer places is a sold product. If these products don't match then this is considered cross-sell. Cross-sell revenue is the total value you made from cross-sell attributed to your ads. Example: Someone clicked on a Shopping ad for a hat then bought the same hat and a shirt. The hat is priced $10 and the shirt is priced $20. The cross-sell revenue of this order is $20. This metric is only available if you report conversions with cart data. This metric is a monetary value and returned in the customer's currency by default. See the metrics_currency parameter at https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause |
cross_sell_revenue_micros | Cross-sell revenue is the total amount you made from products sold as a result of advertising a different product. How it works: You report conversions with cart data for completed purchases on your website. If the ad that was interacted with before the purchase has an associated product (see Shopping Ads) then this product is considered the advertised product. Any product included in the order the customer places is a sold product. If these products don't match then this is considered cross-sell. Cross-sell revenue is the total value you made from cross-sell attributed to your ads. Example: Someone clicked on a Shopping ad for a hat then bought the same hat and a shirt. The hat is priced $10 and the shirt is priced $20. The cross-sell revenue of this order is $20. This metric is only available if you report conversions with cart data. This metric is a monetary value and returned in the customer's currency by default. See the metrics_currency parameter at https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause |
client_account_cross_sell_units_sold | Client account cross-sell units sold is the total number of products sold as a result of advertising a different product. How it works: You report conversions with cart data for completed purchases on your website. If the ad that was interacted with before the purchase has an associated product (see Shopping Ads) then this product is considered the advertised product. Any product included in the order the customer places is a sold product. If these products don't match then this is considered cross-sell. Cross-sell units sold is the total number of cross-sold products from all orders attributed to your ads. Example: Someone clicked on a Shopping ad for a hat then bought the same hat, a shirt and a jacket. The cross-sell units sold in this order is 2. This metric is only available if you report conversions with cart data. |
cross_sell_units_sold | Cross-sell units sold is the total number of products sold as a result of advertising a different product. How it works: You report conversions with cart data for completed purchases on your website. If the ad that was interacted with before the purchase has an associated product (see Shopping Ads) then this product is considered the advertised product. Any product included in the order the customer places is a sold product. If these products don't match then this is considered cross-sell. Cross-sell units sold is the total number of cross-sold products from all orders attributed to your ads. Example: Someone clicked on a Shopping ad for a hat then bought the same hat, a shirt and a jacket. The cross-sell units sold in this order is 2. This metric is only available if you report conversions with cart data. |
client_account_lead_cost_of_goods_sold_micros | Client account lead cost of goods sold (COGS) is the total cost of products sold as a result of advertising the same product. How it works: You report conversions with cart data for completed purchases on your website. If the ad that was interacted with has an associated product (see Shopping Ads) then this product is considered the advertised product. Any product included in the order the customer places is a sold product. If the advertised and sold products match, then the cost of these goods is counted under lead cost of goods sold. Example: Someone clicked on a Shopping ad for a hat then bought the same hat and a shirt. The hat has a cost of goods sold value of $3, the shirt has a cost of goods sold value of $5. The lead cost of goods sold for this order is $3. This metric is only available if you report conversions with cart data. This metric is a monetary value and returned in the customer's currency by default. See the metrics_currency parameter at https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause |
lead_cost_of_goods_sold_micros | Lead cost of goods sold (COGS) is the total cost of products sold as a result of advertising the same product. How it works: You report conversions with cart data for completed purchases on your website. If the ad that was interacted with has an associated product (see Shopping Ads) then this product is considered the advertised product. Any product included in the order the customer places is a sold product. If the advertised and sold products match, then the cost of these goods is counted under lead cost of goods sold. Example: Someone clicked on a Shopping ad for a hat then bought the same hat and a shirt. The hat has a cost of goods sold value of $3, the shirt has a cost of goods sold value of $5. The lead cost of goods sold for this order is $3. This metric is only available if you report conversions with cart data. This metric is a monetary value and returned in the customer's currency by default. See the metrics_currency parameter at https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause |
client_account_lead_gross_profit_micros | Client account lead gross profit is the profit you made from products sold as a result of advertising the same product, minus cost of goods sold (COGS). How it works: You report conversions with cart data for completed purchases on your website. If the ad that was interacted with before the purchase has an associated product (see Shopping Ads) then this product is considered the advertised product. Any product included in the order the customer places is a sold product. If the advertised and sold products match, then the revenue you made from these sales minus the cost of goods sold is your lead gross profit. Example: Someone clicked on a Shopping ad for a hat then bought the same hat and a shirt. The hat is priced $10 and has a cost of goods sold value of $3. The lead gross profit of this order is $7 = $10 - $3. This metric is only available if you report conversions with cart data. This metric is a monetary value and returned in the customer's currency by default. See the metrics_currency parameter at https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause |
lead_gross_profit_micros | Lead gross profit is the profit you made from products sold as a result of advertising the same product, minus cost of goods sold (COGS). How it works: You report conversions with cart data for completed purchases on your website. If the ad that was interacted with before the purchase has an associated product (see Shopping Ads) then this product is considered the advertised product. Any product included in the order the customer places is a sold product. If the advertised and sold products match, then the revenue you made from these sales minus the cost of goods sold is your lead gross profit. Example: Someone clicked on a Shopping ad for a hat then bought the same hat and a shirt. The hat is priced $10 and has a cost of goods sold value of $3. The lead gross profit of this order is $7 = $10 - $3. This metric is only available if you report conversions with cart data. This metric is a monetary value and returned in the customer's currency by default. See the metrics_currency parameter at https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause |
client_account_lead_revenue_micros | Client account lead revenue is the total amount you made from products sold as a result of advertising the same product. How it works: You report conversions with cart data for completed purchases on your website. If the ad that was interacted with before the purchase has an associated product (see Shopping Ads) then this product is considered the advertised product. Any product included in the order the customer places is a sold product. If the advertised and sold products match, then the total value you made from the sales of these products is shown under lead revenue. Example: Someone clicked on a Shopping ad for a hat then bought the same hat and a shirt. The hat is priced $10 and the shirt is priced $20. The lead revenue of this order is $10. This metric is only available if you report conversions with cart data. This metric is a monetary value and returned in the customer's currency by default. See the metrics_currency parameter at https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause |
lead_revenue_micros | Lead revenue is the total amount you made from products sold as a result of advertising the same product. How it works: You report conversions with cart data for completed purchases on your website. If the ad that was interacted with before the purchase has an associated product (see Shopping Ads) then this product is considered the advertised product. Any product included in the order the customer places is a sold product. If the advertised and sold products match, then the total value you made from the sales of these products is shown under lead revenue. Example: Someone clicked on a Shopping ad for a hat then bought the same hat and a shirt. The hat is priced $10 and the shirt is priced $20. The lead revenue of this order is $10. This metric is only available if you report conversions with cart data. This metric is a monetary value and returned in the customer's currency by default. See the metrics_currency parameter at https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause |
client_account_lead_units_sold | Client account lead units sold is the total number of products sold as a result of advertising the same product. How it works: You report conversions with cart data for completed purchases on your website. If the ad that was interacted with before the purchase has an associated product (see Shopping Ads) then this product is considered the advertised product. Any product included in the order the customer places is a sold product. If the advertised and sold products match, then the total number of these products sold is shown under lead units sold. Example: Someone clicked on a Shopping ad for a hat then bought the same hat, a shirt and a jacket. The lead units sold in this order is 1. This metric is only available if you report conversions with cart data. |
lead_units_sold | Lead units sold is the total number of products sold as a result of advertising the same product. How it works: You report conversions with cart data for completed purchases on your website. If the ad that was interacted with before the purchase has an associated product (see Shopping Ads) then this product is considered the advertised product. Any product included in the order the customer places is a sold product. If the advertised and sold products match, then the total number of these products sold is shown under lead units sold. Example: Someone clicked on a Shopping ad for a hat then bought the same hat, a shirt and a jacket. The lead units sold in this order is 1. This metric is only available if you report conversions with cart data. |
MobileAppAsset
An asset representing a mobile app.
فیلدها | |
---|---|
app_id | مورد نیاز. A string that uniquely identifies a mobile application. It should just contain the platform native id, like "com.android.ebay" for Android or "12345689" for iOS. |
app_store | مورد نیاز. The application store that distributes this specific app. |
درصد Cpc
A bidding strategy where bids are a fraction of the advertised price for some good or service.
فیلدها | |
---|---|
cpc_bid_ceiling_micros | Maximum bid limit that can be set by the bid strategy. This is an optional field entered by the advertiser and specified in local micros. Note: A zero value is interpreted in the same way as having bid_ceiling undefined. |
enhanced_cpc_enabled | Adjusts the bid for each auction upward or downward, depending on the likelihood of a conversion. Individual bids may exceed cpc_bid_ceiling_micros, but the average bid amount for a campaign should not. |
RealTimeBiddingSetting
Settings for Real-Time Bidding, a feature only available for campaigns targeting the Ad Exchange network.
فیلدها | |
---|---|
opt_in | Whether the campaign is opted in to real-time bidding. |
SearchAds360ExpandedDynamicSearchAdInfo
An expanded dynamic search ad.
فیلدها | |
---|---|
description1 | The first line of the ad's description. |
description2 | The second line of the ad's description. |
ad_tracking_id | The tracking id of the ad. |
SearchAds360ExpandedTextAdInfo
A Search Ads 360 expanded text ad.
فیلدها | |
---|---|
headline | The headline of the ad. |
headline2 | The second headline of the ad. |
headline3 | The third headline of the ad. |
description1 | The first line of the ad's description. |
description2 | The second line of the ad's description. |
path1 | Text appended to the auto-generated visible URL with a delimiter. |
path2 | Text appended to path1 with a delimiter. |
ad_tracking_id | The tracking id of the ad. |
SearchAds360ProductAdInfo
This type has no fields.
A Search Ads 360 product ad.
SearchAds360ResponsiveSearchAdInfo
A Search Ads 360 responsive search ad.
فیلدها | |
---|---|
headlines[] | List of text assets for headlines. When the ad serves the headlines will be selected from this list. |
descriptions[] | List of text assets for descriptions. When the ad serves the descriptions will be selected from this list. |
path1 | Text appended to the auto-generated visible URL with a delimiter. |
path2 | Text appended to path1 with a delimiter. |
ad_tracking_id | The tracking id of the ad. |
SearchAds360TextAdInfo
A Search Ads 360 text ad.
فیلدها | |
---|---|
headline | The headline of the ad. |
description1 | The first line of the ad's description. |
description2 | The second line of the ad's description. |
display_url | The displayed URL of the ad. |
display_mobile_url | The displayed mobile URL of the ad. |
ad_tracking_id | The tracking id of the ad. |
بخش ها
Segment only fields.
فیلدها | |
---|---|
ad_network_type | Ad network type. |
conversion_action_category | Conversion action category. |
conversion_custom_dimensions[] | The conversion custom dimensions. |
day_of_week | Day of the week, for example, MONDAY. |
device | Device to which metrics apply. |
keyword | Keyword criterion. |
product_channel | Channel of the product. |
product_channel_exclusivity | Channel exclusivity of the product. |
product_condition | Condition of the product. |
product_sold_condition | Condition of the product sold. |
raw_event_conversion_dimensions[] | The raw event conversion dimensions. |
conversion_action | Resource name of the conversion action. |
conversion_action_name | Conversion action name. |
date | Date to which metrics apply. yyyy-MM-dd format, for example, 2018-04-17. |
geo_target_city | Resource name of the geo target constant that represents a city. |
geo_target_country | Resource name of the geo target constant that represents a country. |
geo_target_metro | Resource name of the geo target constant that represents a metro. |
geo_target_region | Resource name of the geo target constant that represents a region. |
hour | Hour of day as a number between 0 and 23, inclusive. |
month | Month as represented by the date of the first day of a month. Formatted as yyyy-MM-dd. |
product_bidding_category_level1 | Bidding category (level 1) of the product. |
product_bidding_category_level2 | Bidding category (level 2) of the product. |
product_bidding_category_level3 | Bidding category (level 3) of the product. |
product_bidding_category_level4 | Bidding category (level 4) of the product. |
product_bidding_category_level5 | Bidding category (level 5) of the product. |
product_brand | Brand of the product. |
product_country | Resource name of the geo target constant for the country of sale of the product. |
product_custom_attribute0 | Custom attribute 0 of the product. |
product_custom_attribute1 | Custom attribute 1 of the product. |
product_custom_attribute2 | Custom attribute 2 of the product. |
product_custom_attribute3 | Custom attribute 3 of the product. |
product_custom_attribute4 | Custom attribute 4 of the product. |
product_item_id | Item ID of the product. |
product_language | Resource name of the language constant for the language of the product. |
product_sold_bidding_category_level1 | Bidding category (level 1) of the product sold. |
product_sold_bidding_category_level2 | Bidding category (level 2) of the product sold. |
product_sold_bidding_category_level3 | Bidding category (level 3) of the product sold. |
product_sold_bidding_category_level4 | Bidding category (level 4) of the product sold. |
product_sold_bidding_category_level5 | Bidding category (level 5) of the product sold. |
product_sold_brand | Brand of the product sold. |
product_sold_custom_attribute0 | Custom attribute 0 of the product sold. |
product_sold_custom_attribute1 | Custom attribute 1 of the product sold. |
product_sold_custom_attribute2 | Custom attribute 2 of the product sold. |
product_sold_custom_attribute3 | Custom attribute 3 of the product sold. |
product_sold_custom_attribute4 | Custom attribute 4 of the product sold. |
product_sold_item_id | Item ID of the product sold. |
product_sold_title | Title of the product sold. |
product_sold_type_l1 | Type (level 1) of the product sold. |
product_sold_type_l2 | Type (level 2) of the product sold. |
product_sold_type_l3 | Type (level 3) of the product sold. |
product_sold_type_l4 | Type (level 4) of the product sold. |
product_sold_type_l5 | Type (level 5) of the product sold. |
product_store_id | Store ID of the product. |
product_title | Title of the product. |
product_type_l1 | Type (level 1) of the product. |
product_type_l2 | Type (level 2) of the product. |
product_type_l3 | Type (level 3) of the product. |
product_type_l4 | Type (level 4) of the product. |
product_type_l5 | Type (level 5) of the product. |
quarter | Quarter as represented by the date of the first day of a quarter. Uses the calendar year for quarters, for example, the second quarter of 2018 starts on 2018-04-01. Formatted as yyyy-MM-dd. |
week | Week as defined as Monday through Sunday, and represented by the date of Monday. Formatted as yyyy-MM-dd. |
year | Year, formatted as yyyy. |
asset_interaction_target | Only used with CustomerAsset, CampaignAsset and AdGroupAsset metrics. Indicates whether the interaction metrics occurred on the asset itself or a different asset or ad unit. Interactions (for example, clicks) are counted across all the parts of the served ad (for example, Ad itself and other components like Sitelinks) when they are served together. When interaction_on_this_asset is true, it means the interactions are on this specific asset and when interaction_on_this_asset is false, it means the interactions is not on this specific asset but on other parts of the served ad this asset is served with. |
TargetCpa
An automated bid strategy that sets bids to help get as many conversions as possible at the target cost-per-acquisition (CPA) you set.
فیلدها | |
---|---|
target_cpa_micros | Average CPA target. This target should be greater than or equal to minimum billable unit based on the currency for the account. |
cpc_bid_ceiling_micros | Maximum bid limit that can be set by the bid strategy. The limit applies to all keywords managed by the strategy. This should only be set for portfolio bid strategies. |
cpc_bid_floor_micros | Minimum bid limit that can be set by the bid strategy. The limit applies to all keywords managed by the strategy. This should only be set for portfolio bid strategies. |
TargetCpm
This type has no fields.
Target CPM (cost per thousand impressions) is an automated bidding strategy that sets bids to optimize performance given the target CPM you set.
TargetRestriction
The list of per-targeting-dimension targeting settings.
فیلدها | |
---|---|
targeting_dimension | The targeting dimension that these settings apply to. |
bid_only | Indicates whether to restrict your ads to show only for the criteria you have selected for this targeting_dimension, or to target all values for this targeting_dimension and show ads based on your targeting in other TargetingDimensions. A value of |
TargetRoas
An automated bidding strategy that helps you maximize revenue while averaging a specific target return on ad spend (ROAS).
فیلدها | |
---|---|
target_roas | مورد نیاز. The chosen revenue (based on conversion data) per unit of spend. Value must be between 0.01 and 1000.0, inclusive. |
cpc_bid_ceiling_micros | Maximum bid limit that can be set by the bid strategy. The limit applies to all keywords managed by the strategy. This should only be set for portfolio bid strategies. |
cpc_bid_floor_micros | Minimum bid limit that can be set by the bid strategy. The limit applies to all keywords managed by the strategy. This should only be set for portfolio bid strategies. |
TargetSpend
An automated bid strategy that sets your bids to help get as many clicks as possible within your budget.
فیلدها | |
---|---|
target_spend_micros | Deprecated: The spend target under which to maximize clicks. A TargetSpend bidder will attempt to spend the smaller of this value or the natural throttling spend amount. If not specified, the budget is used as the spend target. This field is deprecated and should no longer be used. See https://ads-developers.googleblog.com/2020/05/reminder-about-sunset-creation-of.html for details. |
cpc_bid_ceiling_micros | Maximum bid limit that can be set by the bid strategy. The limit applies to all keywords managed by the strategy. |
TargetingSetting
Settings for the targeting-related features, at the campaign and ad group levels. For more details about the targeting setting, visit https://support.google.com/google-ads/answer/7365594
فیلدها | |
---|---|
target_restrictions[] | The per-targeting-dimension setting to restrict the reach of your campaign or ad group. |
TextAsset
A Text asset.
فیلدها | |
---|---|
text | Text content of the text asset. |
TextLabel
A type of label displaying text on a colored background.
فیلدها | |
---|---|
background_color | Background color of the label in HEX format. This string must match the regular expression '^#([a-fA-F0-9]{6}|[a-fA-F0-9]{3})$'. Note: The background color may not be visible for manager accounts. |
description | A short description of the label. The length must be no more than 200 characters. |
UnifiedCallAsset
A unified call asset.
فیلدها | |
---|---|
country_code | Two-letter country code of the phone number. Examples: 'US', 'us'. |
phone_number | The advertiser's raw phone number. Examples: '1234567890', '(123)456-7890' |
call_conversion_reporting_state | Indicates whether this CallAsset should use its own call conversion setting, follow the account level setting, or disable call conversion. |
call_conversion_action | The conversion action to attribute a call conversion to. If not set, the default conversion action is used. This field only has effect if call_conversion_reporting_state is set to USE_RESOURCE_LEVEL_CALL_CONVERSION_ACTION. |
ad_schedule_targets[] | List of non-overlapping schedules specifying all time intervals for which the asset may serve. There can be a maximum of 6 schedules per day, 42 in total. |
call_only | Whether the call only shows the phone number without a link to the website. Applies to Microsoft Ads. |
call_tracking_enabled | Whether the call should be enabled on call tracking. Applies to Microsoft Ads. |
use_searcher_time_zone | Whether to show the call extension in search user's time zone. Applies to Microsoft Ads. |
start_date | Start date of when this asset is effective and can begin serving, in yyyy-MM-dd format. |
end_date | Last date of when this asset is effective and still serving, in yyyy-MM-dd format. |
UnifiedCalloutAsset
A unified callout asset.
فیلدها | |
---|---|
callout_text | The callout text. The length of this string should be between 1 and 25, inclusive. |
start_date | Start date of when this asset is effective and can begin serving, in yyyy-MM-dd format. |
end_date | Last date of when this asset is effective and still serving, in yyyy-MM-dd format. |
ad_schedule_targets[] | List of non-overlapping schedules specifying all time intervals for which the asset may serve. There can be a maximum of 6 schedules per day, 42 in total. |
use_searcher_time_zone | Whether to show the asset in search user's time zone. Applies to Microsoft Ads. |
UnifiedLocationAsset
A unified location asset.
فیلدها | |
---|---|
place_id | Place IDs uniquely identify a place in the Google Places database and on Google Maps. This field is unique for a given customer ID and asset type. See https://developers.google.com/places/web-service/place-id to learn more about Place ID. |
business_profile_locations[] | The list of business locations for the customer. This will only be returned if the Location Asset is syncing from the Business Profile account. It is possible to have multiple Business Profile listings under the same account that point to the same Place ID. |
location_ownership_type | The type of location ownership. If the type is BUSINESS_OWNER, it will be served as a location extension. If the type is AFFILIATE, it will be served as an affiliate location. |
UnifiedPageFeedAsset
A Unified Page Feed asset.
فیلدها | |
---|---|
page_url | The webpage that advertisers want to target. |
labels[] | Labels used to group the page urls. |
UnifiedSitelinkAsset
A unified sitelink asset.
فیلدها | |
---|---|
link_text | URL display text for the sitelink. The length of this string should be between 1 and 25, inclusive. |
description1 | First line of the description for the sitelink. If set, the length should be between 1 and 35, inclusive, and description2 must also be set. |
description2 | Second line of the description for the sitelink. If set, the length should be between 1 and 35, inclusive, and description1 must also be set. |
start_date | Start date of when this asset is effective and can begin serving, in yyyy-MM-dd format. |
end_date | Last date of when this asset is effective and still serving, in yyyy-MM-dd format. |
ad_schedule_targets[] | List of non-overlapping schedules specifying all time intervals for which the asset may serve. There can be a maximum of 6 schedules per day, 42 in total. |
tracking_id | ID used for tracking clicks for the sitelink asset. This is a Yahoo! Japan only field. |
use_searcher_time_zone | Whether to show the sitelink asset in search user's time zone. Applies to Microsoft Ads. |
mobile_preferred | Whether the preference is for the sitelink asset to be displayed on mobile devices. Applies to Microsoft Ads. |
UserListInfo
A User List criterion. Represents a user list that is defined by the advertiser to be targeted.
فیلدها | |
---|---|
user_list | The User List resource name. |
ارزش
A generic data container.
فیلدها | |
---|---|
Union field value . A value. value can be only one of the following: | |
boolean_value | یک بولی |
int64_value | An int64. |
float_value | A float. |
double_value | یک دوتایی |
string_value | یک رشته |
WebpageConditionInfo
Logical expression for targeting webpages of an advertiser's website.
فیلدها | |
---|---|
operand | Operand of webpage targeting condition. |
operator | Operator of webpage targeting condition. |
argument | Argument of webpage targeting condition. |
WebpageInfo
Represents a criterion for targeting webpages of an advertiser's website.
فیلدها | |
---|---|
conditions[] | Conditions, or logical expressions, for webpage targeting. The list of webpage targeting conditions are and-ed together when evaluated for targeting. An empty list of conditions indicates all pages of the campaign's website are targeted. This field is required for CREATE operations and is prohibited on UPDATE operations. |
coverage_percentage | 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 | 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 | YouTube video title. |
youtube_video_id | YouTube video id. This is the 11 character string value used in the YouTube video URL. |
شاخص
-
AdScheduleInfo
(message) -
AdTextAsset
(message) -
AgeRangeInfo
(message) -
AssetInteractionTarget
(message) -
AssetUsage
(message) -
AudienceInfo
(message) -
BusinessProfileLocation
(message) -
CallToActionAsset
(message) -
CustomParameter
(message) -
DeviceInfo
(message) -
EnhancedCpc
(message) -
FrequencyCapEntry
(message) -
GenderInfo
(message) -
ImageAsset
(message) -
ImageDimension
(message) -
Keyword
(message) -
KeywordInfo
(message) -
LanguageInfo
(message) -
ListingGroupInfo
(message) -
LocationGroupInfo
(message) -
LocationInfo
(message) -
ManualCpa
(message) -
ManualCpc
(message) -
ManualCpm
(message) -
MaximizeConversionValue
(message) -
MaximizeConversions
(message) -
Metrics
(message) -
MobileAppAsset
(message) -
PercentCpc
(message) -
RealTimeBiddingSetting
(message) -
SearchAds360ExpandedDynamicSearchAdInfo
(message) -
SearchAds360ExpandedTextAdInfo
(message) -
SearchAds360ProductAdInfo
(message) -
SearchAds360ResponsiveSearchAdInfo
(message) -
SearchAds360TextAdInfo
(message) -
Segments
(message) -
TargetCpa
(message) -
TargetCpm
(message) -
TargetImpressionShare
(message) -
TargetOutrankShare
(message) -
TargetRestriction
(message) -
TargetRoas
(message) -
TargetSpend
(message) -
TargetingSetting
(message) -
TextAsset
(message) -
TextLabel
(message) -
UnifiedCallAsset
(message) -
UnifiedCalloutAsset
(message) -
UnifiedLocationAsset
(message) -
UnifiedPageFeedAsset
(message) -
UnifiedSitelinkAsset
(message) -
UserListInfo
(message) -
Value
(message) -
WebpageConditionInfo
(message) -
WebpageInfo
(message) -
YoutubeVideoAsset
(message)
AdScheduleInfo
Represents an AdSchedule criterion.
AdSchedule is specified as the day of the week and a time interval within which ads will be shown.
No more than six AdSchedules can be added for the same day.
فیلدها | |
---|---|
start_minute | Minutes after the start hour at which this schedule starts. This field is required for CREATE operations and is prohibited on UPDATE operations. |
end_minute | Minutes after the end hour at which this schedule ends. The schedule is exclusive of the end minute. This field is required for CREATE operations and is prohibited on UPDATE operations. |
day_of_week | Day of the week the schedule applies to. This field is required for CREATE operations and is prohibited on UPDATE operations. |
start_hour | Starting hour in 24 hour time. This field must be between 0 and 23, inclusive. This field is required for CREATE operations and is prohibited on UPDATE operations. |
end_hour | Ending hour in 24 hour time; 24 signifies end of the day. This field must be between 0 and 24, inclusive. This field is required for CREATE operations and is prohibited on UPDATE operations. |
AdTextAsset
A text asset used inside an ad.
فیلدها | |
---|---|
text | Asset text. |
AgeRangeInfo
An age range criterion.
فیلدها | |
---|---|
type | Type of the age range. |
AssetInteractionTarget
An AssetInteractionTarget segment.
فیلدها | |
---|---|
asset | The asset resource name. |
interaction_on_this_asset | Only used with CustomerAsset, CampaignAsset and AdGroupAsset metrics. Indicates whether the interaction metrics occurred on the asset itself or a different asset or ad unit. |
AssetUsage
Contains the usage information of the asset.
فیلدها | |
---|---|
asset | Resource name of the asset. |
served_asset_field_type | The served field type of the asset. |
AudienceInfo
An audience criterion.
فیلدها | |
---|---|
audience | The Audience resource name. |
BusinessProfileLocation
Business Profile location data synced from the linked Business Profile account.
فیلدها | |
---|---|
labels[] | Advertiser specified label for the location on the Business Profile account. This is synced from the Business Profile account. |
store_code | Business Profile store code of this location. This is synced from the Business Profile account. |
listing_id | Listing ID of this Business Profile location. This is synced from the linked Business Profile account. |
CallToActionAsset
A call to action asset.
فیلدها | |
---|---|
call_to_action | فراخوان به اقدام. |
CustomParameter
A mapping that can be used by custom parameter tags in a tracking_url_template
, final_urls
, or mobile_final_urls
.
فیلدها | |
---|---|
key | The key matching the parameter tag name. |
value | The value to be substituted. |
اطلاعات دستگاه
A device criterion.
فیلدها | |
---|---|
type | Type of the device. |
EnhancedCpc
This type has no fields.
An automated bidding strategy that raises bids for clicks that seem more likely to lead to a conversion and lowers them for clicks where they seem less likely.
This bidding strategy is deprecated and cannot be created anymore. Use ManualCpc with enhanced_cpc_enabled set to true for equivalent functionality.
FrequencyCapEntry
This type has no fields.
A rule specifying the maximum number of times an ad (or some set of ads) can be shown to a user over a particular time period.
GenderInfo
A gender criterion.
فیلدها | |
---|---|
type | Type of the gender. |
ImageAsset
An Image asset.
فیلدها | |
---|---|
mime_type | MIME type of the image asset. |
full_size | Metadata for this image at its original size. |
file_size | File size of the image asset in bytes. |
ImageDimension
Metadata for an image at a certain size, either original or resized.
فیلدها | |
---|---|
height_pixels | Height of the image. |
width_pixels | Width of the image. |
url | A URL that returns the image with this height and width. |
کلمه کلیدی
A Keyword criterion segment.
فیلدها | |
---|---|
info | اطلاعات کلمه کلیدی |
ad_group_criterion | The AdGroupCriterion resource name. |
KeywordInfo
A keyword criterion.
فیلدها | |
---|---|
match_type | The match type of the keyword. |
text | The text of the keyword (at most 80 characters and 10 words). |
LanguageInfo
A language criterion.
فیلدها | |
---|---|
language_constant | The language constant resource name. |
ListingGroupInfo
A listing group criterion.
فیلدها | |
---|---|
type | Type of the listing group. |
LocationGroupInfo
A radius around a list of locations specified through a feed.
فیلدها | |
---|---|
geo_target_constants[] | Geo target constant(s) restricting the scope of the geographic area within the feed. Currently only one geo target constant is allowed. |
radius_units | Unit of the radius. Miles and meters are supported for geo target constants. Milli miles and meters are supported for feed item sets. This is required and must be set in CREATE operations. |
feed_item_sets[] | FeedItemSets whose FeedItems are targeted. If multiple IDs are specified, then all items that appear in at least one set are targeted. This field cannot be used with geo_target_constants. This is optional and can only be set in CREATE operations. |
radius | Distance in units specifying the radius around targeted locations. This is required and must be set in CREATE operations. |
LocationInfo
A location criterion.
فیلدها | |
---|---|
geo_target_constant | The geo target constant resource name. |
ManualCpa
This type has no fields.
Manual bidding strategy that allows advertiser to set the bid per advertiser-specified action.
ManualCpc
Manual click-based bidding where user pays per click.
فیلدها | |
---|---|
enhanced_cpc_enabled | Whether bids are to be enhanced based on conversion optimizer data. |
ManualCpm
This type has no fields.
Manual impression-based bidding where user pays per thousand impressions.
MaximizeConversionValue
An automated bidding strategy to help get the most conversion value for your campaigns while spending your budget.
فیلدها | |
---|---|
cpc_bid_ceiling_micros | Maximum bid limit that can be set by the bid strategy. The limit applies to all keywords managed by the strategy. Mutable for portfolio bidding strategies only. |
cpc_bid_floor_micros | Minimum bid limit that can be set by the bid strategy. The limit applies to all keywords managed by the strategy. Mutable for portfolio bidding strategies only. |
target_roas | The target return on ad spend (ROAS) option. If set, the bid strategy will maximize revenue while averaging the target return on ad spend. If the target ROAS is high, the bid strategy may not be able to spend the full budget. If the target ROAS is not set, the bid strategy will aim to achieve the highest possible ROAS for the budget. |
MaximizeConversions
An automated bidding strategy to help get the most conversions for your campaigns while spending your budget.
فیلدها | |
---|---|
cpc_bid_ceiling_micros | Maximum bid limit that can be set by the bid strategy. The limit applies to all keywords managed by the strategy. Mutable for portfolio bidding strategies only. |
cpc_bid_floor_micros | Minimum bid limit that can be set by the bid strategy. The limit applies to all keywords managed by the strategy. Mutable for portfolio bidding strategies only. |
target_cpa_micros | The target cost-per-action (CPA) option. This is the average amount that you would like to spend per conversion action specified in micro units of the bidding strategy's currency. If set, the bid strategy will get as many conversions as possible at or below the target cost-per-action. If the target CPA is not set, the bid strategy will aim to achieve the lowest possible CPA given the budget. |
معیارها
Metrics data.
فیلدها | |
---|---|
all_conversions_value_by_conversion_date | The value of all conversions. When this column is selected with date, the values in date column means the conversion date. Details for the by_conversion_date columns are available at https://support.google.com/sa360/answer/9250611 . |
all_conversions_by_conversion_date | The total number of conversions. This includes all conversions regardless of the value of include_in_conversions_metric. When this column is selected with date, the values in date column means the conversion date. Details for the by_conversion_date columns are available at https://support.google.com/sa360/answer/9250611 . |
conversion_custom_metrics[] | The conversion custom metrics. |
conversions_value_by_conversion_date | The sum of biddable conversions value by conversion date. When this column is selected with date, the values in date column means the conversion date. |
conversions_by_conversion_date | The sum of conversions by conversion date for biddable conversion types. Can be fractional due to attribution modeling. When this column is selected with date, the values in date column means the conversion date. |
historical_creative_quality_score | The creative historical quality score. |
historical_landing_page_quality_score | The quality of historical landing page experience. |
historical_search_predicted_ctr | The historical search predicted click through rate (CTR). |
interaction_event_types[] | The types of payable and free interactions. |
raw_event_conversion_metrics[] | The raw event conversion metrics. |
absolute_top_impression_percentage | Search absolute top impression share is the percentage of your Search ad impressions that are shown in the most prominent Search position. |
all_conversions_from_interactions_rate | All conversions from interactions (as oppose to view through conversions) divided by the number of ad interactions. |
all_conversions_value | The value of all conversions. |
all_conversions | The total number of conversions. This includes all conversions regardless of the value of include_in_conversions_metric. |
all_conversions_value_per_cost | The value of all conversions divided by the total cost of ad interactions (such as clicks for text ads or views for video ads). |
all_conversions_from_click_to_call | The number of times people clicked the "Call" button to call a store during or after clicking an ad. This number doesn't include whether or not calls were connected, or the duration of any calls. This metric applies to feed items only. |
all_conversions_from_directions | The number of times people clicked a "Get directions" button to navigate to a store after clicking an ad. This metric applies to feed items only. |
all_conversions_from_interactions_value_per_interaction | The value of all conversions from interactions divided by the total number of interactions. |
all_conversions_from_menu | The number of times people clicked a link to view a store's menu after clicking an ad. This metric applies to feed items only. |
all_conversions_from_order | The number of times people placed an order at a store after clicking an ad. This metric applies to feed items only. |
all_conversions_from_other_engagement | The number of other conversions (for example, posting a review or saving a location for a store) that occurred after people clicked an ad. This metric applies to feed items only. |
all_conversions_from_store_visit | Estimated number of times people visited a store after clicking an ad. This metric applies to feed items only. |
visits | Clicks that Search Ads 360 has successfully recorded and forwarded to an advertiser's landing page. |
all_conversions_from_store_website | The number of times that people were taken to a store's URL after clicking an ad. This metric applies to feed items only. |
average_cost | The average amount you pay per interaction. This amount is the total cost of your ads divided by the total number of interactions. |
average_cpc | The total cost of all clicks divided by the total number of clicks received. This metric is a monetary value and returned in the customer's currency by default. See the metrics_currency parameter at https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause |
average_cpm | Average cost-per-thousand impressions (CPM). This metric is a monetary value and returned in the customer's currency by default. See the metrics_currency parameter at https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause |
clicks | The number of clicks. |
content_budget_lost_impression_share | The estimated percent of times that your ad was eligible to show on the Display Network but didn't because your budget was too low. Note: Content budget lost impression share is reported in the range of 0 to 0.9. Any value above 0.9 is reported as 0.9001. |
content_impression_share | The impressions you've received on the Display Network divided by the estimated number of impressions you were eligible to receive. Note: Content impression share is reported in the range of 0.1 to 1. Any value below 0.1 is reported as 0.0999. |
content_rank_lost_impression_share | The estimated percentage of impressions on the Display Network that your ads didn't receive due to poor Ad Rank. Note: Content rank lost impression share is reported in the range of 0 to 0.9. Any value above 0.9 is reported as 0.9001. |
conversions_from_interactions_rate | Average biddable conversions (from interaction) per conversion eligible interaction. Shows how often, on average, an ad interaction leads to a biddable conversion. |
client_account_conversions_value | The value of client account conversions. This only includes conversion actions which include_in_client_account_conversions_metric attribute is set to true. If you use conversion-based bidding, your bid strategies will optimize for these conversions. |
conversions_value_per_cost | The value of biddable conversion divided by the total cost of conversion eligible interactions. |
conversions_from_interactions_value_per_interaction | The value of conversions from interactions divided by the number of ad interactions. This only includes conversion actions which include_in_conversions_metric attribute is set to true. If you use conversion-based bidding, your bid strategies will optimize for these conversions. |
client_account_conversions | The number of client account conversions. This only includes conversion actions which include_in_client_account_conversions_metric attribute is set to true. If you use conversion-based bidding, your bid strategies will optimize for these conversions. |
cost_micros | The sum of your cost-per-click (CPC) and cost-per-thousand impressions (CPM) costs during this period. This metric is a monetary value and returned in the customer's currency by default. See the metrics_currency parameter at https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause |
cost_per_all_conversions | The cost of ad interactions divided by all conversions. |
cost_per_conversion | Average conversion eligible cost per biddable conversion. |
cost_per_current_model_attributed_conversion | The cost of ad interactions divided by current model attributed conversions. This only includes conversion actions which include_in_conversions_metric attribute is set to true. If you use conversion-based bidding, your bid strategies will optimize for these conversions. |
cross_device_conversions | Conversions from when a customer clicks on an ad on one device, then converts on a different device or browser. Cross-device conversions are already included in all_conversions. |
cross_device_conversions_by_conversion_date | The number of cross-device conversions by conversion date. Details for the by_conversion_date columns are available at https://support.google.com/sa360/answer/9250611 . |
cross_device_conversions_value | The sum of the value of cross-device conversions. |
cross_device_conversions_value_by_conversion_date | The sum of cross-device conversions value by conversion date. Details for the by_conversion_date columns are available at https://support.google.com/sa360/answer/9250611 . |
ctr | The number of clicks your ad receives (Clicks) divided by the number of times your ad is shown (Impressions). |
conversions | The number of conversions. This only includes conversion actions which include_in_conversions_metric attribute is set to true. If you use conversion-based bidding, your bid strategies will optimize for these conversions. |
conversions_value | The sum of conversion values for the conversions included in the "conversions" field. This metric is useful only if you entered a value for your conversion actions. |
average_quality_score | The average quality score. |
historical_quality_score | The historical quality score. |
impressions | Count of how often your ad has appeared on a search results page or website on the Google Network. |
interaction_rate | How often people interact with your ad after it is shown to them. This is the number of interactions divided by the number of times your ad is shown. |
interactions | The number of interactions. An interaction is the main user action associated with an ad format-clicks for text and shopping ads, views for video ads, and so on. |
invalid_click_rate | The percentage of clicks filtered out of your total number of clicks (filtered + non-filtered clicks) during the reporting period. |
invalid_clicks | Number of clicks Google considers illegitimate and doesn't charge you for. |
general_invalid_click_rate | The percentage of clicks that have been filtered out of your total number of clicks (filtered + non-filtered clicks) due to being general invalid clicks. These are clicks Google considers illegitimate that are detected through routine means of filtration (that is, known invalid data-center traffic, bots and spiders or other crawlers, irregular patterns, etc). You're not charged for them, and they don't affect your account statistics. See the help page at https://support.google.com/campaignmanager/answer/6076504 for details. |
general_invalid_clicks | Number of general invalid clicks. These are a subset of your invalid clicks that are detected through routine means of filtration (such as known invalid data-center traffic, bots and spiders or other crawlers, irregular patterns, etc.). You're not charged for them, and they don't affect your account statistics. See the help page at https://support.google.com/campaignmanager/answer/6076504 for details. |
mobile_friendly_clicks_percentage | The percentage of mobile clicks that go to a mobile-friendly page. |
search_absolute_top_impression_share | The percentage of the customer's Shopping or Search ad impressions that are shown in the most prominent Shopping position. See https://support.google.com/sa360/answer/9566729 for details. Any value below 0.1 is reported as 0.0999. |
search_budget_lost_absolute_top_impression_share | The number estimating how often your ad wasn't the very first ad among the top ads in the search results due to a low budget. Note: Search budget lost absolute top impression share is reported in the range of 0 to 0.9. Any value above 0.9 is reported as 0.9001. |
search_budget_lost_impression_share | The estimated percent of times that your ad was eligible to show on the Search Network but didn't because your budget was too low. Note: Search budget lost impression share is reported in the range of 0 to 0.9. Any value above 0.9 is reported as 0.9001. |
search_budget_lost_top_impression_share | The number estimating how often your ad didn't show adjacent to the top organic search results due to a low budget. Note: Search budget lost top impression share is reported in the range of 0 to 0.9. Any value above 0.9 is reported as 0.9001. |
search_click_share | The number of clicks you've received on the Search Network divided by the estimated number of clicks you were eligible to receive. Note: Search click share is reported in the range of 0.1 to 1. Any value below 0.1 is reported as 0.0999. |
search_exact_match_impression_share | The impressions you've received divided by the estimated number of impressions you were eligible to receive on the Search Network for search terms that matched your keywords exactly (or were close variants of your keyword), regardless of your keyword match types. Note: Search exact match impression share is reported in the range of 0.1 to 1. Any value below 0.1 is reported as 0.0999. |
search_impression_share | The impressions you've received on the Search Network divided by the estimated number of impressions you were eligible to receive. Note: Search impression share is reported in the range of 0.1 to 1. Any value below 0.1 is reported as 0.0999. |
search_rank_lost_absolute_top_impression_share | The number estimating how often your ad wasn't the very first ad among the top ads in the search results due to poor Ad Rank. Note: Search rank lost absolute top impression share is reported in the range of 0 to 0.9. Any value above 0.9 is reported as 0.9001. |
search_rank_lost_impression_share | The estimated percentage of impressions on the Search Network that your ads didn't receive due to poor Ad Rank. Note: Search rank lost impression share is reported in the range of 0 to 0.9. Any value above 0.9 is reported as 0.9001. |
search_rank_lost_top_impression_share | The number estimating how often your ad didn't show adjacent to the top organic search results due to poor Ad Rank. Note: Search rank lost top impression share is reported in the range of 0 to 0.9. Any value above 0.9 is reported as 0.9001. |
search_top_impression_share | The impressions you've received among the top ads compared to the estimated number of impressions you were eligible to receive among the top ads. Note: Search top impression share is reported in the range of 0.1 to 1. Any value below 0.1 is reported as 0.0999. Top ads are generally above the top organic results, although they may show below the top organic results on certain queries. |
top_impression_percentage | The percent of your ad impressions that are shown adjacent to the top organic search results. |
value_per_all_conversions | The value of all conversions divided by the number of all conversions. |
value_per_all_conversions_by_conversion_date | The value of all conversions divided by the number of all conversions. When this column is selected with date, the values in date column means the conversion date. Details for the by_conversion_date columns are available at https://support.google.com/sa360/answer/9250611 . |
value_per_conversion | The value of biddable conversion divided by the number of biddable conversions. Shows how much, on average, each of the biddable conversions is worth. |
value_per_conversions_by_conversion_date | Biddable conversions value by conversion date divided by biddable conversions by conversion date. Shows how much, on average, each of the biddable conversions is worth (by conversion date). When this column is selected with date, the values in date column means the conversion date. |
client_account_view_through_conversions | The total number of view-through conversions. These happen when a customer sees an image or rich media ad, then later completes a conversion on your site without interacting with (for example, clicking on) another ad. |
client_account_cross_sell_cost_of_goods_sold_micros | Client account cross-sell cost of goods sold (COGS) is the total cost of products sold as a result of advertising a different product. How it works: You report conversions with cart data for completed purchases on your website. If the ad that was interacted with before the purchase has an associated product (see Shopping Ads) then this product is considered the advertised product. Any product included in the order the customer places is a sold product. If these products don't match then this is considered cross-sell. Cross-sell cost of goods sold is the total cost of the products sold that weren't advertised. Example: Someone clicked on a Shopping ad for a hat then bought the same hat and a shirt. The hat has a cost of goods sold value of $3, the shirt has a cost of goods sold value of $5. The cross-sell cost of goods sold for this order is $5. This metric is only available if you report conversions with cart data. This metric is a monetary value and returned in the customer's currency by default. See the metrics_currency parameter at https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause |
cross_sell_cost_of_goods_sold_micros | Cross-sell cost of goods sold (COGS) is the total cost of products sold as a result of advertising a different product. How it works: You report conversions with cart data for completed purchases on your website. If the ad that was interacted with before the purchase has an associated product (see Shopping Ads) then this product is considered the advertised product. Any product included in the order the customer places is a sold product. If these products don't match then this is considered cross-sell. Cross-sell cost of goods sold is the total cost of the products sold that weren't advertised. Example: Someone clicked on a Shopping ad for a hat then bought the same hat and a shirt. The hat has a cost of goods sold value of $3, the shirt has a cost of goods sold value of $5. The cross-sell cost of goods sold for this order is $5. This metric is only available if you report conversions with cart data. This metric is a monetary value and returned in the customer's currency by default. See the metrics_currency parameter at https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause |
client_account_cross_sell_gross_profit_micros | Client account cross-sell gross profit is the profit you made from products sold as a result of advertising a different product, minus cost of goods sold (COGS). How it works: You report conversions with cart data for completed purchases on your website. If the ad that was interacted with before the purchase has an associated product (see Shopping Ads) then this product is considered the advertised product. Any product included in the purchase is a sold product. If these products don't match then this is considered cross-sell. Cross-sell gross profit is the revenue you made from cross-sell attributed to your ads minus the cost of the goods sold. Example: Someone clicked on a Shopping ad for a hat then bought the same hat and a shirt. The shirt is priced $20 and has a cost of goods sold value of $5. The cross-sell gross profit of this order is $15 = $20 - $5. This metric is only available if you report conversions with cart data. This metric is a monetary value and returned in the customer's currency by default. See the metrics_currency parameter at https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause |
cross_sell_gross_profit_micros | Cross-sell gross profit is the profit you made from products sold as a result of advertising a different product, minus cost of goods sold (COGS). How it works: You report conversions with cart data for completed purchases on your website. If the ad that was interacted with before the purchase has an associated product (see Shopping Ads) then this product is considered the advertised product. Any product included in the purchase is a sold product. If these products don't match then this is considered cross-sell. Cross-sell gross profit is the revenue you made from cross-sell attributed to your ads minus the cost of the goods sold. Example: Someone clicked on a Shopping ad for a hat then bought the same hat and a shirt. The shirt is priced $20 and has a cost of goods sold value of $5. The cross-sell gross profit of this order is $15 = $20 - $5. This metric is only available if you report conversions with cart data. This metric is a monetary value and returned in the customer's currency by default. See the metrics_currency parameter at https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause |
client_account_cross_sell_revenue_micros | Client account cross-sell revenue is the total amount you made from products sold as a result of advertising a different product. How it works: You report conversions with cart data for completed purchases on your website. If the ad that was interacted with before the purchase has an associated product (see Shopping Ads) then this product is considered the advertised product. Any product included in the order the customer places is a sold product. If these products don't match then this is considered cross-sell. Cross-sell revenue is the total value you made from cross-sell attributed to your ads. Example: Someone clicked on a Shopping ad for a hat then bought the same hat and a shirt. The hat is priced $10 and the shirt is priced $20. The cross-sell revenue of this order is $20. This metric is only available if you report conversions with cart data. This metric is a monetary value and returned in the customer's currency by default. See the metrics_currency parameter at https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause |
cross_sell_revenue_micros | Cross-sell revenue is the total amount you made from products sold as a result of advertising a different product. How it works: You report conversions with cart data for completed purchases on your website. If the ad that was interacted with before the purchase has an associated product (see Shopping Ads) then this product is considered the advertised product. Any product included in the order the customer places is a sold product. If these products don't match then this is considered cross-sell. Cross-sell revenue is the total value you made from cross-sell attributed to your ads. Example: Someone clicked on a Shopping ad for a hat then bought the same hat and a shirt. The hat is priced $10 and the shirt is priced $20. The cross-sell revenue of this order is $20. This metric is only available if you report conversions with cart data. This metric is a monetary value and returned in the customer's currency by default. See the metrics_currency parameter at https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause |
client_account_cross_sell_units_sold | Client account cross-sell units sold is the total number of products sold as a result of advertising a different product. How it works: You report conversions with cart data for completed purchases on your website. If the ad that was interacted with before the purchase has an associated product (see Shopping Ads) then this product is considered the advertised product. Any product included in the order the customer places is a sold product. If these products don't match then this is considered cross-sell. Cross-sell units sold is the total number of cross-sold products from all orders attributed to your ads. Example: Someone clicked on a Shopping ad for a hat then bought the same hat, a shirt and a jacket. The cross-sell units sold in this order is 2. This metric is only available if you report conversions with cart data. |
cross_sell_units_sold | Cross-sell units sold is the total number of products sold as a result of advertising a different product. How it works: You report conversions with cart data for completed purchases on your website. If the ad that was interacted with before the purchase has an associated product (see Shopping Ads) then this product is considered the advertised product. Any product included in the order the customer places is a sold product. If these products don't match then this is considered cross-sell. Cross-sell units sold is the total number of cross-sold products from all orders attributed to your ads. Example: Someone clicked on a Shopping ad for a hat then bought the same hat, a shirt and a jacket. The cross-sell units sold in this order is 2. This metric is only available if you report conversions with cart data. |
client_account_lead_cost_of_goods_sold_micros | Client account lead cost of goods sold (COGS) is the total cost of products sold as a result of advertising the same product. How it works: You report conversions with cart data for completed purchases on your website. If the ad that was interacted with has an associated product (see Shopping Ads) then this product is considered the advertised product. Any product included in the order the customer places is a sold product. If the advertised and sold products match, then the cost of these goods is counted under lead cost of goods sold. Example: Someone clicked on a Shopping ad for a hat then bought the same hat and a shirt. The hat has a cost of goods sold value of $3, the shirt has a cost of goods sold value of $5. The lead cost of goods sold for this order is $3. This metric is only available if you report conversions with cart data. This metric is a monetary value and returned in the customer's currency by default. See the metrics_currency parameter at https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause |
lead_cost_of_goods_sold_micros | Lead cost of goods sold (COGS) is the total cost of products sold as a result of advertising the same product. How it works: You report conversions with cart data for completed purchases on your website. If the ad that was interacted with has an associated product (see Shopping Ads) then this product is considered the advertised product. Any product included in the order the customer places is a sold product. If the advertised and sold products match, then the cost of these goods is counted under lead cost of goods sold. Example: Someone clicked on a Shopping ad for a hat then bought the same hat and a shirt. The hat has a cost of goods sold value of $3, the shirt has a cost of goods sold value of $5. The lead cost of goods sold for this order is $3. This metric is only available if you report conversions with cart data. This metric is a monetary value and returned in the customer's currency by default. See the metrics_currency parameter at https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause |
client_account_lead_gross_profit_micros | Client account lead gross profit is the profit you made from products sold as a result of advertising the same product, minus cost of goods sold (COGS). How it works: You report conversions with cart data for completed purchases on your website. If the ad that was interacted with before the purchase has an associated product (see Shopping Ads) then this product is considered the advertised product. Any product included in the order the customer places is a sold product. If the advertised and sold products match, then the revenue you made from these sales minus the cost of goods sold is your lead gross profit. Example: Someone clicked on a Shopping ad for a hat then bought the same hat and a shirt. The hat is priced $10 and has a cost of goods sold value of $3. The lead gross profit of this order is $7 = $10 - $3. This metric is only available if you report conversions with cart data. This metric is a monetary value and returned in the customer's currency by default. See the metrics_currency parameter at https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause |
lead_gross_profit_micros | Lead gross profit is the profit you made from products sold as a result of advertising the same product, minus cost of goods sold (COGS). How it works: You report conversions with cart data for completed purchases on your website. If the ad that was interacted with before the purchase has an associated product (see Shopping Ads) then this product is considered the advertised product. Any product included in the order the customer places is a sold product. If the advertised and sold products match, then the revenue you made from these sales minus the cost of goods sold is your lead gross profit. Example: Someone clicked on a Shopping ad for a hat then bought the same hat and a shirt. The hat is priced $10 and has a cost of goods sold value of $3. The lead gross profit of this order is $7 = $10 - $3. This metric is only available if you report conversions with cart data. This metric is a monetary value and returned in the customer's currency by default. See the metrics_currency parameter at https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause |
client_account_lead_revenue_micros | Client account lead revenue is the total amount you made from products sold as a result of advertising the same product. How it works: You report conversions with cart data for completed purchases on your website. If the ad that was interacted with before the purchase has an associated product (see Shopping Ads) then this product is considered the advertised product. Any product included in the order the customer places is a sold product. If the advertised and sold products match, then the total value you made from the sales of these products is shown under lead revenue. Example: Someone clicked on a Shopping ad for a hat then bought the same hat and a shirt. The hat is priced $10 and the shirt is priced $20. The lead revenue of this order is $10. This metric is only available if you report conversions with cart data. This metric is a monetary value and returned in the customer's currency by default. See the metrics_currency parameter at https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause |
lead_revenue_micros | Lead revenue is the total amount you made from products sold as a result of advertising the same product. How it works: You report conversions with cart data for completed purchases on your website. If the ad that was interacted with before the purchase has an associated product (see Shopping Ads) then this product is considered the advertised product. Any product included in the order the customer places is a sold product. If the advertised and sold products match, then the total value you made from the sales of these products is shown under lead revenue. Example: Someone clicked on a Shopping ad for a hat then bought the same hat and a shirt. The hat is priced $10 and the shirt is priced $20. The lead revenue of this order is $10. This metric is only available if you report conversions with cart data. This metric is a monetary value and returned in the customer's currency by default. See the metrics_currency parameter at https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause |
client_account_lead_units_sold | Client account lead units sold is the total number of products sold as a result of advertising the same product. How it works: You report conversions with cart data for completed purchases on your website. If the ad that was interacted with before the purchase has an associated product (see Shopping Ads) then this product is considered the advertised product. Any product included in the order the customer places is a sold product. If the advertised and sold products match, then the total number of these products sold is shown under lead units sold. Example: Someone clicked on a Shopping ad for a hat then bought the same hat, a shirt and a jacket. The lead units sold in this order is 1. This metric is only available if you report conversions with cart data. |
lead_units_sold | Lead units sold is the total number of products sold as a result of advertising the same product. How it works: You report conversions with cart data for completed purchases on your website. If the ad that was interacted with before the purchase has an associated product (see Shopping Ads) then this product is considered the advertised product. Any product included in the order the customer places is a sold product. If the advertised and sold products match, then the total number of these products sold is shown under lead units sold. Example: Someone clicked on a Shopping ad for a hat then bought the same hat, a shirt and a jacket. The lead units sold in this order is 1. This metric is only available if you report conversions with cart data. |
MobileAppAsset
An asset representing a mobile app.
فیلدها | |
---|---|
app_id | مورد نیاز. A string that uniquely identifies a mobile application. It should just contain the platform native id, like "com.android.ebay" for Android or "12345689" for iOS. |
app_store | مورد نیاز. The application store that distributes this specific app. |
درصد Cpc
A bidding strategy where bids are a fraction of the advertised price for some good or service.
فیلدها | |
---|---|
cpc_bid_ceiling_micros | Maximum bid limit that can be set by the bid strategy. This is an optional field entered by the advertiser and specified in local micros. Note: A zero value is interpreted in the same way as having bid_ceiling undefined. |
enhanced_cpc_enabled | Adjusts the bid for each auction upward or downward, depending on the likelihood of a conversion. Individual bids may exceed cpc_bid_ceiling_micros, but the average bid amount for a campaign should not. |
RealTimeBiddingSetting
Settings for Real-Time Bidding, a feature only available for campaigns targeting the Ad Exchange network.
فیلدها | |
---|---|
opt_in | Whether the campaign is opted in to real-time bidding. |
SearchAds360ExpandedDynamicSearchAdInfo
An expanded dynamic search ad.
فیلدها | |
---|---|
description1 | The first line of the ad's description. |
description2 | The second line of the ad's description. |
ad_tracking_id | The tracking id of the ad. |
SearchAds360ExpandedTextAdInfo
A Search Ads 360 expanded text ad.
فیلدها | |
---|---|
headline | The headline of the ad. |
headline2 | The second headline of the ad. |
headline3 | The third headline of the ad. |
description1 | The first line of the ad's description. |
description2 | The second line of the ad's description. |
path1 | Text appended to the auto-generated visible URL with a delimiter. |
path2 | Text appended to path1 with a delimiter. |
ad_tracking_id | The tracking id of the ad. |
SearchAds360ProductAdInfo
This type has no fields.
A Search Ads 360 product ad.
SearchAds360ResponsiveSearchAdInfo
A Search Ads 360 responsive search ad.
فیلدها | |
---|---|
headlines[] | List of text assets for headlines. When the ad serves the headlines will be selected from this list. |
descriptions[] | List of text assets for descriptions. When the ad serves the descriptions will be selected from this list. |
path1 | Text appended to the auto-generated visible URL with a delimiter. |
path2 | Text appended to path1 with a delimiter. |
ad_tracking_id | The tracking id of the ad. |
SearchAds360TextAdInfo
A Search Ads 360 text ad.
فیلدها | |
---|---|
headline | The headline of the ad. |
description1 | The first line of the ad's description. |
description2 | The second line of the ad's description. |
display_url | The displayed URL of the ad. |
display_mobile_url | The displayed mobile URL of the ad. |
ad_tracking_id | The tracking id of the ad. |
بخش ها
Segment only fields.
فیلدها | |
---|---|
ad_network_type | Ad network type. |
conversion_action_category | Conversion action category. |
conversion_custom_dimensions[] | The conversion custom dimensions. |
day_of_week | Day of the week, for example, MONDAY. |
device | Device to which metrics apply. |
keyword | Keyword criterion. |
product_channel | Channel of the product. |
product_channel_exclusivity | Channel exclusivity of the product. |
product_condition | Condition of the product. |
product_sold_condition | Condition of the product sold. |
raw_event_conversion_dimensions[] | The raw event conversion dimensions. |
conversion_action | Resource name of the conversion action. |
conversion_action_name | Conversion action name. |
date | Date to which metrics apply. yyyy-MM-dd format, for example, 2018-04-17. |
geo_target_city | Resource name of the geo target constant that represents a city. |
geo_target_country | Resource name of the geo target constant that represents a country. |
geo_target_metro | Resource name of the geo target constant that represents a metro. |
geo_target_region | Resource name of the geo target constant that represents a region. |
hour | Hour of day as a number between 0 and 23, inclusive. |
month | Month as represented by the date of the first day of a month. Formatted as yyyy-MM-dd. |
product_bidding_category_level1 | Bidding category (level 1) of the product. |
product_bidding_category_level2 | Bidding category (level 2) of the product. |
product_bidding_category_level3 | Bidding category (level 3) of the product. |
product_bidding_category_level4 | Bidding category (level 4) of the product. |
product_bidding_category_level5 | Bidding category (level 5) of the product. |
product_brand | Brand of the product. |
product_country | Resource name of the geo target constant for the country of sale of the product. |
product_custom_attribute0 | Custom attribute 0 of the product. |
product_custom_attribute1 | Custom attribute 1 of the product. |
product_custom_attribute2 | Custom attribute 2 of the product. |
product_custom_attribute3 | Custom attribute 3 of the product. |
product_custom_attribute4 | Custom attribute 4 of the product. |
product_item_id | Item ID of the product. |
product_language | Resource name of the language constant for the language of the product. |
product_sold_bidding_category_level1 | Bidding category (level 1) of the product sold. |
product_sold_bidding_category_level2 | Bidding category (level 2) of the product sold. |
product_sold_bidding_category_level3 | Bidding category (level 3) of the product sold. |
product_sold_bidding_category_level4 | Bidding category (level 4) of the product sold. |
product_sold_bidding_category_level5 | Bidding category (level 5) of the product sold. |
product_sold_brand | Brand of the product sold. |
product_sold_custom_attribute0 | Custom attribute 0 of the product sold. |
product_sold_custom_attribute1 | Custom attribute 1 of the product sold. |
product_sold_custom_attribute2 | Custom attribute 2 of the product sold. |
product_sold_custom_attribute3 | Custom attribute 3 of the product sold. |
product_sold_custom_attribute4 | Custom attribute 4 of the product sold. |
product_sold_item_id | Item ID of the product sold. |
product_sold_title | Title of the product sold. |
product_sold_type_l1 | Type (level 1) of the product sold. |
product_sold_type_l2 | Type (level 2) of the product sold. |
product_sold_type_l3 | Type (level 3) of the product sold. |
product_sold_type_l4 | Type (level 4) of the product sold. |
product_sold_type_l5 | Type (level 5) of the product sold. |
product_store_id | Store ID of the product. |
product_title | Title of the product. |
product_type_l1 | Type (level 1) of the product. |
product_type_l2 | Type (level 2) of the product. |
product_type_l3 | Type (level 3) of the product. |
product_type_l4 | Type (level 4) of the product. |
product_type_l5 | Type (level 5) of the product. |
quarter | Quarter as represented by the date of the first day of a quarter. Uses the calendar year for quarters, for example, the second quarter of 2018 starts on 2018-04-01. Formatted as yyyy-MM-dd. |
week | Week as defined as Monday through Sunday, and represented by the date of Monday. Formatted as yyyy-MM-dd. |
year | Year, formatted as yyyy. |
asset_interaction_target | Only used with CustomerAsset, CampaignAsset and AdGroupAsset metrics. Indicates whether the interaction metrics occurred on the asset itself or a different asset or ad unit. Interactions (for example, clicks) are counted across all the parts of the served ad (for example, Ad itself and other components like Sitelinks) when they are served together. When interaction_on_this_asset is true, it means the interactions are on this specific asset and when interaction_on_this_asset is false, it means the interactions is not on this specific asset but on other parts of the served ad this asset is served with. |
TargetCpa
An automated bid strategy that sets bids to help get as many conversions as possible at the target cost-per-acquisition (CPA) you set.
فیلدها | |
---|---|
target_cpa_micros | Average CPA target. This target should be greater than or equal to minimum billable unit based on the currency for the account. |
cpc_bid_ceiling_micros | Maximum bid limit that can be set by the bid strategy. The limit applies to all keywords managed by the strategy. This should only be set for portfolio bid strategies. |
cpc_bid_floor_micros | Minimum bid limit that can be set by the bid strategy. The limit applies to all keywords managed by the strategy. This should only be set for portfolio bid strategies. |
TargetCpm
This type has no fields.
Target CPM (cost per thousand impressions) is an automated bidding strategy that sets bids to optimize performance given the target CPM you set.
TargetRestriction
The list of per-targeting-dimension targeting settings.
فیلدها | |
---|---|
targeting_dimension | The targeting dimension that these settings apply to. |
bid_only | Indicates whether to restrict your ads to show only for the criteria you have selected for this targeting_dimension, or to target all values for this targeting_dimension and show ads based on your targeting in other TargetingDimensions. A value of |
TargetRoas
An automated bidding strategy that helps you maximize revenue while averaging a specific target return on ad spend (ROAS).
فیلدها | |
---|---|
target_roas | مورد نیاز. The chosen revenue (based on conversion data) per unit of spend. Value must be between 0.01 and 1000.0, inclusive. |
cpc_bid_ceiling_micros | Maximum bid limit that can be set by the bid strategy. The limit applies to all keywords managed by the strategy. This should only be set for portfolio bid strategies. |
cpc_bid_floor_micros | Minimum bid limit that can be set by the bid strategy. The limit applies to all keywords managed by the strategy. This should only be set for portfolio bid strategies. |
TargetSpend
An automated bid strategy that sets your bids to help get as many clicks as possible within your budget.
فیلدها | |
---|---|
target_spend_micros | Deprecated: The spend target under which to maximize clicks. A TargetSpend bidder will attempt to spend the smaller of this value or the natural throttling spend amount. If not specified, the budget is used as the spend target. This field is deprecated and should no longer be used. See https://ads-developers.googleblog.com/2020/05/reminder-about-sunset-creation-of.html for details. |
cpc_bid_ceiling_micros | Maximum bid limit that can be set by the bid strategy. The limit applies to all keywords managed by the strategy. |
TargetingSetting
Settings for the targeting-related features, at the campaign and ad group levels. For more details about the targeting setting, visit https://support.google.com/google-ads/answer/7365594
فیلدها | |
---|---|
target_restrictions[] | The per-targeting-dimension setting to restrict the reach of your campaign or ad group. |
TextAsset
A Text asset.
فیلدها | |
---|---|
text | Text content of the text asset. |
TextLabel
A type of label displaying text on a colored background.
فیلدها | |
---|---|
background_color | Background color of the label in HEX format. This string must match the regular expression '^#([a-fA-F0-9]{6}|[a-fA-F0-9]{3})$'. Note: The background color may not be visible for manager accounts. |
description | A short description of the label. The length must be no more than 200 characters. |
UnifiedCallAsset
A unified call asset.
فیلدها | |
---|---|
country_code | Two-letter country code of the phone number. Examples: 'US', 'us'. |
phone_number | The advertiser's raw phone number. Examples: '1234567890', '(123)456-7890' |
call_conversion_reporting_state | Indicates whether this CallAsset should use its own call conversion setting, follow the account level setting, or disable call conversion. |
call_conversion_action | The conversion action to attribute a call conversion to. If not set, the default conversion action is used. This field only has effect if call_conversion_reporting_state is set to USE_RESOURCE_LEVEL_CALL_CONVERSION_ACTION. |
ad_schedule_targets[] | List of non-overlapping schedules specifying all time intervals for which the asset may serve. There can be a maximum of 6 schedules per day, 42 in total. |
call_only | Whether the call only shows the phone number without a link to the website. Applies to Microsoft Ads. |
call_tracking_enabled | Whether the call should be enabled on call tracking. Applies to Microsoft Ads. |
use_searcher_time_zone | Whether to show the call extension in search user's time zone. Applies to Microsoft Ads. |
start_date | Start date of when this asset is effective and can begin serving, in yyyy-MM-dd format. |
end_date | Last date of when this asset is effective and still serving, in yyyy-MM-dd format. |
UnifiedCalloutAsset
A unified callout asset.
فیلدها | |
---|---|
callout_text | The callout text. The length of this string should be between 1 and 25, inclusive. |
start_date | Start date of when this asset is effective and can begin serving, in yyyy-MM-dd format. |
end_date | Last date of when this asset is effective and still serving, in yyyy-MM-dd format. |
ad_schedule_targets[] | List of non-overlapping schedules specifying all time intervals for which the asset may serve. There can be a maximum of 6 schedules per day, 42 in total. |
use_searcher_time_zone | Whether to show the asset in search user's time zone. Applies to Microsoft Ads. |
UnifiedLocationAsset
A unified location asset.
فیلدها | |
---|---|
place_id | Place IDs uniquely identify a place in the Google Places database and on Google Maps. This field is unique for a given customer ID and asset type. See https://developers.google.com/places/web-service/place-id to learn more about Place ID. |
business_profile_locations[] | The list of business locations for the customer. This will only be returned if the Location Asset is syncing from the Business Profile account. It is possible to have multiple Business Profile listings under the same account that point to the same Place ID. |
location_ownership_type | The type of location ownership. If the type is BUSINESS_OWNER, it will be served as a location extension. If the type is AFFILIATE, it will be served as an affiliate location. |
UnifiedPageFeedAsset
A Unified Page Feed asset.
فیلدها | |
---|---|
page_url | The webpage that advertisers want to target. |
labels[] | Labels used to group the page urls. |
UnifiedSitelinkAsset
A unified sitelink asset.
فیلدها | |
---|---|
link_text | URL display text for the sitelink. The length of this string should be between 1 and 25, inclusive. |
description1 | First line of the description for the sitelink. If set, the length should be between 1 and 35, inclusive, and description2 must also be set. |
description2 | Second line of the description for the sitelink. If set, the length should be between 1 and 35, inclusive, and description1 must also be set. |
start_date | Start date of when this asset is effective and can begin serving, in yyyy-MM-dd format. |
end_date | Last date of when this asset is effective and still serving, in yyyy-MM-dd format. |
ad_schedule_targets[] | List of non-overlapping schedules specifying all time intervals for which the asset may serve. There can be a maximum of 6 schedules per day, 42 in total. |
tracking_id | ID used for tracking clicks for the sitelink asset. This is a Yahoo! Japan only field. |
use_searcher_time_zone | Whether to show the sitelink asset in search user's time zone. Applies to Microsoft Ads. |
mobile_preferred | Whether the preference is for the sitelink asset to be displayed on mobile devices. Applies to Microsoft Ads. |
UserListInfo
A User List criterion. Represents a user list that is defined by the advertiser to be targeted.
فیلدها | |
---|---|
user_list | The User List resource name. |
ارزش
A generic data container.
فیلدها | |
---|---|
Union field value . A value. value can be only one of the following: | |
boolean_value | یک بولی |
int64_value | An int64. |
float_value | A float. |
double_value | یک دوتایی |
string_value | یک رشته |
WebpageConditionInfo
Logical expression for targeting webpages of an advertiser's website.
فیلدها | |
---|---|
operand | Operand of webpage targeting condition. |
operator | Operator of webpage targeting condition. |
argument | Argument of webpage targeting condition. |
WebpageInfo
Represents a criterion for targeting webpages of an advertiser's website.
فیلدها | |
---|---|
conditions[] | Conditions, or logical expressions, for webpage targeting. The list of webpage targeting conditions are and-ed together when evaluated for targeting. An empty list of conditions indicates all pages of the campaign's website are targeted. This field is required for CREATE operations and is prohibited on UPDATE operations. |
coverage_percentage | 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 | 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 | YouTube video title. |
youtube_video_id | YouTube video id. This is the 11 character string value used in the YouTube video URL. |