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

استخدِم مَوردَي 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 التي تتضمّن المجموعات التالية من 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

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

على مستوى الحملة، يمكنك ضبط إعدادات هدف اكتساب العملاء عن طريق إنشاء 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 on the appropriate
    # allowlist.
    #
    # 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