Package google.ads.searchads360.v0.common

شاخص

AdScheduleInfo

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

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

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

فیلدها
start_minute

MinuteOfHour

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

این فیلد برای عملیات CREATE لازم است و در عملیات UPDATE ممنوع است.

end_minute

MinuteOfHour

چند دقیقه پس از ساعت پایانی که این برنامه در آن به پایان می رسد. برنامه منحصر به دقیقه پایانی است.

این فیلد برای عملیات CREATE لازم است و در عملیات UPDATE ممنوع است.

day_of_week

DayOfWeek

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

این فیلد برای عملیات CREATE لازم است و در عملیات UPDATE ممنوع است.

start_hour

int32

شروع ساعت در 24 ساعت این فیلد باید بین 0 تا 23 باشد.

این فیلد برای عملیات CREATE لازم است و در عملیات UPDATE ممنوع است.

end_hour

int32

ساعت پایان در 24 ساعت زمان؛ 24 به معنای پایان روز است. این فیلد باید بین 0 تا 24 باشد.

این فیلد برای عملیات CREATE لازم است و در عملیات UPDATE ممنوع است.

AdTextAsset

دارایی متنی که در یک آگهی استفاده می شود.

فیلدها
text

string

متن دارایی

AgeRangeInfo

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

فیلدها
type

AgeRangeType

نوع محدوده سنی

AssetInteractionTarget

یک بخش AssetInteractionTarget.

فیلدها
asset

string

نام منبع دارایی

interaction_on_this_asset

bool

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

AssetUsage

حاوی اطلاعات استفاده از دارایی است.

فیلدها
asset

string

نام منبع دارایی

served_asset_field_type

ServedAssetFieldType

نوع فیلد ارائه شده دارایی.

AudienceInfo

یک معیار مخاطب

فیلدها
audience

string

نام منبع مخاطب.

Business ProfileLocation

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

فیلدها
labels[]

string

برچسب مشخص شده توسط تبلیغ کننده برای مکان در حساب نمایه کسب و کار. این از حساب نمایه کسب‌وکار همگام‌سازی شده است.

store_code

string

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

listing_id

int64

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

CallToActionAsset

دارایی دعوت به اقدام

فیلدها
call_to_action

CallToActionType

فراخوان به اقدام.

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

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

فیلدها
key

string

کلیدی که با نام تگ پارامتر مطابقت دارد.

value

string

مقداری که باید جایگزین شود.

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

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

فیلدها
type

Device

نوع دستگاه.

EnhancedCpc

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

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

این استراتژی مناقصه منسوخ شده است و دیگر نمی توان آن را ایجاد کرد. از ManualCpc با تنظیم شده به true_cpc_enabled از Manual برای عملکرد معادل استفاده کنید.

FrequencyCapEntry

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

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

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

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

فیلدها
type

GenderType

نوع جنسیت

ImageAsset

دارایی تصویر

فیلدها
mime_type

MimeType

نوع MIME دارایی تصویر.

full_size

ImageDimension

فراداده این تصویر در اندازه اصلی آن.

file_size

int64

اندازه فایل دارایی تصویر بر حسب بایت.

ابعاد تصویر

متادیتا برای یک تصویر در اندازه معین، اعم از اصلی یا تغییر اندازه.

فیلدها
height_pixels

int64

ارتفاع تصویر.

width_pixels

int64

عرض تصویر.

url

string

URL که تصویر را با این ارتفاع و عرض برمی گرداند.

کلمه کلیدی

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

فیلدها
info

KeywordInfo

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

ad_group_criterion

string

نام منبع AdGroupCriterion.

KeywordInfo

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

فیلدها
match_type

KeywordMatchType

نوع مطابقت کلمه کلیدی.

text

string

متن کلمه کلیدی (حداکثر 80 کاراکتر و 10 کلمه).

LanguageInfo

یک معیار زبان

فیلدها
language_constant

string

نام منبع ثابت زبان.

ListingGroupInfo

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

فیلدها
type

ListingGroupType

نوع گروه لیست

LocationGroupInfo

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

فیلدها
geo_target_constants[]

string

ثابت(های) هدف جغرافیایی که محدوده منطقه جغرافیایی را در خوراک محدود می کند. در حال حاضر فقط یک ثابت هدف جغرافیایی مجاز است.

radius_units

LocationGroupRadiusUnits

واحد شعاع. مایل ها و متر ها برای ثابت های هدف جغرافیایی پشتیبانی می شوند. میلی مایل و متر برای مجموعه اقلام خوراک پشتیبانی می شود. این مورد نیاز است و باید در عملیات CREATE تنظیم شود.

feed_item_sets[]

string

FeedItemSets که FeedItems آنها هدف قرار می گیرند. اگر چندین شناسه مشخص شده باشد، تمام مواردی که حداقل در یک مجموعه ظاهر می شوند، هدف قرار می گیرند. این فیلد با geo_target_constants قابل استفاده نیست. این اختیاری است و فقط در عملیات CREATE قابل تنظیم است.

radius

int64

فاصله در واحدهایی که شعاع اطراف مکان های مورد نظر را مشخص می کند. این مورد نیاز است و باید در عملیات CREATE تنظیم شود.

LocationInfo

یک معیار مکان.

فیلدها
geo_target_constant

string

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

ManualCpa

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

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

ManualCpc

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

فیلدها
enhanced_cpc_enabled

bool

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

ManualCpm

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

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

MaximizeConversionValue

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

فیلدها
cpc_bid_ceiling_micros

int64

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

cpc_bid_floor_micros

int64

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

target_roas

double

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

MaximizeConversions

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

فیلدها
cpc_bid_ceiling_micros

int64

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

cpc_bid_floor_micros

int64

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

target_cpa_micros

int64

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

معیارها

داده های متریک

فیلدها
all_conversions_value_by_conversion_date

double

ارزش همه تبدیل ها وقتی این ستون با تاریخ انتخاب می شود، مقادیر در ستون تاریخ به معنای تاریخ تبدیل است. جزئیات ستون‌های by_conversion_date در https://support.google.com/sa360/answer/9250611 موجود است.

all_conversions_by_conversion_date

double

تعداد کل تبدیل. این شامل همه تبدیل‌ها بدون توجه به مقدار include_in_conversions_metric می‌شود. وقتی این ستون با تاریخ انتخاب می شود، مقادیر در ستون تاریخ به معنای تاریخ تبدیل است. جزئیات ستون‌های by_conversion_date در https://support.google.com/sa360/answer/9250611 موجود است.

conversion_custom_metrics[]

Value

معیارهای سفارشی تبدیل

conversions_value_by_conversion_date

double

مجموع ارزش تبدیل های قابل پیشنهاد بر اساس تاریخ تبدیل. وقتی این ستون با تاریخ انتخاب می شود، مقادیر در ستون تاریخ به معنای تاریخ تبدیل است.

conversions_by_conversion_date

double

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

historical_creative_quality_score

QualityScoreBucket

امتیاز کیفی تاریخی خلاق.

historical_landing_page_quality_score

QualityScoreBucket

کیفیت تجربه صفحه فرود تاریخی

historical_search_predicted_ctr

QualityScoreBucket

جستجوی تاریخی نرخ کلیک (CTR) را پیش‌بینی می‌کرد.

interaction_event_types[]

InteractionEventType

انواع تعاملات قابل پرداخت و رایگان.

raw_event_conversion_metrics[]

Value

معیارهای تبدیل رویداد خام

absolute_top_impression_percentage

double

سهم تأثیر مطلق جستجو در بالای صفحه، درصدی از نمایش‌های آگهی جستجوی شما است که در برجسته‌ترین موقعیت جستجو نشان داده می‌شود.

all_conversions_from_interactions_rate

double

همه تبدیل‌های حاصل از تعاملات (برخلاف مشاهده از طریق تبدیل) تقسیم بر تعداد تعاملات تبلیغاتی.

all_conversions_value

double

ارزش همه تبدیل ها

all_conversions

double

تعداد کل تبدیل. این شامل همه تبدیل‌ها بدون توجه به مقدار include_in_conversions_metric می‌شود.

all_conversions_value_per_cost

double

ارزش تمام تبدیل ها تقسیم بر هزینه کل تعاملات تبلیغاتی (مانند کلیک برای تبلیغات متنی یا بازدید برای تبلیغات ویدیویی).

all_conversions_from_click_to_call

double

تعداد دفعاتی که افراد روی دکمه «تماس» برای تماس با فروشگاه در حین یا پس از کلیک بر روی آگهی کلیک کردند. این شماره شامل متصل بودن یا نبودن تماس‌ها یا مدت تماس نیست.

این معیار فقط برای موارد فید اعمال می شود.

all_conversions_from_directions

double

تعداد دفعاتی که افراد روی دکمه «دریافت مسیرها» کلیک کردند تا پس از کلیک بر روی یک آگهی به فروشگاه بروید.

این معیار فقط برای موارد فید اعمال می شود.

all_conversions_from_interactions_value_per_interaction

double

ارزش همه تبدیل‌های حاصل از تعاملات تقسیم بر تعداد کل تعاملات.

all_conversions_from_menu

double

تعداد دفعاتی که افراد پس از کلیک بر روی یک تبلیغ، برای مشاهده منوی فروشگاه روی یک پیوند کلیک کردند.

این معیار فقط برای موارد فید اعمال می شود.

all_conversions_from_order

double

تعداد دفعاتی که افراد پس از کلیک کردن بر روی تبلیغ، در فروشگاهی سفارش دادند.

این معیار فقط برای موارد فید اعمال می شود.

all_conversions_from_other_engagement

double

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

این معیار فقط برای موارد فید اعمال می شود.

all_conversions_from_store_visit

double

تعداد تخمینی تعداد دفعاتی که افراد پس از کلیک بر روی یک تبلیغ از یک فروشگاه بازدید می کنند.

این معیار فقط برای موارد فید اعمال می شود.

visits

double

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

all_conversions_from_store_website

double

تعداد دفعاتی که افراد پس از کلیک کردن بر روی یک تبلیغ به آدرس اینترنتی فروشگاه منتقل شدند.

این معیار فقط برای موارد فید اعمال می شود.

average_cost

double

میانگین مبلغی که برای هر تعامل پرداخت می کنید. این مبلغ کل هزینه تبلیغات شما تقسیم بر تعداد کل تعاملات است.

average_cpc

double

هزینه کل همه کلیک ها تقسیم بر تعداد کل کلیک های دریافت شده. این معیار یک ارزش پولی است و به صورت پیش‌فرض به واحد پول مشتری بازگردانده می‌شود. پارامتر metrics_currency را در https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause ببینید

average_cpm

double

میانگین هزینه به ازای هر هزار نمایش (CPM). این معیار یک ارزش پولی است و به صورت پیش‌فرض به واحد پول مشتری بازگردانده می‌شود. پارامتر metrics_currency را در https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause ببینید

clicks

int64

تعداد کلیک ها.

content_budget_lost_impression_share

double

درصد تخمینی مواقعی که تبلیغ شما واجد شرایط نمایش در شبکه نمایش بود اما به دلیل پایین بودن بودجه شما واجد شرایط نبود. توجه: سهم برداشت از دست رفته بودجه محتوا در محدوده 0 تا 0.9 گزارش شده است. هر مقدار بالاتر از 0.9 به عنوان 0.9001 گزارش می شود.

content_impression_share

double

نمایش‌هایی که در Display Network دریافت کرده‌اید تقسیم بر تعداد تخمینی نمایش‌هایی که واجد شرایط دریافت آن بودید. توجه: سهم نمایش محتوا در محدوده 0.1 تا 1 گزارش می شود. هر مقدار کمتر از 0.1 به عنوان 0.0999 گزارش می شود.

content_rank_lost_impression_share

double

درصد تخمینی نمایش‌هایی در شبکه نمایش که تبلیغات شما به دلیل رتبه پایین آگهی دریافت نکرده است. توجه: رتبه محتوا سهم برداشت از دست رفته در محدوده 0 تا 0.9 گزارش شده است. هر مقدار بالاتر از 0.9 به عنوان 0.9001 گزارش می شود.

conversions_from_interactions_rate

double

میانگین تبدیل‌های قابل پیشنهاد (از تعامل) به ازای هر تعامل واجد شرایط تبدیل. نشان می دهد که به طور متوسط ​​هر چند وقت یک تعامل تبلیغاتی منجر به تبدیل قابل پیشنهاد می شود.

client_account_conversions_value

double

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

conversions_value_per_cost

double

ارزش تبدیل قابل پیشنهاد تقسیم بر هزینه کل تعاملات واجد شرایط تبدیل.

conversions_from_interactions_value_per_interaction

double

ارزش تبدیل‌های حاصل از تعاملات تقسیم بر تعداد تعاملات تبلیغاتی. این فقط شامل اقدامات تبدیلی می‌شود که ویژگی include_in_conversions_metric روی درست تنظیم شده است. اگر از مناقصه مبتنی بر تبدیل استفاده می‌کنید، استراتژی‌های پیشنهادی شما برای این تبدیل‌ها بهینه می‌شوند.

client_account_conversions

double

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

cost_micros

int64

مجموع هزینه‌های هزینه هر کلیک (CPC) و هزینه به ازای هر هزار نمایش (CPM) شما در این دوره. این معیار یک ارزش پولی است و به صورت پیش‌فرض به واحد پول مشتری بازگردانده می‌شود. پارامتر metrics_currency را در https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause ببینید

cost_per_all_conversions

double

هزینه تعاملات تبلیغاتی تقسیم بر همه تبدیل ها.

cost_per_conversion

double

میانگین هزینه واجد شرایط تبدیل به ازای هر تبدیل قابل پیشنهاد.

cost_per_current_model_attributed_conversion

double

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

cross_device_conversions

double

تبدیل ها از زمانی که مشتری روی یک تبلیغ در یک دستگاه کلیک می کند، سپس در دستگاه یا مرورگر دیگری تبدیل می کند. تبدیل‌های بین دستگاهی قبلاً در all_conversions گنجانده شده است.

cross_device_conversions_by_conversion_date

double

تعداد تبدیل‌های بین دستگاهی بر اساس تاریخ تبدیل. جزئیات ستون‌های by_conversion_date در https://support.google.com/sa360/answer/9250611 موجود است.

cross_device_conversions_value

double

مجموع مقدار تبدیل های متقابل دستگاه.

cross_device_conversions_value_by_conversion_date

double

مجموع ارزش تبدیل‌های بین دستگاهی بر اساس تاریخ تبدیل. جزئیات ستون‌های by_conversion_date در https://support.google.com/sa360/answer/9250611 موجود است.

ctr

double

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

conversions

double

تعداد تبدیل. این فقط شامل اقدامات تبدیلی می‌شود که ویژگی include_in_conversions_metric روی درست تنظیم شده است. اگر از مناقصه مبتنی بر تبدیل استفاده می‌کنید، استراتژی‌های پیشنهادی شما برای این تبدیل‌ها بهینه می‌شوند.

conversions_value

double

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

average_quality_score

double

نمره کیفیت متوسط.

historical_quality_score

int64

امتیاز کیفیت تاریخی

impressions

int64

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

interaction_rate

double

هر چند وقت یکبار افراد پس از نمایش آگهی شما با آنها تعامل برقرار می کنند. این تعداد تعاملات تقسیم بر تعداد دفعاتی است که تبلیغ شما نشان داده می شود.

interactions

int64

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

invalid_click_rate

double

درصد کلیک‌های فیلتر شده از تعداد کل کلیک‌های شما (کلیک‌های فیلتر شده + فیلتر نشده) در طول دوره گزارش.

invalid_clicks

int64

تعداد کلیک‌هایی که گوگل نامشروع می‌داند و هزینه‌ای را از شما دریافت نمی‌کند.

general_invalid_click_rate

double

درصد کلیک‌هایی که از تعداد کل کلیک‌های شما (کلیک‌های فیلتر شده + فیلتر نشده) به دلیل کلی‌کلیک‌های نامعتبر فیلتر شده‌اند. اینها کلیک‌هایی هستند که Google آنها را غیرقانونی می‌داند و از طریق روش‌های معمول فیلتر کردن (یعنی ترافیک نامعتبر مرکز داده، ربات‌ها و عنکبوت‌ها یا سایر خزنده‌ها، الگوهای نامنظم و غیره) شناسایی می‌شوند. برای آنها هزینه ای از شما دریافت نمی شود و آنها بر آمار حساب شما تأثیر نمی گذارند. برای جزئیات به صفحه راهنما در https://support.google.com/campaignmanager/answer/6076504 مراجعه کنید.

general_invalid_clicks

int64

تعداد کلیک‌های نامعتبر عمومی اینها زیرمجموعه‌ای از کلیک‌های نامعتبر شما هستند که از طریق روش‌های معمول فیلتر کردن (مانند ترافیک نامعتبر مرکز داده، ربات‌ها و عنکبوت‌ها یا سایر خزنده‌ها، الگوهای نامنظم و غیره) شناسایی می‌شوند. برای آنها هزینه ای از شما دریافت نمی شود و آنها بر آمار حساب شما تأثیر نمی گذارند. برای جزئیات به صفحه راهنما در https://support.google.com/campaignmanager/answer/6076504 مراجعه کنید.

mobile_friendly_clicks_percentage

double

درصد کلیک های موبایلی که به یک صفحه سازگار با موبایل می رود.

search_absolute_top_impression_share

double

درصدی از آگهی‌های خرید یا جستجوی مشتری که در برجسته‌ترین موقعیت خرید نشان داده می‌شوند. برای جزئیات به https://support.google.com/sa360/answer/9566729 مراجعه کنید. هر مقدار کمتر از 0.1 به عنوان 0.0999 گزارش می شود.

search_budget_lost_absolute_top_impression_share

double

عددی که تخمین می‌زند که چقدر تبلیغ شما به دلیل بودجه کم، اولین تبلیغ در بین آگهی‌های برتر در نتایج جستجو نیست. توجه: بودجه جست و جو از دست رفته سهم نمایش برتر مطلق در محدوده 0 تا 0.9 گزارش شده است. هر مقدار بالاتر از 0.9 به عنوان 0.9001 گزارش می شود.

search_budget_lost_impression_share

double

درصد تخمینی مواقعی که تبلیغ شما واجد شرایط نمایش در شبکه جستجو بود اما به دلیل پایین بودن بودجه شما واجد شرایط نبود. توجه: سهم برداشت از دست رفته بودجه جستجو در محدوده 0 تا 0.9 گزارش شده است. هر مقدار بالاتر از 0.9 به عنوان 0.9001 گزارش می شود.

search_budget_lost_top_impression_share

double

عددی که تخمین می‌زند چند بار تبلیغ شما به دلیل بودجه کم در مجاورت نتایج جستجوی ارگانیک برتر نمایش داده نمی‌شود. توجه: بودجه جستجو از دست رفته سهم نمایش برتر در محدوده 0 تا 0.9 گزارش شده است. هر مقدار بالاتر از 0.9 به عنوان 0.9001 گزارش می شود.

search_click_share

double

تعداد کلیک‌هایی که در شبکه جستجو دریافت کرده‌اید تقسیم بر تعداد تخمینی کلیک‌هایی که واجد شرایط دریافت آن بودید. توجه: سهم کلیک جستجو در محدوده 0.1 تا 1 گزارش می شود. هر مقدار زیر 0.1 به عنوان 0.0999 گزارش می شود.

search_exact_match_impression_share

double

نمایش‌هایی که دریافت کرده‌اید تقسیم بر تعداد تخمینی نمایش‌هایی که واجد شرایط دریافت آن‌ها در شبکه جستجو بودید برای عبارات جستجویی که دقیقاً با کلمات کلیدی شما مطابقت داشتند (یا انواع نزدیک کلمه کلیدی شما بودند)، صرف نظر از نوع تطبیق کلمه کلیدی شما. توجه: سهم نمایش منطبق دقیق جستجو در محدوده 0.1 تا 1 گزارش می شود. هر مقدار کمتر از 0.1 به عنوان 0.0999 گزارش می شود.

search_impression_share

double

نمایش‌هایی که در شبکه جستجو دریافت کرده‌اید تقسیم بر تعداد تخمینی نمایش‌هایی که واجد شرایط دریافت آن بودید. توجه: سهم نمایش جستجو در محدوده 0.1 تا 1 گزارش می شود. هر مقدار کمتر از 0.1 به عنوان 0.0999 گزارش می شود.

search_rank_lost_absolute_top_impression_share

double

عددی که تخمین می‌زند چقدر تبلیغ شما به دلیل رتبه پایین آگهی، اولین آگهی در بین آگهی‌های برتر در نتایج جستجو نبوده است. توجه: رتبه جستجو از دست رفته سهم برداشت مطلق در محدوده 0 تا 0.9 گزارش شده است. هر مقدار بالاتر از 0.9 به عنوان 0.9001 گزارش می شود.

search_rank_lost_impression_share

double

درصد تخمینی نمایش‌هایی در شبکه جستجو که تبلیغات شما به دلیل رتبه پایین آگهی دریافت نکرده است. توجه: رتبه جستجو سهم برداشت از دست رفته در محدوده 0 تا 0.9 گزارش شده است. هر مقدار بالاتر از 0.9 به عنوان 0.9001 گزارش می شود.

search_rank_lost_top_impression_share

double

عددی که تخمین می‌زند چند بار تبلیغ شما به دلیل رتبه پایین آگهی در مجاورت نتایج جستجوی ارگانیک برتر نمایش داده نمی‌شود. توجه: رتبه جستجو از دست رفته سهم نمایش برتر در محدوده 0 تا 0.9 گزارش شده است. هر مقدار بالاتر از 0.9 به عنوان 0.9001 گزارش می شود.

search_top_impression_share

double

نمایش‌هایی که در بین آگهی‌های برتر دریافت کرده‌اید در مقایسه با تعداد تخمینی نمایش‌هایی که واجد شرایط دریافت در بین آگهی‌های برتر بودید. توجه: سهم نمایش برتر جستجو در محدوده 0.1 تا 1 گزارش می شود. هر مقدار کمتر از 0.1 به عنوان 0.0999 گزارش می شود.

تبلیغات برتر عموماً بالاتر از نتایج ارگانیک برتر هستند، اگرچه ممکن است در زیر نتایج ارگانیک برتر در مورد جستجوهای خاص نشان داده شوند.

top_impression_percentage

double

درصد درج آگهی شما که در مجاورت نتایج جستجوی ارگانیک برتر نشان داده می شود.

value_per_all_conversions

double

ارزش همه تبدیل‌ها تقسیم بر تعداد همه تبدیل‌ها.

value_per_all_conversions_by_conversion_date

double

ارزش همه تبدیل‌ها تقسیم بر تعداد همه تبدیل‌ها. وقتی این ستون با تاریخ انتخاب می شود، مقادیر در ستون تاریخ به معنای تاریخ تبدیل است. جزئیات ستون‌های by_conversion_date در https://support.google.com/sa360/answer/9250611 موجود است.

value_per_conversion

double

ارزش تبدیل قابل مناقصه تقسیم بر تعداد تبدیل‌های قابل پیشنهاد. نشان می دهد که به طور متوسط ​​هر یک از تبدیل های قابل پیشنهاد چقدر ارزش دارد.

value_per_conversions_by_conversion_date

double

ارزش تبدیل‌های قابل پیشنهاد بر اساس تاریخ تبدیل تقسیم بر تبدیل‌های قابل پیشنهاد بر اساس تاریخ تبدیل. نشان می دهد که به طور متوسط ​​هر یک از تبدیل های قابل پیشنهاد قیمت (بر اساس تاریخ تبدیل) چقدر است. وقتی این ستون با تاریخ انتخاب می شود، مقادیر در ستون تاریخ به معنای تاریخ تبدیل است.

client_account_view_through_conversions

int64

تعداد کل تبدیل‌های بازدید از طریق. اینها زمانی اتفاق می‌افتند که مشتری یک تبلیغ تصویری یا رسانه‌ای غنی را می‌بیند، سپس بعداً یک تبدیل را در سایت شما بدون تعامل با یک آگهی دیگر (مثلاً کلیک کردن روی) انجام می‌دهد.

client_account_cross_sell_cost_of_goods_sold_micros

int64

هزینه فروش متقابل کالاهای فروخته شده حساب مشتری (COGS) کل هزینه محصولات فروخته شده در نتیجه تبلیغات یک محصول متفاوت است. چگونه کار می کند: شما تبدیل ها را با داده های سبد خرید برای خریدهای تکمیل شده در وب سایت خود گزارش می دهید. اگر تبلیغی که قبل از خرید با آن تعامل داشته‌اید، محصول مرتبطی داشته باشد (به آگهی‌های خرید مراجعه کنید)، این محصول به عنوان محصول تبلیغ‌شده در نظر گرفته می‌شود. هر محصولی که در سفارشی که مشتری قرار می دهد گنجانده شود، محصول فروخته شده است. اگر این محصولات مطابقت نداشته باشند، این فروش متقابل در نظر گرفته می شود. هزینه فروش متقابل کالاهای فروخته شده، کل هزینه محصولات فروخته شده است که تبلیغ نشده اند. مثال: شخصی روی یک آگهی خرید کلاه کلیک کرد و سپس همان کلاه و یک پیراهن را خرید. کلاه دارای بهای تمام شده کالای فروخته شده 3 دلار است، پیراهن دارای بهای تمام شده کالای فروخته شده 5 دلار است. هزینه فروش متقابل کالاهای فروخته شده برای این سفارش 5 دلار است. این معیار فقط در صورتی در دسترس است که تبدیل‌ها را با داده‌های سبد خرید گزارش دهید. این معیار یک ارزش پولی است و به صورت پیش‌فرض به واحد پول مشتری بازگردانده می‌شود. پارامتر metrics_currency را در https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause ببینید

cross_sell_cost_of_goods_sold_micros

int64

هزینه فروش متقابل کالاهای فروخته شده (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

int64

سود ناخالص فروش متقابل حساب مشتری، سودی است که از محصولات فروخته شده در نتیجه تبلیغات یک محصول متفاوت، منهای هزینه کالای فروخته شده (COGS) به دست آورده اید. چگونه کار می کند: شما تبدیل ها را با داده های سبد خرید برای خریدهای تکمیل شده در وب سایت خود گزارش می دهید. اگر تبلیغی که قبل از خرید با آن تعامل داشته‌اید، محصول مرتبطی داشته باشد (به آگهی‌های خرید مراجعه کنید)، این محصول به عنوان محصول تبلیغ‌شده در نظر گرفته می‌شود. هر محصولی که در خرید گنجانده شود، محصول فروخته شده است. اگر این محصولات مطابقت نداشته باشند، این فروش متقابل در نظر گرفته می شود. سود ناخالص فروش متقابل درآمدی است که شما از فروش متقابل نسبت داده شده به تبلیغات خود منهای هزینه کالای فروخته شده کسب کرده اید. مثال: شخصی روی یک آگهی خرید کلاه کلیک کرد و سپس همان کلاه و یک پیراهن را خرید. قیمت این پیراهن 20 دلار است و بهای تمام شده کالا 5 دلار است. سود ناخالص فروش متقابل این سفارش 15 دلار = 20 - 5 دلار است. این معیار فقط در صورتی در دسترس است که تبدیل‌ها را با داده‌های سبد خرید گزارش دهید. این معیار یک ارزش پولی است و به صورت پیش‌فرض به واحد پول مشتری بازگردانده می‌شود. پارامتر metrics_currency را در https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause ببینید

cross_sell_gross_profit_micros

int64

سود ناخالص فروش متقابل، سودی است که شما از محصولات فروخته شده در نتیجه تبلیغات یک محصول متفاوت، منهای هزینه کالای فروخته شده (COGS) به دست آورده اید. چگونه کار می کند: شما تبدیل ها را با داده های سبد خرید برای خریدهای تکمیل شده در وب سایت خود گزارش می دهید. اگر تبلیغی که قبل از خرید با آن تعامل داشته‌اید، محصول مرتبطی داشته باشد (به آگهی‌های خرید مراجعه کنید)، این محصول به عنوان محصول تبلیغ‌شده در نظر گرفته می‌شود. هر محصولی که در خرید گنجانده شود، محصول فروخته شده است. اگر این محصولات مطابقت نداشته باشند، این فروش متقابل در نظر گرفته می شود. سود ناخالص فروش متقابل درآمدی است که شما از فروش متقابل نسبت داده شده به تبلیغات خود منهای هزینه کالای فروخته شده کسب کرده اید. مثال: شخصی روی یک آگهی خرید کلاه کلیک کرد و سپس همان کلاه و یک پیراهن را خرید. قیمت این پیراهن 20 دلار است و بهای تمام شده کالا 5 دلار است. سود ناخالص فروش متقابل این سفارش 15 دلار = 20 - 5 دلار است. این معیار فقط در صورتی در دسترس است که تبدیل‌ها را با داده‌های سبد خرید گزارش دهید. این معیار یک ارزش پولی است و به صورت پیش‌فرض به واحد پول مشتری بازگردانده می‌شود. پارامتر metrics_currency را در https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause ببینید

client_account_cross_sell_revenue_micros

int64

درآمد حاصل از فروش متقابل حساب مشتری کل مبلغی است که شما از محصولات فروخته شده در نتیجه تبلیغات یک محصول دیگر به دست آورده اید. چگونه کار می کند: شما تبدیل ها را با داده های سبد خرید برای خریدهای تکمیل شده در وب سایت خود گزارش می دهید. اگر تبلیغی که قبل از خرید با آن تعامل داشته‌اید، محصول مرتبطی داشته باشد (به آگهی‌های خرید مراجعه کنید)، این محصول به عنوان محصول تبلیغ‌شده در نظر گرفته می‌شود. هر محصولی که در سفارشی که مشتری قرار می دهد گنجانده شود، محصول فروخته شده است. اگر این محصولات مطابقت نداشته باشند، این فروش متقابل در نظر گرفته می شود. درآمد حاصل از فروش متقابل کل ارزشی است که شما از فروش متقابل به تبلیغات خود نسبت داده اید. مثال: شخصی روی یک آگهی خرید کلاه کلیک کرد و سپس همان کلاه و یک پیراهن را خرید. قیمت کلاه 10 دلار و قیمت پیراهن 20 دلار است. درآمد متقابل فروش این سفارش 20 دلار است. این معیار فقط در صورتی در دسترس است که تبدیل‌ها را با داده‌های سبد خرید گزارش دهید. این معیار یک ارزش پولی است و به صورت پیش‌فرض به واحد پول مشتری بازگردانده می‌شود. پارامتر metrics_currency را در https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause ببینید

cross_sell_revenue_micros

int64

درآمد حاصل از فروش متقابل کل مبلغی است که شما از محصولات فروخته شده در نتیجه تبلیغات یک محصول دیگر به دست آورده اید. چگونه کار می کند: شما تبدیل ها را با داده های سبد خرید برای خریدهای تکمیل شده در وب سایت خود گزارش می دهید. اگر تبلیغی که قبل از خرید با آن تعامل داشته‌اید، محصول مرتبطی داشته باشد (به آگهی‌های خرید مراجعه کنید)، این محصول به عنوان محصول تبلیغ‌شده در نظر گرفته می‌شود. هر محصولی که در سفارشی که مشتری قرار می دهد گنجانده شود، محصول فروخته شده است. اگر این محصولات مطابقت نداشته باشند، این فروش متقابل در نظر گرفته می شود. درآمد حاصل از فروش متقابل کل ارزشی است که شما از فروش متقابل به تبلیغات خود نسبت داده اید. مثال: شخصی روی یک آگهی خرید کلاه کلیک کرد و سپس همان کلاه و یک پیراهن را خرید. قیمت کلاه 10 دلار و قیمت پیراهن 20 دلار است. درآمد متقابل فروش این سفارش 20 دلار است. این معیار فقط در صورتی در دسترس است که تبدیل‌ها را با داده‌های سبد خرید گزارش دهید. این معیار یک ارزش پولی است و به صورت پیش‌فرض به واحد پول مشتری بازگردانده می‌شود. پارامتر metrics_currency را در https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause ببینید

client_account_cross_sell_units_sold

double

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

cross_sell_units_sold

double

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

client_account_lead_cost_of_goods_sold_micros

int64

بهای تمام شده کالاهای فروخته شده حساب مشتری (COGS) کل هزینه محصولات فروخته شده در نتیجه تبلیغات همان محصول است. چگونه کار می کند: شما تبدیل ها را با داده های سبد خرید برای خریدهای تکمیل شده در وب سایت خود گزارش می دهید. اگر تبلیغی که با آن تعامل داشته‌اید، محصول مرتبطی داشته باشد (به آگهی‌های خرید مراجعه کنید)، این محصول به عنوان محصول تبلیغ‌شده در نظر گرفته می‌شود. هر محصولی که در سفارشی که مشتری قرار می دهد گنجانده شود، محصول فروخته شده است. اگر محصولات تبلیغ شده و فروخته شده مطابقت داشته باشند، بهای تمام شده این کالاها تحت عنوان بهای تمام شده سرب کالای فروخته شده محاسبه می شود. مثال: شخصی روی یک آگهی خرید کلاه کلیک کرد و سپس همان کلاه و یک پیراهن را خرید. کلاه دارای بهای تمام شده کالای فروخته شده 3 دلار است، پیراهن دارای بهای تمام شده کالای فروخته شده 5 دلار است. هزینه سرب کالاهای فروخته شده برای این سفارش 3 دلار است. این معیار فقط در صورتی در دسترس است که تبدیل‌ها را با داده‌های سبد خرید گزارش دهید. این معیار یک ارزش پولی است و به صورت پیش‌فرض به واحد پول مشتری بازگردانده می‌شود. پارامتر metrics_currency را در https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause ببینید

lead_cost_of_goods_sold_micros

int64

هزینه سرب کالاهای فروخته شده (COGS) کل هزینه محصولات فروخته شده در نتیجه تبلیغات همان محصول است. چگونه کار می کند: شما تبدیل ها را با داده های سبد خرید برای خریدهای تکمیل شده در وب سایت خود گزارش می دهید. اگر تبلیغی که با آن تعامل داشته‌اید، محصول مرتبطی داشته باشد (به آگهی‌های خرید مراجعه کنید)، این محصول به عنوان محصول تبلیغ‌شده در نظر گرفته می‌شود. هر محصولی که در سفارشی که مشتری قرار می دهد گنجانده شود، محصول فروخته شده است. اگر محصولات تبلیغ شده و فروخته شده مطابقت داشته باشند، بهای تمام شده این کالاها تحت عنوان بهای تمام شده سرب کالای فروخته شده محاسبه می شود. مثال: شخصی روی یک آگهی خرید کلاه کلیک کرد و سپس همان کلاه و یک پیراهن را خرید. کلاه دارای بهای تمام شده کالای فروخته شده 3 دلار است، پیراهن دارای بهای تمام شده کالای فروخته شده 5 دلار است. هزینه سرب کالاهای فروخته شده برای این سفارش 3 دلار است. این معیار فقط در صورتی در دسترس است که تبدیل‌ها را با داده‌های سبد خرید گزارش دهید. این معیار یک ارزش پولی است و به صورت پیش‌فرض به واحد پول مشتری بازگردانده می‌شود. به پارامتر metrics_currency در https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause مراجعه کنید

client_account_lead_gross_profit_micros

int64

حساب مشتری سود ناخالص سود شما از محصولات فروخته شده در نتیجه تبلیغات همان محصول ، منهای هزینه کالاهای فروخته شده (COGS) است. نحوه عملکرد آن: شما تبدیل ها را با داده های سبد خرید برای خریدهای تکمیل شده در وب سایت خود گزارش می دهید. اگر تبلیغی که قبل از خرید با آن تعامل داشته باشد ، یک محصول مرتبط داشته باشد (به تبلیغات خرید مراجعه کنید) ، این محصول محصول تبلیغ شده در نظر گرفته می شود. هر محصولی که به ترتیب مشتری قرار می گیرد ، محصولی فروخته شده است. اگر محصولات تبلیغاتی و فروخته شده مطابقت داشته باشند ، پس از درآمد شما از این فروش منهای هزینه کالاهای فروخته شده سود ناخالص شما است. مثال: شخصی روی یک تبلیغ خرید برای کلاه کلیک کرد و سپس همان کلاه و پیراهن را خریداری کرد. این کلاه 10 دلار قیمت دارد و هزینه کالاهای فروخته شده 3 دلار را دارد. سود ناخالص این سفارش 7 دلار = 10 دلار - 3 دلار است. این متریک فقط در صورتی در دسترس است که تبدیل ها را با داده های سبد خرید گزارش می دهید. این متریک یک ارزش پولی است و به طور پیش فرض در ارز مشتری بازگردانده می شود. به پارامتر metrics_currency در https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause مراجعه کنید

lead_gross_profit_micros

int64

سود ناخالص سرب سود شما از محصولات فروخته شده در نتیجه تبلیغات همان محصول ، منهای هزینه کالاهای فروخته شده (COGS) است. نحوه عملکرد آن: شما تبدیل ها را با داده های سبد خرید برای خریدهای تکمیل شده در وب سایت خود گزارش می دهید. اگر تبلیغی که قبل از خرید با آن تعامل داشته باشد ، یک محصول مرتبط داشته باشد (به تبلیغات خرید مراجعه کنید) ، این محصول محصول تبلیغ شده در نظر گرفته می شود. هر محصولی که به ترتیب مشتری قرار می گیرد ، محصولی فروخته شده است. اگر محصولات تبلیغاتی و فروخته شده مطابقت داشته باشند ، پس از درآمد شما از این فروش منهای هزینه کالاهای فروخته شده سود ناخالص شما است. مثال: شخصی روی یک تبلیغ خرید برای کلاه کلیک کرد و سپس همان کلاه و پیراهن را خریداری کرد. این کلاه 10 دلار قیمت دارد و هزینه کالاهای فروخته شده 3 دلار را دارد. سود ناخالص این سفارش 7 دلار = 10 دلار - 3 دلار است. این متریک فقط در صورتی در دسترس است که تبدیل ها را با داده های سبد خرید گزارش می دهید. این متریک یک ارزش پولی است و به طور پیش فرض در ارز مشتری بازگردانده می شود. به پارامتر metrics_currency در https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause مراجعه کنید

client_account_lead_revenue_micros

int64

درآمد سرب حساب مشتری کل مبلغی است که شما از محصولات فروخته شده در نتیجه تبلیغات همان محصول ساخته اید. نحوه عملکرد آن: شما تبدیل ها را با داده های سبد خرید برای خریدهای تکمیل شده در وب سایت خود گزارش می دهید. اگر تبلیغی که قبل از خرید با آن تعامل داشته باشد ، یک محصول مرتبط داشته باشد (به تبلیغات خرید مراجعه کنید) ، این محصول محصول تبلیغ شده در نظر گرفته می شود. هر محصولی که به ترتیب مشتری قرار می گیرد ، محصولی فروخته شده است. اگر محصولات تبلیغاتی و فروخته شده مطابقت داشته باشند ، ارزش کل شما از فروش این محصولات با درآمد سرب نشان داده شده است. مثال: شخصی روی یک تبلیغ خرید برای کلاه کلیک کرد و سپس همان کلاه و پیراهن را خریداری کرد. این کلاه 10 دلار قیمت دارد و پیراهن 20 دلار قیمت دارد. درآمد سرب این سفارش 10 دلار است. این متریک فقط در صورتی در دسترس است که تبدیل ها را با داده های سبد خرید گزارش می دهید. این متریک یک ارزش پولی است و به طور پیش فرض در ارز مشتری بازگردانده می شود. به پارامتر metrics_currency در https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause مراجعه کنید

lead_revenue_micros

int64

درآمد سرب کل مبلغی است که شما از محصولات فروخته شده در نتیجه تبلیغات همان محصول ساخته اید. نحوه عملکرد آن: شما تبدیل ها را با داده های سبد خرید برای خریدهای تکمیل شده در وب سایت خود گزارش می دهید. اگر تبلیغی که قبل از خرید با آن تعامل داشته باشد ، یک محصول مرتبط داشته باشد (به تبلیغات خرید مراجعه کنید) ، این محصول محصول تبلیغ شده در نظر گرفته می شود. هر محصولی که به ترتیب مشتری قرار می گیرد ، محصولی فروخته شده است. اگر محصولات تبلیغاتی و فروخته شده مطابقت داشته باشند ، ارزش کل شما از فروش این محصولات با درآمد سرب نشان داده شده است. مثال: شخصی روی یک تبلیغ خرید برای کلاه کلیک کرد و سپس همان کلاه و پیراهن را خریداری کرد. این کلاه 10 دلار قیمت دارد و پیراهن 20 دلار قیمت دارد. درآمد سرب این سفارش 10 دلار است. این متریک فقط در صورتی در دسترس است که تبدیل ها را با داده های سبد خرید گزارش می دهید. این متریک یک ارزش پولی است و به طور پیش فرض در ارز مشتری بازگردانده می شود. به پارامتر metrics_currency در https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause مراجعه کنید

client_account_lead_units_sold

double

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

lead_units_sold

double

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

موبایل

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

فیلدها
app_id

string

مورد نیاز. رشته ای که منحصر به فرد یک برنامه تلفن همراه را مشخص می کند. این فقط باید شناسه بومی پلتفرم مانند "com.android.ebay" برای Android یا "12345689" برای iOS باشد.

app_store

MobileAppVendor

مورد نیاز. فروشگاه برنامه ای که این برنامه خاص را توزیع می کند.

درصد Cpc

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

فیلدها
cpc_bid_ceiling_micros

int64

حداکثر حد پیشنهاد که می تواند توسط استراتژی پیشنهاد تعیین شود. این یک فیلد اختیاری است که توسط تبلیغ کننده وارد شده و در Micros محلی مشخص شده است. توجه: یک مقدار صفر به همان روشی که BID_CEILING نامشخص است تفسیر می شود.

enhanced_cpc_enabled

bool

بسته به احتمال تبدیل ، پیشنهاد برای هر حراج را به سمت بالا یا رو به پایین تنظیم می کند. پیشنهادات فردی ممکن است از CPC_BID_CEILING_MICRO فراتر رود ، اما میانگین پیشنهاد برای یک کمپین نباید.

در زمان بندی در زمان بندی

تنظیمات برای مناقصه در زمان واقعی ، ویژگی ای که فقط برای کمپین های هدفمند شبکه تبادل آگهی موجود است.

فیلدها
opt_in

bool

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

SearchAds360expandedDynamicsearchAdinfo

یک آگهی جستجوی پویا گسترده.

فیلدها
description1

string

خط اول توضیحات تبلیغات.

description2

string

خط دوم توضیحات آگهی.

ad_tracking_id

int64

شناسه ردیابی آگهی.

SearchAds360expandedTextAdinfo

تبلیغات جستجو 360 آگهی متن گسترش یافته.

فیلدها
headline

string

تیتر تبلیغ.

headline2

string

عنوان دوم تبلیغ.

headline3

string

عنوان سوم تبلیغ.

description1

string

خط اول توضیحات تبلیغات.

description2

string

خط دوم توضیحات آگهی.

path1

string

متن ضمیمه شده به URL قابل مشاهده به صورت خودکار با تعیین کننده.

path2

string

متن ضمیمه شده به PATH1 با تعیین کننده.

ad_tracking_id

int64

شناسه ردیابی آگهی.

searchads360productadinfo

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

تبلیغات ADS 360 AD.

SearchAds360rounsivesearchAdinfo

تبلیغات جستجو 360 آگهی جستجوی پاسخگو.

فیلدها
headlines[]

AdTextAsset

لیست دارایی های متنی برای عناوین. هنگامی که تبلیغ در خدمت عناوین از این لیست انتخاب می شود.

descriptions[]

AdTextAsset

لیست دارایی های متنی برای توضیحات. هنگامی که تبلیغ در خدمت توضیحات از این لیست انتخاب می شود.

path1

string

متن ضمیمه شده به URL قابل مشاهده به صورت خودکار با تعیین کننده.

path2

string

متن ضمیمه شده به PATH1 با تعیین کننده.

ad_tracking_id

int64

شناسه ردیابی آگهی.

searchAds360TextAdinfo

تبلیغات جستجو 360 آگهی متن.

فیلدها
headline

string

تیتر تبلیغ.

description1

string

خط اول توضیحات تبلیغات.

description2

string

خط دوم توضیحات آگهی.

display_url

string

URL نمایش داده شده از تبلیغ.

display_mobile_url

string

URL موبایل نمایش داده شده از آگهی.

ad_tracking_id

int64

شناسه ردیابی آگهی.

بخش ها

قسمت های فقط بخش.

فیلدها
ad_network_type

AdNetworkType

نوع شبکه تبلیغاتی.

conversion_action_category

ConversionActionCategory

دسته اقدام تبدیل.

conversion_custom_dimensions[]

Value

ابعاد سفارشی تبدیل.

day_of_week

DayOfWeek

به عنوان مثال ، روز هفته ، دوشنبه.

device

Device

دستگاهی که معیارها در آن اعمال می شوند.

keyword

Keyword

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

product_channel

ProductChannel

کانال محصول.

product_channel_exclusivity

ProductChannelExclusivity

انحصار کانال محصول.

product_condition

ProductCondition

شرط محصول.

product_sold_condition

ProductCondition

شرط محصول فروخته شده.

raw_event_conversion_dimensions[]

Value

ابعاد تبدیل رویداد خام.

conversion_action

string

نام منبع عمل تبدیل.

conversion_action_name

string

نام اقدام تبدیل.

date

string

تاریخ استفاده از معیارها. فرمت YYYY-MM-DD ، به عنوان مثال ، 2018-04-17.

geo_target_city

string

نام منابع ثابت هدف GEO که نمایانگر یک شهر است.

geo_target_country

string

نام منابع ثابت هدف GEO که نمایانگر یک کشور است.

geo_target_metro

string

نام منابع ثابت هدف GEO که نشان دهنده یک مترو است.

geo_target_region

string

نام منابع ثابت هدف GEO که نشان دهنده یک منطقه است.

hour

int32

ساعت روز به عنوان تعداد بین 0 تا 23 ، فراگیر.

month

string

ماه که در تاریخ روز اول یک ماه نشان داده شده است. به عنوان yyyy-mm-dd فرمت شده است.

product_bidding_category_level1

string

دسته مناقصه (سطح 1) محصول.

product_bidding_category_level2

string

دسته مناقصه (سطح 2) محصول.

product_bidding_category_level3

string

دسته مناقصه (سطح 3) محصول.

product_bidding_category_level4

string

دسته مناقصه (سطح 4) محصول.

product_bidding_category_level5

string

دسته مناقصه (سطح 5) محصول.

product_brand

string

مارک محصول.

product_country

string

نام منابع هدف GEO برای کشور فروش محصول ثابت است.

product_custom_attribute0

string

ویژگی سفارشی 0 محصول.

product_custom_attribute1

string

ویژگی سفارشی 1 محصول.

product_custom_attribute2

string

ویژگی سفارشی 2 محصول.

product_custom_attribute3

string

ویژگی سفارشی 3 محصول.

product_custom_attribute4

string

ویژگی سفارشی 4 محصول.

product_item_id

string

شناسه مورد محصول.

product_language

string

نام منبع زبان ثابت برای زبان محصول.

product_sold_bidding_category_level1

string

دسته مناقصه (سطح 1) محصول فروخته شده.

product_sold_bidding_category_level2

string

دسته مناقصه (سطح 2) محصول فروخته شده.

product_sold_bidding_category_level3

string

دسته مناقصه (سطح 3) محصول فروخته شده.

product_sold_bidding_category_level4

string

دسته مناقصه (سطح 4) محصول فروخته شده.

product_sold_bidding_category_level5

string

دسته مناقصه (سطح 5) محصول فروخته شده.

product_sold_brand

string

مارک محصول فروخته شده.

product_sold_custom_attribute0

string

ویژگی سفارشی 0 محصول فروخته شده.

product_sold_custom_attribute1

string

ویژگی سفارشی 1 محصول فروخته شده.

product_sold_custom_attribute2

string

ویژگی سفارشی 2 محصول فروخته شده.

product_sold_custom_attribute3

string

ویژگی سفارشی 3 محصول فروخته شده.

product_sold_custom_attribute4

string

ویژگی سفارشی 4 محصول فروخته شده.

product_sold_item_id

string

شناسه مورد محصول فروخته شده.

product_sold_title

string

عنوان محصول فروخته شده.

product_sold_type_l1

string

نوع (سطح 1) محصول فروخته شده را تایپ کنید.

product_sold_type_l2

string

نوع (سطح 2) محصول فروخته شده را تایپ کنید.

product_sold_type_l3

string

نوع (سطح 3) محصول فروخته شده را تایپ کنید.

product_sold_type_l4

string

نوع (سطح 4) محصول فروخته شده.

product_sold_type_l5

string

نوع (سطح 5) محصول فروخته شده.

product_store_id

string

شناسه محصول را ذخیره کنید.

product_title

string

عنوان محصول.

product_type_l1

string

نوع (سطح 1) محصول را تایپ کنید.

product_type_l2

string

نوع (سطح 2) محصول.

product_type_l3

string

نوع (سطح 3) محصول.

product_type_l4

string

نوع (سطح 4) محصول.

product_type_l5

string

نوع (سطح 5) محصول.

quarter

string

سه ماهه که در تاریخ روز اول یک چهارم نشان داده شده است. به عنوان مثال ، از سال تقویم برای چهارم استفاده می کند ، به عنوان مثال ، سه ماهه دوم سال 2018 از 2018-04-01 آغاز می شود. به عنوان yyyy-mm-dd فرمت شده است.

week

string

هفته همانطور که دوشنبه تا یکشنبه تعریف شده است ، و تا تاریخ دوشنبه نشان داده شده است. به عنوان yyyy-mm-dd فرمت شده است.

year

int32

سال ، به عنوان yyyy.

asset_interaction_target

AssetInteractionTarget

فقط با معیارهای CustomerAsseSt ، CompunsaSset و AdGroupAsset استفاده می شود. نشان می دهد که آیا معیارهای تعامل بر روی خود دارایی یا یک دارایی متفاوت یا واحد تبلیغاتی رخ داده است. تعامل (به عنوان مثال ، کلیک) در تمام قسمتهای تبلیغاتی (به عنوان مثال ، خود تبلیغ و سایر اجزای مانند Sitelinks) در هنگام ارائه آنها به حساب می آیند. هنگامی که تعامل_ون_تیز_ست صحیح است ، به این معنی است که تعامل بر روی این دارایی خاص است و وقتی تعامل_ون_تیز_ است نادرست است ، به این معنی است که تعامل بر روی این دارایی خاص نیست بلکه در سایر قسمت های تبلیغاتی این دارایی با آن سرو می شود.

TargetCpa

یک استراتژی پیشنهادی خودکار که پیشنهاداتی را برای کمک به دستیابی به هرچه بیشتر تبدیل در هزینه هدف در هر منطقه (CPA) که تعیین کرده اید ، تعیین می کند.

فیلدها
target_cpa_micros

int64

هدف متوسط ​​CPA. این هدف باید بر اساس ارز برای حساب بیشتر یا مساوی با حداقل واحد قابل پرداخت باشد.

cpc_bid_ceiling_micros

int64

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

cpc_bid_floor_micros

int64

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

TargetCPM

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

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

هدف گیری

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

فیلدها
location

TargetImpressionShareLocation

مکان هدفمند در صفحه نتایج جستجو.

location_fraction_micros

int64

بخش انتخابی از تبلیغات که در مکان هدفمند در میکرو نشان داده می شود. به عنوان مثال ، 1 ٪ برابر با 10،000 است.

cpc_bid_ceiling_micros

int64

بالاترین پیشنهاد CPC سیستم مناقصه خودکار مجاز به مشخص کردن است. این یک زمینه مورد نیاز است که توسط تبلیغ کننده وارد شده است که سقف را تنظیم کرده و در MICRO های محلی مشخص شده است.

Targetoutrankshare

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

فیلدها
cpc_bid_ceiling_micros

Int64Value

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

هدف گیری

لیست تنظیمات هدفمند در هر هدف.

فیلدها
targeting_dimension

TargetingDimension

بعد هدفگذاری که این تنظیمات برای آن اعمال می شود.

bid_only

bool

نشان می دهد که آیا تبلیغات خود را محدود کنید تا فقط برای معیارهایی که برای این هدف قرار داده اید نشان دهید ، یا اینکه تمام مقادیر را برای این هدف قرار دهید تا هدف قرار دهید و تبلیغات را بر اساس هدفگذاری خود در سایر موارد هدفمند نشان دهید. مقدار true به این معنی است که این معیارها فقط اصلاح کننده های پیشنهاد را اعمال می کنند و بر هدف قرار نمی دهند. مقدار false به این معنی است که این معیارها هدف قرار دادن و همچنین استفاده از اصلاح کننده های پیشنهاد را محدود می کند.

TargetRoas

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

فیلدها
target_roas

double

مورد نیاز. درآمد انتخاب شده (بر اساس داده های تبدیل) در هر واحد هزینه. مقدار باید بین 0.01 تا 1000.0 باشد ، فراگیر.

cpc_bid_ceiling_micros

int64

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

cpc_bid_floor_micros

int64

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

هدف

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

فیلدها
target_spend_micros
(deprecated)

int64

کاهش یافته: هدف هزینه ای که برای حداکثر کلیک ها در آن قرار دارد. یک پیشنهاد دهنده Targetspend سعی خواهد کرد که کوچکتر از این ارزش یا مبلغ هزینه های طبیعی را خرج کند. اگر مشخص نشده باشد ، بودجه به عنوان هدف هزینه استفاده می شود. این قسمت مستهلک می شود و دیگر نباید مورد استفاده قرار گیرد. برای جزئیات بیشتر به https://ads-developers.googleblog.com/2020/05/reminder-about-sunset-creation-of.html مراجعه کنید.

cpc_bid_ceiling_micros

int64

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

هدف گیری

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

فیلدها
target_restrictions[]

TargetRestriction

تنظیم در هر هدف برای محدود کردن دسترسی به کمپین یا گروه تبلیغاتی شما.

TextAsset

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

فیلدها
text

string

محتوای متن دارایی متن.

TextLabel

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

فیلدها
background_color

string

رنگ پس زمینه برچسب در قالب hex. این رشته باید با عبارت معمولی مطابقت داشته باشد '^#([A-FA-F0-9] {6} | [A-FA-F0-9] {3}) $'. توجه: ممکن است رنگ پس زمینه برای حساب های مدیر قابل مشاهده نباشد.

description

string

شرح کوتاهی از برچسب. طول نباید بیش از 200 کاراکتر باشد.

یکپارچه

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

فیلدها
country_code

string

کد کشور دو حرف شماره تلفن. مثالها: "ما" ، "ما".

phone_number

string

شماره تلفن خام تبلیغ کننده. مثال: '1234567890' ، '(123) 456-7890'

call_conversion_reporting_state

CallConversionReportingState

نشان می دهد که آیا این Callasset باید از تنظیمات تبدیل تماس خود استفاده کند ، تنظیم سطح حساب را دنبال کنید یا تبدیل تماس را غیرفعال کنید.

call_conversion_action

string

اقدام تبدیل برای نسبت دادن یک تماس به. در صورت عدم تنظیم ، از عمل تبدیل پیش فرض استفاده می شود. این قسمت فقط در صورتی که call_conversion_reporting_state روی use_resource_level_call_conversion_action تنظیم شده باشد ، تأثیر دارد.

ad_schedule_targets[]

AdScheduleInfo

لیست برنامه های غیر همپوشانی که تمام فواصل زمانی را که ممکن است دارایی در آن باشد ، مشخص می کند. حداکثر 6 برنامه در روز وجود دارد ، در کل 42.

call_only

bool

این که آیا تماس فقط شماره تلفن را بدون پیوند به وب سایت نشان می دهد. برای تبلیغات مایکروسافت اعمال می شود.

call_tracking_enabled

bool

آیا تماس باید در ردیابی تماس فعال باشد. برای تبلیغات مایکروسافت اعمال می شود.

use_searcher_time_zone

bool

آیا می توان پسوند تماس را در منطقه زمانی کاربر جستجو نشان داد. برای تبلیغات مایکروسافت اعمال می شود.

start_date

string

تاریخ شروع زمانی که این دارایی مؤثر است و می تواند با فرمت YYYY-MM-DD شروع به خدمت کند.

end_date

string

آخرین تاریخ زمانی که این دارایی مؤثر است و هنوز هم در حال خدمت است ، در قالب YYYY-MM-DD.

یکپارچه

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

فیلدها
callout_text

string

متن فراخوانی طول این رشته باید بین 1 تا 25 باشد ، فراگیر.

start_date

string

تاریخ شروع زمانی که این دارایی مؤثر است و می تواند با فرمت YYYY-MM-DD شروع به خدمت کند.

end_date

string

آخرین تاریخ زمانی که این دارایی مؤثر است و هنوز هم در حال خدمت است ، در قالب YYYY-MM-DD.

ad_schedule_targets[]

AdScheduleInfo

لیست برنامه های غیر همپوشانی که تمام فواصل زمانی را که ممکن است دارایی در آن باشد ، مشخص می کند. حداکثر 6 برنامه در روز وجود دارد ، در کل 42.

use_searcher_time_zone

bool

آیا می توان دارایی را در منطقه زمانی کاربر جستجو نشان داد. برای تبلیغات مایکروسافت اعمال می شود.

یکپارچه یکپارچه

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

فیلدها
place_id

string

شناسه های منحصر به فرد مکانی را در پایگاه داده Google Places و در Google Maps قرار دهید. این قسمت برای شناسه مشتری خاص و نوع دارایی بی نظیر است. برای کسب اطلاعات بیشتر در مورد شناسه مکان ، به https://developers.google.com/places/web-service/place-id مراجعه کنید.

business_profile_locations[]

BusinessProfileLocation

لیست مکان های تجاری برای مشتری. این تنها درصورتی بازگردانده می شود که دارایی مکان از حساب پروفایل تجاری همگام سازی شود. می توان چندین لیست پروفایل تجاری را تحت همان حساب که به همان شناسه مکان اشاره دارد ، داشته باشید.

location_ownership_type

LocationOwnershipType

نوع مالکیت مکان. اگر این نوع Business_owner باشد ، به عنوان یک برنامه افزودنی محل خدمت می شود. اگر نوع وابسته باشد ، به عنوان یک مکان وابسته خدمت می شود.

یکپارچه

یک دارایی یک صفحه یکپارچه.

فیلدها
page_url

string

صفحه وب که تبلیغ کنندگان می خواهند هدف قرار دهند.

labels[]

string

برچسب های مورد استفاده برای گروه بندی URL های صفحه.

unifiedSitelinkAsset

یک دارایی یکپارچه Sitelink.

فیلدها
description1

string

خط اول توضیحات برای Sitelink. در صورت تنظیم ، طول باید بین 1 تا 35 باشد ، فراگیر و توضیحات 2 نیز باید تنظیم شود.

description2

string

خط دوم توضیحات برای Sitelink. در صورت تنظیم ، طول باید بین 1 تا 35 باشد ، فراگیر و توضیحات 1 نیز باید تنظیم شود.

start_date

string

تاریخ شروع زمانی که این دارایی مؤثر است و می تواند با فرمت YYYY-MM-DD شروع به خدمت کند.

end_date

string

آخرین تاریخ زمانی که این دارایی مؤثر است و هنوز هم در حال خدمت است ، در قالب YYYY-MM-DD.

ad_schedule_targets[]

AdScheduleInfo

لیست برنامه های غیر همپوشانی که تمام فواصل زمانی را که ممکن است دارایی در آن باشد ، مشخص می کند. حداکثر 6 برنامه در روز وجود دارد ، در کل 42.

tracking_id

int64

شناسه برای ردیابی کلیک برای دارایی SiteLink استفاده می شود. این یک یاهو است! فقط میدان ژاپن.

use_searcher_time_zone

bool

آیا می توان دارایی SiteLink را در منطقه زمانی کاربر جستجو نشان داد. برای تبلیغات مایکروسافت اعمال می شود.

mobile_preferred

bool

این که آیا ترجیح این است که دارایی Sitelink در دستگاه های تلفن همراه نمایش داده شود. برای تبلیغات مایکروسافت اعمال می شود.

userlistinfo

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

فیلدها
user_list

string

نام منابع لیست کاربر.

ارزش

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

فیلدها
value میدان اتحادیه. یک مقدار value فقط می تواند یکی از موارد زیر باشد:
boolean_value

bool

یک بولی

int64_value

int64

int64.

float_value

float

یک شناور

double_value

double

یک دوتایی

string_value

string

یک رشته

صفحه اصلی

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

فیلدها
operand

WebpageConditionOperand

عملکرد هدف قرار دادن صفحه وب.

operator

WebpageConditionOperator

اپراتور وضعیت هدف قرار دادن صفحه.

argument

string

استدلال وضعیت هدف گذاری صفحه وب.

صفحه وب

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

فیلدها
conditions[]

WebpageConditionInfo

شرایط یا عبارات منطقی برای هدف قرار دادن صفحه وب. لیست شرایط هدف گذاری صفحه وب هنگام ارزیابی برای هدف قرار دادن ، با هم جمع می شوند. لیست خالی از شرایط نشان می دهد که تمام صفحات وب سایت کمپین مورد هدف قرار گرفته است.

این قسمت برای ایجاد عملیات مورد نیاز است و در عملیات به روزرسانی ممنوع است.

coverage_percentage

double

درصد پوشش معیارهای وب سایت. این درصد محاسبه شده از پوشش وب سایت بر اساس هدف وب سایت ، هدف منفی وب سایت و کلمات کلیدی منفی در گروه تبلیغات و کمپین است. به عنوان مثال ، هنگامی که پوشش به عنوان 1 باز می گردد ، نشان می دهد که 100 ٪ پوشش دارد. این قسمت فقط خواندنی است.

criterion_name

string

نام معیاری که توسط این پارامتر تعریف شده است. از مقدار نام برای شناسایی ، مرتب سازی و معیارهای فیلتر با این نوع پارامترها استفاده می شود.

این قسمت برای ایجاد عملیات مورد نیاز است و در عملیات به روزرسانی ممنوع است.

YouTubeVideoAsset

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

فیلدها
youtube_video_title

string

عنوان ویدیوی YouTube.

youtube_video_id

string

شناسه ویدیوی YouTube. این 11 مقدار رشته کاراکتر است که در URL ویدیوی YouTube استفاده می شود.

،

شاخص

adscheduleinfo

معیار adschedule را نشان می دهد.

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

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

فیلدها
start_minute

MinuteOfHour

دقایقی بعد از ساعت شروع که این برنامه شروع می شود.

این قسمت برای ایجاد عملیات مورد نیاز است و در عملیات به روزرسانی ممنوع است.

end_minute

MinuteOfHour

دقایقی بعد از ساعت پایان که این برنامه به پایان می رسد. برنامه منحصر به فرد از دقیقه پایان است.

این قسمت برای ایجاد عملیات مورد نیاز است و در عملیات به روزرسانی ممنوع است.

day_of_week

DayOfWeek

روز هفته برنامه مربوط می شود.

این قسمت برای ایجاد عملیات مورد نیاز است و در عملیات به روزرسانی ممنوع است.

start_hour

int32

ساعت شروع در زمان 24 ساعت. این قسمت باید بین 0 تا 23 باشد ، فراگیر.

این قسمت برای ایجاد عملیات مورد نیاز است و در عملیات به روزرسانی ممنوع است.

end_hour

int32

ساعت پایان در زمان 24 ساعت ؛ 24 نشانگر پایان روز است. این قسمت باید بین 0 تا 24 باشد ، فراگیر.

این قسمت برای ایجاد عملیات مورد نیاز است و در عملیات به روزرسانی ممنوع است.

یدکست

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

فیلدها
text

string

متن دارایی

alerangeinfo

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

فیلدها
type

AgeRangeType

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

دارایی

یک بخش AssetInteractionTarget.

فیلدها
asset

string

نام منابع دارایی.

interaction_on_this_asset

bool

فقط با معیارهای CustomerAsseSt ، CompunsaSset و AdGroupAsset استفاده می شود. نشان می دهد که آیا معیارهای تعامل بر روی خود دارایی یا یک دارایی متفاوت یا واحد تبلیغاتی رخ داده است.

دارایی

حاوی اطلاعات استفاده از دارایی است.

فیلدها
asset

string

نام منابع دارایی.

served_asset_field_type

ServedAssetFieldType

نوع میدان خدمت دارایی.

مخاطبان

معیار مخاطبان.

فیلدها
audience

string

نام منابع مخاطب.

تجارت

داده های مکان مشخصات کسب و کار از حساب پروفایل کسب و کار پیوند یافته همگام سازی شده است.

فیلدها
labels[]

string

تبلیغ کننده برچسب مشخص شده برای مکان در حساب پروفایل تجاری. این از حساب پروفایل تجاری همگام سازی شده است.

store_code

string

کد فروشگاه پروفایل تجاری این مکان. این از حساب پروفایل تجاری همگام سازی شده است.

listing_id

int64

شناسه لیست این مکان پروفایل تجاری. این از حساب پروفایل کسب و کار مرتبط است.

calltoactionasset

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

فیلدها
call_to_action

CallToActionType

فراخوان به اقدام.

سفارشی

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

فیلدها
key

string

کلیدی مطابق با نام برچسب پارامتر.

value

string

مقدار جایگزین

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

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

فیلدها
type

Device

نوع دستگاه

EnhancedCpc

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

یک استراتژی خودکار مناقصه که پیشنهاداتی را برای کلیک هایی ایجاد می کند که به نظر می رسد بیشتر منجر به تبدیل می شوند و آنها را برای کلیک هایی که به نظر می رسد کمتر است ، پایین می آورد.

این استراتژی مناقصه مستهلک می شود و دیگر نمی توان ایجاد کرد. برای عملکرد معادل آن از manualcpc با Edvanced_cpc_enabled استفاده کنید.

فرکانس

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

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

جنس جنسیت

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

فیلدها
type

GenderType

نوع جنسیت.

تصویر

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

فیلدها
mime_type

MimeType

نوع MIME دارایی تصویر.

full_size

ImageDimension

ابرداده برای این تصویر در اندازه اصلی آن.

file_size

int64

اندازه پرونده دارایی تصویر در بایت.

تصویر

ابرداده برای یک تصویر در اندازه خاص ، یا اصلی یا اندازه گیری شده.

فیلدها
height_pixels

int64

ارتفاع تصویر.

width_pixels

int64

عرض تصویر.

url

string

URL که تصویر را با این ارتفاع و عرض برمی گرداند.

کلمه کلیدی

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

فیلدها
info

KeywordInfo

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

ad_group_criterion

string

نام منبع AdGroupCriterion.

کلمه کلیدی

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

فیلدها
match_type

KeywordMatchType

نوع مسابقه کلمه کلیدی.

text

string

متن کلمه کلیدی (حداکثر 80 کاراکتر و 10 کلمه).

زبان

یک معیار زبان.

فیلدها
language_constant

string

نام منبع ثابت زبان.

ListingGroupInfo

معیار گروه لیست.

فیلدها
type

ListingGroupType

نوع گروه لیست.

موقعیت مکانی

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

فیلدها
geo_target_constants[]

string

GEO ثابت (های) هدف محدود کننده دامنه منطقه جغرافیایی در خوراک. در حال حاضر فقط یک ثابت هدف GEO مجاز است.

radius_units

LocationGroupRadiusUnits

واحد شعاع. مایل و متر برای ثابت های هدف GEO پشتیبانی می شوند. مایل و متر برای مجموعه های مورد تغذیه پشتیبانی می شود. این مورد نیاز است و باید در ایجاد عملیات تنظیم شود.

feed_item_sets[]

string

تغذیه ای که فیدیم ها مورد هدف قرار می گیرند. اگر چندین شناسه مشخص شده باشد ، تمام مواردی که حداقل در یک مجموعه ظاهر می شوند هدف قرار می گیرند. این قسمت با GEO_TARGET_CONSTANTS قابل استفاده نیست. این اختیاری است و فقط می تواند در ایجاد عملیات تنظیم شود.

radius

int64

فاصله در واحدهایی که شعاع اطراف مکان های هدفمند را مشخص می کند. این مورد نیاز است و باید در ایجاد عملیات تنظیم شود.

LocationInfo

یک معیار مکان

فیلدها
geo_target_constant

string

نام منبع ثابت GEO.

manualcpa

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

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

ManualCpc

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

فیلدها
enhanced_cpc_enabled

bool

این که آیا پیشنهادات بر اساس داده های بهینه ساز تبدیل می شوند.

ManualCpm

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

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

حداکثر

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

فیلدها
cpc_bid_ceiling_micros

int64

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

cpc_bid_floor_micros

int64

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

target_roas

double

گزینه Return On Ad Devent (ROAS) گزینه. در صورت تنظیم ، استراتژی پیشنهاد در حالی که میانگین بازده هدف در تبلیغات را دارد ، درآمد را به حداکثر می رساند. اگر ROAS هدف بالا باشد ، ممکن است استراتژی پیشنهاد نتواند بودجه کامل را خرج کند. اگر ROA های هدف تعیین نشده باشد ، استراتژی پیشنهاد برای دستیابی به بالاترین ROAS ممکن برای بودجه خواهد بود.

حداکثر

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

فیلدها
cpc_bid_ceiling_micros

int64

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

cpc_bid_floor_micros

int64

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

target_cpa_micros

int64

گزینه Cost-Action Target (CPA). این میانگین مبلغی است که شما می خواهید در هر اقدام تبدیل شده در واحدهای خرد از ارز استراتژی مناقصه هزینه کنید. در صورت تنظیم ، استراتژی پیشنهاد هرچه بیشتر ممکن است در هر یا پایین تر از هزینه هر عمل در هر عمل دریافت کند. اگر CPA هدف تعیین نشده باشد ، استراتژی پیشنهاد برای دستیابی به کمترین CPA ممکن با توجه به بودجه خواهد بود.

معیارها

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

فیلدها
all_conversions_value_by_conversion_date

double

ارزش همه تبدیل ها. هنگامی که این ستون با تاریخ انتخاب می شود ، مقادیر ستون تاریخ به معنای تاریخ تبدیل است. جزئیات مربوط به ستون های by_conversion_date در https://support.google.com/sa360/answer/9250611 در دسترس است.

all_conversions_by_conversion_date

double

تعداد کل تبدیل ها. این شامل تمام تبدیل ها بدون در نظر گرفتن مقدار شامل_ین_کونسورها_متریک است. هنگامی که این ستون با تاریخ انتخاب می شود ، مقادیر ستون تاریخ به معنای تاریخ تبدیل است. جزئیات مربوط به ستون های by_conversion_date در https://support.google.com/sa360/answer/9250611 در دسترس است.

conversion_custom_metrics[]

Value

معیارهای سفارشی تبدیل.

conversions_value_by_conversion_date

double

مبلغ تبدیل قابل تبدیل به تاریخ تبدیل. هنگامی که این ستون با تاریخ انتخاب می شود ، مقادیر ستون تاریخ به معنای تاریخ تبدیل است.

conversions_by_conversion_date

double

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

historical_creative_quality_score

QualityScoreBucket

نمره کیفیت تاریخی خلاق.

historical_landing_page_quality_score

QualityScoreBucket

کیفیت تجربه صفحه فرود تاریخی.

historical_search_predicted_ctr

QualityScoreBucket

جستجوی تاریخی پیش بینی شده با کلیک از طریق نرخ (CTR).

interaction_event_types[]

InteractionEventType

انواع تعامل قابل پرداخت و رایگان.

raw_event_conversion_metrics[]

Value

معیارهای تبدیل رویداد خام.

absolute_top_impression_percentage

double

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

all_conversions_from_interactions_rate

double

تمام تبدیل ها از تعامل (در مقابل مشاهده از طریق تبدیل) تقسیم بر تعداد تعامل AD.

all_conversions_value

double

ارزش همه تبدیل ها.

all_conversions

double

تعداد کل تبدیل ها. این شامل تمام تبدیل ها بدون در نظر گرفتن مقدار شامل_ین_کونسورها_متریک است.

all_conversions_value_per_cost

double

ارزش کلیه تبدیل های تقسیم شده بر کل هزینه تعامل AD (مانند کلیک برای تبلیغات متنی یا نمایش برای تبلیغات ویدیویی).

all_conversions_from_click_to_call

double

تعداد دفعاتی که مردم روی دکمه "تماس" کلیک می کردند تا در حین یا بعد از کلیک بر روی یک آگهی با یک فروشگاه تماس بگیرند. این شماره شامل اتصال یا عدم تماس یا مدت زمان تماس نیست.

این متریک فقط برای موارد خوراک اعمال می شود.

all_conversions_from_directions

double

تعداد دفعاتی که مردم روی دکمه "Get Directions" کلیک کردند تا بعد از کلیک بر روی یک آگهی به یک فروشگاه حرکت کنند.

این متریک فقط برای موارد خوراک اعمال می شود.

all_conversions_from_interactions_value_per_interaction

double

مقدار کلیه تبدیل ها از تعامل تقسیم بر تعداد کل تعامل ها.

all_conversions_from_menu

double

تعداد دفعاتی که مردم پس از کلیک بر روی یک آگهی ، روی یک لینک کلیک کردند تا منوی فروشگاه را مشاهده کنند.

این متریک فقط برای موارد خوراک اعمال می شود.

all_conversions_from_order

double

تعداد دفعاتی که مردم بعد از کلیک بر روی یک آگهی ، سفارش را در یک فروشگاه قرار داده اند.

این متریک فقط برای موارد خوراک اعمال می شود.

all_conversions_from_other_engagement

double

تعداد سایر تبدیل ها (به عنوان مثال ، ارسال یک بررسی یا صرفه جویی در مکان برای یک فروشگاه) که پس از کلیک افراد در یک آگهی رخ داده است.

این متریک فقط برای موارد خوراک اعمال می شود.

all_conversions_from_store_visit

double

تعداد تخمین زده شده تعداد دفعاتی که مردم پس از کلیک بر روی یک آگهی از یک فروشگاه بازدید کرده اند.

این متریک فقط برای موارد خوراک اعمال می شود.

visits

double

Clicks that Search Ads 360 has successfully recorded and forwarded to an advertiser's landing page.

all_conversions_from_store_website

double

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

double

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

double

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

double

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

int64

The number of clicks.

content_budget_lost_impression_share

double

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

double

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

double

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

double

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

double

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

double

The value of biddable conversion divided by the total cost of conversion eligible interactions.

conversions_from_interactions_value_per_interaction

double

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

double

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

int64

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

double

The cost of ad interactions divided by all conversions.

cost_per_conversion

double

Average conversion eligible cost per biddable conversion.

cost_per_current_model_attributed_conversion

double

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

double

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

double

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

double

The sum of the value of cross-device conversions.

cross_device_conversions_value_by_conversion_date

double

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

double

The number of clicks your ad receives (Clicks) divided by the number of times your ad is shown (Impressions).

conversions

double

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

double

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

double

The average quality score.

historical_quality_score

int64

The historical quality score.

impressions

int64

Count of how often your ad has appeared on a search results page or website on the Google Network.

interaction_rate

double

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

int64

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

double

The percentage of clicks filtered out of your total number of clicks (filtered + non-filtered clicks) during the reporting period.

invalid_clicks

int64

Number of clicks Google considers illegitimate and doesn't charge you for.

general_invalid_click_rate

double

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

int64

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

double

The percentage of mobile clicks that go to a mobile-friendly page.

search_absolute_top_impression_share

double

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

double

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

double

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

double

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

double

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

double

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

double

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

double

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

double

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

double

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

double

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

double

The percent of your ad impressions that are shown adjacent to the top organic search results.

value_per_all_conversions

double

The value of all conversions divided by the number of all conversions.

value_per_all_conversions_by_conversion_date

double

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

double

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

double

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

int64

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

int64

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

int64

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

int64

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

int64

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

int64

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

int64

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

double

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

double

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

int64

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

int64

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

int64

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

int64

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

int64

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

int64

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

double

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

double

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

string

مورد نیاز. 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

MobileAppVendor

مورد نیاز. 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

int64

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

bool

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

bool

Whether the campaign is opted in to real-time bidding.

SearchAds360ExpandedDynamicSearchAdInfo

An expanded dynamic search ad.

فیلدها
description1

string

The first line of the ad's description.

description2

string

The second line of the ad's description.

ad_tracking_id

int64

The tracking id of the ad.

SearchAds360ExpandedTextAdInfo

A Search Ads 360 expanded text ad.

فیلدها
headline

string

The headline of the ad.

headline2

string

The second headline of the ad.

headline3

string

The third headline of the ad.

description1

string

The first line of the ad's description.

description2

string

The second line of the ad's description.

path1

string

Text appended to the auto-generated visible URL with a delimiter.

path2

string

Text appended to path1 with a delimiter.

ad_tracking_id

int64

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[]

AdTextAsset

List of text assets for headlines. When the ad serves the headlines will be selected from this list.

descriptions[]

AdTextAsset

List of text assets for descriptions. When the ad serves the descriptions will be selected from this list.

path1

string

Text appended to the auto-generated visible URL with a delimiter.

path2

string

Text appended to path1 with a delimiter.

ad_tracking_id

int64

The tracking id of the ad.

SearchAds360TextAdInfo

A Search Ads 360 text ad.

فیلدها
headline

string

The headline of the ad.

description1

string

The first line of the ad's description.

description2

string

The second line of the ad's description.

display_url

string

The displayed URL of the ad.

display_mobile_url

string

The displayed mobile URL of the ad.

ad_tracking_id

int64

The tracking id of the ad.

بخش ها

Segment only fields.

فیلدها
ad_network_type

AdNetworkType

Ad network type.

conversion_action_category

ConversionActionCategory

Conversion action category.

conversion_custom_dimensions[]

Value

The conversion custom dimensions.

day_of_week

DayOfWeek

Day of the week, for example, MONDAY.

device

Device

Device to which metrics apply.

keyword

Keyword

Keyword criterion.

product_channel

ProductChannel

Channel of the product.

product_channel_exclusivity

ProductChannelExclusivity

Channel exclusivity of the product.

product_condition

ProductCondition

Condition of the product.

product_sold_condition

ProductCondition

Condition of the product sold.

raw_event_conversion_dimensions[]

Value

The raw event conversion dimensions.

conversion_action

string

Resource name of the conversion action.

conversion_action_name

string

Conversion action name.

date

string

Date to which metrics apply. yyyy-MM-dd format, for example, 2018-04-17.

geo_target_city

string

Resource name of the geo target constant that represents a city.

geo_target_country

string

Resource name of the geo target constant that represents a country.

geo_target_metro

string

Resource name of the geo target constant that represents a metro.

geo_target_region

string

Resource name of the geo target constant that represents a region.

hour

int32

Hour of day as a number between 0 and 23, inclusive.

month

string

Month as represented by the date of the first day of a month. Formatted as yyyy-MM-dd.

product_bidding_category_level1

string

Bidding category (level 1) of the product.

product_bidding_category_level2

string

Bidding category (level 2) of the product.

product_bidding_category_level3

string

Bidding category (level 3) of the product.

product_bidding_category_level4

string

Bidding category (level 4) of the product.

product_bidding_category_level5

string

Bidding category (level 5) of the product.

product_brand

string

Brand of the product.

product_country

string

Resource name of the geo target constant for the country of sale of the product.

product_custom_attribute0

string

Custom attribute 0 of the product.

product_custom_attribute1

string

Custom attribute 1 of the product.

product_custom_attribute2

string

Custom attribute 2 of the product.

product_custom_attribute3

string

Custom attribute 3 of the product.

product_custom_attribute4

string

Custom attribute 4 of the product.

product_item_id

string

Item ID of the product.

product_language

string

Resource name of the language constant for the language of the product.

product_sold_bidding_category_level1

string

Bidding category (level 1) of the product sold.

product_sold_bidding_category_level2

string

Bidding category (level 2) of the product sold.

product_sold_bidding_category_level3

string

Bidding category (level 3) of the product sold.

product_sold_bidding_category_level4

string

Bidding category (level 4) of the product sold.

product_sold_bidding_category_level5

string

Bidding category (level 5) of the product sold.

product_sold_brand

string

Brand of the product sold.

product_sold_custom_attribute0

string

Custom attribute 0 of the product sold.

product_sold_custom_attribute1

string

Custom attribute 1 of the product sold.

product_sold_custom_attribute2

string

Custom attribute 2 of the product sold.

product_sold_custom_attribute3

string

Custom attribute 3 of the product sold.

product_sold_custom_attribute4

string

Custom attribute 4 of the product sold.

product_sold_item_id

string

Item ID of the product sold.

product_sold_title

string

Title of the product sold.

product_sold_type_l1

string

Type (level 1) of the product sold.

product_sold_type_l2

string

Type (level 2) of the product sold.

product_sold_type_l3

string

Type (level 3) of the product sold.

product_sold_type_l4

string

Type (level 4) of the product sold.

product_sold_type_l5

string

Type (level 5) of the product sold.

product_store_id

string

Store ID of the product.

product_title

string

Title of the product.

product_type_l1

string

Type (level 1) of the product.

product_type_l2

string

Type (level 2) of the product.

product_type_l3

string

Type (level 3) of the product.

product_type_l4

string

Type (level 4) of the product.

product_type_l5

string

Type (level 5) of the product.

quarter

string

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

string

Week as defined as Monday through Sunday, and represented by the date of Monday. Formatted as yyyy-MM-dd.

year

int32

Year, formatted as yyyy.

asset_interaction_target

AssetInteractionTarget

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

int64

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

int64

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

int64

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.

TargetImpressionShare

An automated bidding strategy that sets bids so that a certain percentage of search ads are shown at the top of the first page (or other targeted location).

فیلدها
location

TargetImpressionShareLocation

The targeted location on the search results page.

location_fraction_micros

int64

The chosen fraction of ads to be shown in the targeted location in micros. For example, 1% equals 10,000.

cpc_bid_ceiling_micros

int64

The highest CPC bid the automated bidding system is permitted to specify. This is a required field entered by the advertiser that sets the ceiling and specified in local micros.

TargetOutrankShare

An automated bidding strategy that sets bids based on the target fraction of auctions where the advertiser should outrank a specific competitor. This strategy is deprecated.

فیلدها
cpc_bid_ceiling_micros

Int64Value

Maximum bid limit that can be set by the bid strategy. The limit applies to all keywords managed by the strategy.

TargetRestriction

The list of per-targeting-dimension targeting settings.

فیلدها
targeting_dimension

TargetingDimension

The targeting dimension that these settings apply to.

bid_only

bool

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 true means that these criteria will only apply bid modifiers, and not affect targeting. A value of false means that these criteria will restrict targeting as well as applying bid modifiers.

TargetRoas

An automated bidding strategy that helps you maximize revenue while averaging a specific target return on ad spend (ROAS).

فیلدها
target_roas

double

مورد نیاز. 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

int64

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

int64

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)

int64

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

int64

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[]

TargetRestriction

The per-targeting-dimension setting to restrict the reach of your campaign or ad group.

TextAsset

A Text asset.

فیلدها
text

string

Text content of the text asset.

TextLabel

A type of label displaying text on a colored background.

فیلدها
background_color

string

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

string

A short description of the label. The length must be no more than 200 characters.

UnifiedCallAsset

A unified call asset.

فیلدها
country_code

string

Two-letter country code of the phone number. Examples: 'US', 'us'.

phone_number

string

The advertiser's raw phone number. Examples: '1234567890', '(123)456-7890'

call_conversion_reporting_state

CallConversionReportingState

Indicates whether this CallAsset should use its own call conversion setting, follow the account level setting, or disable call conversion.

call_conversion_action

string

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[]

AdScheduleInfo

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

bool

Whether the call only shows the phone number without a link to the website. Applies to Microsoft Ads.

call_tracking_enabled

bool

Whether the call should be enabled on call tracking. Applies to Microsoft Ads.

use_searcher_time_zone

bool

Whether to show the call extension in search user's time zone. Applies to Microsoft Ads.

start_date

string

Start date of when this asset is effective and can begin serving, in yyyy-MM-dd format.

end_date

string

Last date of when this asset is effective and still serving, in yyyy-MM-dd format.

UnifiedCalloutAsset

A unified callout asset.

فیلدها
callout_text

string

The callout text. The length of this string should be between 1 and 25, inclusive.

start_date

string

Start date of when this asset is effective and can begin serving, in yyyy-MM-dd format.

end_date

string

Last date of when this asset is effective and still serving, in yyyy-MM-dd format.

ad_schedule_targets[]

AdScheduleInfo

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

bool

Whether to show the asset in search user's time zone. Applies to Microsoft Ads.

UnifiedLocationAsset

A unified location asset.

فیلدها
place_id

string

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[]

BusinessProfileLocation

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

LocationOwnershipType

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

string

The webpage that advertisers want to target.

labels[]

string

Labels used to group the page urls.

UnifiedSitelinkAsset

A unified sitelink asset.

فیلدها
description1

string

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

string

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

string

Start date of when this asset is effective and can begin serving, in yyyy-MM-dd format.

end_date

string

Last date of when this asset is effective and still serving, in yyyy-MM-dd format.

ad_schedule_targets[]

AdScheduleInfo

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

int64

ID used for tracking clicks for the sitelink asset. This is a Yahoo! Japan only field.

use_searcher_time_zone

bool

Whether to show the sitelink asset in search user's time zone. Applies to Microsoft Ads.

mobile_preferred

bool

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

string

The User List resource name.

ارزش

A generic data container.

فیلدها
Union field value . A value. value can be only one of the following:
boolean_value

bool

یک بولی

int64_value

int64

An int64.

float_value

float

A float.

double_value

double

یک دوتایی

string_value

string

یک رشته

WebpageConditionInfo

Logical expression for targeting webpages of an advertiser's website.

فیلدها
operand

WebpageConditionOperand

Operand of webpage targeting condition.

operator

WebpageConditionOperator

Operator of webpage targeting condition.

argument

string

Argument of webpage targeting condition.

WebpageInfo

Represents a criterion for targeting webpages of an advertiser's website.

فیلدها
conditions[]

WebpageConditionInfo

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

double

Website criteria coverage percentage. This is the computed percentage of website coverage based on the website target, negative website target and negative keywords in the ad group and campaign. For instance, when coverage returns as 1, it indicates it has 100% coverage. This field is read-only.

criterion_name

string

The name of the criterion that is defined by this parameter. The name value will be used for identifying, sorting and filtering criteria with this type of parameters.

This field is required for CREATE operations and is prohibited on UPDATE operations.

YoutubeVideoAsset

A YouTube asset.

فیلدها
youtube_video_title

string

YouTube video title.

youtube_video_id

string

YouTube video id. This is the 11 character string value used in the YouTube video URL.

،

شاخص

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

MinuteOfHour

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

MinuteOfHour

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

DayOfWeek

Day of the week the schedule applies to.

This field is required for CREATE operations and is prohibited on UPDATE operations.

start_hour

int32

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

int32

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

string

Asset text.

AgeRangeInfo

An age range criterion.

فیلدها
type

AgeRangeType

Type of the age range.

AssetInteractionTarget

An AssetInteractionTarget segment.

فیلدها
asset

string

The asset resource name.

interaction_on_this_asset

bool

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

string

Resource name of the asset.

served_asset_field_type

ServedAssetFieldType

The served field type of the asset.

AudienceInfo

An audience criterion.

فیلدها
audience

string

The Audience resource name.

BusinessProfileLocation

Business Profile location data synced from the linked Business Profile account.

فیلدها
labels[]

string

Advertiser specified label for the location on the Business Profile account. This is synced from the Business Profile account.

store_code

string

Business Profile store code of this location. This is synced from the Business Profile account.

listing_id

int64

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

CallToActionType

فراخوان به اقدام.

CustomParameter

A mapping that can be used by custom parameter tags in a tracking_url_template , final_urls , or mobile_final_urls .

فیلدها
key

string

The key matching the parameter tag name.

value

string

The value to be substituted.

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

A device criterion.

فیلدها
type

Device

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

GenderType

Type of the gender.

ImageAsset

An Image asset.

فیلدها
mime_type

MimeType

MIME type of the image asset.

full_size

ImageDimension

Metadata for this image at its original size.

file_size

int64

File size of the image asset in bytes.

ImageDimension

Metadata for an image at a certain size, either original or resized.

فیلدها
height_pixels

int64

Height of the image.

width_pixels

int64

Width of the image.

url

string

A URL that returns the image with this height and width.

کلمه کلیدی

A Keyword criterion segment.

فیلدها
info

KeywordInfo

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

ad_group_criterion

string

The AdGroupCriterion resource name.

KeywordInfo

A keyword criterion.

فیلدها
match_type

KeywordMatchType

The match type of the keyword.

text

string

The text of the keyword (at most 80 characters and 10 words).

LanguageInfo

A language criterion.

فیلدها
language_constant

string

The language constant resource name.

ListingGroupInfo

A listing group criterion.

فیلدها
type

ListingGroupType

Type of the listing group.

LocationGroupInfo

A radius around a list of locations specified through a feed.

فیلدها
geo_target_constants[]

string

Geo target constant(s) restricting the scope of the geographic area within the feed. Currently only one geo target constant is allowed.

radius_units

LocationGroupRadiusUnits

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[]

string

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

int64

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

string

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

bool

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

int64

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

int64

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

double

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

int64

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

int64

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

int64

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

double

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

double

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[]

Value

The conversion custom metrics.

conversions_value_by_conversion_date

double

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

double

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

QualityScoreBucket

The creative historical quality score.

historical_landing_page_quality_score

QualityScoreBucket

The quality of historical landing page experience.

historical_search_predicted_ctr

QualityScoreBucket

The historical search predicted click through rate (CTR).

interaction_event_types[]

InteractionEventType

The types of payable and free interactions.

raw_event_conversion_metrics[]

Value

The raw event conversion metrics.

absolute_top_impression_percentage

double

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

double

All conversions from interactions (as oppose to view through conversions) divided by the number of ad interactions.

all_conversions_value

double

The value of all conversions.

all_conversions

double

The total number of conversions. This includes all conversions regardless of the value of include_in_conversions_metric.

all_conversions_value_per_cost

double

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

double

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

double

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

double

The value of all conversions from interactions divided by the total number of interactions.

all_conversions_from_menu

double

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

double

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

double

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

double

Estimated number of times people visited a store after clicking an ad.

This metric applies to feed items only.

visits

double

Clicks that Search Ads 360 has successfully recorded and forwarded to an advertiser's landing page.

all_conversions_from_store_website

double

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

double

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

double

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

double

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

int64

The number of clicks.

content_budget_lost_impression_share

double

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

double

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

double

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

double

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

double

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

double

The value of biddable conversion divided by the total cost of conversion eligible interactions.

conversions_from_interactions_value_per_interaction

double

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

double

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

int64

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

double

The cost of ad interactions divided by all conversions.

cost_per_conversion

double

Average conversion eligible cost per biddable conversion.

cost_per_current_model_attributed_conversion

double

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

double

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

double

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

double

The sum of the value of cross-device conversions.

cross_device_conversions_value_by_conversion_date

double

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

double

The number of clicks your ad receives (Clicks) divided by the number of times your ad is shown (Impressions).

conversions

double

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

double

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

double

The average quality score.

historical_quality_score

int64

The historical quality score.

impressions

int64

Count of how often your ad has appeared on a search results page or website on the Google Network.

interaction_rate

double

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

int64

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

double

The percentage of clicks filtered out of your total number of clicks (filtered + non-filtered clicks) during the reporting period.

invalid_clicks

int64

Number of clicks Google considers illegitimate and doesn't charge you for.

general_invalid_click_rate

double

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

int64

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

double

The percentage of mobile clicks that go to a mobile-friendly page.

search_absolute_top_impression_share

double

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

double

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

double

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

double

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

double

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

double

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

double

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

double

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

double

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

double

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

double

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

double

The percent of your ad impressions that are shown adjacent to the top organic search results.

value_per_all_conversions

double

The value of all conversions divided by the number of all conversions.

value_per_all_conversions_by_conversion_date

double

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

double

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

double

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

int64

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

int64

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

int64

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

int64

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

int64

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

int64

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

int64

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

double

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

double

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

int64

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

int64

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

int64

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

int64

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

int64

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

int64

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

double

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

double

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

string

مورد نیاز. 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

MobileAppVendor

مورد نیاز. 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

int64

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

bool

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

bool

Whether the campaign is opted in to real-time bidding.

SearchAds360ExpandedDynamicSearchAdInfo

An expanded dynamic search ad.

فیلدها
description1

string

The first line of the ad's description.

description2

string

The second line of the ad's description.

ad_tracking_id

int64

The tracking id of the ad.

SearchAds360ExpandedTextAdInfo

A Search Ads 360 expanded text ad.

فیلدها
headline

string

The headline of the ad.

headline2

string

The second headline of the ad.

headline3

string

The third headline of the ad.

description1

string

The first line of the ad's description.

description2

string

The second line of the ad's description.

path1

string

Text appended to the auto-generated visible URL with a delimiter.

path2

string

Text appended to path1 with a delimiter.

ad_tracking_id

int64

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[]

AdTextAsset

List of text assets for headlines. When the ad serves the headlines will be selected from this list.

descriptions[]

AdTextAsset

List of text assets for descriptions. When the ad serves the descriptions will be selected from this list.

path1

string

Text appended to the auto-generated visible URL with a delimiter.

path2

string

Text appended to path1 with a delimiter.

ad_tracking_id

int64

The tracking id of the ad.

SearchAds360TextAdInfo

A Search Ads 360 text ad.

فیلدها
headline

string

The headline of the ad.

description1

string

The first line of the ad's description.

description2

string

The second line of the ad's description.

display_url

string

The displayed URL of the ad.

display_mobile_url

string

The displayed mobile URL of the ad.

ad_tracking_id

int64

The tracking id of the ad.

بخش ها

Segment only fields.

فیلدها
ad_network_type

AdNetworkType

Ad network type.

conversion_action_category

ConversionActionCategory

Conversion action category.

conversion_custom_dimensions[]

Value

The conversion custom dimensions.

day_of_week

DayOfWeek

Day of the week, for example, MONDAY.

device

Device

Device to which metrics apply.

keyword

Keyword

Keyword criterion.

product_channel

ProductChannel

Channel of the product.

product_channel_exclusivity

ProductChannelExclusivity

Channel exclusivity of the product.

product_condition

ProductCondition

Condition of the product.

product_sold_condition

ProductCondition

Condition of the product sold.

raw_event_conversion_dimensions[]

Value

The raw event conversion dimensions.

conversion_action

string

Resource name of the conversion action.

conversion_action_name

string

Conversion action name.

date

string

Date to which metrics apply. yyyy-MM-dd format, for example, 2018-04-17.

geo_target_city

string

Resource name of the geo target constant that represents a city.

geo_target_country

string

Resource name of the geo target constant that represents a country.

geo_target_metro

string

Resource name of the geo target constant that represents a metro.

geo_target_region

string

Resource name of the geo target constant that represents a region.

hour

int32

Hour of day as a number between 0 and 23, inclusive.

month

string

Month as represented by the date of the first day of a month. Formatted as yyyy-MM-dd.

product_bidding_category_level1

string

Bidding category (level 1) of the product.

product_bidding_category_level2

string

Bidding category (level 2) of the product.

product_bidding_category_level3

string

Bidding category (level 3) of the product.

product_bidding_category_level4

string

Bidding category (level 4) of the product.

product_bidding_category_level5

string

Bidding category (level 5) of the product.

product_brand

string

Brand of the product.

product_country

string

Resource name of the geo target constant for the country of sale of the product.

product_custom_attribute0

string

Custom attribute 0 of the product.

product_custom_attribute1

string

Custom attribute 1 of the product.

product_custom_attribute2

string

Custom attribute 2 of the product.

product_custom_attribute3

string

Custom attribute 3 of the product.

product_custom_attribute4

string

Custom attribute 4 of the product.

product_item_id

string

Item ID of the product.

product_language

string

Resource name of the language constant for the language of the product.

product_sold_bidding_category_level1

string

Bidding category (level 1) of the product sold.

product_sold_bidding_category_level2

string

Bidding category (level 2) of the product sold.

product_sold_bidding_category_level3

string

Bidding category (level 3) of the product sold.

product_sold_bidding_category_level4

string

Bidding category (level 4) of the product sold.

product_sold_bidding_category_level5

string

Bidding category (level 5) of the product sold.

product_sold_brand

string

Brand of the product sold.

product_sold_custom_attribute0

string

Custom attribute 0 of the product sold.

product_sold_custom_attribute1

string

Custom attribute 1 of the product sold.

product_sold_custom_attribute2

string

Custom attribute 2 of the product sold.

product_sold_custom_attribute3

string

Custom attribute 3 of the product sold.

product_sold_custom_attribute4

string

Custom attribute 4 of the product sold.

product_sold_item_id

string

Item ID of the product sold.

product_sold_title

string

Title of the product sold.

product_sold_type_l1

string

Type (level 1) of the product sold.

product_sold_type_l2

string

Type (level 2) of the product sold.

product_sold_type_l3

string

Type (level 3) of the product sold.

product_sold_type_l4

string

Type (level 4) of the product sold.

product_sold_type_l5

string

Type (level 5) of the product sold.

product_store_id

string

Store ID of the product.

product_title

string

Title of the product.

product_type_l1

string

Type (level 1) of the product.

product_type_l2

string

Type (level 2) of the product.

product_type_l3

string

Type (level 3) of the product.

product_type_l4

string

Type (level 4) of the product.

product_type_l5

string

Type (level 5) of the product.

quarter

string

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

string

Week as defined as Monday through Sunday, and represented by the date of Monday. Formatted as yyyy-MM-dd.

year

int32

Year, formatted as yyyy.

asset_interaction_target

AssetInteractionTarget

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

int64

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

int64

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

int64

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.

TargetImpressionShare

An automated bidding strategy that sets bids so that a certain percentage of search ads are shown at the top of the first page (or other targeted location).

فیلدها
location

TargetImpressionShareLocation

The targeted location on the search results page.

location_fraction_micros

int64

The chosen fraction of ads to be shown in the targeted location in micros. For example, 1% equals 10,000.

cpc_bid_ceiling_micros

int64

The highest CPC bid the automated bidding system is permitted to specify. This is a required field entered by the advertiser that sets the ceiling and specified in local micros.

TargetOutrankShare

An automated bidding strategy that sets bids based on the target fraction of auctions where the advertiser should outrank a specific competitor. This strategy is deprecated.

فیلدها
cpc_bid_ceiling_micros

Int64Value

Maximum bid limit that can be set by the bid strategy. The limit applies to all keywords managed by the strategy.

TargetRestriction

The list of per-targeting-dimension targeting settings.

فیلدها
targeting_dimension

TargetingDimension

The targeting dimension that these settings apply to.

bid_only

bool

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 true means that these criteria will only apply bid modifiers, and not affect targeting. A value of false means that these criteria will restrict targeting as well as applying bid modifiers.

TargetRoas

An automated bidding strategy that helps you maximize revenue while averaging a specific target return on ad spend (ROAS).

فیلدها
target_roas

double

مورد نیاز. 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

int64

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

int64

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)

int64

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

int64

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[]

TargetRestriction

The per-targeting-dimension setting to restrict the reach of your campaign or ad group.

TextAsset

A Text asset.

فیلدها
text

string

Text content of the text asset.

TextLabel

A type of label displaying text on a colored background.

فیلدها
background_color

string

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

string

A short description of the label. The length must be no more than 200 characters.

UnifiedCallAsset

A unified call asset.

فیلدها
country_code

string

Two-letter country code of the phone number. Examples: 'US', 'us'.

phone_number

string

The advertiser's raw phone number. Examples: '1234567890', '(123)456-7890'

call_conversion_reporting_state

CallConversionReportingState

Indicates whether this CallAsset should use its own call conversion setting, follow the account level setting, or disable call conversion.

call_conversion_action

string

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[]

AdScheduleInfo

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

bool

Whether the call only shows the phone number without a link to the website. Applies to Microsoft Ads.

call_tracking_enabled

bool

Whether the call should be enabled on call tracking. Applies to Microsoft Ads.

use_searcher_time_zone

bool

Whether to show the call extension in search user's time zone. Applies to Microsoft Ads.

start_date

string

Start date of when this asset is effective and can begin serving, in yyyy-MM-dd format.

end_date

string

Last date of when this asset is effective and still serving, in yyyy-MM-dd format.

UnifiedCalloutAsset

A unified callout asset.

فیلدها
callout_text

string

The callout text. The length of this string should be between 1 and 25, inclusive.

start_date

string

Start date of when this asset is effective and can begin serving, in yyyy-MM-dd format.

end_date

string

Last date of when this asset is effective and still serving, in yyyy-MM-dd format.

ad_schedule_targets[]

AdScheduleInfo

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

bool

Whether to show the asset in search user's time zone. Applies to Microsoft Ads.

UnifiedLocationAsset

A unified location asset.

فیلدها
place_id

string

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[]

BusinessProfileLocation

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

LocationOwnershipType

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

string

The webpage that advertisers want to target.

labels[]

string

Labels used to group the page urls.

UnifiedSitelinkAsset

A unified sitelink asset.

فیلدها
description1

string

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

string

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

string

Start date of when this asset is effective and can begin serving, in yyyy-MM-dd format.

end_date

string

Last date of when this asset is effective and still serving, in yyyy-MM-dd format.

ad_schedule_targets[]

AdScheduleInfo

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

int64

ID used for tracking clicks for the sitelink asset. This is a Yahoo! Japan only field.

use_searcher_time_zone

bool

Whether to show the sitelink asset in search user's time zone. Applies to Microsoft Ads.

mobile_preferred

bool

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

string

The User List resource name.

ارزش

A generic data container.

فیلدها
Union field value . A value. value can be only one of the following:
boolean_value

bool

یک بولی

int64_value

int64

An int64.

float_value

float

A float.

double_value

double

یک دوتایی

string_value

string

یک رشته

WebpageConditionInfo

Logical expression for targeting webpages of an advertiser's website.

فیلدها
operand

WebpageConditionOperand

Operand of webpage targeting condition.

operator

WebpageConditionOperator

Operator of webpage targeting condition.

argument

string

Argument of webpage targeting condition.

WebpageInfo

Represents a criterion for targeting webpages of an advertiser's website.

فیلدها
conditions[]

WebpageConditionInfo

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

double

Website criteria coverage percentage. This is the computed percentage of website coverage based on the website target, negative website target and negative keywords in the ad group and campaign. For instance, when coverage returns as 1, it indicates it has 100% coverage. This field is read-only.

criterion_name

string

The name of the criterion that is defined by this parameter. The name value will be used for identifying, sorting and filtering criteria with this type of parameters.

This field is required for CREATE operations and is prohibited on UPDATE operations.

YoutubeVideoAsset

A YouTube asset.

فیلدها
youtube_video_title

string

YouTube video title.

youtube_video_id

string

YouTube video id. This is the 11 character string value used in the YouTube video URL.

،

شاخص

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

MinuteOfHour

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

MinuteOfHour

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

DayOfWeek

Day of the week the schedule applies to.

This field is required for CREATE operations and is prohibited on UPDATE operations.

start_hour

int32

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

int32

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

string

Asset text.

AgeRangeInfo

An age range criterion.

فیلدها
type

AgeRangeType

Type of the age range.

AssetInteractionTarget

An AssetInteractionTarget segment.

فیلدها
asset

string

The asset resource name.

interaction_on_this_asset

bool

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

string

Resource name of the asset.

served_asset_field_type

ServedAssetFieldType

The served field type of the asset.

AudienceInfo

An audience criterion.

فیلدها
audience

string

The Audience resource name.

BusinessProfileLocation

Business Profile location data synced from the linked Business Profile account.

فیلدها
labels[]

string

Advertiser specified label for the location on the Business Profile account. This is synced from the Business Profile account.

store_code

string

Business Profile store code of this location. This is synced from the Business Profile account.

listing_id

int64

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

CallToActionType

فراخوان به اقدام.

CustomParameter

A mapping that can be used by custom parameter tags in a tracking_url_template , final_urls , or mobile_final_urls .

فیلدها
key

string

The key matching the parameter tag name.

value

string

The value to be substituted.

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

A device criterion.

فیلدها
type

Device

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

GenderType

Type of the gender.

ImageAsset

An Image asset.

فیلدها
mime_type

MimeType

MIME type of the image asset.

full_size

ImageDimension

Metadata for this image at its original size.

file_size

int64

File size of the image asset in bytes.

ImageDimension

Metadata for an image at a certain size, either original or resized.

فیلدها
height_pixels

int64

Height of the image.

width_pixels

int64

Width of the image.

url

string

A URL that returns the image with this height and width.

کلمه کلیدی

A Keyword criterion segment.

فیلدها
info

KeywordInfo

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

ad_group_criterion

string

The AdGroupCriterion resource name.

KeywordInfo

A keyword criterion.

فیلدها
match_type

KeywordMatchType

The match type of the keyword.

text

string

The text of the keyword (at most 80 characters and 10 words).

LanguageInfo

A language criterion.

فیلدها
language_constant

string

The language constant resource name.

ListingGroupInfo

A listing group criterion.

فیلدها
type

ListingGroupType

Type of the listing group.

LocationGroupInfo

A radius around a list of locations specified through a feed.

فیلدها
geo_target_constants[]

string

Geo target constant(s) restricting the scope of the geographic area within the feed. Currently only one geo target constant is allowed.

radius_units

LocationGroupRadiusUnits

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[]

string

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

int64

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

string

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

bool

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

int64

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

int64

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

double

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

int64

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

int64

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

int64

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

double

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

double

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[]

Value

The conversion custom metrics.

conversions_value_by_conversion_date

double

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

double

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

QualityScoreBucket

The creative historical quality score.

historical_landing_page_quality_score

QualityScoreBucket

The quality of historical landing page experience.

historical_search_predicted_ctr

QualityScoreBucket

The historical search predicted click through rate (CTR).

interaction_event_types[]

InteractionEventType

The types of payable and free interactions.

raw_event_conversion_metrics[]

Value

The raw event conversion metrics.

absolute_top_impression_percentage

double

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

double

All conversions from interactions (as oppose to view through conversions) divided by the number of ad interactions.

all_conversions_value

double

The value of all conversions.

all_conversions

double

The total number of conversions. This includes all conversions regardless of the value of include_in_conversions_metric.

all_conversions_value_per_cost

double

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

double

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

double

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

double

The value of all conversions from interactions divided by the total number of interactions.

all_conversions_from_menu

double

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

double

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

double

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

double

Estimated number of times people visited a store after clicking an ad.

This metric applies to feed items only.

visits

double

Clicks that Search Ads 360 has successfully recorded and forwarded to an advertiser's landing page.

all_conversions_from_store_website

double

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

double

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

double

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

double

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

int64

The number of clicks.

content_budget_lost_impression_share

double

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

double

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

double

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

double

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

double

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

double

The value of biddable conversion divided by the total cost of conversion eligible interactions.

conversions_from_interactions_value_per_interaction

double

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

double

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

int64

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

double

The cost of ad interactions divided by all conversions.

cost_per_conversion

double

Average conversion eligible cost per biddable conversion.

cost_per_current_model_attributed_conversion

double

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

double

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

double

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

double

The sum of the value of cross-device conversions.

cross_device_conversions_value_by_conversion_date

double

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

double

The number of clicks your ad receives (Clicks) divided by the number of times your ad is shown (Impressions).

conversions

double

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

double

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

double

The average quality score.

historical_quality_score

int64

The historical quality score.

impressions

int64

Count of how often your ad has appeared on a search results page or website on the Google Network.

interaction_rate

double

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

int64

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

double

The percentage of clicks filtered out of your total number of clicks (filtered + non-filtered clicks) during the reporting period.

invalid_clicks

int64

Number of clicks Google considers illegitimate and doesn't charge you for.

general_invalid_click_rate

double

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

int64

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

double

The percentage of mobile clicks that go to a mobile-friendly page.

search_absolute_top_impression_share

double

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

double

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

double

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

double

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

double

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

double

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

double

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

double

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

double

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

double

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

double

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

double

The percent of your ad impressions that are shown adjacent to the top organic search results.

value_per_all_conversions

double

The value of all conversions divided by the number of all conversions.

value_per_all_conversions_by_conversion_date

double

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

double

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

double

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

int64

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

int64

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

int64

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

int64

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

int64

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

int64

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

int64

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

double

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

double

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

int64

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

int64

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

int64

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

int64

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

int64

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

int64

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

double

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

double

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

string

مورد نیاز. 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

MobileAppVendor

مورد نیاز. 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

int64

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

bool

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

bool

Whether the campaign is opted in to real-time bidding.

SearchAds360ExpandedDynamicSearchAdInfo

An expanded dynamic search ad.

فیلدها
description1

string

The first line of the ad's description.

description2

string

The second line of the ad's description.

ad_tracking_id

int64

The tracking id of the ad.

SearchAds360ExpandedTextAdInfo

A Search Ads 360 expanded text ad.

فیلدها
headline

string

The headline of the ad.

headline2

string

The second headline of the ad.

headline3

string

The third headline of the ad.

description1

string

The first line of the ad's description.

description2

string

The second line of the ad's description.

path1

string

Text appended to the auto-generated visible URL with a delimiter.

path2

string

Text appended to path1 with a delimiter.

ad_tracking_id

int64

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[]

AdTextAsset

List of text assets for headlines. When the ad serves the headlines will be selected from this list.

descriptions[]

AdTextAsset

List of text assets for descriptions. When the ad serves the descriptions will be selected from this list.

path1

string

Text appended to the auto-generated visible URL with a delimiter.

path2

string

Text appended to path1 with a delimiter.

ad_tracking_id

int64

The tracking id of the ad.

SearchAds360TextAdInfo

A Search Ads 360 text ad.

فیلدها
headline

string

The headline of the ad.

description1

string

The first line of the ad's description.

description2

string

The second line of the ad's description.

display_url

string

The displayed URL of the ad.

display_mobile_url

string

The displayed mobile URL of the ad.

ad_tracking_id

int64

The tracking id of the ad.

بخش ها

Segment only fields.

فیلدها
ad_network_type

AdNetworkType

Ad network type.

conversion_action_category

ConversionActionCategory

Conversion action category.

conversion_custom_dimensions[]

Value

The conversion custom dimensions.

day_of_week

DayOfWeek

Day of the week, for example, MONDAY.

device

Device

Device to which metrics apply.

keyword

Keyword

Keyword criterion.

product_channel

ProductChannel

Channel of the product.

product_channel_exclusivity

ProductChannelExclusivity

Channel exclusivity of the product.

product_condition

ProductCondition

Condition of the product.

product_sold_condition

ProductCondition

Condition of the product sold.

raw_event_conversion_dimensions[]

Value

The raw event conversion dimensions.

conversion_action

string

Resource name of the conversion action.

conversion_action_name

string

Conversion action name.

date

string

Date to which metrics apply. yyyy-MM-dd format, for example, 2018-04-17.

geo_target_city

string

Resource name of the geo target constant that represents a city.

geo_target_country

string

Resource name of the geo target constant that represents a country.

geo_target_metro

string

Resource name of the geo target constant that represents a metro.

geo_target_region

string

Resource name of the geo target constant that represents a region.

hour

int32

Hour of day as a number between 0 and 23, inclusive.

month

string

Month as represented by the date of the first day of a month. Formatted as yyyy-MM-dd.

product_bidding_category_level1

string

Bidding category (level 1) of the product.

product_bidding_category_level2

string

Bidding category (level 2) of the product.

product_bidding_category_level3

string

Bidding category (level 3) of the product.

product_bidding_category_level4

string

Bidding category (level 4) of the product.

product_bidding_category_level5

string

Bidding category (level 5) of the product.

product_brand

string

Brand of the product.

product_country

string

Resource name of the geo target constant for the country of sale of the product.

product_custom_attribute0

string

Custom attribute 0 of the product.

product_custom_attribute1

string

Custom attribute 1 of the product.

product_custom_attribute2

string

Custom attribute 2 of the product.

product_custom_attribute3

string

Custom attribute 3 of the product.

product_custom_attribute4

string

Custom attribute 4 of the product.

product_item_id

string

Item ID of the product.

product_language

string

Resource name of the language constant for the language of the product.

product_sold_bidding_category_level1

string

Bidding category (level 1) of the product sold.

product_sold_bidding_category_level2

string

Bidding category (level 2) of the product sold.

product_sold_bidding_category_level3

string

Bidding category (level 3) of the product sold.

product_sold_bidding_category_level4

string

Bidding category (level 4) of the product sold.

product_sold_bidding_category_level5

string

Bidding category (level 5) of the product sold.

product_sold_brand

string

Brand of the product sold.

product_sold_custom_attribute0

string

Custom attribute 0 of the product sold.

product_sold_custom_attribute1

string

Custom attribute 1 of the product sold.

product_sold_custom_attribute2

string

Custom attribute 2 of the product sold.

product_sold_custom_attribute3

string

Custom attribute 3 of the product sold.

product_sold_custom_attribute4

string

Custom attribute 4 of the product sold.

product_sold_item_id

string

Item ID of the product sold.

product_sold_title

string

Title of the product sold.

product_sold_type_l1

string

Type (level 1) of the product sold.

product_sold_type_l2

string

Type (level 2) of the product sold.

product_sold_type_l3

string

Type (level 3) of the product sold.

product_sold_type_l4

string

Type (level 4) of the product sold.

product_sold_type_l5

string

Type (level 5) of the product sold.

product_store_id

string

Store ID of the product.

product_title

string

Title of the product.

product_type_l1

string

Type (level 1) of the product.

product_type_l2

string

Type (level 2) of the product.

product_type_l3

string

Type (level 3) of the product.

product_type_l4

string

Type (level 4) of the product.

product_type_l5

string

Type (level 5) of the product.

quarter

string

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

string

Week as defined as Monday through Sunday, and represented by the date of Monday. Formatted as yyyy-MM-dd.

year

int32

Year, formatted as yyyy.

asset_interaction_target

AssetInteractionTarget

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

int64

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

int64

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

int64

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.

TargetImpressionShare

An automated bidding strategy that sets bids so that a certain percentage of search ads are shown at the top of the first page (or other targeted location).

فیلدها
location

TargetImpressionShareLocation

The targeted location on the search results page.

location_fraction_micros

int64

The chosen fraction of ads to be shown in the targeted location in micros. For example, 1% equals 10,000.

cpc_bid_ceiling_micros

int64

The highest CPC bid the automated bidding system is permitted to specify. This is a required field entered by the advertiser that sets the ceiling and specified in local micros.

TargetOutrankShare

An automated bidding strategy that sets bids based on the target fraction of auctions where the advertiser should outrank a specific competitor. This strategy is deprecated.

فیلدها
cpc_bid_ceiling_micros

Int64Value

Maximum bid limit that can be set by the bid strategy. The limit applies to all keywords managed by the strategy.

TargetRestriction

The list of per-targeting-dimension targeting settings.

فیلدها
targeting_dimension

TargetingDimension

The targeting dimension that these settings apply to.

bid_only

bool

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 true means that these criteria will only apply bid modifiers, and not affect targeting. A value of false means that these criteria will restrict targeting as well as applying bid modifiers.

TargetRoas

An automated bidding strategy that helps you maximize revenue while averaging a specific target return on ad spend (ROAS).

فیلدها
target_roas

double

مورد نیاز. 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

int64

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

int64

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)

int64

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

int64

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[]

TargetRestriction

The per-targeting-dimension setting to restrict the reach of your campaign or ad group.

TextAsset

A Text asset.

فیلدها
text

string

Text content of the text asset.

TextLabel

A type of label displaying text on a colored background.

فیلدها
background_color

string

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

string

A short description of the label. The length must be no more than 200 characters.

UnifiedCallAsset

A unified call asset.

فیلدها
country_code

string

Two-letter country code of the phone number. Examples: 'US', 'us'.

phone_number

string

The advertiser's raw phone number. Examples: '1234567890', '(123)456-7890'

call_conversion_reporting_state

CallConversionReportingState

Indicates whether this CallAsset should use its own call conversion setting, follow the account level setting, or disable call conversion.

call_conversion_action

string

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[]

AdScheduleInfo

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

bool

Whether the call only shows the phone number without a link to the website. Applies to Microsoft Ads.

call_tracking_enabled

bool

Whether the call should be enabled on call tracking. Applies to Microsoft Ads.

use_searcher_time_zone

bool

Whether to show the call extension in search user's time zone. Applies to Microsoft Ads.

start_date

string

Start date of when this asset is effective and can begin serving, in yyyy-MM-dd format.

end_date

string

Last date of when this asset is effective and still serving, in yyyy-MM-dd format.

UnifiedCalloutAsset

A unified callout asset.

فیلدها
callout_text

string

The callout text. The length of this string should be between 1 and 25, inclusive.

start_date

string

Start date of when this asset is effective and can begin serving, in yyyy-MM-dd format.

end_date

string

Last date of when this asset is effective and still serving, in yyyy-MM-dd format.

ad_schedule_targets[]

AdScheduleInfo

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

bool

Whether to show the asset in search user's time zone. Applies to Microsoft Ads.

UnifiedLocationAsset

A unified location asset.

فیلدها
place_id

string

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[]

BusinessProfileLocation

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

LocationOwnershipType

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

string

The webpage that advertisers want to target.

labels[]

string

Labels used to group the page urls.

UnifiedSitelinkAsset

A unified sitelink asset.

فیلدها
description1

string

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

string

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

string

Start date of when this asset is effective and can begin serving, in yyyy-MM-dd format.

end_date

string

Last date of when this asset is effective and still serving, in yyyy-MM-dd format.

ad_schedule_targets[]

AdScheduleInfo

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

int64

ID used for tracking clicks for the sitelink asset. This is a Yahoo! Japan only field.

use_searcher_time_zone

bool

Whether to show the sitelink asset in search user's time zone. Applies to Microsoft Ads.

mobile_preferred

bool

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

string

The User List resource name.

ارزش

A generic data container.

فیلدها
Union field value . A value. value can be only one of the following:
boolean_value

bool

یک بولی

int64_value

int64

An int64.

float_value

float

A float.

double_value

double

یک دوتایی

string_value

string

یک رشته

WebpageConditionInfo

Logical expression for targeting webpages of an advertiser's website.

فیلدها
operand

WebpageConditionOperand

Operand of webpage targeting condition.

operator

WebpageConditionOperator

Operator of webpage targeting condition.

argument

string

Argument of webpage targeting condition.

WebpageInfo

Represents a criterion for targeting webpages of an advertiser's website.

فیلدها
conditions[]

WebpageConditionInfo

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

double

Website criteria coverage percentage. This is the computed percentage of website coverage based on the website target, negative website target and negative keywords in the ad group and campaign. For instance, when coverage returns as 1, it indicates it has 100% coverage. This field is read-only.

criterion_name

string

The name of the criterion that is defined by this parameter. The name value will be used for identifying, sorting and filtering criteria with this type of parameters.

This field is required for CREATE operations and is prohibited on UPDATE operations.

YoutubeVideoAsset

A YouTube asset.

فیلدها
youtube_video_title

string

YouTube video title.

youtube_video_id

string

YouTube video id. This is the 11 character string value used in the YouTube video URL.