هل يهمّك مشاركة ملاحظاتك حول Google Ads API؟ اشترِك للاستفادة من فرصة المشاركة في الأبحاث المتعلّقة بالمستخدمين.

تمت ترجمة هذه الصفحة بواسطة Cloud Translation API‏.

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

استخدِم مرجعَي 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.

تقسيم شرائح جمهورك

يجب استخدام مورد UserListCustomerType لتقسيم شرائح جمهورك لتحقيق أهداف مراحل نشاط العميل. يجب ربط كل قائمة مستخدمين بفئة واحدة أو أكثر من خلال إنشاء UserListCustomerType لكل تركيبة من قائمة المستخدمين والفئة.

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

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

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

أهداف الحملة