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 siklus proses pelanggan secara efisien melalui kampanye Google Ads.
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 menyetel 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 pada 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 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 kolom
new_customer_acquisition_goal_settings menggunakan
GoalService.
Kolom new_customer_acquisition_goal_settings.value_settings menggunakan
CustomerLifecycleOptimizationValueSettings untuk
menentukan penyesuaian nilai konversi untuk pelanggan yang diakuisisi:
value_settings(CustomerLifecycleOptimizationValueSettings):value_adjustment(oneof):additional_value(ganda): Nilai konversi inkremental yang akan ditambahkan ke konversi pembelian pertama pelanggan baru.value_multiplier(ganda): 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(ganda): Nilai konversi tambahan untuk pelanggan baru yang diidentifikasi sebagai pelanggan dengan nilai umur tinggi.high_lifetime_value_multiplier(ganda): 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 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 dalam 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 konfigurasikan setelan di kolom
loyalty_retention_goal_settings (LoyaltyRetentionGoal).
Tidak seperti sasaran NEW_CUSTOMER_ACQUISITION dan CUSTOMER_RETENTION (yang menggunakan
penyesuaian nilai aditif), 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]
)
Menyegmentasikan audiens
Anda harus menggunakan resource UserListCustomerType untuk menyegmentasikan audiens untuk sasaran siklus proses pelanggan (termasuk sasaran Akuisisi Pelanggan Baru, Retensi Pelanggan, dan 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 Anda ingin memperbarui UserListCustomerType yang ada, Anda harus menghapusnya terlebih dahulu, 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 instance UserListCustomerType dengan kombinasi
customer_type_category berikut ke daftar pengguna yang sama akan menghasilkan error
UserListCustomerTypeError.CONFLICTING_CUSTOMER_TYPES:
customer_type_category pertama |
Kedua customer_type_category |
|---|---|
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 spesifik per 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, konfigurasi kolom campaign_new_customer_acquisition_settings berjenis CampaignNewCustomerAcquisitionGoalSettings:
value_settings_override(Jenis:CustomerLifecycleOptimizationValueSettings): Penyesuaian nilai kustom untuk menggantikan 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 bid 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 berjenis CampaignRetentionGoalSettings:
value_settings_override(Jenis:CustomerLifecycleOptimizationValueSettings): Penyesuaian nilai kustom untuk menggantikan setelan tingkat akun.target_option(Jenis:CustomerLifecycleOptimizationMode): Mengontrol mode pengoptimalan. Nilai defaultnya adalahTARGET_ALL. Untuk menyetelnya 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]
)
Nilai default campaign_retention_settings.target_option adalah TARGET_ALL jika tidak
ditetapkan. Opsi untuk menyetel TARGET_SPECIFIC hanya tersedia untuk pengguna dalam 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, konfigurasi kolom campaign_loyalty_retention_settings jenis CampaignLoyaltyRetentionGoalSettings di CampaignGoalConfig:
value_settings_override(Type:CustomerLifecycleOptimizationValueSettings): Penyesuaian nilai kustom untuk menggantikan 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 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 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, maka 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, maka pengganda nilai harus ada
(
GoalError.HIGH_LIFETIME_VALUE_MULTIPLIER_PRESENT_BUT_VALUE_MULTIPLIER_ABSENT), dan pengganda nilai umur tinggi harus lebih besar daripada 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 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, maka 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, maka pengganda nilai harus ada (CampaignGoalConfigError.HIGH_LIFETIME_VALUE_MULTIPLIER_PRESENT_BUT_VALUE_MULTIPLIER_ABSENT), dan pengganda nilai umur tinggi harus lebih besar daripada 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), Pencarian Pelanggan
|
Retensi Pelanggan ("Ajukan bid lebih tinggi untuk pelanggan yang tidak aktif" /
TARGET_ALL)
|
Akuisisi Pelanggan Baru ("Hanya ajukan bid untuk pelanggan baru" /
TARGET_SPECIFIC), Mencari Pelanggan Potensial
|
| 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), Prospeksi, Laba Kotor
|
| Retensi Loyalitas (Manfaat di PLA) |
Akuisisi Pelanggan Baru ("Hanya ajukan bid untuk pelanggan baru" /
TARGET_SPECIFIC), Penjajakan, Laba Kotor
|
| Prospecting |
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
GoogleAdsService untuk mengambil tujuan
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