Variáveis de conversão personalizadas
Mantenha tudo organizado com as coleções Salve e categorize o conteúdo com base nas suas preferências.
As variáveis de conversão personalizadas permitem associar outras informações, na forma de tags, a uma conversão importada usando a API Google Ads, como conversões de clique ou chamada. Com essas informações, você pode criar relatórios segmentados que fornecem dados mais avançados sobre suas conversões.
Por exemplo, ao importar uma conversão para a compra de um novo chapéu azul, você também pode importar duas tags associadas: color
e status
com os valores blue
e new
, respectivamente. Siga estas etapas:
Crie quantas variáveis de conversão personalizadas forem necessárias. Cada variável corresponde a uma tag. Portanto, se você quiser duas tags (color
e status
), crie duas variáveis personalizadas. Os campos obrigatórios para ConversionCustomVariable
são estes:
name
: identifica a variável. O nome precisa ser único. tag
: no nosso exemplo, as tags são color
e status
. As tags são usadas no snippet de evento quando uma conversão é enviada ao Google Ads pelo seu site. Se você usar a API Google Ads, vai precisar especificar o nome do recurso das variáveis personalizadas ao importar conversões, conforme detalhado na próxima etapa.
Ao importar uma conversão, como ClickConversion
, defina custom_variables
como a lista de todas as variáveis personalizadas que você criou na etapa anterior. É necessário definir todos os campos de cada variável personalizada:
conversion_custom_variable
: o nome do recurso da variável personalizada que você criou na etapa anterior. value
: o valor da tag que você quer associar à conversão. No nosso exemplo: blue
e new
.
Exceto em caso de indicação contrária, o conteúdo desta página é licenciado de acordo com a Licença de atribuição 4.0 do Creative Commons, e as amostras de código são licenciadas de acordo com a Licença Apache 2.0. Para mais detalhes, consulte as políticas do site do Google Developers. Java é uma marca registrada da Oracle e/ou afiliadas.
Última atualização 2025-08-21 UTC.
[[["Fácil de entender","easyToUnderstand","thumb-up"],["Meu problema foi resolvido","solvedMyProblem","thumb-up"],["Outro","otherUp","thumb-up"]],[["Não contém as informações de que eu preciso","missingTheInformationINeed","thumb-down"],["Muito complicado / etapas demais","tooComplicatedTooManySteps","thumb-down"],["Desatualizado","outOfDate","thumb-down"],["Problema na tradução","translationIssue","thumb-down"],["Problema com as amostras / o código","samplesCodeIssue","thumb-down"],["Outro","otherDown","thumb-down"]],["Última atualização 2025-08-21 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](//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/v20/ConversionCustomVariable) are as\n follows:\n\n | **Note:** See [`ConversionCustomVariable`](/google-ads/api/reference/rpc/v20/ConversionCustomVariable) for limitations on its fields.\n - [`name`](/google-ads/api/reference/rpc/v20/ConversionCustomVariable#name): Identifies the variable. The name must be unique.\n - [`tag`](/google-ads/api/reference/rpc/v20/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/v20/ClickConversion), set\n [`custom_variables`](/google-ads/api/reference/rpc/v20/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/v20/CustomVariable#conversion_custom_variable): The resource name of the custom variable you created in the previous step.\n - [`value`](/google-ads/api/reference/rpc/v20/CustomVariable#conversion_custom_variable): The value for the tag you want to associate with the conversion. For our example: `blue` and `new`."]]