Google Ads API の CustomerLifecycleGoal
リソースと CampaignLifecycleGoal
リソースを使用して、顧客ライフサイクルに関連する目標を設定します。v15 では、Google Ads API は、Google 広告の検索キャンペーンと P-MAX キャンペーンを通じて新規顧客を効率的に獲得するための顧客獲得目標をサポートしています。
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 つまで設定できます。customer_acquisition_goal_value_settings.value
フィールドでは、新規顧客の最初の購入コンバージョンに追加する、追加の値調整を定義します。目標の customer_acquisition_goal_value_settings.high_lifetime_value
を読み取ることはできますが、このフィールドは Google Ads API では変更できません。
オーディエンスをセグメント化する
Google Ads API v17 以降、顧客ライフサイクルの目標に合わせてオーディエンスをセグメント化するには、UserListCustomerType
リソースを使用する必要があります。CustomerLifecycleGoal
リソースでオーディエンスを直接設定することはサポートされなくなりました。詳細:
- v17 より前:
- ユーザーリストを
CustomerLifecycleGoal
のexisting_user_lists
コレクションに追加します。
- ユーザーリストを
- v17 以降:
- ユーザーリストとカテゴリの組み合わせごとに
UserListCustomerType
を作成して、各ユーザーリストを 1 つ以上のカテゴリに関連付けます。
- ユーザーリストとカテゴリの組み合わせごとに
Google Ads API v17 以降
UserListCustomerTypeService
を使用して UserListCustomerType
インスタンスを作成します。CustomerLifecycleGoal.lifecycle_goal_customer_definition_settings.existing_user_lists
フィールドにすでに入力している場合、アカウントには関連する UserListCustomerType
インスタンスがすでに含まれています。
UserListCustomerTypeService
は create
オペレーションと remove
オペレーションのみをサポートしているため、既存の UserListCustomerType
を更新する場合は、それを削除してから、必要な更新を含む新しいオペレーションを作成する必要があります。
UserListCustomerType
は 1 つのユーザーリストにのみ割り当てることができますが、UserListCustomerType
インスタンス間に競合がない限り、ユーザーリストには複数の UserListCustomerType
インスタンスを関連付けることができます。次の customer_type_category
の組み合わせで UserListCustomerType
インスタンスを同じユーザーリストに割り当てようとすると、UserListCustomerTypeError.CONFLICTING_CUSTOMER_TYPES
エラーが発生します。
最初の customer_type_category |
2 回目の customer_type_category |
---|---|
購入者 | CONVERTED_LEADS |
購入者 | QUALIFIED_LEADS |
購入者 | CART_ABANDONERS |
CONVERTED_LEADS | QUALIFIED_LEADS |
DISENGAGED_CUSTOMERS | CONVERTED_LEADS |
DISENGAGED_CUSTOMERS | QUALIFIED_LEADS |
DISENGAGED_CUSTOMERS | CART_ABANDONERS |
Google Ads API v16 以前
アカウントの CustomerLifecycleGoal
で次のフィールドを設定します。
lifecycle_goal_customer_definition_settings.existing_user_lists
は、既存の顧客が含まれているユーザーリストを示します。lifecycle_goal_customer_definition_settings.high_lifetime_value_user_lists
フィールドは、ライフタイム バリューの高いユーザーが含まれているユーザーリストを示します。このフィールドは読み取ることができますが、Google Ads API では変更できません。
共有リソースの動作
2025 年 1 月に Google Ads API v16 が廃止されるまでは、UserListCustomerType
と CustomerLifecycleGoal
のオーディエンス セグメンテーション フィールドは共有リソースであることにご留意ください。つまり、v17 以降で新しい UserListCustomerType
インスタンスを作成すると、v16 以前では CustomerLifecycleGoal
インスタンスが変更され、その逆も同様です。
2 つのリソースのフィールドは次のようにマッピングされます。
v16 の「CustomerLifecycleGoal」フィールドの変更 | v17 の「UserListCustomerType」に対する副作用 |
---|---|
lifecycle_goal_customer_definition_settings.existing_user_lists
|
UserListCustomerType インスタンスを作成または削除します。user_list フィールドには、関連するユーザーリストのリソース名が含まれます。 |
v17 での「UserListCustomerType」の変更 | v16 の「CustomerLifecycleGoal」フィールドの副作用 |
---|---|
UserListCustomerType インスタンスを作成または削除します。 |
個々のリソース名は、lifecycle_goal_customer_definition_settings.existing_user_lists
|
customer_type_category が HIGH_VALUE_CUSTOMERS に設定されている UserListCustomerType インスタンスを作成または削除する |
個々のリソース名は、lifecycle_goal_customer_definition_settings.high_lifetime_value_user_lists
|
キャンペーンのライフサイクル目標を設定
キャンペーン単位では、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