از Goal و CampaignGoalConfig
منابع Google Ads API برای پیکربندی اهداف مربوط به چرخه حیات مشتری استفاده کنید.
Google Ads API از اهداف جذب مشتری و اهداف حفظ مشتری پشتیبانی میکند تا بتوانید بهطور مؤثر تعدیلهای ارزش چرخه عمر مشتری را ازطریق پویشهای Google Ads مدیریت کنید.
اگر حساب Google Ads شما از ردیابی تبدیل بینحسابی استفاده میکند، باید هدفهای چرخه عمر سطح مشتری را در حساب تبدیل Google Ads پیکربندی کنید، نه مستقیماً در حساب Google Ads خودتان. بااینحال، همچنان باید پیکربندیهای سطح پویش را در حسابتان تنظیم کنید. این مشابه نحوه مدیریت سایر اهداف هنگام استفاده از ردگیری تبدیل میانحسابی است.
انواع هدف چرخه حیات مشتری
اهداف چرخه حیات مشتری در سطح حساب بااستفاده از منبع
Goal پیکربندی میشوند. هدف نشاندهنده یک هدف چرخه حیات خاص است
و با goal_type آن تعریف میشود.
انواع هدف چرخه حیات پشتیبانیشده عبارتاند از:
NEW_CUSTOMER_ACQUISITION- برای جذب مؤثر مشتریان جدید با اختصاص دادن تعدیلهای ارزش به تبدیلهای آنها.
CUSTOMER_RETENTION- برای بازگرداندن مشتریان قدیمی، ارزشمند، و خاموش.
LOYALTY_RETENTION- برای افزایش ماندگاری و تعامل بهطور خاص در میان اعضای برنامه وفاداری.
پیکربندی اهداف چرخه حیات مشتری
در سطح مشتری، با ایجاد کردن
Goal، هدف چرخه حیات را پیکربندی کنید. در هر حساب Google Ads، حداکثر یک Goal برای هر نوع هدف (NEW_CUSTOMER_ACQUISITION، CUSTOMER_RETENTION، یا LOYALTY_RETENTION) میتواند وجود داشته باشد.
تنظیمات هدف «جذب مشتری جدید»
برای راهاندازی «کسب مشتری جدید» (NCA)، goal_type را روی
NEW_CUSTOMER_ACQUISITION تنظیم کنید و تنظیمات را در فیلد
new_customer_acquisition_goal_settings بااستفاده از
GoalService پیکربندی کنید.
فیلد new_customer_acquisition_goal_settings.value_settings از
CustomerLifecycleOptimizationValueSettings برای
مشخص کردن اصلاحات مقدار تبدیل برای مشتریان جذبشده استفاده میکند:
value_settings(CustomerLifecycleOptimizationValueSettings):value_adjustment(oneof):additional_value(دوبرابر): ارزش تبدیل افزایشی برای افزودن به تبدیل اولین خرید مشتری جدید.-
value_multiplier(دوبرابر): ضریبی که باید برای مقدار تبدیل برای اولین خرید مشتری جدید اعمال شود (برایNEW_CUSTOMER_ACQUISITIONپشتیبانی نمیشود؛ برایLOYALTY_RETENTIONپشتیبانی میشود).
high_lifetime_value_adjustment(oneof):additional_high_lifetime_value(دوبرابر): ارزش تبدیل افزایشی برای مشتریان جدیدی که بهعنوان مشتریان با ارزش طول عمر بالا شناسایی شدهاند.high_lifetime_value_multiplier(دوبرابر): ضریب ارزش تبدیل برای اعمال بر مشتریان جدید با ارزش طول عمر بالا (هنوز پشتیبانی نمیشود).
مقدار طول عمر بالا باید بیشتر از مقدار باشد، و ضریب مقدار طول عمر بالا باید کاملاً بیشتر از ضریب مقدار باشد (اگر تنظیم شده باشد).
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]
)
تنظیمات هدف «حفظ مشتری»
برای راهاندازی حفظ مشتری، goal_type را روی CUSTOMER_RETENTION تنظیم کنید و
تنظیمات را در فیلد retention_goal_settings پیکربندی کنید.
قبلاز ایجاد هدف نگهداری، باید پیشنیازهای شرحدادهشده در درباره هدف نگهداری را برآورده کنید. این شامل داشتن پویش «بیشینهسازی عملکرد» و فهرست کاربر «مطابقت مشتری» میشود.
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]
)
با این کار، هدف حفظ مشتری جدیدی در سطح حساب برای حساب مشتری مشخصشده ایجاد میشود که برای همه پویشهای آن اعمال میشود. بهطور پیشفرض، این هدف همه کاربران موجود در فهرستهای کاربران «مطابقت مشتری» شما را هدفیابی میکند.
تنظیمات هدف حفظ مشتری وفادار
برای راهاندازی اهداف حفظ وفاداری برای اعضای برنامه وفاداری، goal_type را روی LOYALTY_RETENTION تنظیم کنید و تنظیمات را در فیلد loyalty_retention_goal_settings (LoyaltyRetentionGoal) پیکربندی کنید.
برخلاف اهداف NEW_CUSTOMER_ACQUISITION و CUSTOMER_RETENTION (که از
تعدیلهای ارزش افزایشی استفاده میکنند)، اهداف LOYALTY_RETENTION از
تنظیم value_multiplier در value_settings بااستفاده از
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]
)
بخشبندی مخاطبان
برای بخشبندی مخاطبان برای اهداف چرخه حیات مشتری (ازجمله اهداف «کسب مشتری جدید»، «حفظ مشتری»، و «حفظ وفاداری»)، باید از منبع UserListCustomerType استفاده کنید. باید
هر فهرست کاربر را با ایجاد یک UserListCustomerType برای هر ترکیب فهرست کاربر و دسته، با یک یا چند دسته مرتبط کنید.
از UserListCustomerTypeService برای ایجاد نمونههای UserListCustomerType استفاده کنید.
UserListCustomerTypeService فقط از عملیات create و remove پشتیبانی میکند، بنابراین اگر میخواهید UserListCustomerType موجود را بهروز کنید، باید آن را بردارید و سپس با بهروزرسانیهای لازم، یک مورد جدید ایجاد کنید.
UserListCustomerType فقط میتواند به یک فهرست کاربران اختصاص داده شود، اما فهرست کاربران میتواند چندین نمونه UserListCustomerType مرتبط داشته باشد بهشرطی که بین نمونههای UserListCustomerType تعارضی وجود نداشته باشد. تلاش برای
اختصاص دادن UserListCustomerType نمونه با ترکیبهای زیر از
customer_type_category به فهرست نتایج کاربر یکسان منجر به
UserListCustomerTypeError.CONFLICTING_CUSTOMER_TYPES خطا میشود:
customer_type_category اول |
دومین 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 |
پیکربندی هدفهای چرخه عمر پویش
در سطح پویش، میتوانید بااستفاده از CampaignGoalConfig، گزینههای هدفیابی یا ملغی کردنهای خاص پویش را پیکربندی کنید. وقتی
هدف سطح حساب داشتید، از resource_name آن برای ایجاد
CampaignGoalConfig بااستفاده از روش mutate_campaign_goal_configs در
CampaignGoalConfigService استفاده کنید.
تنظیمات جذب مشتری جدید پویش
برای ملغی کردن تنظیمات یا پیکربندی هدفیابی برای NCA در سطح پویش،
فیلد campaign_new_customer_acquisition_settings از نوع
CampaignNewCustomerAcquisitionGoalSettings را پیکربندی کنید:
value_settings_override(نوع:CustomerLifecycleOptimizationValueSettings): تعدیلهای مقدار سفارشی برای ملغی کردن تنظیمات سطح حساب.target_option(نوع:CustomerLifecycleOptimizationMode): حالت بهینهسازی چرخه حیات مشتری را کنترل میکند. گزینهها عبارتاند از:TARGET_ALL: پویش هم مشتریان جدید و هم مشتریان فعلی را هدف قرار میدهد، اما بااستفاده از اصلاحات مقدار پیکربندیشده، برای مشتریان جدید قیمت پیشنهادی بالاتری ارائه میدهد.-
TARGET_SPECIFIC: پویش فقط مشتریان جدید را هدف قرار میدهد. تعدیل قیمت پیشنهادی برای این گزینه قابلاعمال نیست.
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]
)
تنظیمات حفظ مشتری پویش
برای لغو تنظیمات یا پیکربندی هدفیابی برای اهداف «حفظ مشتری» در سطح پویش، فیلد campaign_retention_settings از نوع CampaignRetentionGoalSettings را پیکربندی کنید:
value_settings_override(نوع:CustomerLifecycleOptimizationValueSettings): اصلاحات مقدار سفارشی برای لغو تنظیمات سطح حساب.target_option(نوع:CustomerLifecycleOptimizationMode): حالت بهینهسازی را کنترل میکند. پیشفرضها بهTARGET_ALL. برای تنظیم آن رویTARGET_SPECIFIC، حسابتان باید در فهرست مجازهای مناسب باشد.
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 تنظیم نشده باشد، بهطور پیشفرض روی TARGET_ALL تنظیم میشود. گزینه تنظیم TARGET_SPECIFIC فقط برای کاربران موجود در
فهرست مجاز مناسب دردسترس است.
تنظیمات حفظ وفاداری پویش
برای ملغی کردن تنظیمات یا پیکربندی رفتار ویژه عضو وفادار در سطح پویش برای LOYALTY_RETENTION هدف، فیلد campaign_loyalty_retention_settings از نوع CampaignLoyaltyRetentionGoalSettings را در CampaignGoalConfig پیکربندی کنید:
value_settings_override(نوع:CustomerLifecycleOptimizationValueSettings): اصلاحات مقدار سفارشی برای لغو تنظیمات مقدار حفظ وفاداری در سطح حساب.enable_bid_adjustments_for_loyalty_members(نوع:bool): آیا تعدیل قیمت پیشنهادی برای اعضای برنامه وفاداری در این پویش فعال شود یا نه.show_targeted_loyalty_member_benefits_in_pla(نوع:bool): اینکه مزایای هدفیابیشده اعضای وفادار در قالب «آگهی فهرستگان محصولات» (PLA) در کشورهای واجدشرایط نمایش داده شود یا نه.
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]
)
اعتبارسنجی و خطاها
هنگام پیکربندی اهداف چرخه حیات مشتری، ممکن است با محدودیتها و خطاهای زیر مواجه شوید:
خطاهای اعتبارسنجی هدف
- پیکربندی هدف تکراری
- ایجاد هدف چرخه حیات تکراری درحالیکه هدف دیگری ازقبل وجود دارد منجر به خطای
GoalError.NEW_CUSTOMER_ACQUISITION_GOAL_ALREADY_EXISTS(برای «اقدام مشتری جدید»)،GoalError.RETENTION_GOAL_ALREADY_EXISTS(برای اهداف نگهداری)، یاGoalError.LOYALTY_RETENTION_GOAL_ALREADY_EXISTS(برای اهداف نگهداری وفاداری) میشود. - تنظیمات مقدار نامعتبر
- هنگام پیکربندی تنظیمات مقدار هدف چرخه حیات، اگر مقدار طول عمر بالا وجود داشته باشد، مقدار استاندارد باید وجود داشته باشد
(
GoalError.HIGH_LIFETIME_VALUE_PRESENT_BUT_VALUE_ABSENT)، و مقدار طول عمر بالا باید بزرگتر از مقدار باشد، درصورت تنظیم (GoalError.HIGH_LIFETIME_VALUE_LESS_THAN_OR_EQUAL_TO_VALUE). - بههمین ترتیب، برای تنظیمات مقدار چندبرابر، اگر ضریب مقدار طول عمر بالا وجود داشته باشد، ضریب مقدار باید وجود داشته باشد
(
GoalError.HIGH_LIFETIME_VALUE_MULTIPLIER_PRESENT_BUT_VALUE_MULTIPLIER_ABSENT)، و ضریب مقدار طول عمر بالا باید اکیداً بزرگتر از ضریب مقدار باشد (GoalError.HIGH_LIFETIME_VALUE_MULTIPLIER_LESS_THAN_OR_EQUAL_TO_VALUE_MULTIPLIER).
خطاهای اعتبارسنجی پیکربندی هدف پویش
- تعارض با مقدار هدف خاص
- برای اهداف «جذب مشتری جدید»، اگر
target_optionرویTARGET_SPECIFICتنظیم شده باشد (برای هدفیابی فقط مشتریان جدید)، لغوهای مقدار سطح پویش نباید پیکربندی شود (CampaignGoalConfigError.CAMPAIGN_OVERRIDE_VALUES_SET_FOR_NEW_CUSTOMER_ACQUISITION_TARGET_SPECIFIC_OPTION). تعدیلهای قیمت پیشنهادی هنگام هدفیابی فقط مشتریان جدید قابلاعمال نیست. - لغو تنظیمات مقدار نامعتبر
- هنگام پیکربندی لغو تنظیمات مقدار چرخه حیات در سطح پویش، اگر مقدار طول عمر بالا وجود داشته باشد، مقدار استاندارد نیز باید وجود داشته باشد (
CampaignGoalConfigError.HIGH_LIFETIME_VALUE_PRESENT_BUT_VALUE_ABSENT)، و مقدار طول عمر بالا باید بیشتر از مقدار باشد، درصورت تنظیم (CampaignGoalConfigError.HIGH_LIFETIME_VALUE_LESS_THAN_OR_EQUAL_TO_VALUE). بهطور مشابه، برای تنظیمات مقدار ضربی، اگر ضریب مقدار طول عمر بالا وجود داشته باشد، ضریب مقدار نیز باید وجود داشته باشد (CampaignGoalConfigError.HIGH_LIFETIME_VALUE_MULTIPLIER_PRESENT_BUT_VALUE_MULTIPLIER_ABSENT)، و ضریب مقدار طول عمر بالا باید بهطور دقیق بیشتر از ضریب مقدار باشد (CampaignGoalConfigError.HIGH_LIFETIME_VALUE_MULTIPLIER_LESS_THAN_OR_EQUAL_TO_VALUE_MULTIPLIER). - پشتیبانی از نوع پویش ارزش طول عمر بالا
- ملغیهای مقدار طول عمر بالا و ملغیهای ضریب مقدار طول عمر بالا
فقط باید برای انواع پویش پشتیبانیشده تنظیم شوند
(
CampaignGoalConfigError.CAMPAIGN_OVERRIDE_HIGH_LIFETIME_VALUE_NOT_SUPPORTED_FOR_CAMPAIGN_TYPEیاCampaignGoalConfigError.CAMPAIGN_OVERRIDE_HIGH_LIFETIME_VALUE_MULTIPLIER_NOT_SUPPORTED_FOR_CAMPAIGN_TYPE). - هدفهای ناسازگار
- اگر پویشی تلاش کند اهداف ناسازگار «بهینهسازی چرخه حیات مشتری» را بهطور همزمان اعمال کند، خطایی ایجاد میشود (
CampaignGoalConfigError.CANNOT_USE_INCOMPATIBLE_CLO_GOALS). جدول زیر ترکیبهای هدف ناسازگار را که باعث ایجاد این خطا میشوند نشان میدهد:
| نوع / حالت هدف چرخه حیات مشتری | هدف / حالت ناسازگار |
|---|---|
«نگهداری مشتری» («پیشنهاد قیمت فقط برای مشتریان خاموش» /
TARGET_SPECIFIC)
|
جذب مشتری جدید («فقط برای مشتریان جدید قیمت پیشنهادی بدهید» /
TARGET_SPECIFIC، «برای مشتریان جدید قیمت پیشنهادی بالاتری بدهید» /
TARGET_ALL)، کاوش
|
حفظ مشتری («پیشنهاد دادن قیمت بالاتر برای مشتریان خاموش» /
TARGET_ALL)
|
«جذب مشتری جدید» («قیمت پیشنهادی فقط برای مشتریان جدید» /
TARGET_SPECIFIC)، «کاوش مشتری بالقوه»
|
| نگهداری وفاداری (ضریب مقدار) |
«اکتساب مشتری جدید» («قیمت پیشنهادی فقط برای مشتریان جدید» /
TARGET_SPECIFIC)، «حفظ مشتری» («قیمت پیشنهادی فقط برای مشتریان
خاموش» / TARGET_SPECIFIC)، «کاوش مشتری بالقوه»، «سود ناخالص»
|
| حفظ وفاداری (مزایا در PLA) |
جذب مشتری جدید («فقط برای مشتریان جدید قیمت پیشنهادی ارائه شود» /
TARGET_SPECIFIC)، مشترییابی، سود ناخالص
|
| مشترییابی |
جذب مشتری جدید («فقط برای مشتریان جدید قیمت پیشنهادی ارائه شود» /
TARGET_SPECIFIC، «برای مشتریان جدید قیمت پیشنهادی بالاتری ارائه شود» /
TARGET_ALL)
|
بازیابی اهداف چرخه حیات
مانند سایر منابع در Google Ads API، از روشهای search یا searchStream
GoogleAdsService برای بازیابی اهداف و پیکربندیهای چرخه حیات
استفاده کنید.
پرسمان زیر جزئیات هر Goal پیکربندیشده را در حساب 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
بههمین ترتیب، پُرسمان زیر جزئیات هر
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