استخدِم مَراجِع CustomerLifecycleGoal و
CampaignLifecycleGoal الخاصة بواجهة برمجة التطبيقات
Google Ads API لضبط الأهداف ذات الصلة برحلة العميل. اعتبارًا من الإصدار 15،
تدعم 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 مثيل باستخدام
المجموعات التالية من
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 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