استخدِم الموارد CustomerLifecycleGoal
وCampaignLifecycleGoal
في Google Ads API من أجل ضبط الأهداف ذات الصلة بدورة حياة العميل. اعتبارًا من الإصدار 15، ستوفّر Google Ads API إمكانية أهداف اكتساب العملاء لاكتساب عملاء جدد بكفاءة من خلال "الحملات على شبكة البحث" و"حملات الأداء الأفضل" في "إعلانات Google".
إذا كان حسابك على "إعلانات Google" يستخدِم ميزة تتبُّع الإحالات الناجحة في جميع الحسابات، عليك ضبط أهداف مراحل نشاط العملاء في حساب عميل الإحالات الناجحة على "إعلانات Google" بدلاً من حسابك على "إعلانات Google" مباشرةً. ومع ذلك، لا يزال يتعين عليك تحديد أهداف مراحل نشاط الحملة في حسابك. ويُعدّ هذا مشابهًا لطريقة إدارة الأهداف الأخرى عند استخدام تتبُّع الإحالات الناجحة في جميع الحسابات.
التعامل مع عمليات الإنشاء والتحديث (للإصدار 15 فقط)
في الإصدار 15 من Google Ads API، تختلف العمليات المتاحة في
CustomerLifecycleGoalService
وCampaignLifecycleGoalService
قليلاً عن الخدمات الأخرى في Google Ads API. بدلاً من إنشاء عمليتَي create
وupdate
منفصلتَين، يتضمّن الإصداران 15
CustomerLifecycleGoalOperation
وCampaignLifecycleGoalOperation
عملية create
فقط، ويمكنك توضيح هدفك باستخدام
update_mask
على النحو التالي:
لإنشاء هدف لدورة الحياة باستخدام الإصدار 15، عليك تعبئة
create
بالهدف، ولكن بدون ضبطresource_name
، وعدم تحديدupdate_mask
للعملية.لتعديل هدف لدورة الحياة باستخدام الإصدار 15، عليك تعبئة
create
بالهدف، وضبطresource_name
للهدف، ثم ضبطupdate_mask
لإدراج الحقول التي تريد تعديلها.
ضبط أهداف مراحل نشاط العملاء
على مستوى العميل، يمكنك ضبط هدف لمراحل النشاط من خلال إنشاء CustomerLifecycleGoal
أو تعديلها. ويمكن توفير CustomerLifecycleGoal
واحدة على الأكثر لكل حساب على "إعلانات Google". ويحدِّد حقل
customer_acquisition_goal_value_settings.value
تعديل القيمة الإضافي الذي يجب إضافته إلى الإحالة الناجحة المتمثّلة بعملية الشراء الأولى التي يجريها العميل الجديد. يمكنك قراءة customer_acquisition_goal_value_settings.high_lifetime_value
للهدف، ولكن هذا الحقل غير قابل للتغيير في Google Ads API.
تقسيم الجماهير
بدءًا من الإصدار 17 من Google Ads API، عليك استخدام المورد
UserListCustomerType
لتقسيم شرائح جمهورك حسب أهداف مراحل نشاط العملاء. وقد تم إيقاف إعداد شرائح الجمهور مباشرةً في
المورد CustomerLifecycleGoal
. التفاصيل في ما يلي:
- قبل الإصدار 17:
- يمكنك إضافة قوائم المستخدمين إلى مجموعة
existing_user_lists
منCustomerLifecycleGoal
.
- يمكنك إضافة قوائم المستخدمين إلى مجموعة
- بدءًا من الإصدار 17:
- اربط كل قائمة مستخدمين بفئة واحدة أو أكثر من خلال إنشاء
UserListCustomerType
لكل مجموعة من قائمة المستخدمين والفئة.
- اربط كل قائمة مستخدمين بفئة واحدة أو أكثر من خلال إنشاء
في الإصدار 17 والإصدارات الأحدث من Google Ads API
استخدِم 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 |
في الإصدار 16 من Google Ads API والإصدارات الأقدم
اضبط الحقول التالية على CustomerLifecycleGoal
في حسابك:
تشير السمة
lifecycle_goal_customer_definition_settings.existing_user_lists
إلى قوائم المستخدمين التي تحتوي على عملاء حاليين.يشير الحقل
lifecycle_goal_customer_definition_settings.high_lifetime_value_user_lists
إلى قوائم المستخدمين التي تحتوي على عملاء ذوي قيمة دائمة عالية لنشاطك التجاري. يمكنك قراءة هذا الحقل، ولكنه غير قابل للتغيير في Google Ads API.
سلوك الموارد المشتركة
إلى أن يتم إيقاف الإصدار 16 من Google Ads API نهائيًا في كانون الثاني (يناير) 2025، من المهم تذكُّر أنّ
UserListCustomerType
وحقول تصنيف الجمهور في
CustomerLifecycleGoal
هما مصدران مشترَكان، ما يعني أنّ إنشاء مثيلات
UserListCustomerType
جديدة في الإصدار 17 والإصدارات الأحدث سيؤدي إلى إجراء تعديلات
على مثيل CustomerLifecycleGoal
في الإصدار 16 والإصدارات الأقدم، والعكس صحيح.
في ما يلي كيفية تعيين الحقول في الموردَين:
تغيير حقل "CustomerLifecycleGoal" في الإصدار 16 | تأثير جانبي على "UserListCustomerType" في الإصدار 17 |
---|---|
lifecycle_goal_customer_definition_settings.existing_user_lists
|
إنشاء UserListCustomerType نسخة أو إزالتها يحتوي الحقل user_list على اسم مورد قائمة المستخدمين المرتبط.
|
تغيير "UserListCustomerType" في الإصدار 17 | التأثير الجانبي على حقل "CustomerLifecycleGoal" في الإصدار 16 |
---|---|
إنشاء UserListCustomerType نسخة أو إزالتها
|
ستتم إضافة أسماء الموارد الفردية إلى lifecycle_goal_customer_definition_settings.existing_user_lists أو إزالتها منه.
|
إنشاء أو إزالة مثيلات UserListCustomerType ، حيث يتم ضبط
customer_type_category على
HIGH_VALUE_CUSTOMERS
|
ستتم إضافة أسماء الموارد الفردية إلى lifecycle_goal_customer_definition_settings.high_lifetime_value_user_lists أو إزالتها منه.
|
ضبط أهداف مراحل نشاط الحملة
على مستوى الحملة، يمكنك ضبط هدف لمراحل النشاط من خلال إنشاء 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
في الهدف على مستوى العميل. استخدِم هذه الإعدادات
على مستوى الحملة لإلغاء قيم حملة معيّنة.
استرداد أهداف مراحل النشاط
كما هو الحال مع الموارد الأخرى في Google Ads API، استخدِم طريقة search
أو searchStream
في GoogleAdsService
لاسترداد أهداف مراحل النشاط.
يعرض طلب البحث التالي تفاصيل كل CustomerLifecycleGoal
في حساب "إعلانات Google":
SELECT
customer_lifecycle_goal.lifecycle_goal_customer_definition_settings.existing_user_lists,
customer_lifecycle_goal.lifecycle_goal_customer_definition_settings.high_lifetime_value_user_lists,
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