カスタム コンバージョン変数
コレクションでコンテンツを整理
必要に応じて、コンテンツの保存と分類を行います。
カスタム コンバージョン変数を使用すると、Google Ads API を使用してインポートするコンバージョン(クリック コンバージョンや通話コンバージョンなど)に、タグの形式で追加情報を関連付けることができます。この情報を使用して、コンバージョンに関する豊富なデータを提供するセグメント化されたレポートを作成できます。
たとえば、新しい青い帽子の購入のコンバージョンをインポートする際に、関連する 2 つのタグ(color
と status
)もインポートできます。それぞれの値は blue
と new
です。手順は次のとおりです。
カスタム コンバージョン変数は必要に応じていくつでも作成できます。各変数は 1 つのタグに対応します。そのため、2 つのタグ(color
と status
)が必要な場合は、2 つのカスタム変数を作成する必要があります。ConversionCustomVariable
の必須フィールドは次のとおりです。
name
: 変数を識別します。名前は一意である必要があります。
tag
: この例では、タグは color
と status
です。タグは、ウェブサイトから Google 広告にコンバージョンが送信されるときに、イベント スニペットで使用されます。Google 広告 API を使用する場合は、次の手順で説明するように、コンバージョンをインポートする際にカスタム変数のリソース名を指定する必要があります。
ClickConversion
などのコンバージョンをインポートする場合は、custom_variables
を前の手順で作成したすべてのカスタム変数のリストに設定します。各カスタム変数のすべてのフィールドを設定する必要があります。
特に記載のない限り、このページのコンテンツはクリエイティブ・コモンズの表示 4.0 ライセンスにより使用許諾されます。コードサンプルは Apache 2.0 ライセンスにより使用許諾されます。詳しくは、Google Developers サイトのポリシーをご覧ください。Java は Oracle および関連会社の登録商標です。
最終更新日 2025-09-05 UTC。
[null,null,["最終更新日 2025-09-05 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`."]]