Dostępny jest już nowy interfejs Search Ads 360 Reporting API. Dołącz do grupy dyskusyjnej Google searchads-api-announcements, aby na bieżąco otrzymywać informacje o nadchodzących ulepszeniach i wersjach.
Zadbaj o dobrą organizację dzięki kolekcji
Zapisuj i kategoryzuj treści zgodnie ze swoimi preferencjami.
Niestandardowe zmienne Floodlight (CFV) umożliwiają zbieranie szczegółowych informacji o każdej konwersji śledzonej w aktywności Floodlight. Zmienne te mogą zawierać informacje takie jak typ zakupionego produktu, stan programu lojalnościowego klienta czy wysokość zastosowanych rabatów.
Search Ads 360 agreguje wartości zmiennych ustawionych jako dane. Jeśli np. reklamodawca śledzi długookresową wartość klienta (CLV) jako niestandardowe dane Floodlight, uwzględnienie tego w zasobach grupy reklam spowoduje wyświetlenie zbiorczej wartości CLV dla każdej grupy reklam w tym zasobie.
Wartości CFV zdefiniowane jako wymiary można stosować do segmentowania zasobów. Na przykład reklamodawca może używać CFV do śledzenia kategorii produktów. Po ustawieniu jako wymiar umożliwia ona podział zasobu grupy reklam na segmenty, aby wyświetlać liczbę konwersji przypisanych do każdej kategorii produktów w grupie reklam.
Aby uzyskać dostęp do wszystkich dostępnych zmiennych niestandardowych:
W każdym zapytaniu można wybrać tylko 1 segment conversion_custom_dimensions.
W tym samym zapytaniu nie można wybierać kolumn conversion_custom_metrics ani conversion_custom_dimensions.
Parametrów conversion_custom_metrics i conversion_custom_dimensions można używać tylko w przypadku zasobów ad_group, ad_group_ad, ad_group_criterion, campaign i customer.
Zmienna CFV jako nieprzetworzone atrybuty zdarzenia w zasobie konwersji
W zasobie Konwersja niestandardowe zmienne Floodlight (CFV) dostarczają szczegółowych, niezagregowanych danych o poszczególnych konwersjach. Gdy do zapytania zostanie dodany wymiar niestandardowy, jego konkretna wartość dla każdego zdarzenia będzie widoczna. Jeśli na przykład śledzisz typy produktów i marki jako atrybuty CFV, możesz utworzyć raport z tymi danymi:
Identyfikator konwersji
Sygnatura czasowa
Typ usługi
Marka
20001
202311101030
Elektronika
Przykładowa marka 1
20002
202311101045
Odzież
Przykładowa marka 2
20003
202311101215
Elektronika
Przykładowa marka 3
Pamiętaj, że w zasobie konwersji dane takie jak „Sprzedana liczba” są przedstawiane jako dane pojedynczego zdarzenia, a nie jako dane zbiorcze. Każde zdarzenie konwersji jest szczegółowo opisane oddzielnie, a dane i wymiary dotyczące CFV są traktowane jako określone atrybuty zdarzenia.
Aby uzyskać wszystkie dostępne zmienne niestandardowe, wykonaj to polecenie:
[[["Łatwo zrozumieć","easyToUnderstand","thumb-up"],["Rozwiązało to mój problem","solvedMyProblem","thumb-up"],["Inne","otherUp","thumb-up"]],[["Brak potrzebnych mi informacji","missingTheInformationINeed","thumb-down"],["Zbyt skomplikowane / zbyt wiele czynności do wykonania","tooComplicatedTooManySteps","thumb-down"],["Nieaktualne treści","outOfDate","thumb-down"],["Problem z tłumaczeniem","translationIssue","thumb-down"],["Problem z przykładami/kodem","samplesCodeIssue","thumb-down"],["Inne","otherDown","thumb-down"]],["Ostatnia aktualizacja: 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."]]