コンバージョン値のルールを使用すると、ConversionAction
のカテゴリとインプレッションの次のディメンションに基づいて、コンバージョンの値を変更するアクションを定義できます。
- オーディエンスのメンバーシップ
- ユーザーの所在地、またはユーザーが関心を示した地域
- デバイス
Google Ads API を使ってコンバージョン値のルールを定義し、それらのルールを 1 つのコンバージョン値のルールセットに統合してから、そのルールセットを Google 広告アカウント全体または特定のキャンペーンに適用できます。Google Ads API レポートのセグメントには内訳が表示されるため、コンバージョン値の元の部分、未調整の部分、調整された部分を比較できます。
ルールを作成する
コンバージョン値のルールを使用するには、まず、次の要素で構成される ConversionValueRule
を 1 つ以上作成します。
- ルールが適用されるタイミングを決定する条件
- ルールの適用時に実行されるアクション
ルールの条件
次のフィールドを使用して ConversionValueRule
の条件を定義します。
audience_condition
- 1 つ以上のオーディエンスに関連付けられているインプレッションにルールを適用します。
user_lists
フィールドまたはuser_interests
フィールドを使用して、各ユーザーリストまたはユーザーの関心事のリソース名を指定します。使用可能なユーザーリストまたはユーザーの興味 / 関心のリソース名を取得するには、クエリのFROM
句がuser_list
またはuser_interest
であるGoogleAdsService
のsearchStream
リクエストまたはsearch
リクエストを発行します。 audience_condition
に複数のユーザーリストまたはユーザーの興味 / 関心が含まれている場合、インプレッションがいずれかのユーザーリストまたはユーザーの興味 / 関心に関連付けられていれば、そのインプレッションはルールに一致します。device_condition
- インプレッションのデバイスが、指定された
device_types
のいずれかと一致する場合にルールを適用します。ValueRuleDeviceType
内のデバイスタイプのみが許可されます。 geo_location_condition
- 位置情報が
geo_match_type
に指定されたgeo_target_constants
のいずれかに一致し、かつexcluded_geo_match_type
のexcluded_geo_target_constants
のいずれとも一致しないインプレッションにルールを適用します。ビジネスのリソース名を取得する方法については、地域ターゲティング ガイドをご覧ください。
各 ConversionValueRule
には、audience_condition
、device_condition
、geo_location_condition
のうち最大 2 つを指定できます。
条件が指定されていないルールは、同じルールセット内のより具体的なルールの条件を満たさないインプレッションに適用されます。
ルールのアクション
ルールには、operation
と value
で構成される単一の action
が必要です。アクションでは、ルールの条件を満たすコンバージョンの価値をどのように調整するかを定義します。使用可能なオペレーションは次のとおりです。
ADD
- コンバージョンの元の値に
value
を加算します。value
は0
より大きくする必要があります。 MULTIPLY
- コンバージョンの元の値に、指定された
value
を乗算します。value
は、0.5
以上10
以下にする必要があります。 SET
コンバージョン値を指定の
value
に設定します。value
は0
より大きくする必要があります。SET
アクションを含むルールは、後述のルールセットの作成で説明されている条件を満たすルールセット内でのみ使用できます。
その他のルール属性
ConversionValueRule
には、条件とアクションに加えて、次の属性があります。
owner_customer
- ルールを所有する
Customer
のリソース名。この属性を使用して、ルールがアカウント内か、いずれかの MCC アカウント内かを判断します。 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 つまでです。
このリストに
NO_CONDITION
のエントリが含まれている場合:NO_CONDITION
はリスト内の唯一のエントリである必要があります。- セットの
conversion_action_categories
のリストには、STORE_VISIT
またはSTORE_SALE
のエントリを 1 つだけ含める必要があります。 conversion_value_rules
のリストには、audience_condition
、device_condition
、またはgeo_location_condition
が設定されているルールを含めることはできません。
このリストの最初のエントリにより、レポートの
segments.conversion_value_rule_primary_dimension
に表示される値が決まります。attachment_type
アカウント全体に適用するルールセットを作成する場合は、この値を
CUSTOMER
に設定し、特定のキャンペーンのルールセットを作成する場合はCAMPAIGN
に設定します。campaign
ルールセットの
attachment_type
がCAMPAIGN
の場合は、ルールセットが適用されるリソース名に設定します。
rules と同様に、ルールセットにも 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 つのルールを選択して適用します。
考慮するルールセットの
attachment_type
を決定します。インプレッションに関連付けられたキャンペーンに設定されたattachment_type = CAMPAIGN
とcampaign
を含むルールセットがある場合は、キャンペーン単位のルールセットのみを考慮します。それ以外の場合は、顧客レベルのルールセットのみを考慮してください。検討するルールセットの中で、
conversion_action_categories
が空でなく、コンバージョンのコンバージョン アクションのカテゴリを含むルールセットを選択します(そのようなルールセットが存在する場合)。それ以外の場合は、conversion_action_categories
が空のルールセットを選択します。選択したルールセットのルールを
conversion_value_rules
に出現する順序で評価し、インプレッションに一致する条件を持つ最初のルールを選択します。
レポート
metrics.conversions_value
フィールドと metrics.all_conversions_value
フィールド、およびこれらの指標から派生するフィールドには、コンバージョン値のルールセットで行われた変更が反映されます。また、クエリに segments.conversion_value_rule_primary_dimension
を含めると、ルールがどのように適用されたかに関する詳細情報を確認できます。このセグメントで使用できる値は次のとおりです。
NO_RULE_APPLIED
- ルールが適用されていないコンバージョンの値。
ORIGINAL
- ルールが適用されたコンバージョンの元の値。
GEO_LOCATION
、DEVICE
、AUDIENCE
、またはNO_CONDITION
- ルール適用後のコンバージョンの値。ルールセットの
dimensions
コレクションの最初のエントリでグループ化されます。