Search Ads 360 Reporting API เวอร์ชันใหม่พร้อมให้ใช้งานแล้ว เข้าร่วมกลุ่ม Google searchads-api-announcements เพื่อติดตามการปรับปรุงและรุ่นที่กำลังจะเปิดตัว
[null,null,["อัปเดตล่าสุด 2025-08-29 UTC"],[[["\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."]]
