أهداف مراحل النشاط

استخدِم المَرجِعَين Goal وCampaignGoalConfig في Google Ads API لضبط الأهداف المتعلّقة بمراحل نشاط العملاء. تتيح Google Ads API أهداف اكتساب العملاء وأهداف الاحتفاظ بالعملاء لإدارة تعديلات قيمة مراحل نشاط العملاء بكفاءة من خلال حملاتك على "إعلانات Google".

إذا كان حسابك على "إعلانات Google" يستخدم ميزة تتبُّع الإحالات الناجحة في جميع الحسابات، عليك إعداد أهداف مراحل النشاط على مستوى العميل في حساب الإحالات الناجحة في "إعلانات Google" بدلاً من إعدادها مباشرةً في حسابك على "إعلانات Google". ومع ذلك، يجب مواصلة ضبط الإعدادات على مستوى الحملة في حسابك. يشبه ذلك طريقة إدارة الأهداف الأخرى عند استخدام ميزة تتبُّع الإحالات الناجحة في جميع الحسابات.

أنواع أهداف مراحل نشاط العملاء

يتم ضبط أهداف مراحل نشاط العملاء على مستوى الحساب باستخدام المورد Goal. يمثّل الهدف غرضًا محدّدًا من مراحل النشاط، ويتم تحديده من خلال goal_type.

في ما يلي أنواع أهداف مراحل النشاط المتوافقة:

NEW_CUSTOMER_ACQUISITION

لاكتساب عملاء جدد بكفاءة من خلال تعيين تعديلات القيمة لإحالاتهم الناجحة

CUSTOMER_RETENTION

لإعادة جذب العملاء الحاليين والبارزين وغير النشطين

LOYALTY_RETENTION

لتعزيز الاحتفاظ بالمشتركين والتفاعل معهم، لا سيما المشتركين في برنامج الولاء

ضبط أهداف مراحل نشاط العملاء

على مستوى العميل، اضبط هدف مراحل النشاط من خلال إنشاء Goal. يمكن أن يكون هناك Goal واحد على الأكثر لكل نوع هدف (NEW_CUSTOMER_ACQUISITION أو CUSTOMER_RETENTION أو LOYALTY_RETENTION) في حساب على "إعلانات Google".

إعدادات هدف "اكتساب عملاء جدد"

لإعداد ميزة "اكتساب عملاء جدد"، اضبط 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 (الضعف): قيمة الإحالة الناجحة الإضافية للعملاء الجدد الذين تم تحديدهم كعملاء بارزين.
    • ‫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:

ضبط إعدادات أهداف مراحل نشاط الحملة

على مستوى الحملة، يمكنك ضبط عمليات إلغاء أو خيارات استهداف خاصة بالحملة باستخدام 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): ما إذا كان سيتم عرض مزايا برنامج الولاء المستهدَفة بتنسيق "إعلانات قائمة المنتجات" في البلدان المؤهَّلة.

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 (لاكتساب عملاء جدد) أو 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). يوضّح الجدول التالي مجموعات الأهداف الحصرية المتبادلة التي تؤدي إلى حدوث هذا الخطأ:

استرداد أهداف مراحل النشاط

كما هو الحال مع الموارد الأخرى في 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