API جدید Search Ads 360 Reporting اکنون در دسترس است. به گروه Google searchads-api-announcements بپیوندید تا در مورد پیشرفت‌ها و نسخه‌های آینده به‌روز باشید.

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

customer_asset

پیوندی بین مشتری و دارایی.

منابع نسبت‌داده‌شده
دارایی
مشتری

فیلدهای منابع بالا ممکن است همراه با این منبع در عبارت‌های SELECT و WHERE شما انتخاب شوند. این فیلدها سنجه‌ها را در عبارت SELECT شما بخش‌بندی نخواهند کرد.

منابع تقسیم‌بندی
ad_group
پویش

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

فیلدها/بخش‌ها/سنجه‌ها

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

آیا customer_asset در عبارت FROM پرسمان شما مشخص شده است؟

فیلدهای منبع
دارایی
resource_name
وضعیت

‫ بخش
ad_format_type
ad_network_type
asset_interaction_target.asset
asset_interaction_target.interaction_on_this_asset
conversion_action
conversion_action_category
conversion_action_name
تاریخ
day_of_week
دستگاه
ماه
‫فصل
هفته
‫سال

سنجه
absolute_top_impression_percentage
all_conversions
all_conversions_from_interactions_rate
all_conversions_from_interactions_value_per_interaction
all_conversions_value
all_conversions_value_per_cost
average_cost
average_cpc
average_cpm
کلیک
client_account_conversions
client_account_conversions_value
client_account_view_through_conversions
conversions_from_interactions_value_per_interaction
cost_micros
cost_per_all_conversions
cross_device_conversions
cross_device_conversions_value
ctr
ظهور
interaction_event_types
interaction_rate
تعاملات
top_impression_percentage
value_per_all_conversions

customer_asset.asset
شرح فیلد	الزامی. تغییرناپذیر. دارایی‌ای که به مشتری پیوند داده شده است.
دسته	`ATTRIBUTE`
نوع داده	`RESOURCE_NAME`
نشانی وب را تایپ کنید	`N/A`
قابل فیلتر کردن	True
قابل‌انتخاب	True
مرتب‌شدنی	نادرست
تکرارشده	نادرست

customer_asset.resource_name
شرح فیلد	نام منبع دارایی مشتری. نام‌های منبع CustomerAsset این فرم را دارند: `customers/{customer_id}/customerAssets/{asset_id}~{field_type}`
دسته	`ATTRIBUTE`
نوع داده	`RESOURCE_NAME`
نشانی وب را تایپ کنید	`N/A`
قابل فیلتر کردن	True
قابل‌انتخاب	True
مرتب‌شدنی	نادرست
تکرارشده	نادرست

customer_asset.status
شرح فیلد	وضعیت دارایی مشتری.
دسته	`ATTRIBUTE`
نوع داده	`ENUM ENABLED PAUSED REMOVED UNKNOWN UNSPECIFIED`
نشانی وب را تایپ کنید	`google.ads.searchads360.v0.enums.AssetLinkStatusEnum.AssetLinkStatus`
قابل فیلتر کردن	True
قابل‌انتخاب	True
مرتب‌شدنی	True
تکرارشده	نادرست

segments.ad_format_type
شرح فیلد	نوع قالب آگهی.
دسته	`SEGMENT`
نوع داده	`ENUM TEXT UNKNOWN UNSPECIFIED VERTICAL_ADS_BOOKING_LINK VERTICAL_ADS_PROMOTION`
نشانی وب را تایپ کنید	`google.ads.searchads360.v0.enums.AdFormatTypeEnum.AdFormatType`
قابل فیلتر کردن	True
قابل‌انتخاب	True
مرتب‌شدنی	True
تکرارشده	نادرست

segments.ad_network_type
شرح فیلد	نوع شبکه آگهی.
دسته	`SEGMENT`
نوع داده	`ENUM CONTENT MIXED SEARCH SEARCH_PARTNERS UNKNOWN UNSPECIFIED YOUTUBE_SEARCH YOUTUBE_WATCH`
نشانی وب را تایپ کنید	`google.ads.searchads360.v0.enums.AdNetworkTypeEnum.AdNetworkType`
قابل فیلتر کردن	True
قابل‌انتخاب	True
مرتب‌شدنی	True
تکرارشده	نادرست

segments.asset_interaction_target.asset
شرح فیلد	نام منبع دارایی.
دسته	`SEGMENT`
نوع داده	`RESOURCE_NAME`
نشانی وب را تایپ کنید	`N/A`
قابل فیلتر کردن	True
قابل‌انتخاب	True
مرتب‌شدنی	True
تکرارشده	نادرست

segments.asset_interaction_target.interaction_on_this_asset
شرح فیلد	فقط با سنجه‌های CustomerAsset،‏ CampaignAsset، و AdGroupAsset استفاده می‌شود. نشان می‌دهد که آیا سنجه‌های تعامل در خود دارایی یا دارایی یا واحد آگهی دیگری رخ داده است یا نه.
دسته	`SEGMENT`
نوع داده	`BOOLEAN`
نشانی وب را تایپ کنید	`N/A`
قابل فیلتر کردن	True
قابل‌انتخاب	True
مرتب‌شدنی	True
تکرارشده	نادرست

segments.conversion_action
شرح فیلد	نام منبع کنش تبدیل.
دسته	`SEGMENT`
نوع داده	`RESOURCE_NAME`
نشانی وب را تایپ کنید	`N/A`
قابل فیلتر کردن	True
قابل‌انتخاب	True
مرتب‌شدنی	True
تکرارشده	نادرست

segments.conversion_action_category
شرح فیلد	دسته کنش تبدیل.
دسته	`SEGMENT`
نوع داده	`ENUM ADD_TO_CART BEGIN_CHECKOUT BOOK_APPOINTMENT CONTACT CONVERTED_LEAD DEFAULT DOWNLOAD ENGAGEMENT GET_DIRECTIONS IMPORTED_LEAD LEAD OUTBOUND_CLICK PAGE_VIEW PHONE_CALL_LEAD PURCHASE QUALIFIED_LEAD REQUEST_QUOTE SIGNUP STORE_SALE STORE_VISIT SUBMIT_LEAD_FORM SUBSCRIBE_PAID UNKNOWN UNSPECIFIED`
نشانی وب را تایپ کنید	`google.ads.searchads360.v0.enums.ConversionActionCategoryEnum.ConversionActionCategory`
قابل فیلتر کردن	True
قابل‌انتخاب	True
مرتب‌شدنی	True
تکرارشده	نادرست

segments.conversion_action_name
شرح فیلد	نام کنش تبدیل.
دسته	`SEGMENT`
نوع داده	`STRING`
نشانی وب را تایپ کنید	`N/A`
قابل فیلتر کردن	True
قابل‌انتخاب	True
مرتب‌شدنی	True
تکرارشده	نادرست

segments.date
شرح فیلد	تاریخی که سنجه‌ها برای آن اعمال می‌شود. قالب yyyy-MM-dd، برای مثال، 2018-04-17.
دسته	`SEGMENT`
نوع داده	`DATE`
نشانی وب را تایپ کنید	`N/A`
قابل فیلتر کردن	True
قابل‌انتخاب	True
مرتب‌شدنی	True
تکرارشده	نادرست

segments.day_of_week
شرح فیلد	روز هفته، برای مثال، دوشنبه.
دسته	`SEGMENT`
نوع داده	`ENUM FRIDAY MONDAY SATURDAY SUNDAY THURSDAY TUESDAY UNKNOWN UNSPECIFIED WEDNESDAY`
نشانی وب را تایپ کنید	`google.ads.searchads360.v0.enums.DayOfWeekEnum.DayOfWeek`
قابل فیلتر کردن	True
قابل‌انتخاب	True
مرتب‌شدنی	True
تکرارشده	نادرست

segments.device
شرح فیلد	دستگاهی که سنجه‌ها بر آن اعمال می‌شود.
دسته	`SEGMENT`
نوع داده	`ENUM CONNECTED_TV DESKTOP MOBILE OTHER TABLET UNKNOWN UNSPECIFIED`
نشانی وب را تایپ کنید	`google.ads.searchads360.v0.enums.DeviceEnum.Device`
قابل فیلتر کردن	True
قابل‌انتخاب	True
مرتب‌شدنی	True
تکرارشده	نادرست

segments.month
شرح فیلد	ماه که با تاریخ اولین روز ماه نشان داده می‌شود. قالب‌بندی‌شده به‌صورت yyyy-MM-dd.
دسته	`SEGMENT`
نوع داده	`DATE`
نشانی وب را تایپ کنید	`N/A`
قابل فیلتر کردن	True
قابل‌انتخاب	True
مرتب‌شدنی	True
تکرارشده	نادرست

segments.quarter
شرح فیلد	سه‌ماهه که با تاریخ اولین روز سه‌ماهه نشان داده می‌شود. از سال تقویمی برای سه‌ماهه استفاده می‌کند، برای مثال، سه‌ماهه دوم ۲۰۱۸ از ۲۰۱۸-۰۴-۰۱ شروع می‌شود. قالب‌بندی‌شده به‌صورت yyyy-MM-dd.
دسته	`SEGMENT`
نوع داده	`DATE`
نشانی وب را تایپ کنید	`N/A`
قابل فیلتر کردن	True
قابل‌انتخاب	True
مرتب‌شدنی	True
تکرارشده	نادرست

segments.week
شرح فیلد	هفته از دوشنبه تا یکشنبه تعریف می‌شود و با تاریخ دوشنبه نشان داده می‌شود. قالب‌بندی‌شده به‌صورت yyyy-MM-dd.
دسته	`SEGMENT`
نوع داده	`DATE`
نشانی وب را تایپ کنید	`N/A`
قابل فیلتر کردن	True
قابل‌انتخاب	True
مرتب‌شدنی	True
تکرارشده	نادرست

segments.year
شرح فیلد	سال، با قالب yyyy.
دسته	`SEGMENT`
نوع داده	`INT32`
نشانی وب را تایپ کنید	`N/A`
قابل فیلتر کردن	True
قابل‌انتخاب	True
مرتب‌شدنی	True
تکرارشده	نادرست

metrics.absolute_top_impression_percentage
شرح فیلد	سهم ظهور در صدر صفحه جستجو عبارت است از درصد ظهورهای آگهی جستجوهای شما که در برجسته‌ترین موقعیت صفحه «جستجو» نمایش داده می‌شود.
دسته	`METRIC`
نوع داده	`DOUBLE`
نشانی وب را تایپ کنید	`N/A`
قابل فیلتر کردن	True
قابل‌انتخاب	True
مرتب‌شدنی	True
تکرارشده	نادرست

metrics.all_conversions
شرح فیلد	تعداد کل تبدیل‌ها. این شامل همه تبدیل‌ها بدون درنظر گرفتن مقدار include_in_conversions_metric می‌شود.
دسته	`METRIC`
نوع داده	`DOUBLE`
نشانی وب را تایپ کنید	`N/A`
قابل فیلتر کردن	True
قابل‌انتخاب	True
مرتب‌شدنی	True
تکرارشده	نادرست

metrics.all_conversions_from_interactions_rate
شرح فیلد	کل تبدیل‌های حاصل از تعامل‌ها (درمقابل تبدیل‌های بازدیدِ گذری) تقسیم بر تعداد تعامل‌ها با آگهی.
دسته	`METRIC`
نوع داده	`DOUBLE`
نشانی وب را تایپ کنید	`N/A`
قابل فیلتر کردن	True
قابل‌انتخاب	True
مرتب‌شدنی	True
تکرارشده	نادرست

metrics.all_conversions_from_interactions_value_per_interaction
شرح فیلد	مقدار همه تبدیل‌ها از تعامل‌ها تقسیم بر تعداد کل تعامل‌ها.
دسته	`METRIC`
نوع داده	`DOUBLE`
نشانی وب را تایپ کنید	`N/A`
قابل فیلتر کردن	True
قابل‌انتخاب	True
مرتب‌شدنی	True
تکرارشده	نادرست

metrics.all_conversions_value
شرح فیلد	ارزش همه تبدیل‌ها.
دسته	`METRIC`
نوع داده	`DOUBLE`
نشانی وب را تایپ کنید	`N/A`
قابل فیلتر کردن	True
قابل‌انتخاب	True
مرتب‌شدنی	True
تکرارشده	نادرست

metrics.all_conversions_value_per_cost
شرح فیلد	مقدار همه تبدیل‌ها تقسیم بر هزینه کل تعامل‌ها با آگهی (مثل کلیک‌های آگهی‌های نوشتاری یا بازدیدهای تبلیغ‌های ویدیویی).
دسته	`METRIC`
نوع داده	`DOUBLE`
نشانی وب را تایپ کنید	`N/A`
قابل فیلتر کردن	True
قابل‌انتخاب	True
مرتب‌شدنی	True
تکرارشده	نادرست

metrics.average_cost
شرح فیلد	میانگین مبلغی که برای هر تعامل می‌پردازید. این مقدار عبارت است از هزینه کل آگهی‌هایتان تقسیم بر تعداد کل تعامل‌ها.
دسته	`METRIC`
نوع داده	`DOUBLE`
نشانی وب را تایپ کنید	`N/A`
قابل فیلتر کردن	True
قابل‌انتخاب	True
مرتب‌شدنی	True
تکرارشده	نادرست

metrics.average_cpc
شرح فیلد	کل هزینه همه کلیک‌ها تقسیم بر تعداد کل کلیک‌های دریافتی. این سنجه یک مقدار پولی است و به‌طور پیش‌فرض به واحد پول مشتری برگردانده می‌شود. پارامتر `metrics_currency` را در بند PARAMETERS ببینید.
دسته	`METRIC`
نوع داده	`DOUBLE`
نشانی وب را تایپ کنید	`N/A`
قابل فیلتر کردن	True
قابل‌انتخاب	True
مرتب‌شدنی	True
تکرارشده	نادرست

metrics.average_cpm
شرح فیلد	هزارظهوربهای میانگین (CPM). این سنجه یک مقدار پولی است و به‌طور پیش‌فرض به واحد پول مشتری برگردانده می‌شود. پارامتر `metrics_currency` را در بند PARAMETERS ببینید.
دسته	`METRIC`
نوع داده	`DOUBLE`
نشانی وب را تایپ کنید	`N/A`
قابل فیلتر کردن	True
قابل‌انتخاب	True
مرتب‌شدنی	True
تکرارشده	نادرست

metrics.clicks
شرح فیلد	تعداد کلیک‌ها.
دسته	`METRIC`
نوع داده	`INT64`
نشانی وب را تایپ کنید	`N/A`
قابل فیلتر کردن	True
قابل‌انتخاب	True
مرتب‌شدنی	True
تکرارشده	نادرست

metrics.client_account_conversions
شرح فیلد	تعداد تبدیل‌های حساب مشتری. این فقط شامل کنش‌های تبدیلی می‌شود که مشخصه `include_in_client_account_conversions_metric` آن‌ها روی `true` تنظیم شده است. اگر از پیشنهاد قیمت تبدیل‌محور استفاده می‌کنید، استراتژی‌های پیشنهاد قیمت شما برای این تبدیل‌ها بهینه‌سازی خواهند شد.
دسته	`METRIC`
نوع داده	`DOUBLE`
نشانی وب را تایپ کنید	`N/A`
قابل فیلتر کردن	True
قابل‌انتخاب	True
مرتب‌شدنی	True
تکرارشده	نادرست

metrics.client_account_conversions_value
شرح فیلد	ارزش تبدیل‌های حساب مشتری. این فقط شامل کنش‌های تبدیلی می‌شود که مشخصه `include_in_client_account_conversions_metric` آن‌ها روی `true` تنظیم شده است. اگر از پیشنهاد قیمت تبدیل‌محور استفاده می‌کنید، استراتژی‌های پیشنهاد قیمت شما برای این تبدیل‌ها بهینه‌سازی خواهند شد.
دسته	`METRIC`
نوع داده	`DOUBLE`
نشانی وب را تایپ کنید	`N/A`
قابل فیلتر کردن	True
قابل‌انتخاب	True
مرتب‌شدنی	True
تکرارشده	نادرست

metrics.client_account_view_through_conversions
شرح فیلد	تعداد کل تبدیل‌های پس‌از مشاهده. این تبدیل‌ها زمانی اتفاق می‌افتند که مشتری آگهی تصویری یا رسانه‌ای پیشرفته‌ای را می‌بیند و سپس بدون تعامل با آگهی دیگری (مثلاً کلیک کردن روی آن)، تبدیلی را در سایت شما تکمیل می‌کند.
دسته	`METRIC`
نوع داده	`INT64`
نشانی وب را تایپ کنید	`N/A`
قابل فیلتر کردن	True
قابل‌انتخاب	True
مرتب‌شدنی	True
تکرارشده	نادرست

metrics.conversions_from_interactions_value_per_interaction
شرح فیلد	مقدار تبدیل‌های ناشی‌از تعامل‌ها تقسیم بر تعداد تعامل‌ها با آگهی. این فقط شامل کنش‌های تبدیلی می‌شود که مشخصه `include_in_conversions_metric` آن‌ها روی `true` تنظیم شده است. اگر از پیشنهاد قیمت تبدیل‌محور استفاده می‌کنید، استراتژی‌های پیشنهاد قیمت شما برای این تبدیل‌ها بهینه‌سازی خواهند شد.
دسته	`METRIC`
نوع داده	`DOUBLE`
نشانی وب را تایپ کنید	`N/A`
قابل فیلتر کردن	True
قابل‌انتخاب	True
مرتب‌شدنی	True
تکرارشده	نادرست

metrics.cost_micros
شرح فیلد	مجموع هزینه‌های کلیک‌بها (CPC) و هزارظهوربها (CPM) درطول این دوره. این سنجه یک مقدار پولی است و به‌طور پیش‌فرض به واحد پول مشتری برگردانده می‌شود. برای جزئیات بیشتر، پارامتر `metrics_currency` را در بند PARAMETERS ببینید.
دسته	`METRIC`
نوع داده	`INT64`
نشانی وب را تایپ کنید	`N/A`
قابل فیلتر کردن	True
قابل‌انتخاب	True
مرتب‌شدنی	True
تکرارشده	نادرست

metrics.cost_per_all_conversions
شرح فیلد	هزینه تعامل‌ها با آگهی تقسیم بر همه تبدیل‌ها.
دسته	`METRIC`
نوع داده	`DOUBLE`
نشانی وب را تایپ کنید	`N/A`
قابل فیلتر کردن	True
قابل‌انتخاب	True
مرتب‌شدنی	True
تکرارشده	نادرست

metrics.cross_device_conversions
شرح فیلد	تبدیل‌هایی که وقتی مشتری روی آگهی در یک دستگاه کلیک می‌کند، سپس در دستگاه یا مرورگر دیگری تبدیل می‌شود. تبدیل‌های بین‌دستگاهی قبلاً در `all_conversions` گنجانده شده است.
دسته	`METRIC`
نوع داده	`DOUBLE`
نشانی وب را تایپ کنید	`N/A`
قابل فیلتر کردن	True
قابل‌انتخاب	True
مرتب‌شدنی	True
تکرارشده	نادرست

metrics.cross_device_conversions_value
شرح فیلد	مجموع مقدار تبدیل‌های بین‌دستگاهی.
دسته	`METRIC`
نوع داده	`DOUBLE`
نشانی وب را تایپ کنید	`N/A`
قابل فیلتر کردن	True
قابل‌انتخاب	True
مرتب‌شدنی	True
تکرارشده	نادرست

metrics.ctr
شرح فیلد	تعداد کلیک‌هایی که آگهی‌تان دریافت می‌کند (کلیک‌ها) تقسیم بر تعداد دفعاتی که آگهی‌تان نشان داده می‌شود (ظهورها).
دسته	`METRIC`
نوع داده	`DOUBLE`
نشانی وب را تایپ کنید	`N/A`
قابل فیلتر کردن	True
قابل‌انتخاب	True
مرتب‌شدنی	True
تکرارشده	نادرست

metrics.impressions
شرح فیلد	تعداد دفعاتی که آگهی شما در صفحه نتایج جستجو یا وب‌سایتی در «شبکه Google» نشان داده شده است.
دسته	`METRIC`
نوع داده	`INT64`
نشانی وب را تایپ کنید	`N/A`
قابل فیلتر کردن	True
قابل‌انتخاب	True
مرتب‌شدنی	True
تکرارشده	نادرست

metrics.interaction_event_types
شرح فیلد	انواع تعامل‌های قابل پرداخت و رایگان.
دسته	`METRIC`
نوع داده	`ENUM`
نشانی وب را تایپ کنید	`google.ads.searchads360.v0.enums.InteractionEventTypeEnum.InteractionEventType`
قابل فیلتر کردن	True
قابل‌انتخاب	True
مرتب‌شدنی	نادرست
تکرارشده	True

metrics.interaction_rate
شرح فیلد	تعداد دفعاتی که افراد پس‌از دیدن آگهی‌تان با آن تعامل می‌کنند. این تعداد تعامل‌ها تقسیم بر تعداد دفعاتی است که آگهی شما نشان داده شده است.
دسته	`METRIC`
نوع داده	`DOUBLE`
نشانی وب را تایپ کنید	`N/A`
قابل فیلتر کردن	True
قابل‌انتخاب	True
مرتب‌شدنی	True
تکرارشده	نادرست

metrics.interactions
شرح فیلد	تعداد تعامل‌ها. تعامل کنش اصلی کاربر همراه با قالب آگهی است - کلیک برای آگهی‌های نوشتاری و Shopping، بازدید برای تبلیغ‌های ویدیویی، و غیره.
دسته	`METRIC`
نوع داده	`INT64`
نشانی وب را تایپ کنید	`N/A`
قابل فیلتر کردن	True
قابل‌انتخاب	True
مرتب‌شدنی	True
تکرارشده	نادرست

metrics.top_impression_percentage
شرح فیلد	درصدی از ظهورهای آگهی شما که در کنار نتایج جستجوی عادی بالای صفحه نشان داده می‌شود.
دسته	`METRIC`
نوع داده	`DOUBLE`
نشانی وب را تایپ کنید	`N/A`
قابل فیلتر کردن	True
قابل‌انتخاب	True
مرتب‌شدنی	True
تکرارشده	نادرست

metrics.value_per_all_conversions
شرح فیلد	مقدار همه تبدیل‌ها تقسیم بر تعداد همه تبدیل‌ها.
دسته	`METRIC`
نوع داده	`DOUBLE`
نشانی وب را تایپ کنید	`N/A`
قابل فیلتر کردن	True
قابل‌انتخاب	True
مرتب‌شدنی	True
تکرارشده	نادرست

customer_asset با مجموعه‌ها، منظم بمانید ذخیره و طبقه‌بندی محتوا براساس اولویت‌های شما.

فیلدها/بخش‌ها/سنجه‌ها

customer_asset.asset

customer_asset.resource_name

customer_asset.status

segments.ad_format_type

segments.ad_network_type

segments.asset_interaction_target.asset

segments.asset_interaction_target.interaction_on_this_asset

segments.conversion_action

segments.conversion_action_category

segments.conversion_action_name

segments.date

segments.day_of_week

segments.device

segments.month

segments.quarter

segments.week

segments.year

metrics.absolute_top_impression_percentage

metrics.all_conversions

metrics.all_conversions_from_interactions_rate

metrics.all_conversions_from_interactions_value_per_interaction

metrics.all_conversions_value

metrics.all_conversions_value_per_cost

metrics.average_cost

metrics.average_cpc

metrics.average_cpm

metrics.clicks

metrics.client_account_conversions

metrics.client_account_conversions_value

metrics.client_account_view_through_conversions

metrics.conversions_from_interactions_value_per_interaction

metrics.cost_micros

metrics.cost_per_all_conversions

metrics.cross_device_conversions

metrics.cross_device_conversions_value

metrics.ctr

metrics.impressions

metrics.interaction_event_types

metrics.interaction_rate

metrics.interactions

metrics.top_impression_percentage

metrics.value_per_all_conversions

customer_asset