يمكنك استخدام CustomerLifecycleGoal
CampaignLifecycleGoal
من الموارد
Google Ads API لضبط الأهداف ذات الصلة بدورة حياة العملاء اعتبارًا من الإصدار 15،
تدعم Google Ads API اكتساب العملاء
أهدافك لتحقيق
اكتساب عملاء جدد من خلال "الحملات على شبكة البحث" و"حملات الأداء الأفضل" في "إعلانات Google"
الحملات.
إذا كان حسابك على "إعلانات Google" يستخدم ميزة تتبُّع الإحالات الناجحة في جميع الحسابات، يجب ضبط أهداف مراحل نشاط العملاء ضمن الإحالة الناجحة في "إعلانات Google" العميل بدلاً من حسابك في "إعلانات Google" مباشرةً لا يزال يتعين عليك تعيين أهداف مراحل نشاط الحملة في حسابك. هذا مشابه لكيفية إدارة الأهداف الأخرى عند استخدام تتبُّع الإحالات الناجحة في جميع الحسابات
التعامل مع عمليات الإنشاء والتحديث (للإصدار 15 فقط)
في الإصدار 15 من إعلانات Google 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 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