검색어당 conversion_custom_dimensions 세그먼트는 하나만 선택할 수 있습니다.
conversion_custom_metrics 및 conversion_custom_dimensions를 동일한 쿼리에서 선택할 수 없습니다.
conversion_custom_metrics 및 conversion_custom_dimensions는 ad_group, ad_group_ad, ad_group_criterion, 캠페인, 고객 리소스에만 사용할 수 있습니다.
전환 리소스의 원시 이벤트 속성으로 CFV 사용
전환 리소스에서 맞춤 플러드라이트 변수(CFV)는 개별 전환에 대해 집계되지 않은 자세한 데이터를 제공합니다. 맞춤 측정기준이 쿼리에 추가되면 각 이벤트의 특정 값이 표시됩니다. 예를 들어 제품 유형과 브랜드를 CFV로 추적하는 경우 다음 데이터를 보여주는 보고서를 만들 수 있습니다.
전환 ID
타임스탬프
제품 유형
브랜드
20001
202311101030
전자제품
예시 브랜드 1
20002
202311101045
의류
예시 브랜드 2
20003
202311101215
전자제품
브랜드 3의 예
전환 리소스에서는 판매 수와 같은 측정항목이 집계된 수치가 아닌 개별 이벤트 데이터로 표시됩니다. 각 전환 이벤트는 CFV 측정항목과 측정기준을 모두 특정 이벤트 속성으로 취급하여 별도로 자세히 설명합니다.
[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."]]
