ライフサイクル目標

CustomerLifecycleGoal と 次の CampaignLifecycleGoal 個のリソース: Google Ads API: 顧客のライフサイクルに関連する目標を設定します。v15 以降、 Google Ads API: 顧客獲得をサポート 効率的に目標を達成するための Google 広告の検索キャンペーンと P-MAX キャンペーンで新規顧客を獲得 比較します

Google 広告アカウントでクロスアカウント コンバージョン トラッキングを使用している場合は、以下のようになります。 Google 広告コンバージョンで顧客ライフサイクル目標を設定する必要がある お客様 直接ログインする必要はありません。その場合でも アカウントでキャンペーンのライフサイクル目標を 設定することもできます同様の方法で Google 広告アカウントで他の目標を管理する クロスアカウント コンバージョン トラッキング

作成オペレーションと更新オペレーションを処理する(v15 のみ)

Google Ads API v15 では、 CustomerLifecycleGoalServiceCampaignLifecycleGoalService Google Ads API の他のサービスとは若干異なります個別のリソースを create オペレーションと update オペレーション、v15 CustomerLifecycleGoalOperation および CampaignLifecycleGoalOperation create 演算しかなく、 update_mask は次のようになります。

  • v15 を使用してライフサイクル目標を作成するには、create に目標を入力しますが、 resource_name を設定せず、インスタンスの update_mask も設定しない あります。

  • v15 を使用してライフサイクル目標を更新するには、目標を create に入力し、次のように設定します。 目標の resource_nameupdate_mask を設定して 指定します。

顧客ライフサイクル目標を設定する

顧客レベルで、ライフサイクル目標を作成または更新して、 CustomerLifecycleGoal。場所によっては、 Google 広告アカウントごとに最大 1 つのCustomerLifecycleGoal。「 customer_acquisition_goal_value_settings.value フィールドは、追加の 新規顧客の最初の購入コンバージョンに追加する金額調整。Google Chat では customer_acquisition_goal_value_settings.high_lifetime_value の読み取り このフィールドは Google Ads API では変更できません。

オーディエンスをセグメント化する

Google Ads API v17 以降では、 セグメント化するリソース: UserListCustomerType 顧客ライフサイクル目標に合わせてオーディエンスを 最適化できますGoogle Cloud コンソールで直接 CustomerLifecycleGoal リソースは 非推奨です。詳細:

  • v17 より前: <ph type="x-smartling-placeholder">
      </ph>
    • ユーザーリストを existing_user_lists CustomerLifecycleGoal
  • v17 以降: <ph type="x-smartling-placeholder">
      </ph>
    • 各ユーザーリストを 1 つ以上のカテゴリに関連付けるには、 ユーザーリストとカテゴリの組み合わせごとに UserListCustomerType
で確認できます。

Google Ads API v17 以降

こちらの UserListCustomerTypeServiceUserListCustomerType インスタンスを作成します。 すでに入力済みの場合は CustomerLifecycleGoal.lifecycle_goal_customer_definition_settings.existing_user_lists フィールドに入力すると、関連する UserListCustomerType がアカウントに自動的に含まれます。 説明します。

UserListCustomerTypeServicecreateremove のみをサポートします。 そのため、既存の UserListCustomerType を更新する場合は、 削除してから、必要なアップデートを加えて新しいものを作成する必要があります。

UserListCustomerType は 1 つのユーザーリストにのみ割り当てることができますが、 ユーザーリストには複数の UserListCustomerType インスタンスを関連付けることができます UserListCustomerType の間に競合がなければ 説明します。次の権限で UserListCustomerType インスタンスを割り当てようとしています: 次の組み合わせ: customer_type_category 同じユーザーリストに追加すると 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:

  1. lifecycle_goal_customer_definition_settings.existing_user_lists の意味 既存顧客が含まれているユーザーリスト

  2. 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
UserListCustomerType インスタンスを作成または削除します。ここで、 customer_type_category の設定 HIGH_VALUE_CUSTOMERS 個々のリソース名は 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 の他のリソースと同様に、search または searchStream を使用します。 取得する GoogleAdsService のメソッド ライフサイクル目標を設定します。

次のクエリは、すべての CustomerLifecycleGoal の詳細を取得します。 Google 広告アカウント:

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