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

कस्टमर लाइफ़साइकल से जुड़े लक्ष्यों को कॉन्फ़िगर करने के लिए, Google Ads API के Goal और CampaignGoalConfig संसाधनों का इस्तेमाल करें. Google Ads API, ग्राहक हासिल करने के लक्ष्यों और ग्राहकों को जोड़े रखने के लक्ष्यों के साथ काम करता है. इससे, Google Ads कैंपेन के ज़रिए कस्टमर लाइफ़साइकल वैल्यू में हुए बदलावों को मैनेज किया जा सकता है.

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

कस्टमर लाइफ़साइकल के लक्ष्यों के टाइप

कस्टमर लाइफ़साइकल के लक्ष्यों को खाता लेवल पर कॉन्फ़िगर किया जाता है. इसके लिए, Goal रिसॉर्स का इस्तेमाल किया जाता है. लक्ष्य, लाइफ़साइकल के किसी खास मकसद को दिखाता है. इसे इसके goal_type से तय किया जाता है.

लाइफ़साइकल के लक्ष्यों के लिए, इन टाइप का इस्तेमाल किया जा सकता है:

NEW_CUSTOMER_ACQUISITION

नए ग्राहकों के कन्वर्ज़न के लिए वैल्यू अडजस्टमेंट असाइन करके, उन्हें आसानी से हासिल करने के लिए.

CUSTOMER_RETENTION

मौजूदा, ज़्यादा अहम, और ऐसे ग्राहकों की दिलचस्पी फिर से बढ़ाने के लिए जो अब सक्रिय नहीं हैं.

LOYALTY_RETENTION

खास तौर पर, लॉयल्टी प्रोग्राम के सदस्यों को जोड़े रखने और उनकी दिलचस्पी बढ़ाने के लिए.

कस्टमर लाइफ़साइकल के लक्ष्यों को कॉन्फ़िगर करना

कस्टमर लेवल पर, Goal बनाकर लाइफ़साइकल का लक्ष्य कॉन्फ़िगर करें. Google Ads खाते में, हर लक्ष्य टाइप (NEW_CUSTOMER_ACQUISITION, CUSTOMER_RETENTION या LOYALTY_RETENTION) के लिए ज़्यादा से ज़्यादा एक Goal हो सकता है.

नए ग्राहक हासिल करने के लक्ष्य की सेटिंग

नए ग्राहक हासिल करने (एनसीए) का लक्ष्य सेट अप करने के लिए, goal_type को NEW_CUSTOMER_ACQUISITION पर सेट करें. इसके बाद, GoalService का इस्तेमाल करके, new_customer_acquisition_goal_settings फ़ील्ड में सेटिंग कॉन्फ़िगर करें.

इन सेटिंग में CustomerLifecycleOptimizationValueSettings का इस्तेमाल किया जाता है. इससे, हासिल किए गए ग्राहकों के लिए कन्वर्ज़न वैल्यू अडजस्टमेंट तय किए जाते हैं:

• value_adjustment (oneof):
  • additional_value (डबल): नए ग्राहक के पहले परचेज़ कन्वर्ज़न में जोड़ने के लिए, इंक्रिमेंटल कन्वर्ज़न वैल्यू.
  • value_multiplier (दो गुना): यह मल्टीप्लायर, नए ग्राहक की पहली खरीदारी के लिए कन्वर्ज़न वैल्यू पर लागू होता है. हालांकि, यह सुविधा अभी उपलब्ध नहीं है.
• 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.
    goal.new_customer_acquisition_goal_settings.value_settings.additional_value = 50.0
    goal.new_customer_acquisition_goal_settings.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
    goal.retention_goal_settings.value_settings.additional_value = 50.0
    goal.retention_goal_settings.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) में सेटिंग कॉन्फ़िगर करें.

लॉयल्टी प्रोग्राम के सदस्यों को जोड़े रखने के लक्ष्यों के लिए, value_settings में सिर्फ़ value_multiplier सेटिंग काम करती है. इसके लिए, 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 बनाना होगा.

UserListCustomerType इंस्टेंस बनाने के लिए, UserListCustomerTypeService का इस्तेमाल करें.

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

किसी UserListCustomerType को सिर्फ़ एक उपयोगकर्ता सूची को असाइन किया जा सकता है. हालांकि, किसी उपयोगकर्ता सूची से कई UserListCustomerType इंस्टेंस जोड़े जा सकते हैं. ऐसा तब तक किया जा सकता है, जब तक UserListCustomerType इंस्टेंस के बीच कोई टकराव न हो. customer_type_category के इन कॉम्बिनेशन के साथ एक ही उपयोगकर्ता सूची में UserListCustomerType इंस्टेंस असाइन करने की कोशिश करने पर, UserListCustomerTypeError.CONFLICTING_CUSTOMER_TYPES गड़बड़ी होगी:

कैंपेन के लाइफ़साइकल के लक्ष्यों के कॉन्फ़िगरेशन को कॉन्फ़िगर करना

कैंपेन लेवल पर, CampaignGoalConfig का इस्तेमाल करके, कैंपेन के हिसाब से तय किए गए ओवरराइड या टारगेटिंग के विकल्प कॉन्फ़िगर किए जा सकते हैं. खाता-लेवल का लक्ष्य सेट करने के बाद, CampaignGoalConfigService पर mutate_campaign_goal_configs तरीके का इस्तेमाल करके, CampaignGoalConfig बनाने के लिए resource_name का इस्तेमाल करें.

कैंपेन के लिए, नया ग्राहक हासिल करने की सेटिंग

कैंपेन लेवल पर एनसीए के लिए सेटिंग बदलने या टारगेटिंग कॉन्फ़िगर करने के लिए, CampaignNewCustomerAcquisitionGoalSettings टाइप के campaign_new_customer_acquisition_settings फ़ील्ड को कॉन्फ़िगर करें:

• 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.
    goal_config.campaign_new_customer_acquisition_settings.target_option = (
        client.enums.CustomerLifecycleOptimizationModeEnum.TARGET_ALL
    )
    # Optionally override value settings.
    goal_config.campaign_new_customer_acquisition_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]
    )

कैंपेन में ग्राहकों को जोड़े रखने की सेटिंग

कैंपेन लेवल पर, उपयोगकर्ता बनाए रखने के लक्ष्यों के लिए सेटिंग बदलने या टारगेटिंग कॉन्फ़िगर करने के लिए, CampaignRetentionGoalSettings टाइप के campaign_retention_settings फ़ील्ड को कॉन्फ़िगर करें:

• 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_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 लक्ष्यों के लिए, कैंपेन लेवल पर सेटिंग बदलने या लॉयल्टी प्रोग्राम के सदस्यों के लिए खास व्यवहार कॉन्फ़िगर करने के लिए, CampaignGoalConfig पर CampaignLoyaltyRetentionGoalSettings टाइप का campaign_loyalty_retention_settings फ़ील्ड कॉन्फ़िगर करें:

• value_settings_override (टाइप: CustomerLifecycleOptimizationValueSettings): खाता-लेवल पर लॉयल्टी प्रोग्राम में ग्राहकों को जोड़े रखने से जुड़ी वैल्यू की सेटिंग को बदलने के लिए, कस्टम वैल्यू अडजस्टमेंट.
• enable_bid_adjustments_for_loyalty_members (टाइप: bool): इस कैंपेन में लॉयल्टी प्रोग्राम के सदस्यों के लिए बिड घटाने या बढ़ाने की सुविधा चालू करनी है या नहीं.
• show_targeted_loyalty_member_benefits_in_pla (टाइप: bool): यह तय करता है कि ज़रूरी शर्तें पूरी करने वाले देशों में, टारगेट किए गए लॉयल्टी प्रोग्राम के सदस्यों को प्रॉडक्ट लिस्टिंग विज्ञापन (पीएलए) के फ़ॉर्मैट में फ़ायदे दिखाए जाएं या नहीं.

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 Retention.

    Args:
        client: an initialized GoogleAdsClient instance.
        customer_id: a client customer ID.
        goal_resource_name: the resource name of an existing Loyalty 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

    # Enable bid adjustments and targeted loyalty benefits in PLAs.
    goal_config.campaign_loyalty_retention_settings.enable_bid_adjustments_for_loyalty_members = True
    goal_config.campaign_loyalty_retention_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).

कैंपेन के लक्ष्य के कॉन्फ़िगरेशन की पुष्टि करते समय मिली गड़बड़ियां

टारगेट वैल्यू बदलने से जुड़ा टकराव

नए ग्राहक हासिल करने के लक्ष्यों के लिए, अगर target_option को TARGET_SPECIFIC पर सेट किया गया है (सिर्फ़ नए ग्राहकों को टारगेट करने के लिए), तो कैंपेन-लेवल पर वैल्यू ओवरराइड कॉन्फ़िगर नहीं किए जाने चाहिए (CampaignGoalConfigError.CAMPAIGN_OVERRIDE_VALUES_SET_FOR_NEW_CUSTOMER_ACQUISITION_TARGET_SPECIFIC_OPTION). सिर्फ़ नए ग्राहकों को टारगेट करते समय, बिडिंग में किए जाने वाले बदलाव लागू नहीं होते हैं.

लाइफ़टाइम वैल्यू वाले कैंपेन टाइप के लिए सहायता

लाइफ़टाइम वैल्यू के ज़्यादा होने पर मिलने वाले ओवरराइड, सिर्फ़ उन कैंपेन टाइप के लिए सेट किए जाने चाहिए जिनके साथ यह सुविधा काम करती है (CampaignGoalConfigError.CAMPAIGN_OVERRIDE_HIGH_LIFETIME_VALUE_NOT_SUPPORTED_FOR_CAMPAIGN_TYPE).

काम न करने वाले लक्ष्य

अगर कोई कैंपेन, कस्टमर लाइफ़साइकल ऑप्टिमाइज़ेशन के ऐसे लक्ष्यों को एक साथ लागू करने की कोशिश करता है जो एक-दूसरे के साथ काम नहीं करते, तो गड़बड़ी का मैसेज दिखता है (CampaignGoalConfigError.CANNOT_USE_INCOMPATIBLE_CLO_GOALS). नीचे दी गई टेबल में, लक्ष्यों के ऐसे कॉम्बिनेशन के बारे में बताया गया है जो एक-दूसरे के साथ काम नहीं करते. इन कॉम्बिनेशन की वजह से, गड़बड़ी का यह मैसेज दिखता है:

लाइफ़साइकल के लक्ष्य वापस पाना

Google Ads API में मौजूद अन्य संसाधनों की तरह, लाइफ़साइकल के लक्ष्यों और कॉन्फ़िगरेशन को वापस पाने के लिए, GoogleAdsService के search या searchStream तरीकों का इस्तेमाल करें.

नीचे दी गई क्वेरी, Google Ads API खाते में कॉन्फ़िगर किए गए हर Goal की जानकारी वापस लाती है:

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