Niestandardowe zmienne konwersji
Zadbaj o dobrą organizację dzięki kolekcji
Zapisuj i kategoryzuj treści zgodnie ze swoimi preferencjami.
Niestandardowe zmienne konwersji umożliwiają powiązanie dodatkowych informacji w formie tagów z konwersją importowaną za pomocą interfejsu Google Ads API, np. z konwersjami po kliknięciu lub połączeniu. Dzięki tym informacjom możesz tworzyć raporty podzielone na segmenty, które dostarczają bogatszych danych o konwersjach.
Na przykład podczas importowania konwersji dotyczącej zakupu nowego niebieskiego kapelusza możesz też zaimportować 2 powiązane tagi: color
i status
z wartościami odpowiednio blue
i new
. Aby to zrobić:
Możesz utworzyć dowolną liczbę zmiennych niestandardowych konwersji. Każda zmienna odpowiada jednemu tagowi. Jeśli więc chcesz mieć 2 tagi (color
i status
), musisz utworzyć 2 zmienne niestandardowe. Wymagane pola dla ConversionCustomVariable
to:
name
: identyfikuje zmienną. Nazwa musi być unikalna.
tag
: w naszym przykładzie tagi to color
i status
. Tagi są używane we fragmencie kodu zdarzenia, gdy witryna wysyła do Google Ads konwersję. Jeśli korzystasz z interfejsu Google Ads API, podczas importowania konwersji musisz podać nazwę zasobu zmiennych niestandardowych, jak opisano w następnym kroku.
Podczas importowania konwersji, np. ClickConversion
, ustaw custom_variables
na listę wszystkich zmiennych niestandardowych utworzonych w poprzednim kroku. Musisz ustawić wszystkie pola każdej zmiennej niestandardowej:
conversion_custom_variable
:
Nazwa zasobu zmiennej niestandardowej utworzonej w poprzednim kroku.
value
: wartość tagu, który chcesz powiązać z konwersją. W naszym przykładzie: blue
i new
.
O ile nie stwierdzono inaczej, treść tej strony jest objęta licencją Creative Commons – uznanie autorstwa 4.0, a fragmenty kodu są dostępne na licencji Apache 2.0. Szczegółowe informacje na ten temat zawierają zasady dotyczące witryny Google Developers. Java jest zastrzeżonym znakiem towarowym firmy Oracle i jej podmiotów stowarzyszonych.
Ostatnia aktualizacja: 2025-08-26 UTC.
[null,null,["Ostatnia aktualizacja: 2025-08-26 UTC."],[[["\u003cp\u003eCustom conversion variables allow associating additional information, like tags, to conversions uploaded via the Google Ads API.\u003c/p\u003e\n"],["\u003cp\u003eTo use custom variables, first create them, defining a unique name and tag for each desired piece of information.\u003c/p\u003e\n"],["\u003cp\u003eWhen uploading a conversion, include the custom variables, specifying their resource name and the corresponding value for the tag.\u003c/p\u003e\n"],["\u003cp\u003eThis process lets you add details like 'color' or 'status' to conversions, enabling richer data analysis and reporting.\u003c/p\u003e\n"]]],[],null,["# Custom Conversion Variables\n\n[Custom conversion variables](//support.google.com/google-ads/answer/9964350)\nlet you associate additional information, in the form of tags, to a conversion\nthat you import using the Google Ads API, such as click or call conversions. With this\ninformation, you can create segmented reports that provide richer data about\nyour conversions.\n\nFor example, when importing a conversion for the purchase of a new blue hat,\nyou could also import two associated tags: `color` and `status` with the values\n`blue` and `new`, respectively. Here are the steps:\n\n1. Create as many custom conversion variables as you need. Each variable\n corresponds to one tag. Therefore, if you want two tags (`color` and\n `status`), you need to create two custom variables. The required fields for\n [`ConversionCustomVariable`](/google-ads/api/reference/rpc/v21/ConversionCustomVariable) are as\n follows:\n\n | **Note:** See [`ConversionCustomVariable`](/google-ads/api/reference/rpc/v21/ConversionCustomVariable) for limitations on its fields.\n - [`name`](/google-ads/api/reference/rpc/v21/ConversionCustomVariable#name): Identifies the variable. The name must be unique.\n - [`tag`](/google-ads/api/reference/rpc/v21/ConversionCustomVariable#tag): For our example, the tags are `color` and `status`. Tags are used in the [event\n snippet](//support.google.com/google-ads/answer/9962082#Add&zippy=%2Cconversion-tracking-using-tags-on-your-website) when a conversion is sent to Google Ads by your website. If you use the Google Ads API, you would need to specify the resource name of the custom variables when importing conversions, as detailed in the next step.\n2. When importing a conversion, such as\n [`ClickConversion`](/google-ads/api/reference/rpc/v21/ClickConversion), set\n [`custom_variables`](/google-ads/api/reference/rpc/v21/ClickConversion#custom_variables%5B%5D) to\n the list of all custom variables you created in the previous step. You need\n to set all the fields of each custom variable:\n\n - [`conversion_custom_variable`](/google-ads/api/reference/rpc/v21/CustomVariable#conversion_custom_variable): The resource name of the custom variable you created in the previous step.\n - [`value`](/google-ads/api/reference/rpc/v21/CustomVariable#conversion_custom_variable): The value for the tag you want to associate with the conversion. For our example: `blue` and `new`."]]