انضموا إلينا في بث مباشر على Discord في خادم "منتدى Google للإعلان والقياس" وعلى YouTube في 20 أغسطس الساعة 10:00 صباحًا بتوقيت شرق الولايات المتحدة. سنتحدّث عن الميزات الجديدة التي تمّت إضافتها في الإصدار 25.1 من Google Ads API.

تستخدم Google تكنولوجيا الذكاء الاصطناعي لترجمة المحتوى إلى لغتك المفضّلة، وقد تتضمّن بعض الأخطاء.

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

استخدِم الموارد 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.

تستخدِم الإعدادات 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_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:

أوّل `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
LOYALTY_TIER_X_MEMBERS	LOYALTY_TIER_Y_MEMBERS

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

على مستوى الحملة، يمكنك ضبط عمليات إلغاء أو خيارات استهداف خاصة بالحملة باستخدام 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.
    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]
    )

إعدادات الاحتفاظ بالعملاء في الحملة

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

نوع هدف مراحل نشاط العملاء / الوضع	الهدف أو الوضع غير متوافق
الاحتفاظ بالعملاء ("تقديم عروض أسعار للعملاء غير النشطين فقط" / `TARGET_SPECIFIC`)	اكتساب عملاء جدد ("تقديم عروض أسعار للعملاء الجدد فقط" / `TARGET_SPECIFIC`، "تحديد عروض أسعار أعلى للعملاء الجدد" / `TARGET_ALL`)، البحث عن عملاء محتملين
الاحتفاظ بالعملاء ("تقديم عروض أسعار أعلى للعملاء غير النشطين" / `TARGET_ALL`)	اكتساب عملاء جدد ("ضبط عروض أسعار للعملاء الجدد فقط" / `TARGET_SPECIFIC`)، البحث عن عملاء محتملين
الاحتفاظ بالمشتركين في برنامج الولاء (مُضاعِف القيمة)	اكتساب عملاء جدد ("تقديم عروض أسعار للعملاء الجدد فقط" / `TARGET_SPECIFIC`)، والاحتفاظ بالعملاء ("تقديم عروض أسعار للعملاء غير النشطين فقط" / `TARGET_SPECIFIC`)، واستقطاب العملاء المحتملين، والأرباح الإجمالية
الاحتفاظ بالمشتركين في برنامج الولاء (المزايا في إعلانات قائمة المنتجات)	اكتساب عملاء جدد ("ضبط عروض أسعار للعملاء الجدد فقط" / `TARGET_SPECIFIC`)، البحث عن عملاء محتملين، الربح الإجمالي
البحث عن العملاء المحتملين	اكتساب عملاء جدد ("ضبط عروض أسعار للعملاء الجدد فقط" / `TARGET_SPECIFIC`، "تحديد عروض أسعار أعلى للعملاء الجدد" / `TARGET_ALL`)

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

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

أهداف الحملة

أهداف مراحل النشاط تنظيم صفحاتك في مجموعات يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.