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

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

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

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

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

تقسيم جمهورك إلى شرائح

يجب استخدام مصدر UserListCustomerType لتقسيم شرائح جمهورك من أجل تحقيق أهداف مراحل نشاط العملاء. ويجب ربط كل قائمة مستخدمين بفئة واحدة أو أكثر من خلال إنشاء UserListCustomerType لكل مجموعة من قائمة المستخدمين والفئة.

استخدِم UserListCustomerTypeService لإنشاء مثيلات UserListCustomerType. إذا سبق لك ملء حقل CustomerLifecycleGoal.lifecycle_goal_customer_definition_settings.existing_user_lists، سيتضمّن حسابك تلقائيًا مثيلات UserListCustomerType ذات الصلة.

لا يتيح UserListCustomerTypeService سوى عمليات create وremove، لذا إذا أردت تعديل UserListCustomerType حالي، عليك إزالته ثم إنشاء 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

ضبط أهداف مراحل النشاط في الحملة

على مستوى الحملة، اضبط هدفًا لمراحل النشاط من خلال إنشاء 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 في الهدف على مستوى العميل. استخدِم هذه الإعدادات على مستوى الحملة لتجاوز القيم لحملة معيّنة.

أهداف الاحتفاظ بالعملاء

ملاحظة: لا تنطبق أهداف الاحتفاظ بالعملاء إلا على حملات الأداء الأفضل.

تم تصميم أهداف الاحتفاظ بالعملاء لزيادة ولاء العملاء وتحقيق قيمة دائمة عالية في نشاطك التجاري. توفّر هذه الاستراتيجية أوضاعًا متعددة ضمن حملات الأداء الأفضل، ما يسمح لك باستهداف شرائح محدّدة من العملاء الحاليين.

قبل إنشاء هدف "الاحتفاظ بالعملاء"، يجب استيفاء المتطلبات الأساسية الموضّحة في مقالة لمحة عن هدف "الاحتفاظ بالعملاء". ويشمل ذلك توفُّر "حملة أداء أفضل" وقائمة مستخدمين في "مطابقة العملاء".

لإنشاء هدف الاحتفاظ بالمستخدمين، يجب أولاً تهيئة GoalService وإصدار طلب باستخدام طريقة mutate_goals لإنشاء هدف جديد.

def create_goal(client: GoogleAdsClient, customer_id: str) -> None:
    """Sends an API request to add a new 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.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]
    )

سيؤدي ذلك إلى إنشاء هدف جديد للاحتفاظ بالمستخدمين على مستوى الحساب لحساب العميل المحدّد، وسيتم تطبيقه على جميع حملاته. سيستهدف هذا الهدف تلقائيًا جميع المستخدمين في قوائم المستخدمين في ميزة "مطابقة العملاء".

يمكن إلغاء هذا الهدف باستخدام إعدادات على مستوى الحملة، وذلك باستخدام CampaignGoalConfig. بعد إنشاء هدف على مستوى الحساب، استخدِم resource_name لإنشاء CampaignGoalConfig باستخدام الطريقة mutate_campaign_goal_configs في CampaignGoalConfigService.

def create_campaign_goal_config(
  client: GoogleAdsClient,
  customer_id: str,
  goal_resource_name: str,
  campaign_resource_name: str
) -> None:
    """Sends an API request to add a new CampaignGoalConfig.

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

    # Note that the target_option will be set to TARGET_ALL by default. In order
    # to set it to TARGET_SPECIFIC your account must be allowlisted.
    #
    # 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 إلا للمستخدمين المُدرَجين في القائمة المسموح بها.

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

كما هو الحال مع الموارد الأخرى في Google Ads API، استخدِم الطريقتَين search أو searchStream في GoogleAdsService لاسترداد أهداف مراحل النشاط.

يسترد طلب البحث التالي تفاصيل كل CustomerLifecycleGoal في حساب على "إعلانات Google":

SELECT
  customer_lifecycle_goal.owner_customer,
  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