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

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

  • オーディエンスのメンバーシップ
  • ユーザーの所在地またはユーザーが関心を示している地域（対象地域）
  • デバイス
  • 旅行プラン

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

ルールを作成する

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

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

ルールの条件

次のフィールドを使用して、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 のリソース名。アカウントまたはその MCC アカウントのいずれかでルールが定義されているかどうかを判断するために使用します。
status
ルールのステータス。このフィールドを PAUSED に設定するとルールを一時停止し、ENABLED に設定すると一時停止したルールを有効にできます。

ルールセットを作成する

ConversionValueRule が 1 つ以上ある場合は、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 によって参照されるすべてのルールの status が PAUSED の場合、コンバージョン値のルールセット 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 つのルールが選択され、適用されます。これらのルールについて詳しくは、ヘルプセンターをご覧ください。

  1. 検討するルールセットの attachment_type を決定します。インプレッションに関連付けられているキャンペーンに attachment_type = CAMPAIGN と campaign が設定されているルールセットがある場合は、キャンペーン レベルのルールセットのみを検討します。それ以外の場合は、お客様レベルのルールセットのみを検討してください。

  2. 検討するルールセットの中から、conversion_action_categories が空ではなく、コンバージョンのコンバージョン アクションのカテゴリが含まれているルールセットを選択します（そのようなルールセットが存在する場合）。それ以外の場合は、conversion_action_categories が空のルールセットを選択します。

  3. 選択したルールセットのルールを conversion_value_rules に表示される順序で評価し、インプレッションに一致する条件を持つ最初のルールを選択します。

  4. 複数の位置情報条件が一致する場合は、最も正確な位置情報が適用されます。たとえば、インプレッションが「米国」と「カリフォルニア州」の両方の条件に一致する場合は、より正確な地域である「カリフォルニア州」が適用されます。

  5. 複数のオーディエンス条件が一致する場合は、既存のオーディエンス アトリビューション階層が適用されます。セット内の 2 つのルールが同じオーディエンス グループに適用される場合、調整内容が「追加」型のルールよりも「乗算」型のルールが優先されます。該当する「乗算」型のルールが複数ある場合、調整の値（係数）が大きいものが優先されます。

  6. デバイスのカテゴリは互いに重複しないため、一致するデバイス条件が複数あることはできません。

  7. 旅行プランの条件については、最も具体的な旅行プランのルールが適用されます。つまり、特定のコンバージョンに複数のルールが一致する場合、使用されるルールは、「事前予約期間」や「旅行日数」など、定義されている旅行プラン オプションが最も多いルールです。

指標

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

NO_RULE_APPLIED
ルールが適用されていないコンバージョンの値。
ORIGINAL
ルールが適用されたコンバージョンの元の値。
GEO_LOCATION、DEVICE、AUDIENCE、または NO_CONDITION
ルールが適用された後のコンバージョンの値。ルールセットの dimensions コレクションの最初のエントリでグループ化されます。
前へ
コンバージョンの調整をアップロードする
次へ
カスタム コンバージョン変数