Google は AI 技術を使用して、コンテンツをご希望の言語に翻訳しています。AI 翻訳には誤りが含まれる場合があります。

コンバージョン値のルール

コンバージョン値のルールを使用すると、ConversionAction のカテゴリとインプレッションの次のディメンションに基づいて、コンバージョンの値を変更するアクションを定義できます。

オーディエンスのメンバーシップ
実際の所在地または関心対象地域
デバイス
旅行プラン

Google Ads API を使用してコンバージョン値のルールを定義し、それらをコンバージョン値のルールセットに結合して、そのルールセットを Google 広告アカウント全体または特定のキャンペーンに適用できます。Google Ads API レポートのセグメントには内訳が表示されるため、コンバージョン値の元の部分、未調整の部分、調整済みの部分を比較できます。

ルールの作成

コンバージョン値のルールを使用する最初のステップは、少なくとも 1 つの ConversionValueRule を作成することです。これは、次の要素で構成されます。

ルールが適用されるタイミングを決定する条件
ルールが適用されたときに実行するアクション

たとえば、ConversionValueRuleService.MutateConversionValueRules の次の JSON ペイロードは、モバイルインプレッションのコンバージョン値に 1.5 を掛けるルールを作成します。

{
  "operations": [
    {
      "create": {
        "action": {
          "operation": "MULTIPLY",
          "value": 1.5
        },
        "deviceCondition": {
          "deviceTypes": ["MOBILE"]
        }
      }
    }
  ]
}

ルールの条件

次のフィールドを使用して ConversionValueRule の条件を定義します。

audience_condition: 1 つ以上のオーディエンスに関連付けられたインプレッションにルールを適用します。各ユーザーリストまたはユーザーの興味 / 関心のリソース名を user_lists フィールドまたは user_interests フィールドで指定します。利用可能なユーザーリストまたはユーザーインタレストのリソース名を取得するには、GoogleAdsService の searchStream または search リクエストを発行します。このとき、クエリの FROM 句はそれぞれ user_list または user_interest にします。; audience_condition に複数のユーザーリストまたはユーザーの興味 / 関心が含まれている場合、インプレッションがユーザーリストまたはユーザーの興味 / 関心のいずれかに関連付けられていれば、インプレッションはルールに一致します。
device_condition: インプレッションのデバイスが、指定された device_types のいずれかと一致する場合にルールを適用します。ValueRuleDeviceType のデバイスタイプのみが許可されます。
geo_location_condition: 位置情報が geo_match_type の指定された geo_target_constants のいずれかと一致し、excluded_geo_match_type の excluded_geo_target_constants のいずれとも一致しないインプレッションにルールを適用します。地域リソース名の取得方法については、地域ターゲティングガイドをご覧ください。
itinerary_condition: 予約可能期間、旅行期間、旅行開始日など、旅行プラン固有の情報が検索語句に含まれるインプレッションにルールを適用します。使用可能な条件の詳細については、ValueRuleItineraryCondition をご覧ください。

各 ConversionValueRule には、audience_condition、device_condition、geo_location_condition、itinerary_condition のうち最大 2 つを指定できます。

条件が指定されていないルールは、同じルールセット内のより具体的なルールの条件を満たさないインプレッションに適用されます。

ルールのアクション

ルールには、operation と value で構成される 1 つの action が必要です。アクションは、ルールの条件を満たすコンバージョンのコンバージョン値を調整する方法を定義します。使用できるオペレーションは次のとおりです。

ADD

コンバージョンの元の値に value を加算します。value は 0 より大きくする必要があります。

MULTIPLY

コンバージョンの元の値に、指定した value を掛けます。value は 0.5 以上、10 以下にする必要があります。

SET

コンバージョン値を指定された value に設定します。value は 0 より大きくする必要があります。

SET アクションを含むルールは、ルールセットの作成で説明されている条件を満たすルールセットでのみ使用できます。

その他のルール属性

条件とアクションに加えて、ConversionValueRule には次の属性があります。

owner_customer: ルールを所有する Customer のリソース名。これを使用して、ルールがアカウント内で定義されているか、そのマネージャーアカウントのいずれかで定義されているかを判断します。
status: ルールのステータス。このフィールドを PAUSED に設定すると、ルールを一時停止できます。このフィールドを ENABLED に設定すると、一時停止したルールを有効にできます。

ルールセットを作成する

1 つ以上の ConversionValueRule を作成したら、ConversionValueRuleSet を作成できます。これは、次の要素で構成されます。

conversion_action_categories

このルールセットが適用されるコンバージョンアクションのカテゴリのリスト。リストが空の場合、ルールセットはすべてのカテゴリに適用されます。リストが空でない場合は、STORE_VISIT または STORE_SALE のいずれかのエントリが 1 つ含まれている必要があります。

コンバージョンアクションカテゴリのリストは、ルールセットの作成時にのみ設定できます。

conversion_value_rules

セットに含めるルールのリソース名。

このリストに SET アクションを使用するルールを含めることができるのは、次のいずれかの条件が満たされている場合のみです。

アカウントが許可リストに登録されており、ルールセットの conversion_action_categories が空である。
セットの conversion_action_categories には STORE_VISIT または STORE_SALE のエントリが 1 つだけ含まれ、セットの dimensions には NO_CONDITION のエントリのみが含まれ、ルールの条件フィールドは設定されていません。

dimensions

セット内のルールで使用できる条件を示す ValueRuleSetDimension 列挙値のリスト。たとえば、dimensions に GEO_LOCATION と DEVICE が含まれている場合、geo_location_condition または device_condition を含む広告ルールをセットに追加できますが、audience_condition を含む広告ルールは追加できません。

このリストを空にすることはできません。また、最大 2 つのエントリを含めることができます。

このリストの最初のエントリによって、指標の segments.conversion_value_rule_primary_dimension に表示される値が決まります。

このリストに NO_CONDITION のエントリが含まれている場合:

NO_CONDITION は、リスト内の唯一のエントリである必要があります。
セットの conversion_action_categories のリストには、STORE_VISIT または STORE_SALE のエントリを 1 つだけ含める必要があります。
conversion_value_rules のリストに、audience_condition、device_condition、geo_location_condition が設定されているルールを含めることはできません。

attachment_type

アカウント全体に適用されるルールセットを作成するには、この値を CUSTOMER に設定します。特定のキャンペーンのルールセットを作成するには、CAMPAIGN に設定します。

campaign

ルールセットの attachment_type が CAMPAIGN の場合は、ルールセットが適用されるリソース名に設定します。

ルールと同様に、ルールセットにも owner_customer と status があります。ただし、ルールセットの status は読み取り専用であり、次のようにルールから派生します。

conversion_value_rules によって参照されるすべてのルールに PAUSED の status がある場合、コンバージョン値のルールセット status は PAUSED になります。
それ以外の場合、コンバージョン値のルールセット status は ENABLED になります。

ルールとルールセットを削除する

ConversionValueRuleSet には、PAUSED または ENABLED のコンバージョン値のルールが少なくとも 1 つ必要です。
PAUSED または ENABLED ConversionValueRuleSet の conversion_value_rules で参照されている ConversionValueRule を削除すると、失敗します。
ConversionValueRuleSet を削除しても、セットによって参照される各 ConversionValueRule の status は変更されません。
ConversionValueRuleSet が削除されると、conversion_value_rule_set リソースの search リクエストと searchStream リクエストは、削除されたセットを返さなくなります。

ルールとルールセットの優先順位

Google 広告では、次のロジックを使用して、各コンバージョンに最大 1 つのルールを選択して適用します。これらのルールの詳細については、Google 広告ヘルプセンターをご覧ください。

考慮するルールセットの attachment_type を決定します。インプレッションに関連付けられたキャンペーンに attachment_type = CAMPAIGN と campaign が設定されたルールセットがある場合は、キャンペーン単位のルールセットのみを考慮します。それ以外の場合は、お客様レベルのルールセットのみを考慮します。
検討対象のルールセットの中から、conversion_action_categories が空ではなく、コンバージョンのコンバージョンアクションのカテゴリを含むルールセットを選択します（そのようなルールセットが存在する場合）。それ以外の場合は、conversion_action_categories が空のルールセットを選択します。
選択したルールセットのルールを conversion_value_rules に表示される順に評価し、インプレッションに一致する条件を持つ最初のルールを選択します。
一致する地域条件が複数ある場合は、最も正確な位置情報が適用されます。たとえば、インプレッションが米国とカリフォルニア州の両方の条件に一致する場合、カリフォルニア州の方がより正確な位置情報であるため、カリフォルニア州が適用されます。
複数のオーディエンス条件が一致する場合は、既存のオーディエンスアトリビューション階層が適用されます。セット内の 2 つのルールが同点の場合、[追加] ルールよりも [乗算] ルールが優先されます。該当する「乗算」型のルールが複数ある場合、調整の値（係数）が大きいものが優先されます。
デバイスのカテゴリは互いに重複しないため、デバイスの条件が複数同時に一致することはありません。
旅行プランの条件については、最も具体的な旅行プランのルールが適用されます。つまり、複数のルールが特定のコンバージョンに一致する場合、使用されるルールは、定義されている旅行プランのオプション（「予約可能期間」や「旅行の所要時間」など）の数が最も多いルールです。

指標

metrics.conversions_value フィールドと metrics.all_conversions_value フィールド、およびこれらの指標から派生したフィールドには、コンバージョン値のルールセットによって行われた変更が反映されます。また、クエリに segments.conversion_value_rule_primary_dimension を含めると、ルールの適用方法に関する詳細情報を取得できます。このセグメントに指定できる値は次のとおりです。

NO_RULE_APPLIED: ルールが適用されなかったコンバージョンの値。
ORIGINAL: ルールが適用されたコンバージョンの元の値。
GEO_LOCATION、DEVICE、AUDIENCE、または NO_CONDITION: ルールが適用された後のコンバージョンの値。ルールセットの dimensions コレクションの最初のエントリでグループ化されます。

コンバージョンの調整をアップロードする

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