API جدید Search Ads 360 Reporting اکنون در دسترس است. به گروه Google searchads-api-announcements بپیوندید تا در مورد پیشرفت‌ها و نسخه‌های آینده به‌روز باشید.
با مجموعهها، منظم بمانید
ذخیره و طبقهبندی محتوا براساس اولویتهای شما.
متغیرهای Floodlight سفارشی (CFVs) شما را قادر می‌سازند تا جزئیات مربوط به هر تبدیل ردیابی شده در فعالیت Floodlight را جمع‌آوری کنید. این متغیرها می توانند شامل اطلاعاتی مانند نوع محصول خریداری شده، وضعیت وفاداری مشتری یا میزان تخفیف اعمال شده باشند.
Search Ads 360 مقادیر متغیرهای تنظیم شده به عنوان معیار را جمع آوری می کند. برای مثال، اگر تبلیغ‌کننده‌ای ارزش طول عمر مشتری (CLV) را به‌عنوان یک معیار متغیر سفارشی Floodlight ردیابی کند، گنجاندن آن در منبع گروه آگهی ، CLV جمع‌آوری شده را برای هر گروه آگهی در منبع نشان می‌دهد.
CFV هایی که به عنوان ابعاد تعریف می شوند می توانند برای تقسیم بندی منابع استفاده شوند. برای مثال، یک تبلیغ‌کننده می‌تواند از یک CFV برای ردیابی دسته‌های محصول استفاده کند. پس از تنظیم به عنوان یک بعد، این امکان را به بخش بندی یک منبع گروه تبلیغاتی می دهد تا تعداد تبدیل های نسبت داده شده به هر دسته محصول در گروه تبلیغات را نشان دهد.
برای دریافت تمام متغیرهای سفارشی موجود، موارد زیر را اجرا کنید:
فقط یک بخش conversion_custom_dimensions را می توان در هر پرس و جو انتخاب کرد.
conversion_custom_metrics و conversion_custom_dimensions را نمی توان در یک جستار انتخاب کرد.
conversion_custom_metrics و conversion_custom_dimensions فقط با ad_group، ad_group_ad، ad_group_criterion، کمپین و منابع مشتری قابل استفاده هستند.
CFV به عنوان ویژگی های رویداد خام در منبع تبدیل
در منبع Conversion ، متغیرهای Floodlight سفارشی (CFVs) داده‌های دقیق و تجمیع‌نشده درباره تبدیل‌های فردی را ارائه می‌کنند. هنگامی که یک بعد سفارشی به پرس و جو اضافه می شود، مقدار خاص آن برای هر رویداد قابل مشاهده است. برای مثال، اگر انواع محصول و برندها را به‌عنوان CFV دنبال می‌کنید، می‌توانید گزارشی ایجاد کنید که داده‌های زیر را نشان می‌دهد:
شناسه تبدیل
مهر زمان
نوع محصول
نام تجاری
20001
202311101030
الکترونیک
نمونه برند 1
20002
202311101045
پوشاک
نمونه برند 2
20003
202311101215
الکترونیک
نمونه برند 3
توجه به این نکته مهم است که در منبع تبدیل، معیارهایی مانند Number Sold به عنوان داده های رویداد فردی ارائه می شود، نه به عنوان ارقام انبوه. هر رویداد تبدیل به طور جداگانه به تفصیل بیان می‌شود، و هم معیارهای CFV و هم ابعاد را به عنوان ویژگی‌های رویداد خاص در نظر می‌گیرد.
برای دریافت تمام متغیرهای سفارشی موجود، موارد زیر را اجرا کنید:
تاریخ آخرین بهروزرسانی 2025-08-29 بهوقت ساعت هماهنگ جهانی.
[null,null,["تاریخ آخرین بهروزرسانی 2025-08-29 بهوقت ساعت هماهنگ جهانی."],[[["\u003cp\u003eCustom Floodlight variables (CFVs) allow you to gather specific details about each conversion, such as product type, customer loyalty, or discount applied, enhancing your understanding of customer interactions.\u003c/p\u003e\n"],["\u003cp\u003eCFVs can function as both metrics, providing aggregated data for analysis (e.g., total CLV per ad group), and dimensions, enabling segmentation for deeper insights (e.g., conversions by product category).\u003c/p\u003e\n"],["\u003cp\u003eWithin the Conversion resource, CFVs act as raw event attributes, revealing detailed information about each individual conversion, like product type and brand for each purchase.\u003c/p\u003e\n"],["\u003cp\u003eSearch Ads 360 offers flexibility in utilizing CFVs, but certain restrictions apply, such as limiting to one conversion_custom_dimensions segment per query and specific resource compatibility.\u003c/p\u003e\n"]]],["Custom Floodlight Variables (CFVs) track conversion details, such as product type or customer loyalty. CFVs defined as metrics aggregate values, like total customer lifetime value, within resources such as ad groups. CFVs set as dimensions segment resources, enabling breakdowns by categories like product type. To retrieve all available CFVs, the `conversion_custom_variable` resource must be queried. CFVs provide detailed, individual conversion data, showing each event's attributes. There are limitations in the queries, such as not being able to combine metrics and dimensions.\n"],null,["# Custom Floodlight metrics\n\nCustom Floodlight variables (CFVs) enable you to collect details about each\nconversion tracked in a Floodlight activity. These variables can include\ninformation like the type of product purchased, the loyalty status of the\ncustomer, or the amount of discount applied.\n\nFor more information, see [About custom Floodlight metrics and dimensions in the\nnew Search Ads 360](https://support.google.com/sa360/answer/13567857).\n\nCFVs as metrics and segments\n----------------------------\n\nSearch Ads 360 aggregates the values of variables set as metrics. For example,\nif an advertiser tracks customer lifetime value (CLV) as a custom Floodlight\nvariable metric, including this in the [ad group](/search-ads/reporting/api/reference/fields/v0/ad_group) resource\nwould show the aggregated CLV for each ad group within the resource.\n\nCFVs defined as dimensions can be used to segment resources. For example, an\nadvertiser could use a CFV to track product categories. Once set as a dimension,\nthis allows segmentation of an ad group resource to show the number of\nconversions attributed to each product category within the ad group.\n\nTo get all available custom variables, execute the following: \n\n SELECT conversion_custom_variable.id,\n conversion_custom_variable.name,\n conversion_custom_variable.tag,\n conversion_custom_variable.floodlight_conversion_custom_variable_info.floodlight_variable_type\n FROM conversion_custom_variable\n\n### CFV as metrics and segments examples\n\nAfter you have the conversion_custom_variable ID and variable type, you can\nbuild your own query similar to the following examples: \n\n SELECT conversion_custom_metrics.id[1234]\n FROM campaign\n WHERE segments.date=20240118\n\n SELECT conversion_custom_dimensions.id[1234]\n FROM campaign\n WHERE segments.date=20240118\n\n#### Restrictions\n\n- Only one conversion_custom_dimensions segment can be selected per query.\n\n- conversion_custom_metrics and conversion_custom_dimensions cannot be\n selected in the same query.\n\n- conversion_custom_metrics and conversion_custom_dimensions\n can only be used with ad_group, ad_group_ad, ad_group_criterion, campaign and\n customer resources.\n\nCFV as Raw Event Attributes in the Conversion Resource\n------------------------------------------------------\n\nIn the [Conversion](/search-ads/reporting/api/reference/fields/v0/conversion) resource, custom Floodlight variables\n(CFVs) provide detailed, unaggregated data about individual conversions. When a\ncustom dimension is added to the query, its specific value for each event is\nvisible. For example, if you track product types and brands as CFVs, you could\ncreate a report showing the following data:\n\n| Conversion ID | Timestamp | Product Type | Brand |\n|---------------|--------------|--------------|-----------------|\n| 20001 | 202311101030 | Electronics | Example Brand 1 |\n| 20002 | 202311101045 | Apparel | Example Brand 2 |\n| 20003 | 202311101215 | Electronics | Example Brand 3 |\n\nIt's important to note that in the conversion resource, metrics such as Number\nSold are presented as individual event data, not as aggregated figures. Each\nconversion event is detailed separately, treating both CFV metrics and\ndimensions as specific event attributes.\n\nTo get all available custom variables, execute the following: \n\n SELECT conversion_custom_variable.id,\n conversion_custom_variable.name,\n conversion_custom_variable.tag,\n conversion_custom_variable.floodlight_conversion_custom_variable_info.floodlight_variable_type\n FROM conversion_custom_variable\n\nAfter you have the conversion_custom_variable ID and variable type, you can\nbuild your own query similar to the following example\n\n### CFV as a raw event example\n\n SELECT raw_event_conversion_dimensions.id[1234],\n raw_event_conversion_metrics.id[5678]\n FROM conversion\n WHERE segments.date=20240118\n\n| **Note:** raw_event_conversion_dimensions and raw_event_conversion_metrics can only be used with the conversion resource."]]
