Google Ads API の CustomerLifecycleGoal
リソースと CampaignLifecycleGoal
リソースを使用して、顧客のライフサイクルに関連する目標を設定します。v15 では、Google 広告の検索キャンペーンと P-MAX キャンペーンを通じて新規顧客を効率的に獲得するための顧客獲得目標が Google Ads API でサポートされています。
Google 広告アカウントでクロスアカウント コンバージョン トラッキングを使用している場合は、Google 広告アカウントで直接ではなく、Google 広告コンバージョンのお客様アカウントで顧客ライフサイクル目標を設定する必要があります。ただし、キャンペーンのライフサイクル目標はアカウントで設定する必要があります。これは、クロスアカウント コンバージョン トラッキングで他の目標を管理する方法と同様です。
作成および更新オペレーションを処理する(v15 のみ)
Google Ads API v15 では、CustomerLifecycleGoalService
と CampaignLifecycleGoalService
でサポートされているオペレーションは、Google Ads API の他のサービスとは若干異なります。v15 の CustomerLifecycleGoalOperation
と CampaignLifecycleGoalOperation
には、create
オペレーションと update
オペレーションを別々に用意するのではなく、create
オペレーションのみがあり、次のように update_mask
を使用してインテントを指定します。
v15 を使用してライフサイクル目標を作成するには、
create
に目標を設定します。ただし、そのresource_name
は設定せず、オペレーションのupdate_mask
も設定しないでください。v15 を使用してライフサイクル目標を更新するには、
create
に目標を設定し、目標のresource_name
を設定して、更新するフィールドを一覧表示するようにupdate_mask
を設定します。
顧客ライフサイクル目標を構成する
顧客レベルで、CustomerLifecycleGoal
を作成または更新してライフサイクル目標を構成します。CustomerLifecycleGoal
は、Google 広告アカウントごとに 1 つまで設定できます。
顧客ライフサイクルの目標には次の 2 つのフィールドがあります。
lifecycle_goal_customer_definition_settings
existing_user_lists
フィールドを設定して、既存の顧客が含まれるユーザーリストを指定します。high_lifetime_value_user_lists
フィールドは、ライフタイム バリューの高いユーザーを含むユーザーリストを示します。このフィールドは読み取ることができますが、Google Ads API では変更できません。customer_acquisition_goal_value_settings
value
フィールドを設定して、新規顧客の最初の購入コンバージョンに追加する価値の調整を定義します。目標の
high_lifetime_value
を読み取ることはできますが、Google Ads API でこのフィールドは変更できません。
キャンペーン ライフサイクル目標を設定する
キャンペーン レベルで、CampaignLifecycleGoal
を作成または更新してライフサイクル目標を設定します。キャンペーンごとに最大 1 つの CampaignLifecycleGoal
を設定できます。
キャンペーン レベルの目標の customer_acquisition_goal_settings
フィールドを使用すると、キャンペーンの最適化モードを設定したり、親の顧客目標の値の設定をオーバーライドしたりできます。
optimization_mode
には次のいずれかの値を指定できます。
TARGET_ALL_EQUALLY
- キャンペーンは新規顧客と既存顧客を平等にターゲティングします。これはデフォルトの最適化モードです。
BID_HIGHER_FOR_NEW_CUSTOMERS
- キャンペーンは新規顧客と既存顧客の両方をターゲットにしていますが、新規顧客と予測され、
existing_user_lists
には含まれていない顧客に対する入札単価を高く設定しています。 TARGET_NEW_CUSTOMERS
- キャンペーンで新規顧客のみがターゲティングされている。
value_settings
は、顧客レベルの目標の customer_acquisition_goal_value_settings
と同じです。このキャンペーン単位の設定を使用すると、特定のキャンペーンの値をオーバーライドできます。
ライフサイクル目標を取得する
ライフサイクル目標を取得するには、Google Ads API の他のリソースと同様に、GoogleAdsService
の search
メソッドまたは searchStream
メソッドを使用します。
次のクエリは、Google 広告アカウントのすべての CustomerLifecycleGoal
の詳細を取得します。
SELECT
customer_lifecycle_goal.lifecycle_goal_customer_definition_settings.existing_user_lists,
customer_lifecycle_goal.lifecycle_goal_customer_definition_settings.high_lifetime_value_user_lists,
customer_lifecycle_goal.customer_acquisition_goal_value_settings.value,
customer_lifecycle_goal.customer_acquisition_goal_value_settings.high_lifetime_value
FROM customer_lifecycle_goal
同様に、次のクエリはすべての CampaignLifecycleGoal
の詳細を取得します。
SELECT
campaign_lifecycle_goal.campaign,
campaign_lifecycle_goal.customer_acquisition_goal_settings.optimization_mode,
campaign_lifecycle_goal.customer_acquisition_goal_settings.value_settings.value,
campaign_lifecycle_goal.customer_acquisition_goal_settings.value_settings.high_lifetime_value
FROM campaign_lifecycle_goal