Google Ads API의 CustomerLifecycleGoal
및 CampaignLifecycleGoal
리소스를 사용하여 고객 수명 주기와 관련된 목표를 구성합니다. v15부터 Google Ads API는 Google Ads 검색 및 실적 최대화 캠페인을 통해 신규 고객을 효율적으로 획득할 수 있도록 고객 획득 목표를 지원합니다.
Google Ads 계정에서 교차 계정 전환 추적을 사용 중인 경우 고객 수명 주기 목표를 Google Ads 계정에서 직접 구성하는 대신 Google Ads 전환 고객 계정에서 구성해야 합니다. 단, 계정에서 캠페인 수명 주기 목표는 계속 설정해야 합니다. 이는 교차 계정 전환 추적을 사용할 때 기타 목표를 관리하는 방법과 유사합니다.
만들기 및 업데이트 작업 처리 (v15만 해당)
Google Ads API v15의 경우 CustomerLifecycleGoalService
및 CampaignLifecycleGoalService
에서 지원되는 작업은 Google Ads API의 다른 서비스와 약간 다릅니다. 별도의 create
및 update
작업이 아닌 v15 CustomerLifecycleGoalOperation
및 CampaignLifecycleGoalOperation
에는 create
작업만 있으며 다음과 같이 update_mask
를 사용하여 인텐트를 표시합니다.
v15를 사용하여 수명 주기 목표를 만들려면
create
에 목표를 채우되resource_name
를 설정하거나 작업의update_mask
를 설정하지 마세요.v15를 사용하여 수명 주기 목표를 업데이트하려면
create
에 목표를 채우고 목표의resource_name
를 설정한 후update_mask
를 설정하여 업데이트할 필드를 나열합니다.
고객 수명 주기 목표 구성
고객 수준에서 CustomerLifecycleGoal
를 만들거나 업데이트하여 수명 주기 목표를 구성합니다. Google Ads 계정당
최대 1개의 CustomerLifecycleGoal
를 사용할 수 있습니다. 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
를 만들어 각 사용자 목록을 하나 이상의 카테고리와 연결합니다.
- 사용자 목록과 카테고리의 조합마다
Google Ads API v17 이상
UserListCustomerTypeService
를 사용하여 UserListCustomerType
인스턴스를 만듭니다.
CustomerLifecycleGoal.lifecycle_goal_customer_definition_settings.existing_user_lists
필드를 이미 채운 경우 계정에 관련 UserListCustomerType
인스턴스가 이미 포함됩니다.
UserListCustomerTypeService
은 create
및 remove
작업만 지원하므로 기존 UserListCustomerType
작업을 업데이트하려면 삭제한 다음 필요한 업데이트로 새 작업을 만들어야 합니다.
UserListCustomerType
는 하나의 사용자 목록에만 할당할 수 있지만, 사용자 목록에는 UserListCustomerType
인스턴스 간에 충돌이 없는 한 여러 개의 연결된 UserListCustomerType
인스턴스가 있을 수 있습니다. UserListCustomerType
인스턴스를 동일한 사용자 목록에 다음과 같은 customer_type_category
조합을 할당하려고 하면 UserListCustomerTypeError.CONFLICTING_CUSTOMER_TYPES
오류가 발생합니다.
게시 후 customer_type_category |
두 번째 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
인스턴스가 수정되며 반대의 경우도 마찬가지입니다.
두 리소스의 필드가 매핑되는 방식은 다음과 같습니다.
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의 다른 리소스와 마찬가지로 GoogleAdsService
의 search
또는 searchStream
메서드를 사용하여 수명 주기 목표를 가져옵니다.
다음 쿼리는 Google Ads 계정에서 모든 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