コンバージョン値のルールを使用すると、ConversionAction のカテゴリと以下のインプレッションのディメンションに基づいて、コンバージョンの値を変更するアクションを定義できます。
- オーディエンス メンバーシップ
- ユーザーの所在地、またはユーザーが関心を示した地域
- デバイス
Google Ads API を使ってコンバージョン値のルールを定義し、それらを 1 つのコンバージョン値のルールセットにまとめて、そのルールセットを Google 広告アカウント全体または特定のキャンペーンに適用できます。Google Ads API レポートのセグメントにはデータの内訳が表示されるため、コンバージョン値の元の部分、未調整の部分、調整された部分を比較できます。
ルールを作成する
コンバージョン値のルールを使用するには、まず、以下で構成される ConversionValueRule を 1 つ以上作成します。
- ルールが適用されるタイミングを決定する条件
- ルール適用時に実行するアクション
ルールの条件
次のフィールドを使用して、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のいずれにも一致しないインプレッションにルールを適用します。ビジネスのリソース名を取得する方法については、地域ターゲティング ガイドをご覧ください。
各 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の単一のエントリのみを含める必要があります。 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コレクションの最初のエントリでグループ化されています。