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 است. این معیار فقط در صورتی در دسترس است که تبدیل‌ها را با داده‌های سبد خرید گزارش دهید.

MobileAppAsset

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

فیلدها
app_ id

string

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

app_ store

MobileAppVendor

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

درصد Cpc

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

فیلدها
cpc_ bid_ ceiling_ micros

int64

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

enhanced_ cpc_ enabled

bool

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

RealTime BiddingSetting

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

فیلدها
opt_ in

bool

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

SearchAds360ExpandedDynamicSearchAdInfo

یک تبلیغ جستجوی پویا گسترده

فیلدها
description1

string

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

description2

string

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

ad_ tracking_ id

int64

شناسه پیگیری آگهی

SearchAds360ExpandedTextAdInfo

یک تبلیغ متنی توسعه یافته Search Ads 360.

فیلدها
headline

string

تیتر آگهی.

headline2

string

تیتر دوم آگهی.

headline3

string

عنوان سوم آگهی.

description1

string

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

description2

string

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

path1

string

نوشتاری به نشانی اینترنتی قابل مشاهده که به‌طور خودکار ایجاد می‌شود با یک جداکننده اضافه شد.

path2

string

متن با یک جداکننده به path1 اضافه شد.

ad_ tracking_ id

int64

شناسه پیگیری آگهی

SearchAds360ProductAdInfo

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

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

SearchAds360ResponsiveSearchAdInfo

یک تبلیغ جستجوی پاسخگو Search Ads 360.

فیلدها
headlines[]

AdTextAsset

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

descriptions[]

AdTextAsset

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

path1

string

نوشتاری به نشانی اینترنتی قابل مشاهده که به‌طور خودکار ایجاد می‌شود با یک جداکننده اضافه شد.

path2

string

متن با یک جداکننده به path1 اضافه شد.

ad_ tracking_ id

int64

شناسه پیگیری آگهی

SearchAds360TextAdInfo

یک تبلیغ متنی Search Ads 360.

فیلدها
headline

string

تیتر آگهی.

description1

string

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

description2

string

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

display_ url

string

URL نمایش داده شده آگهی.

display_ mobile_ url

string

نشانی اینترنتی موبایل نمایش داده شده آگهی.

ad_ tracking_ id

int64

شناسه پیگیری آگهی

بخش ها

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

فیلدها
ad_ network_ type

AdNetworkType

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

conversion_ action_ category

ConversionActionCategory

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

conversion_ custom_ dimensions[]

Value

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

day_ of_ week

DayOfWeek

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

device

Device

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

keyword

Keyword

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

product_ channel

ProductChannel

کانال محصول

product_ channel_ exclusivity

ProductChannelExclusivity

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

product_ condition

ProductCondition

وضعیت محصول.

product_ sold_ condition

ProductCondition

وضعیت محصول فروخته شده

raw_ event_ conversion_ dimensions[]

Value

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

conversion_ action

string

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

conversion_ action_ name

string

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

date

string

تاریخی که معیارها برای آن اعمال می شود. فرمت yyyy-MM-dd، به عنوان مثال، 2018-04-17.

geo_ target_ city

string

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

geo_ target_ country

string

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

geo_ target_ metro

string

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

geo_ target_ region

string

نام منبع ثابت هدف جغرافیایی که یک منطقه را نشان می دهد.

hour

int32

ساعت روز به صورت عددی بین 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

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

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 در 01-04-2018 شروع می شود. فرمت شده به عنوان yyyy-MM-dd.

week

string

هفته به عنوان دوشنبه تا یکشنبه تعریف شده و با تاریخ دوشنبه نشان داده می شود. فرمت شده به عنوان yyyy-MM-dd.

year

int32

سال، قالب‌بندی شده به عنوان yyyy.

asset_ interaction_ target

AssetInteractionTarget

فقط با معیارهای CustomerAsset، CampaignAsset و AdGroupAsset استفاده می شود. نشان می دهد که آیا معیارهای تعامل در خود دارایی رخ داده است یا یک دارایی یا واحد تبلیغاتی دیگر. تعاملات (به عنوان مثال، کلیک‌ها) در تمام قسمت‌های تبلیغ ارائه‌شده (به عنوان مثال، خود آگهی و سایر مؤلفه‌ها مانند پیوندهای سایت) وقتی با هم ارائه می‌شوند، شمارش می‌شوند. وقتی interaction_on_this_asset درست است، به این معنی است که تعاملات روی این دارایی خاص است و وقتی interaction_on_this_asset نادرست است، به این معنی است که تعاملات روی این دارایی خاص نیست، بلکه در قسمت‌های دیگر تبلیغ ارائه‌شده با این دارایی ارائه می‌شود.

TargetCpa

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

فیلدها
target_ cpa_ micros

int64

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

cpc_ bid_ ceiling_ micros

int64

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

cpc_ bid_ floor_ micros

int64

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

TargetCpm

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

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

TargetImpressionShare

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

فیلدها
location

TargetImpressionShareLocation

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

location_ fraction_ micros

int64

بخش انتخاب شده از تبلیغات برای نمایش در مکان مورد نظر در میکرو. مثلاً 1% برابر با 10000 است.

cpc_ bid_ ceiling_ micros

int64

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

TargetOutrankShare

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

فیلدها
cpc_ bid_ ceiling_ micros

Int64Value

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

محدودیت هدف

فهرست تنظیمات هدف گذاری در هر بعد هدف.

فیلدها
targeting_ dimension

TargetingDimension

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

bid_ only

bool

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

TargetRoas

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

فیلدها
target_ roas

double

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

cpc_ bid_ ceiling_ micros

int64

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

cpc_ bid_ floor_ micros

int64

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

TargetSpend

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

فیلدها
target_spend_micros
(deprecated)

int64

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

cpc_ bid_ ceiling_ micros

int64

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

TargetingSetting

تنظیمات برای ویژگی های مرتبط با هدف، در سطوح کمپین و گروه تبلیغاتی. برای جزئیات بیشتر در مورد تنظیم هدف، از 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 است.