カスタム コンバージョン変数

カスタム コンバージョン変数 を使用すると、Google 広告 API を使用してインポートしたコンバージョン(クリック コンバージョンや通話コンバージョンなど)に、タグ形式で追加情報を関連付けることができます。この情報を使用して、コンバージョンに関する豊富なデータを提供するセグメント化されたレポートを作成できます。

たとえば、新しい青い帽子の購入のコンバージョンをインポートする際に、関連する 2 つのタグ colorstatus をそれぞれ値 bluenew でインポートできます。手順は次のとおりです。

  1. 必要な数のカスタム コンバージョン変数を作成します。各変数は 1 つのタグに対応します。したがって、2 つのタグ(colorstatus)が必要な場合は、2 つのカスタム変数を作成する必要があります。 ConversionCustomVariable の必須フィールドは次のとおりです。

    • name: 変数を識別します。名前は一意である必要があります。

    • tag: この例では、タグは colorstatus です。タグは 、ウェブサイトから Google 広告にコンバージョンが送信されるときに、イベント スニペットで使用されます 。Google 広告 API を使用する場合は、次の手順で説明するように、コンバージョンをインポートするときにカスタム変数のリソース名を指定する必要があります。

    カスタム コンバージョン変数を管理するには(作成や更新など)、 ConversionCustomVariableService を使用します。具体的には、新しい カスタム コンバージョン変数を作成するには、このサービス内で MutateConversionCustomVariables メソッドを呼び出します。リクエストには、1 つ以上の ConversionCustomVariableOperationメッセージを含める必要があります。

    作成する変数ごとに、create フィールドが ConversionCustomVariable オブジェクトに設定されたオペレーションを含めます。前述のように、作成に必要なフィールドは nametag です。

    作成が成功すると、これらの変数は ENABLED または ACTIVATION_NEEDED の状態になります。設定に応じて、レスポンスの status フィールドを確認します。コンバージョンをアップロードするときに、リソース名を使用できます。

    使用可能なすべてのオペレーションの詳細については、ConversionCustomVariableService をご覧ください。

  2. コンバージョンをインポートする場合は、 ClickConversion などのコンバージョンを、 custom_variables を、前の手順で作成したすべてのカスタム変数のリストに設定します。各カスタム変数のすべてのフィールドを設定する必要があります。

    • conversion_custom_variable: 前の手順で作成したカスタム変数のリソース名。
    • value: コンバージョンに関連付けるタグの値。この例では、bluenew です。