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