수명 주기 목표

CustomerLifecycleGoal 및 CampaignLifecycleGoal의 리소스 Google Ads API를 사용하여 고객 수명 주기와 관련된 목표를 구성합니다. v15부터 Google Ads API를 통한 고객 획득 목표를 효율적으로 Google Ads 검색 및 실적 최대화 캠페인을 통해 신규 고객 획득 있습니다.

Google Ads 계정에서 교차 계정 전환 추적을 사용 중인 경우 Google Ads 전환에서 고객 수명 주기 목표를 구성해야 함 고객 직접 연결하는 것이 아니라 Google Ads 계정에 직접 연결할 수 있습니다. 여전히 캠페인 수명 주기 목표에 따라 변경할 수 있습니다. 이 방법은 Google 애널리틱스 계정의 기타 목표를 교차 계정 전환 추적을 사용하는 것이 좋습니다

만들기 및 업데이트 작업 처리 (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 계정당 CustomerLifecycleGoal 최대 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 이전 버전: <ph type="x-smartling-placeholder">
      </ph>
    • existing_user_lists 컬렉션에 사용자 목록 추가 CustomerLifecycleGoal
  • v17부터: <ph type="x-smartling-placeholder">
      </ph>
    • 각 사용자 목록을 하나 이상의 카테고리와 연결합니다. 사용자 목록 및 카테고리의 조합별 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:

  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 인스턴스에 추가했으며, 그 반대의 경우도 마찬가지입니다. 알 수 있습니다.

두 리소스의 필드가 매핑되는 방식은 다음과 같습니다.

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는 다음과 같이 설정됩니다. <ph type="x-smartling-placeholder">HIGH_VALUE_CUSTOMERS</ph> 개별 리소스 이름은 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 Ads 계정:

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
이전
캠페인 목표