أهداف مراحل النشاط

يمكنك استخدام 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:

في الإصدار 16 من Google Ads API والإصدارات الأقدم

اضبط الحقول التالية في حقول معلومات حسابك CustomerLifecycleGoal:

1. تشير السمة lifecycle_goal_customer_definition_settings.existing_user_lists إلى قوائم المستخدمين التي تحتوي على عملاء حاليين

2. تشير رسالة الأشكال البيانية lifecycle_goal_customer_definition_settings.high_lifetime_value_user_lists إلى قوائم المستخدمين التي تحتوي على عملاء ذوي قيمة دائمة عالية. إِنْتَ يمكنه قراءة هذا الحقل، ولكنه غير قابل للتغيير في إعلانات Google API.

سلوك الموارد المشتركة

إلى أن يتم إيقاف الإصدار 16 من Google Ads API نهائيًا في كانون الثاني (يناير) 2025، من المهم تذكُّر ما يلي: UserListCustomerType وحقول تصنيف الجمهور على CustomerLifecycleGoal مورد مشترك، مما يعني أن إنشاء ستؤدي UserListCustomerType نسخة من الإصدار 17 والإصدارات الأحدث إلى إجراء تعديلات. إلى مثيل CustomerLifecycleGoal في الإصدار 16 والإصدارات الأقدم، والطريقة الأخرى تقريبًا.

في ما يلي كيفية تعيين الحقول في الموردَين:

ضبط أهداف مراحل نشاط الحملة

على مستوى الحملة، يمكنك ضبط هدف لمراحل النشاط من خلال إنشاء أو تعديل 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