Gunakan resource Goal dan CampaignGoalConfig
Google Ads API untuk mengonfigurasi sasaran yang terkait dengan siklus proses pelanggan.
Google Ads API mendukung sasaran akuisisi pelanggan dan
sasaran retensi untuk mengelola penyesuaian nilai umur 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 lainnya 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 berinteraksi kembali dengan pelanggan lama, pelanggan bernilai tinggi, dan pelanggan yang tidak aktif.
LOYALTY_RETENTION- Untuk mendorong retensi dan engagement, khususnya di antara anggota program loyalitas.
Mengonfigurasi sasaran siklus proses pelanggan
Di tingkat pelanggan, konfigurasikan sasaran siklus proses dengan membuat
Goal. Hanya boleh ada maksimal 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 konfigurasikan setelan di
kolom new_customer_acquisition_goal_settings menggunakan
GoalService.
Kolom new_customer_acquisition_goal_settings.value_settings menggunakan
CustomerLifecycleOptimizationValueSettings untuk
menentukan penyesuaian nilai konversi bagi pelanggan yang diakuisisi:
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 untukNEW_CUSTOMER_ACQUISITION; didukung untukLOYALTY_RETENTION).
high_lifetime_value_adjustment(oneof):additional_high_lifetime_value(double): Nilai konversi inkremental untuk pelanggan baru yang diidentifikasi sebagai pelanggan dengan nilai umur tinggi.high_lifetime_value_multiplier(double): Pengganda nilai konversi yang akan diterapkan untuk pelanggan baru dengan nilai umur tinggi (belum didukung).
Nilai umur tinggi harus lebih besar dari nilai, dan pengganda nilai umur tinggi harus benar-benar 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
konfigurasikan setelan di kolom retention_goal_settings.
Sebelum membuat sasaran retensi, Anda harus memenuhi prasyarat yang dijelaskan dalam artikel 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 di 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 konfigurasikan setelan di
kolom loyalty_retention_goal_settings (LoyaltyRetentionGoal).
Tidak seperti sasaran NEW_CUSTOMER_ACQUISITION dan CUSTOMER_RETENTION (yang menggunakan penyesuaian nilai tambahan), sasaran LOYALTY_RETENTION mendukung setelan value_multiplier 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 menyegmentasikan audiens untuk 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 operasi create dan remove, jadi jika ingin memperbarui UserListCustomerType yang ada, Anda harus menghapusnya, lalu membuat yang baru dengan update yang diperlukan.
UserListCustomerType hanya dapat ditetapkan ke satu daftar pengguna, tetapi daftar pengguna
dapat memiliki beberapa instance UserListCustomerType terkait selama tidak ada
konflik di antara instance UserListCustomerType. Mencoba menetapkan instance UserListCustomerType dengan kombinasi customer_type_category berikut ke daftar pengguna yang sama akan menghasilkan error UserListCustomerTypeError.CONFLICTING_CUSTOMER_TYPES:
customer_type_category pertama |
customer_type_category kedua |
|---|---|
PURCHASERS |
CONVERTED_LEADS |
PURCHASERS |
QUALIFIED_LEADS |
PURCHASERS |
CART_ABANDONERS |
CONVERTED_LEADS |
QUALIFIED_LEADS |
DISENGAGED_CUSTOMERS |
CONVERTED_LEADS |
DISENGAGED_CUSTOMERS |
QUALIFIED_LEADS |
DISENGAGED_CUSTOMERS |
CART_ABANDONERS |
LOYALTY_TIER_X_MEMBERS |
LOYALTY_TIER_Y_MEMBERS |
Mengonfigurasi konfigurasi sasaran siklus proses kampanye
Di tingkat kampanye, Anda dapat mengonfigurasi penggantian khusus kampanye atau
opsi penargetan menggunakan CampaignGoalConfig. Setelah
memiliki sasaran tingkat akun, gunakan resource_name-nya 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,
konfigurasikan 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. Opsinya adalah:TARGET_ALL: Kampanye menargetkan pelanggan baru dan 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, konfigurasikan 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 adalahTARGET_ALL. Untuk menetapkannya keTARGET_SPECIFIC, akun Anda harus tercantum dalam 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 di
daftar yang diizinkan yang sesuai.
Setelan retensi loyalitas kampanye
Untuk mengganti setelan atau mengonfigurasi perilaku khusus anggota program loyalitas di tingkat kampanye untuk sasaran LOYALTY_RETENTION, konfigurasikan kolom campaign_loyalty_retention_settings dari jenis CampaignLoyaltyRetentionGoalSettings di 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): Menentukan apakah akan mengaktifkan penyesuaian bid untuk anggota program loyalitas di kampanye ini.show_targeted_loyalty_member_benefits_in_pla(Jenis:bool): Menentukan apakah akan menampilkan manfaat langganan anggota program 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 tersebut sudah ada akan menghasilkan error
GoalError.NEW_CUSTOMER_ACQUISITION_GOAL_ALREADY_EXISTS(untuk NCA),GoalError.RETENTION_GOAL_ALREADY_EXISTS(untuk sasaran retensi), atauGoalError.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 multiplikatif, 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 benar-benar 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 spesifik target
- Untuk sasaran Akuisisi Pelanggan Baru, jika
target_optionditetapkan keTARGET_SPECIFIC(untuk hanya menarget pelanggan baru), penggantian nilai tingkat kampanye tidak boleh dikonfigurasi (CampaignGoalConfigError.CAMPAIGN_OVERRIDE_VALUES_SET_FOR_NEW_CUSTOMER_ACQUISITION_TARGET_SPECIFIC_OPTION). Penyesuaian bidding tidak berlaku saat hanya menarget pelanggan baru. - Penggantian setelan nilai tidak valid
- Saat mengonfigurasi penggantian setelan nilai umur 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 multiplikatif, 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 benar-benar 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_TYPEatauCampaignGoalConfigError.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:
| Jenis/Mode Sasaran Siklus Proses Pelanggan | Sasaran/Mode Tidak Kompatibel |
|---|---|
Retensi Pelanggan ("Hanya ajukan bid untuk pelanggan yang tidak aktif" /
TARGET_SPECIFIC)
|
Akuisisi Pelanggan Baru ("Hanya ajukan bid untuk pelanggan baru" /
TARGET_SPECIFIC, "Ajukan bid yang lebih tinggi untuk pelanggan baru" /
TARGET_ALL), Prospek
|
Retensi Pelanggan ("Ajukan bid lebih tinggi untuk pelanggan yang tidak aktif" /
TARGET_ALL)
|
Akuisisi Pelanggan Baru ("Hanya ajukan bid untuk pelanggan baru" /
TARGET_SPECIFIC), Prospek
|
| Retensi Loyalitas (Pengganda Nilai) |
Akuisisi Pelanggan Baru ("Hanya ajukan bid untuk pelanggan baru"/
TARGET_SPECIFIC), Retensi Pelanggan ("Hanya ajukan bid untuk pelanggan
yang tidak aktif" / TARGET_SPECIFIC), Prospek, Laba Kotor
|
| Retensi Loyalitas (Manfaat di PLA) |
Akuisisi Pelanggan Baru ("Hanya ajukan bid untuk pelanggan baru"/
TARGET_SPECIFIC), Prospek, Laba Kotor
|
| Identifikasi calon pembeli |
Akuisisi Pelanggan Baru ("Hanya ajukan bid untuk pelanggan baru" /
TARGET_SPECIFIC, "Ajukan bid yang lebih tinggi untuk pelanggan baru" /
TARGET_ALL)
|
Mengambil sasaran siklus proses
Seperti resource lainnya di Google Ads API, gunakan metode search atau searchStream dari 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