Sasaran siklus proses

Gunakan resource Goal dan CampaignGoalConfig Google Ads API untuk mengonfigurasi sasaran terkait siklus proses pelanggan. Google Ads API mendukung sasaran akuisisi pelanggan dan sasaran retensi untuk mengelola penyesuaian nilai siklus proses pelanggan secara efisien melalui kampanye Google Ads Anda.

Jika akun Google Ads Anda menggunakan tracking konversi lintas-akun, Anda harus mengonfigurasi sasaran siklus proses tingkat pelanggan di akun konversi Google Ads bukan langsung di akun Google Ads Anda. Namun, Anda tetap harus menetapkan konfigurasi tingkat kampanye di akun Anda. Hal ini mirip dengan cara Anda mengelola sasaran lain saat menggunakan tracking konversi lintas-akun.

Jenis sasaran siklus proses pelanggan

Sasaran siklus proses pelanggan dikonfigurasi di tingkat akun menggunakan resource Goal. Sasaran mewakili tujuan siklus proses tertentu dan ditentukan oleh goal_type-nya.

Jenis sasaran siklus proses yang didukung adalah:

NEW_CUSTOMER_ACQUISITION

Untuk mengakuisisi pelanggan baru secara efisien dengan menetapkan penyesuaian nilai ke konversi mereka.

CUSTOMER_RETENTION

Untuk menjangkau kembali pelanggan lama, pelanggan bernilai tinggi, dan pelanggan yang tidak aktif.

LOYALTY_RETENTION

Untuk mendorong retensi dan engagement secara khusus di antara anggota program loyalitas.

Mengonfigurasi sasaran siklus proses pelanggan

Di tingkat pelanggan, konfigurasi sasaran siklus proses dengan membuat Goal. Maksimal hanya ada satu Goal per jenis sasaran (NEW_CUSTOMER_ACQUISITION, CUSTOMER_RETENTION, atau LOYALTY_RETENTION) di akun Google Ads.

Setelan sasaran akuisisi pelanggan baru

Untuk menyiapkan Akuisisi Pelanggan Baru (NCA), tetapkan goal_type ke NEW_CUSTOMER_ACQUISITION dan konfigurasi setelan di new_customer_acquisition_goal_settings kolom menggunakan GoalService.

Kolom new_customer_acquisition_goal_settings.value_settings menggunakan CustomerLifecycleOptimizationValueSettings untuk menentukan penyesuaian nilai konversi bagi pelanggan yang diperoleh:

• value_settings (CustomerLifecycleOptimizationValueSettings):
  • value_adjustment (oneof):
    • additional_value (double): Nilai konversi inkremental yang akan ditambahkan ke konversi pembelian pertama pelanggan baru.
    • value_multiplier (double): Pengganda yang akan diterapkan ke nilai konversi untuk pembelian pertama pelanggan baru (tidak didukung untuk NEW_CUSTOMER_ACQUISITION; didukung untuk LOYALTY_RETENTION).
  • high_lifetime_value_adjustment (oneof):
    • additional_high_lifetime_value (double): Nilai konversi inkremental untuk pelanggan baru yang diidentifikasi sebagai pelanggan bernilai umur tinggi.
    • high_lifetime_value_multiplier (double): Pengganda nilai konversi yang akan diterapkan untuk pelanggan baru bernilai umur tinggi (belum didukung).

Nilai umur tinggi harus lebih besar dari nilai, dan pengganda nilai umur tinggi harus lebih besar dari pengganda nilai, jika ditetapkan.

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]
    )

Setelan sasaran retensi pelanggan

Untuk menyiapkan retensi pelanggan, tetapkan goal_type ke CUSTOMER_RETENTION dan konfigurasi setelan di kolom retention_goal_settings.

Sebelum membuat sasaran retensi, Anda harus memenuhi prasyarat yang dijelaskan di Tentang sasaran retensi. Hal ini mencakup memiliki kampanye Performa Maksimal dan daftar pengguna Customer Match.

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]
    )

Tindakan ini akan membuat sasaran retensi baru di tingkat akun untuk akun klien yang ditentukan, yang diterapkan ke semua kampanyenya. Secara default, sasaran ini menargetkan semua pengguna dalam daftar pengguna Customer Match Anda.

Setelan sasaran retensi loyalitas

Untuk menyiapkan sasaran retensi loyalitas bagi anggota program loyalitas, tetapkan goal_type ke LOYALTY_RETENTION dan konfigurasi setelan di kolom loyalty_retention_goal_settings (LoyaltyRetentionGoal).

Tidak seperti NEW_CUSTOMER_ACQUISITION dan CUSTOMER_RETENTION target (yang menggunakan penyesuaian nilai tambahan), LOYALTY_RETENTION target mendukung value_multiplier setelan di value_settings menggunakan 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]
    )

Menentukan segmen audiens

Anda harus menggunakan resource UserListCustomerType untuk menentukan segmen audiens bagi sasaran siklus proses pelanggan (termasuk sasaran Akuisisi Pelanggan Baru, Retensi Pelanggan, dan sasaran retensi loyalitas). Anda harus mengaitkan setiap daftar pengguna dengan satu atau beberapa kategori dengan membuat UserListCustomerType untuk setiap kombinasi daftar pengguna dan kategori.

Gunakan UserListCustomerTypeService untuk membuat instance UserListCustomerType.

UserListCustomerTypeService hanya mendukung create dan remove operasi, jadi jika ingin memperbarui UserListCustomerType yang ada, Anda harus menghapusnya, lalu membuat yang baru dengan pembaruan yang diperlukan.

UserListCustomerType hanya dapat ditetapkan ke satu daftar pengguna, tetapi daftar pengguna dapat memiliki beberapa instance UserListCustomerType terkait selama tidak ada konflik antara instance UserListCustomerType. Mencoba menetapkan UserListCustomerType instance dengan kombinasi berikut dari customer_type_category ke daftar pengguna yang sama akan menghasilkan error UserListCustomerTypeError.CONFLICTING_CUSTOMER_TYPES:

Mengonfigurasi konfigurasi sasaran siklus proses kampanye

Di tingkat kampanye, Anda dapat mengonfigurasi penggantian atau opsi penargetan khusus kampanye menggunakan CampaignGoalConfig. Setelah memiliki sasaran tingkat akun, gunakan resource_name untuk membuat CampaignGoalConfig menggunakan metode mutate_campaign_goal_configs di CampaignGoalConfigService.

Setelan akuisisi pelanggan baru kampanye

Untuk mengganti setelan atau mengonfigurasi penargetan untuk NCA di tingkat kampanye, konfigurasi kolom campaign_new_customer_acquisition_settings dari jenis CampaignNewCustomerAcquisitionGoalSettings:

• value_settings_override (Jenis: CustomerLifecycleOptimizationValueSettings): Penyesuaian nilai kustom untuk mengganti setelan tingkat akun.
• target_option (Jenis: CustomerLifecycleOptimizationMode): Mengontrol mode pengoptimalan siklus proses pelanggan. Opsi yang tersedia adalah:
  • TARGET_ALL: Kampanye menargetkan pelanggan baru dan pelanggan lama, tetapi mengajukan bid yang lebih tinggi untuk pelanggan baru menggunakan penyesuaian nilai yang dikonfigurasi.
  • TARGET_SPECIFIC: Kampanye hanya menargetkan pelanggan baru. Penyesuaian bidding tidak berlaku untuk opsi ini.

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]
    )

Setelan retensi pelanggan kampanye

Untuk mengganti setelan atau mengonfigurasi penargetan untuk sasaran retensi di tingkat kampanye, konfigurasi kolom campaign_retention_settings dari jenis CampaignRetentionGoalSettings:

• value_settings_override (Jenis: CustomerLifecycleOptimizationValueSettings): Penyesuaian nilai kustom untuk mengganti setelan tingkat akun.
• target_option (Jenis: CustomerLifecycleOptimizationMode): Mengontrol mode pengoptimalan. Nilai defaultnya adalah TARGET_ALL. Agar dapat menetapkannya ke TARGET_SPECIFIC, akun Anda harus berada di daftar yang diizinkan yang sesuai.

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 ditetapkan secara default ke TARGET_ALL jika tidak ditetapkan. Opsi untuk menetapkan TARGET_SPECIFIC hanya tersedia untuk pengguna yang berada di daftar yang diizinkan yang sesuai.

Setelan retensi loyalitas kampanye

Untuk mengganti setelan atau mengonfigurasi perilaku khusus anggota loyalitas di tingkat kampanye untuk sasaran LOYALTY_RETENTION goals, konfigurasi campaign_loyalty_retention_settings field of type CampaignLoyaltyRetentionGoalSettings on CampaignGoalConfig:

• value_settings_override (Jenis: CustomerLifecycleOptimizationValueSettings): Penyesuaian nilai kustom untuk mengganti setelan nilai retensi loyalitas tingkat akun.
• enable_bid_adjustments_for_loyalty_members (Jenis: bool): Apakah akan mengaktifkan penyesuaian bid untuk anggota program loyalitas dalam kampanye ini.
• show_targeted_loyalty_member_benefits_in_pla (Jenis: bool): Apakah akan menampilkan manfaat langganan anggota loyalitas yang ditargetkan dalam format Iklan Listingan Produk (PLA) di negara yang memenuhi syarat.

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]
    )

Validasi dan error

Saat mengonfigurasi sasaran siklus proses pelanggan, batasan dan error berikut mungkin terjadi:

Error validasi sasaran

Konfigurasi sasaran duplikat

Membuat sasaran siklus proses duplikat saat sasaran sudah ada akan menghasilkan error GoalError.NEW_CUSTOMER_ACQUISITION_GOAL_ALREADY_EXISTS (untuk NCA), GoalError.RETENTION_GOAL_ALREADY_EXISTS (untuk sasaran retensi), atau GoalError.LOYALTY_RETENTION_GOAL_ALREADY_EXISTS (untuk sasaran retensi loyalitas).

Setelan nilai tidak valid

Saat mengonfigurasi setelan nilai sasaran siklus proses, jika nilai umur tinggi ada, nilai standar harus ada (GoalError.HIGH_LIFETIME_VALUE_PRESENT_BUT_VALUE_ABSENT), dan nilai umur tinggi harus lebih besar dari nilai, jika ditetapkan (GoalError.HIGH_LIFETIME_VALUE_LESS_THAN_OR_EQUAL_TO_VALUE).

Demikian pula, untuk setelan nilai perkalian, jika pengganda nilai umur tinggi ada, pengganda nilai harus ada (GoalError.HIGH_LIFETIME_VALUE_MULTIPLIER_PRESENT_BUT_VALUE_MULTIPLIER_ABSENT), dan pengganda nilai umur tinggi harus lebih besar dari pengganda nilai (GoalError.HIGH_LIFETIME_VALUE_MULTIPLIER_LESS_THAN_OR_EQUAL_TO_VALUE_MULTIPLIER).

Error validasi konfigurasi sasaran kampanye

Konflik penggantian nilai target tertentu

Untuk sasaran Akuisisi Pelanggan Baru, jika target_option ditetapkan ke TARGET_SPECIFIC (untuk menargetkan pelanggan baru saja), penggantian nilai tingkat kampanye tidak boleh dikonfigurasi (CampaignGoalConfigError.CAMPAIGN_OVERRIDE_VALUES_SET_FOR_NEW_CUSTOMER_ACQUISITION_TARGET_SPECIFIC_OPTION). Penyesuaian bidding tidak berlaku saat menargetkan hanya pelanggan baru.

Penggantian setelan nilai tidak valid

Saat mengonfigurasi penggantian setelan nilai siklus proses tingkat kampanye, jika nilai umur tinggi ada, nilai standar harus ada (CampaignGoalConfigError.HIGH_LIFETIME_VALUE_PRESENT_BUT_VALUE_ABSENT), dan nilai umur tinggi harus lebih besar dari nilai, jika ditetapkan (CampaignGoalConfigError.HIGH_LIFETIME_VALUE_LESS_THAN_OR_EQUAL_TO_VALUE). Demikian pula, untuk setelan nilai perkalian, jika pengganda nilai umur tinggi ada, pengganda nilai harus ada (CampaignGoalConfigError.HIGH_LIFETIME_VALUE_MULTIPLIER_PRESENT_BUT_VALUE_MULTIPLIER_ABSENT), dan pengganda nilai umur tinggi harus lebih besar dari pengganda nilai (CampaignGoalConfigError.HIGH_LIFETIME_VALUE_MULTIPLIER_LESS_THAN_OR_EQUAL_TO_VALUE_MULTIPLIER).

Dukungan jenis kampanye nilai umur tinggi

Penggantian nilai umur tinggi dan penggantian pengganda nilai umur tinggi hanya boleh ditetapkan untuk jenis kampanye yang didukung (CampaignGoalConfigError.CAMPAIGN_OVERRIDE_HIGH_LIFETIME_VALUE_NOT_SUPPORTED_FOR_CAMPAIGN_TYPE atau CampaignGoalConfigError.CAMPAIGN_OVERRIDE_HIGH_LIFETIME_VALUE_MULTIPLIER_NOT_SUPPORTED_FOR_CAMPAIGN_TYPE).

Sasaran yang tidak kompatibel

Error akan ditampilkan jika kampanye mencoba menerapkan sasaran Pengoptimalan Siklus Proses Pelanggan yang tidak kompatibel secara bersamaan (CampaignGoalConfigError.CANNOT_USE_INCOMPATIBLE_CLO_GOALS). Tabel berikut menguraikan kombinasi sasaran yang saling eksklusif yang memicu error ini:

Mengambil sasaran siklus proses

Seperti resource lainnya di Google Ads API, gunakan search atau searchStream metode GoogleAdsService untuk mengambil sasaran dan konfigurasi siklus proses.

Kueri berikut mengambil detail setiap Goal yang dikonfigurasi di akun 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

Demikian pula, kueri berikut mengambil detail setiap 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