از منابع 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، هدف چرخه حیات را پیکربندی کنید. برای هر نوع هدف (NEW_CUSTOMER_ACQUISITION، CUSTOMER_RETENTION، یا LOYALTY_RETENTION) در حساب Google Ads، حداکثر یک Goal میتواند وجود داشته باشد.
تنظیمات هدف «جذب مشتری جدید»
برای راهاندازی «کسب مشتری جدید» (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(double): Incremental conversion value for new customers who are identified as 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 استفاده کنید.
تنظیمات جذب مشتری جدید پویش
برای لغو تنظیمات یا پیکربندی هدفیابی برای «کسب مشتری جدید» در سطح پویش،
فیلد 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(برای NCA)،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