این صفحه به‌وسیله ‏Cloud Translation API‏ ترجمه شده است.

اهداف چرخه حیات

از منابع CustomerLifecycleGoal و CampaignLifecycleGoal API Google Ads برای پیکربندی اهداف مربوط به چرخه عمر مشتری استفاده کنید. Google Ads API از اهداف جذب مشتری برای به دست آوردن مؤثر مشتریان جدید از طریق کمپین‌های جستجوی Google Ads و حداکثر عملکرد شما پشتیبانی می‌کند.

اگر حساب Google Ads شما از ردیابی تبدیل بین حساب‌ها استفاده می‌کند، باید اهداف چرخه عمر مشتری را به جای مستقیماً در حساب Google Ads خود در حساب تبدیل Google Ads پیکربندی کنید. با این حال، هنوز باید اهداف چرخه عمر کمپین را در حساب خود تنظیم کنید. این مشابه نحوه مدیریت اهداف دیگر هنگام استفاده از ردیابی تبدیل بین حساب‌ها است.

اهداف چرخه عمر مشتری را پیکربندی کنید

در سطح مشتری، با ایجاد یا به‌روزرسانی یک CustomerLifecycleGoal ، یک هدف چرخه عمر را پیکربندی کنید. در هر حساب Google Ads حداکثر می توان یک CustomerLifecycleGoal وجود داشته باشد. فیلد customer_acquisition_goal_value_settings.value تعدیل ارزش اضافی را برای افزودن به اولین تبدیل خرید مشتری جدید تعریف می کند. شما می توانید customer_acquisition_goal_value_settings.high_lifetime_value هدف را بخوانید، اما این فیلد در Google Ads API تغییر ناپذیر است.

مخاطبان خود را تقسیم بندی کنید

با شروع در Google Ads API v17، باید از منبع UserListCustomerType برای تقسیم بندی مخاطبان خود برای اهداف چرخه عمر مشتری استفاده کنید. پیکربندی مخاطبان مستقیماً در منبع CustomerLifecycleGoal منسوخ شده است. در اینجا جزئیات است:

قبل از نسخه 17:
- لیست های کاربر را به مجموعه existing_user_lists یک CustomerLifecycleGoal اضافه کنید.
شروع با نسخه 17:
- با ایجاد UserListCustomerType برای هر ترکیبی از لیست کاربر و دسته، هر فهرست کاربری را با یک یا چند دسته مرتبط کنید.

در Google Ads API نسخه 17 و بالاتر

از UserListCustomerTypeService برای ایجاد نمونه های UserListCustomerType استفاده کنید. اگر قبلاً فیلد CustomerLifecycleGoal.lifecycle_goal_customer_definition_settings.existing_user_lists را پر کرده بودید، حساب شما از قبل حاوی نمونه های UserListCustomerType مرتبط است.

UserListCustomerTypeService فقط از عملیات create و remove پشتیبانی می کند، بنابراین اگر می خواهید یک UserListCustomerType موجود را به روز کنید، باید آن را حذف کنید و سپس یک مورد جدید با به روز رسانی های لازم ایجاد کنید.

یک UserListCustomerType فقط می تواند به یک لیست کاربر اختصاص داده شود، اما یک لیست کاربر می تواند چندین نمونه UserListCustomerType مرتبط داشته باشد تا زمانی که بین نمونه های UserListCustomerType تداخلی وجود نداشته باشد. تلاش برای اختصاص نمونه‌های UserListCustomerType با ترکیب‌های زیر از customer_type_category به فهرست کاربری یکسان منجر به خطای UserListCustomerTypeError.CONFLICTING_CUSTOMER_TYPES می‌شود:

`customer_type_category` اول	`customer_type_category` دوم
خریداران	CONVERTED_LEADS
خریداران	QUALIFIED_LEADS
خریداران	CART_ABANDONERS
CONVERTED_LEADS	QUALIFIED_LEADS
DISENGAGED_CUSTOMERS	CONVERTED_LEADS
DISENGAGED_CUSTOMERS	QUALIFIED_LEADS
DISENGAGED_CUSTOMERS	CART_ABANDONERS

در Google Ads API v16

فیلدهای زیر را در CustomerLifecycleGoal حساب خود تنظیم کنید:

lifecycle_goal_customer_definition_settings.existing_user_lists نشان می دهد که کدام لیست کاربران شامل مشتریان موجود است.
فیلد lifecycle_goal_customer_definition_settings.high_lifetime_value_user_lists نشان می‌دهد که کدام لیست کاربران حاوی مشتریان با ارزش طول عمر بالا هستند. شما می توانید این فیلد را بخوانید، اما در Google Ads API تغییر ناپذیر است.

رفتار منابع مشترک

تا زمانی که Google Ads API v16 در ژانویه 2025 غروب نشود، مهم است که به خاطر داشته باشید که UserListCustomerType و قسمت‌های تقسیم‌بندی مخاطب در CustomerLifecycleGoal یک منبع مشترک هستند، به این معنی که ایجاد نمونه‌های UserListCustomerType جدید در نسخه 17 و نسخه‌های جدیدتر منجر به تغییراتی در v1oCustomerLife و چرخه CustomerLifecycleGoal می‌شود. زودتر و برعکس

در اینجا نحوه ترسیم فیلدهای دو منبع آمده است:

تغییر فیلد «CustomerLifecycleGoal» در نسخه 16	اثر جانبی در "UserListCustomerType" در نسخه 17
`lifecycle_goal_customer_definition_settings.existing_user_lists`	نمونه های `UserListCustomerType` ایجاد یا حذف می کند. فیلد `user_list` حاوی نام منبع لیست کاربر مرتبط است.

جهش «UserListCustomerType» در نسخه 17	اثر جانبی فیلد «CustomerLifecycleGoal» در نسخه 16
نمونه های `UserListCustomerType` ایجاد یا حذف کنید.	نام منابع فردی به `lifecycle_goal_customer_definition_settings.existing_user_lists` اضافه یا حذف خواهد شد.
ایجاد یا حذف موارد `UserListCustomerType` ، که در آن `customer_type_category` روی `HIGH_VALUE_CUSTOMERS` تنظیم شده است	نام منابع فردی به `lifecycle_goal_customer_definition_settings.high_lifetime_value_user_lists` اضافه یا حذف خواهد شد

اهداف چرخه عمر کمپین را پیکربندی کنید

در سطح کمپین، با ایجاد یا به‌روزرسانی یک CampaignLifecycleGoal یک هدف چرخه حیات را پیکربندی کنید. حداکثر یک CampaignLifecycleGoal در هر کمپین می تواند وجود داشته باشد.

قسمت customer_acquisition_goal_settings یک هدف در سطح کمپین به شما امکان می‌دهد حالت بهینه‌سازی کمپین را تنظیم کنید و همچنین تنظیمات ارزش را از هدف مشتری والد لغو کنید.

optimization_mode می تواند یکی از مقادیر زیر باشد:

TARGET_ALL_EQUALLY: این کمپین مشتریان جدید و فعلی را به طور یکسان هدف قرار می دهد. این حالت بهینه سازی پیش فرض است.
BID_HIGHER_FOR_NEW_CUSTOMERS: این کمپین هم مشتریان جدید و هم مشتریان فعلی را هدف قرار می‌دهد، اما برای مشتریانی که پیش‌بینی می‌شود جدید هستند و در یکی از لیست‌های existing_user_lists نیستند، قیمت‌های بالاتری ارائه می‌دهد.
TARGET_NEW_CUSTOMERS: این کمپین فقط مشتریان جدید را هدف قرار می دهد.

value_settings مانند customer_acquisition_goal_value_settings در هدف سطح مشتری است. از این تنظیمات در سطح کمپین برای لغو مقادیر یک کمپین خاص استفاده کنید.

اهداف چرخه زندگی را بازیابی کنید

مانند سایر منابع در Google Ads API، از روش های search یا searchStream GoogleAdsService برای بازیابی اهداف چرخه حیات استفاده کنید.

جستار زیر جزئیات هر CustomerLifecycleGoal را در حساب Google Ads بازیابی می کند:

SELECT
  customer_lifecycle_goal.lifecycle_goal_customer_definition_settings.existing_user_lists,
  customer_lifecycle_goal.lifecycle_goal_customer_definition_settings.high_lifetime_value_user_lists,
  customer_lifecycle_goal.customer_acquisition_goal_value_settings.value,
  customer_lifecycle_goal.customer_acquisition_goal_value_settings.high_lifetime_value
FROM customer_lifecycle_goal

به طور مشابه، پرس و جو زیر جزئیات هر CampaignLifecycleGoal را بازیابی می کند:

SELECT
  campaign_lifecycle_goal.campaign,
  campaign_lifecycle_goal.customer_acquisition_goal_settings.optimization_mode,
  campaign_lifecycle_goal.customer_acquisition_goal_settings.value_settings.value,
  campaign_lifecycle_goal.customer_acquisition_goal_settings.value_settings.high_lifetime_value
FROM campaign_lifecycle_goal