Mục tiêu vòng đời

Sử dụng tài nguyên Goal và CampaignGoalConfig của Google Ads API để định cấu hình các mục tiêu liên quan đến vòng đời của khách hàng. API Google Ads hỗ trợ các mục tiêu thu nạp khách hàng và mục tiêu giữ chân khách hàng để quản lý hiệu quả các mức điều chỉnh cho giá trị vòng đời của khách hàng thông qua chiến dịch trên Google Ads.

Nếu tài khoản Google Ads của bạn đang sử dụng tính năng theo dõi lượt chuyển đổi trên nhiều tài khoản, thì bạn phải định cấu hình các mục tiêu vòng đời ở cấp khách hàng trong tài khoản lượt chuyển đổi của Google Ads thay vì trực tiếp trong tài khoản Google Ads. Tuy nhiên, bạn vẫn nên thiết lập các cấu hình ở cấp chiến dịch trong tài khoản của mình. Điều này tương tự như cách bạn quản lý các mục tiêu khác khi sử dụng tính năng theo dõi lượt chuyển đổi trên nhiều tài khoản.

Các loại mục tiêu vòng đời của khách hàng

Các mục tiêu vòng đời của khách hàng được định cấu hình ở cấp tài khoản bằng tài nguyên Goal. Một mục tiêu đại diện cho một mục tiêu cụ thể trong vòng đời và được xác định bằng goal_type.

Các loại mục tiêu vòng đời được hỗ trợ là:

NEW_CUSTOMER_ACQUISITION

Để thu nạp khách hàng mới một cách hiệu quả bằng cách chỉ định các mức điều chỉnh cho giá trị cho lượt chuyển đổi của họ.

CUSTOMER_RETENTION

Để thu hút lại những khách hàng hiện tại, khách hàng có giá trị cao và khách hàng không còn hoạt động.

LOYALTY_RETENTION

Để thúc đẩy tỷ lệ giữ chân và mức độ tương tác, đặc biệt là trong số các thành viên của chương trình khách hàng thân thiết.

Định cấu hình mục tiêu vòng đời của khách hàng

Ở cấp khách hàng, hãy định cấu hình mục tiêu vòng đời bằng cách tạo Goal. Có thể có tối đa một Goal cho mỗi loại mục tiêu (NEW_CUSTOMER_ACQUISITION, CUSTOMER_RETENTION hoặc LOYALTY_RETENTION) trong một tài khoản Google Ads.

Chế độ cài đặt mục tiêu thu nạp khách hàng mới

Để thiết lập tính năng Thu nạp khách hàng mới (NCA), hãy đặt goal_type thành NEW_CUSTOMER_ACQUISITION và định cấu hình các chế độ cài đặt trong trường new_customer_acquisition_goal_settings bằng GoalService.

Trường new_customer_acquisition_goal_settings.value_settings sử dụng CustomerLifecycleOptimizationValueSettings để chỉ định các mức điều chỉnh cho giá trị lượt chuyển đổi cho khách hàng đã thu nạp:

• value_settings (CustomerLifecycleOptimizationValueSettings):
  • value_adjustment (oneof):
    • additional_value (double): Giá trị lượt chuyển đổi gia tăng để thêm vào lượt chuyển đổi dạng giao dịch mua đầu tiên của khách hàng mới.
    • value_multiplier (double): Hệ số nhân để áp dụng cho giá trị lượt chuyển đổi cho giao dịch mua đầu tiên của khách hàng mới (không được hỗ trợ cho NEW_CUSTOMER_ACQUISITION; được hỗ trợ cho LOYALTY_RETENTION).
  • high_lifetime_value_adjustment (oneof):
    • additional_high_lifetime_value (double): Giá trị lượt chuyển đổi gia tăng cho khách hàng mới được xác định là có giá trị vòng đời cao.
    • high_lifetime_value_multiplier (double): Hệ số nhân giá trị lượt chuyển đổi để áp dụng cho khách hàng mới có giá trị vòng đời cao (chưa được hỗ trợ).

Giá trị vòng đời cao phải lớn hơn giá trị và hệ số nhân giá trị vòng đời cao phải lớn hơn nghiêm ngặt hệ số nhân giá trị (nếu được đặt).

def create_nca_goal(client: GoogleAdsClient, customer_id: str) -> None:
    """Sends an API request to add a new New Customer Acquisition Goal.

    Args:
        client: an initialized GoogleAdsClient instance.
        customer_id: a client customer ID.
    """
    goal_operation: GoalOperation = client.get_type("GoalOperation")
    goal = goal_operation.create
    goal.goal_type = client.enums.GoalTypeEnum.NEW_CUSTOMER_ACQUISITION

    # Configure the value adjustments.
    value_settings = goal.new_customer_acquisition_goal_settings.value_settings
    value_settings.additional_value = 50.0
    value_settings.additional_high_lifetime_value = 100.0

    goal_service = client.get_service("GoalService")
    goal_service.mutate_goals(
        customer_id=customer_id, operations=[goal_operation]
    )

Chế độ cài đặt mục tiêu giữ chân khách hàng

Để thiết lập chế độ giữ chân khách hàng, hãy đặt goal_type thành CUSTOMER_RETENTION và định cấu hình các chế độ cài đặt trong trường retention_goal_settings.

Trước khi tạo mục tiêu giữ chân, bạn phải đáp ứng các điều kiện tiên quyết được mô tả trong Giới thiệu về mục tiêu giữ chân. Điều này bao gồm việc có chiến dịch Tối đa hoá hiệu suất và danh sách người dùng So khớp khách hàng.

def create_retention_goal(client: GoogleAdsClient, customer_id: str) -> None:
    """Sends an API request to add a new Customer Retention Goal.

    Args:
        client: an initialized GoogleAdsClient instance.
        customer_id: a client customer ID.
    """
    goal_operation: GoalOperation = client.get_type("GoalOperation")
    goal = goal_operation.create
    goal.goal_type = client.enums.GoalTypeEnum.CUSTOMER_RETENTION
    value_settings = goal.retention_goal_settings.value_settings
    value_settings.additional_value = 50.0
    value_settings.additional_high_lifetime_value = 100.0

    goal_service = client.get_service("GoalService")
    goal_service.mutate_goals(
        customer_id=customer_id, operations=[goal_operation]
    )

Thao tác này sẽ tạo một mục tiêu giữ chân mới ở cấp tài khoản cho tài khoản khách hàng đã chỉ định, được áp dụng cho tất cả chiến dịch của tài khoản đó. Theo mặc định, mục tiêu này nhắm đến tất cả người dùng trong danh sách người dùng So khớp khách hàng.

Chế độ cài đặt mục tiêu giữ chân khách hàng thân thiết

Để thiết lập mục tiêu giữ chân khách hàng thân thiết cho thành viên của chương trình khách hàng thân thiết, hãy đặt goal_type thành LOYALTY_RETENTION và định cấu hình các chế độ cài đặt trong trường loyalty_retention_goal_settings (LoyaltyRetentionGoal).

Không giống như NEW_CUSTOMER_ACQUISITION và CUSTOMER_RETENTION mục tiêu (sử dụng các mức điều chỉnh cho giá trị cộng), các mục tiêu LOYALTY_RETENTION hỗ trợ chế độ cài đặt value_multiplier trong value_settings bằng cách sử dụng CustomerLifecycleOptimizationValueSettings:

def create_loyalty_retention_goal(
    client: GoogleAdsClient, customer_id: str
) -> None:
    """Sends an API request to add a new Loyalty Retention Goal.

    Args:
        client: an initialized GoogleAdsClient instance.
        customer_id: a client customer ID.
    """
    goal_operation: GoalOperation = client.get_type("GoalOperation")
    goal = goal_operation.create
    goal.goal_type = client.enums.GoalTypeEnum.LOYALTY_RETENTION
    goal.loyalty_retention_goal_settings.value_settings.value_multiplier = 1.5

    goal_service = client.get_service("GoalService")
    goal_service.mutate_goals(
        customer_id=customer_id, operations=[goal_operation]
    )

Phân khúc đối tượng

Bạn phải sử dụng tài nguyên UserListCustomerType để phân khúc đối tượng cho các mục tiêu vòng đời của khách hàng (bao gồm cả mục tiêu Thu nạp khách hàng mới , Giữ chân khách hàng và Giữ chân khách hàng thân thiết). Bạn phải liên kết từng danh sách người dùng với một hoặc nhiều danh mục bằng cách tạo UserListCustomerType cho mỗi tổ hợp danh sách người dùng và danh mục.

Sử dụng UserListCustomerTypeService để tạo các thực thể UserListCustomerType.

UserListCustomerTypeService chỉ hỗ trợ các thao tác create và remove . Vì vậy, nếu muốn cập nhật UserListCustomerType hiện có, bạn phải xoá thực thể đó rồi tạo một thực thể mới với các nội dung cập nhật cần thiết.

Bạn chỉ có thể chỉ định UserListCustomerType cho một danh sách người dùng, nhưng một danh sách người dùng có thể có nhiều thực thể UserListCustomerType được liên kết miễn là không có xung đột giữa các thực thể UserListCustomerType. Việc cố gắng chỉ định UserListCustomerType thực thể với các tổ hợp customer_type_category sau đây cho cùng một danh sách người dùng sẽ dẫn đến lỗi UserListCustomerTypeError.CONFLICTING_CUSTOMER_TYPES:

Định cấu hình các cấu hình mục tiêu vòng đời của chiến dịch đã cấu hình

Ở cấp chiến dịch, bạn có thể định cấu hình các chế độ ghi đè hoặc tuỳ chọn nhắm mục tiêu dành riêng cho chiến dịch bằng CampaignGoalConfig. Sau khi có mục tiêu ở cấp tài khoản, hãy sử dụng resource_name của mục tiêu đó để tạo CampaignGoalConfig bằng phương thức mutate_campaign_goal_configs trên CampaignGoalConfigService.

Chế độ cài đặt thu nạp khách hàng mới của chiến dịch

Để ghi đè chế độ cài đặt hoặc định cấu hình tiêu chí nhắm mục tiêu cho NCA ở cấp chiến dịch, hãy định cấu hình trường campaign_new_customer_acquisition_settings thuộc loại CampaignNewCustomerAcquisitionGoalSettings:

• value_settings_override (Loại: CustomerLifecycleOptimizationValueSettings): Các mức điều chỉnh cho giá trị tuỳ chỉnh để ghi đè chế độ cài đặt ở cấp tài khoản.
• target_option (Loại: CustomerLifecycleOptimizationMode): Kiểm soát chế độ tối ưu hoá vòng đời của khách hàng. Các lựa chọn là:
  • TARGET_ALL: Chiến dịch nhắm đến cả khách hàng mới và khách hàng hiện tại, nhưng đặt giá thầu cao hơn cho khách hàng mới bằng các mức điều chỉnh cho giá trị đã định cấu hình.
  • TARGET_SPECIFIC: Chiến dịch chỉ nhắm đến khách hàng mới. Các mức điều chỉnh cho giá thầu không áp dụng cho lựa chọn này.

def create_campaign_nca_config(
    client: GoogleAdsClient,
    customer_id: str,
    goal_resource_name: str,
    campaign_resource_name: str,
) -> None:
    """Sends an API request to add a new CampaignGoalConfig for NCA.

    Args:
        client: an initialized GoogleAdsClient instance.
        customer_id: a client customer ID.
        goal_resource_name: the resource name of an existing NCA Goal.
        campaign_resource_name: the resource name of an existing Campaign.
    """
    operation: CampaignGoalConfigOperation = client.get_type(
        "CampaignGoalConfigOperation"
    )
    goal_config = operation.create
    goal_config.campaign = campaign_resource_name
    goal_config.goal = goal_resource_name

    # Set the target option to target both new and existing customers.
    nca_settings = goal_config.campaign_new_customer_acquisition_settings
    nca_settings.target_option = (
        client.enums.CustomerLifecycleOptimizationModeEnum.TARGET_ALL
    )
    # Optionally override value settings.
    nca_settings.value_settings_override.additional_value = 60.0

    campaign_goal_config_service = client.get_service(
        "CampaignGoalConfigService"
    )
    campaign_goal_config_service.mutate_campaign_goal_configs(
        customer_id=customer_id, operations=[operation]
    )

Chế độ cài đặt giữ chân khách hàng của chiến dịch

Để ghi đè chế độ cài đặt hoặc định cấu hình tiêu chí nhắm mục tiêu cho mục tiêu giữ chân ở cấp chiến dịch, hãy định cấu hình trường campaign_retention_settings thuộc loại CampaignRetentionGoalSettings:

• value_settings_override (Loại: CustomerLifecycleOptimizationValueSettings): Các mức điều chỉnh cho giá trị tuỳ chỉnh để ghi đè chế độ cài đặt ở cấp tài khoản.
• target_option (Loại: CustomerLifecycleOptimizationMode): Kiểm soát chế độ tối ưu hoá. Giá trị mặc định là TARGET_ALL. Để đặt thành TARGET_SPECIFIC, tài khoản của bạn phải có trong danh sách cho phép thích hợp.

def create_campaign_retention_config(
    client: GoogleAdsClient,
    customer_id: str,
    goal_resource_name: str,
    campaign_resource_name: str,
) -> None:
    """Sends an API request to add a new CampaignGoalConfig for Retention.

    Args:
        client: an initialized GoogleAdsClient instance.
        customer_id: a client customer ID.
        goal_resource_name: the resource name of an existing Retention Goal.
        campaign_resource_name: the resource name of an existing Campaign.
    """
    operation: CampaignGoalConfigOperation = client.get_type(
        "CampaignGoalConfigOperation"
    )
    goal_config = operation.create
    goal_config.campaign = campaign_resource_name
    goal_config.goal = goal_resource_name

    goal_config.campaign_retention_settings.target_option = (
        client.enums.CustomerLifecycleOptimizationModeEnum.TARGET_ALL
    )
    # Accounts on the allowlist can set TARGET_SPECIFIC instead:
    # goal_config.campaign_retention_settings.target_option = (
    #     client.enums.CustomerLifecycleOptimizationModeEnum.TARGET_SPECIFIC
    # )

    campaign_goal_config_service = client.get_service(
        "CampaignGoalConfigService"
    )
    campaign_goal_config_service.mutate_campaign_goal_configs(
        customer_id=customer_id, operations=[operation]
    )

campaign_retention_settings.target_option mặc định là TARGET_ALL nếu không được đặt. Chỉ những người dùng có trong danh sách cho phép thích hợp mới có thể đặt TARGET_SPECIFIC.

Chế độ cài đặt giữ chân khách hàng thân thiết của chiến dịch

Để ghi đè chế độ cài đặt hoặc định cấu hình hành vi dành riêng cho thành viên thân thiết ở cấp chiến dịch cho các mục tiêu LOYALTY_RETENTION, hãy định cấu hình trường campaign_loyalty_retention_settings thuộc loại CampaignLoyaltyRetentionGoalSettings trên CampaignGoalConfig:

• value_settings_override (Loại: CustomerLifecycleOptimizationValueSettings): Các mức điều chỉnh cho giá trị tuỳ chỉnh để ghi đè chế độ cài đặt giá trị giữ chân khách hàng thân thiết ở cấp tài khoản.
• enable_bid_adjustments_for_loyalty_members (Loại: bool): Có bật các mức điều chỉnh giá thầu cho thành viên của chương trình khách hàng thân thiết trong chiến dịch này hay không.
• show_targeted_loyalty_member_benefits_in_pla (Loại: bool): Có hiển thị các lợi ích dành riêng cho thành viên thân thiết ở định dạng Quảng cáo trang thông tin sản phẩm (PLA) ở các quốc gia đủ điều kiện hay không.

def create_campaign_loyalty_retention_config(
    client: GoogleAdsClient,
    customer_id: str,
    goal_resource_name: str,
    campaign_resource_name: str,
) -> None:
    """Sends an API request to add a new CampaignGoalConfig for Loyalty.

    Args:
        client: an initialized GoogleAdsClient instance.
        customer_id: a client customer ID.
        goal_resource_name: the resource name of an existing Loyalty Goal.
        campaign_resource_name: the resource name of an existing Campaign.
    """
    operation: CampaignGoalConfigOperation = client.get_type(
        "CampaignGoalConfigOperation"
    )
    goal_config = operation.create
    goal_config.campaign = campaign_resource_name
    goal_config.goal = goal_resource_name

    # Enable bid adjustments and targeted loyalty benefits in PLAs.
    loyalty_settings = goal_config.campaign_loyalty_retention_settings
    loyalty_settings.enable_bid_adjustments_for_loyalty_members = True
    loyalty_settings.show_targeted_loyalty_member_benefits_in_pla = True

    campaign_goal_config_service = client.get_service(
        "CampaignGoalConfigService"
    )
    campaign_goal_config_service.mutate_campaign_goal_configs(
        customer_id=customer_id, operations=[operation]
    )

Xác thực và lỗi

Khi định cấu hình các mục tiêu vòng đời của khách hàng, bạn có thể gặp phải các ràng buộc và lỗi sau:

Lỗi xác thực mục tiêu

Định cấu hình mục tiêu trùng lặp

Việc tạo mục tiêu vòng đời trùng lặp khi đã có một mục tiêu sẽ dẫn đến lỗi GoalError.NEW_CUSTOMER_ACQUISITION_GOAL_ALREADY_EXISTS (đối với NCA), GoalError.RETENTION_GOAL_ALREADY_EXISTS (đối với mục tiêu giữ chân) hoặc GoalError.LOYALTY_RETENTION_GOAL_ALREADY_EXISTS (đối với mục tiêu giữ chân khách hàng thân thiết).

Chế độ cài đặt giá trị không hợp lệ

Khi định cấu hình chế độ cài đặt giá trị mục tiêu vòng đời, nếu có giá trị vòng đời cao, thì phải có giá trị tiêu chuẩn (GoalError.HIGH_LIFETIME_VALUE_PRESENT_BUT_VALUE_ABSENT) và giá trị vòng đời cao phải lớn hơn giá trị (nếu được đặt) (GoalError.HIGH_LIFETIME_VALUE_LESS_THAN_OR_EQUAL_TO_VALUE).

Tương tự, đối với chế độ cài đặt giá trị nhân, nếu có hệ số nhân giá trị vòng đời cao, thì phải có hệ số nhân giá trị (GoalError.HIGH_LIFETIME_VALUE_MULTIPLIER_PRESENT_BUT_VALUE_MULTIPLIER_ABSENT) và hệ số nhân giá trị vòng đời cao phải lớn hơn nghiêm ngặt hệ số nhân giá trị (GoalError.HIGH_LIFETIME_VALUE_MULTIPLIER_LESS_THAN_OR_EQUAL_TO_VALUE_MULTIPLIER).

Lỗi xác thực cấu hình mục tiêu của chiến dịch

Xung đột ghi đè giá trị mục tiêu cụ thể

Đối với mục tiêu Thu nạp khách hàng mới, nếu target_option được đặt thành TARGET_SPECIFIC (chỉ nhắm đến khách hàng mới), thì bạn không được định cấu hình các chế độ ghi đè giá trị ở cấp chiến dịch (CampaignGoalConfigError.CAMPAIGN_OVERRIDE_VALUES_SET_FOR_NEW_CUSTOMER_ACQUISITION_TARGET_SPECIFIC_OPTION). Các mức điều chỉnh giá thầu không áp dụng khi bạn chỉ nhắm đến khách hàng mới.

Ghi đè chế độ cài đặt giá trị không hợp lệ

Khi định cấu hình các chế độ ghi đè chế độ cài đặt giá trị vòng đời ở cấp chiến dịch, nếu có giá trị vòng đời cao, thì phải có giá trị tiêu chuẩn (CampaignGoalConfigError.HIGH_LIFETIME_VALUE_PRESENT_BUT_VALUE_ABSENT) và giá trị vòng đời cao phải lớn hơn giá trị (nếu được đặt) (CampaignGoalConfigError.HIGH_LIFETIME_VALUE_LESS_THAN_OR_EQUAL_TO_VALUE). Tương tự, đối với chế độ cài đặt giá trị nhân, nếu có hệ số nhân giá trị vòng đời cao, thì phải có hệ số nhân giá trị (CampaignGoalConfigError.HIGH_LIFETIME_VALUE_MULTIPLIER_PRESENT_BUT_VALUE_MULTIPLIER_ABSENT) và hệ số nhân giá trị vòng đời cao phải lớn hơn nghiêm ngặt hệ số nhân giá trị (CampaignGoalConfigError.HIGH_LIFETIME_VALUE_MULTIPLIER_LESS_THAN_OR_EQUAL_TO_VALUE_MULTIPLIER).

Hỗ trợ loại chiến dịch có giá trị vòng đời cao

Bạn chỉ được đặt các chế độ ghi đè giá trị vòng đời cao và các chế độ ghi đè hệ số nhân giá trị vòng đời cao cho các loại chiến dịch được hỗ trợ (CampaignGoalConfigError.CAMPAIGN_OVERRIDE_HIGH_LIFETIME_VALUE_NOT_SUPPORTED_FOR_CAMPAIGN_TYPE hoặc CampaignGoalConfigError.CAMPAIGN_OVERRIDE_HIGH_LIFETIME_VALUE_MULTIPLIER_NOT_SUPPORTED_FOR_CAMPAIGN_TYPE).

Mục tiêu không tương thích

Hệ thống sẽ trả về lỗi nếu một chiến dịch cố gắng áp dụng đồng thời các mục tiêu Tối ưu hoá vòng đời của khách hàng không tương thích (CampaignGoalConfigError.CANNOT_USE_INCOMPATIBLE_CLO_GOALS). Bảng sau đây trình bày các tổ hợp mục tiêu loại trừ lẫn nhau gây ra lỗi này:

Truy xuất mục tiêu vòng đời

Giống như các tài nguyên khác trong Google Ads API, hãy sử dụng các phương thức search hoặc searchStream của GoogleAdsService để truy xuất các mục tiêu và cấu hình vòng đời.

Truy vấn sau đây truy xuất thông tin chi tiết của mọi Goal đã định cấu hình trong tài khoản Google Ads API:

SELECT
  goal.goal_id,
  goal.goal_type,
  goal.owner_customer,
  goal.new_customer_acquisition_goal_settings.value_settings.additional_value,
  goal.new_customer_acquisition_goal_settings.value_settings.additional_high_lifetime_value,
  goal.retention_goal_settings.value_settings.additional_value,
  goal.retention_goal_settings.value_settings.additional_high_lifetime_value,
  goal.loyalty_retention_goal_settings.value_settings.value_multiplier
FROM goal

Tương tự, truy vấn sau đây truy xuất thông tin chi tiết của mọi CampaignGoalConfig:

SELECT
  campaign_goal_config.campaign,
  campaign_goal_config.goal,
  campaign_goal_config.goal_type,
  campaign_goal_config.campaign_new_customer_acquisition_settings.target_option,
  campaign_goal_config.campaign_new_customer_acquisition_settings.value_settings_override.additional_value,
  campaign_goal_config.campaign_new_customer_acquisition_settings.value_settings_override.additional_high_lifetime_value,
  campaign_goal_config.campaign_retention_settings.target_option,
  campaign_goal_config.campaign_retention_settings.value_settings_override.additional_value,
  campaign_goal_config.campaign_loyalty_retention_settings.value_settings_override.value_multiplier,
  campaign_goal_config.campaign_loyalty_retention_settings.enable_bid_adjustments_for_loyalty_members,
  campaign_goal_config.campaign_loyalty_retention_settings.show_targeted_loyalty_member_benefits_in_pla
FROM campaign_goal_config