カスタム コンバージョン変数を使用すると、Google Ads API を使用してインポートするコンバージョン（クリック コンバージョンや通話コンバージョンなど）に、タグの形式で追加情報を関連付けることができます。この情報を使用すると、コンバージョンに関するリッチデータを提供するセグメント化されたレポートを作成できます。
たとえば、新しい青い帽子の購入に関するコンバージョンをインポートする場合、関連する 2 つのタグ（color と status）をインポートし、それぞれに blue と new の値を設定できます。手順は次のとおりです。
カスタム コンバージョン変数は、必要に応じていくつでも作成できます（アカウントの上限は、1 つの顧客アカウントにつき 50 個のカスタム コンバージョン変数です）。各変数は 1 つのタグに対応します。したがって、2 つのタグ（
colorとstatus）が必要な場合は、2 つのカスタム変数を作成する必要があります。ConversionCustomVariableの必須フィールドは次のとおりです。name: 変数を識別します。名前は、顧客アカウント全体で一意である必要があります。tag: この例では、タグはcolorとstatusです。tagは、お客様のアカウント全体で一意である必要があります。スペースを含めることはできません。タグは、ウェブサイトから Google 広告にコンバージョンが送信される際に、イベント スニペットで使用されます。Google Ads API を使用する場合は、次のステップで説明するように、コンバージョンをインポートするときにカスタム変数のリソース名を指定する必要があります。
カスタム コンバージョン変数を作成または更新するなど、カスタム コンバージョン変数を管理するには、
ConversionCustomVariableServiceを使用します。具体的には、新しいカスタム コンバージョン変数を作成するには、このサービス内でMutateConversionCustomVariablesメソッドを呼び出します。リクエストには 1 つ以上のConversionCustomVariableOperationメッセージを含める必要があります。作成する変数ごとに、
createフィールドがConversionCustomVariableオブジェクトに設定されたオペレーションを含めます。前述のように、作成に必要なフィールドはnameとtagです。正常に作成されると、これらの変数は
ENABLED状態またはACTIVATION_NEEDED状態になります。設定に応じて、レスポンスのstatusフィールドを確認します。コンバージョンをアップロードする際に、それらのリソース名を使用できます。利用可能なすべてのオペレーションの詳細については、
ConversionCustomVariableServiceをご覧ください。ClickConversionやCallConversionなどのコンバージョンをインポートする場合は、前の手順で作成したすべてのカスタム変数のリストにcustom_variablesを設定します。各カスタム変数のすべてのフィールドを設定する必要があります。conversion_custom_variable: 前の手順で作成したカスタム変数のリソース名。value: コンバージョンに関連付けるタグの値。この例では、blueとnewです。