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

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

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

مدیریت عملیات ایجاد و به‌روزرسانی (فقط برای نسخه 15)

در Google Ads API نسخه 15، عملیات پشتیبانی شده در CustomerLifecycleGoalService و CampaignLifecycleGoalService کمی با سایر خدمات در Google Ads API متفاوت است. به جای داشتن عملیات create و update جداگانه، v15 CustomerLifecycleGoalOperation و CampaignLifecycleGoalOperation فقط یک عملیات create دارند و شما قصد خود را با استفاده از update_mask به صورت زیر نشان می‌دهید:

  • برای ایجاد یک هدف چرخه حیات با استفاده از v15، create با هدف پر کنید اما resource_name آن را تنظیم نکنید و update_mask عملیات را تنظیم نکنید.

  • برای به‌روزرسانی یک هدف چرخه حیات با استفاده از v15، create با هدف پر کنید، resource_name هدف را تنظیم کنید و update_mask برای فهرست کردن فیلدهایی که می‌خواهید به‌روزرسانی کنید، تنظیم کنید.

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

در سطح مشتری، با ایجاد یا به‌روزرسانی یک 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 نسخه 16 و قبل از آن

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

  1. lifecycle_goal_customer_definition_settings.existing_user_lists نشان می دهد که کدام لیست کاربران شامل مشتریان موجود است.

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

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

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

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

تغییر فیلد «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
قبلی
اهداف کمپین