استخدِم مَراجِع 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هدفك، ولكن هذا الحقل غير قابل للتغيير في 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. سيؤدي محاولة منح مثيلات 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