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

استخدِم الموردَين 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 (double): القيمة التصاعدية للإحالة الناجحة التي يجب إضافتها إلى الإحالة الناجحة المتمثّلة بعملية الشراء الأولى التي يجريها العميل الجديد
    • ‫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): تشير إلى ما إذا كان سيتم عرض مزايا الاشتراك المستهدَفة في برنامج الولاء بتنسيق "إعلانات بيانات المنتجات" (PLA) في البلدان المؤهَّلة.

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