लाइफ़साइकल लक्ष्य

कस्टमर लाइफ़साइकल से जुड़े लक्ष्यों को कॉन्फ़िगर करने के लिए, Google Ads API के CustomerLifecycleGoal और CampaignLifecycleGoal संसाधनों का इस्तेमाल करें. वर्शन 15 के बाद से, Google Ads API ग्राहक हासिल करने के लक्ष्यों के साथ काम करता है. इससे Google Ads के सर्च और परफ़ॉर्मेंस मैक्स कैंपेन की मदद से नए ग्राहक हासिल करने में मदद मिलती है.

अगर आपके Google Ads खाते में, कई खातों में होने वाले कन्वर्ज़न को ट्रैक करने की सुविधा का इस्तेमाल किया जा रहा है, तो आपको कस्टमर लाइफ़साइकल लक्ष्यों को सीधे अपने Google Ads खाते के बजाय, Google Ads कन्वर्ज़न ग्राहक खाते में कॉन्फ़िगर करना होगा. हालांकि, आपको अब भी अपने खाते में कैंपेन लाइफ़साइकल के लक्ष्य सेट करने चाहिए. यह ठीक वैसे ही है जैसे कई खातों में होने वाले कन्वर्ज़न को ट्रैक करने की सुविधा का इस्तेमाल करते समय, अन्य लक्ष्यों को मैनेज किया जाता है.

सिर्फ़ v15 के लिए, फ़ाइल बनाने और अपडेट करने से जुड़ी कार्रवाइयां मैनेज करना

Google Ads API v15 में, 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 संसाधन पर सीधे ऑडियंस कॉन्फ़िगर करने की सुविधा बंद कर दी गई है. यहां विवरण दिए गए हैं:

  • v17 से पहले के वर्शन:
    • किसी CustomerLifecycleGoal के existing_user_lists कलेक्शन में उपयोगकर्ता सूचियां जोड़ें.
  • v17 से शुरू करना:
    • हर उपयोगकर्ता सूची को एक या उससे ज़्यादा कैटगरी से जोड़ें. इसके लिए, उपयोगकर्ता सूची और कैटगरी के हर कॉम्बिनेशन के लिए UserListCustomerType बनाएं.

Google Ads API v17 और इसके बाद के वर्शन में

UserListCustomerType इंस्टेंस बनाने के लिए, UserListCustomerTypeService का इस्तेमाल करें. अगर आपने पहले ही CustomerLifecycleGoal.lifecycle_goal_customer_definition_settings.existing_user_lists फ़ील्ड को भर दिया है, तो आपके खाते में पहले से ही मिलते-जुलते UserListCustomerType इंस्टेंस मौजूद होंगे.

UserListCustomerTypeService पर सिर्फ़ create और remove कार्रवाइयां काम करती हैं. इसलिए, अगर आपको किसी मौजूदा UserListCustomerType को अपडेट करना है, तो आपको उसे हटाना होगा. इसके बाद, ज़रूरी अपडेट के साथ नया फ़ोन बनाना होगा.

किसी UserListCustomerType को सिर्फ़ एक उपयोगकर्ता सूची को असाइन किया जा सकता है. हालांकि, किसी उपयोगकर्ता सूची में उससे जुड़े कई UserListCustomerType इंस्टेंस हो सकते हैं.जब तक कि UserListCustomerType इंस्टेंस के बीच कोई कॉन्फ़्लिक्ट न हो. एक ही उपयोगकर्ता सूची को, नीचे दिए गए customer_type_category कॉम्बिनेशन वाले UserListCustomerType इंस्टेंस असाइन करने की कोशिश करने पर, 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 पर ये फ़ील्ड सेट करें:

  1. lifecycle_goal_customer_definition_settings.existing_user_lists से पता चलता है कि किन उपयोगकर्ता सूचियों में मौजूदा ग्राहक शामिल हैं.

  2. lifecycle_goal_customer_definition_settings.high_lifetime_value_user_lists फ़ील्ड से पता चलता है कि किन उपयोगकर्ता सूचियों में, ज़्यादा लाइफ़टाइम वैल्यू वाले ग्राहक शामिल हैं. आपके पास इस फ़ील्ड को पढ़ने का विकल्प है. हालांकि, Google Ads API में इसे बदला नहीं जा सकता.

संसाधन का व्यवहार शेयर किया गया

जनवरी 2025 में Google Ads API v16 के बंद होने तक, यह ध्यान रखना ज़रूरी है कि CustomerLifecycleGoal पर मौजूद UserListCustomerType और ऑडियंस सेगमेंटेशन फ़ील्ड, शेयर किए गए संसाधन हैं. इसका मतलब है कि v17 और उसके बाद के वर्शन में नए UserListCustomerType इंस्टेंस बनाने पर, v16 और उससे पहले के वर्शन में आपके CustomerLifecycleGoal इंस्टेंस में बदलाव किए जा सकते हैं.

यहां बताया गया है कि दोनों संसाधनों के फ़ील्ड कैसे मैप किए जाते हैं:

v16 में `Customerलाइफ़cycleGoal` फ़ील्ड को बदला जा रहा है v17 में `UserListCustomerType` पर पड़ने वाला खराब असर
lifecycle_goal_customer_definition_settings.existing_user_lists यह UserListCustomerType इंस्टेंस बनाता या हटाता है. user_list फ़ील्ड में, उपयोगकर्ता सूची के संसाधन का नाम होता है.
v17 में `UserListCustomerType` को म्यूट किया जा रहा है v16 में `CustomerlifecycleGoal` फ़ील्ड पर पड़ने वाला खराब असर
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 के अन्य संसाधनों की तरह, लाइफ़साइकल के लक्ष्यों को फिर से पाने के लिए, GoogleAdsService के search या searchStream तरीकों का इस्तेमाल करें.

नीचे दी गई क्वेरी, Google Ads खाते में हर CustomerLifecycleGoal की जानकारी हासिल करती है:

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