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