حملات "الخدمات المحلّية"

تتيح لك حملات "الخدمات المحلّية" الإعلان عن مؤسستك على Google والوصول مباشرةً إلى العملاء المهتمّين. يلخّص هذا الدليل العمليات والقيود المتاحة في Google Ads API.

العمليات المتوافقة

تتيح Google Ads API العمليات التالية في "حملات الخدمات المحلّية".

استرداد حملات "الخدمات المحلّية" وميزانياتها

يمكن استرداد حملات "الخدمات المحلّية" وميزانياتها باستخدام طريقة GoogleAdsService.Search أو GoogleAdsService.SearchStream لطلب موارد Campaign حيث advertising_channel_type = 'LOCAL_SERVICES'. يُرجى الاطّلاع على المثال أدناه:

SELECT
  campaign.id,
  campaign.status,
  campaign_budget.id,
  campaign_budget.period,
  campaign_budget.amount_micros,
  campaign_budget.type
FROM campaign
WHERE campaign.advertising_channel_type = 'LOCAL_SERVICES'

تعديل حملات "الخدمات المحلّية"

يمكنك تعديل حقلَي status للحملة وamount_micros لميزانية الحملة المرتبطة بها.

ضبط استراتيجية عروض الأسعار

يمكنك ضبط استراتيجيات عروض الأسعار التالية كاستراتيجية عروض الأسعار العادية لـ "حملات الخدمات المحلّية":

• ManualCpa من خلال ضبط الحقل manual_cpa

  يمكنك ضبط عروض أسعار "ManualCpa" من خلال LocalServicesCampaignSettings.category_bids. يمكنك استرداد وضبط LocalServicesCampaignSettings من حملات "الخدمات المحلّية" من خلال Campaign.local_services_campaign_settings.

• MaximizeConversions من خلال ضبط الحقل maximize_conversions

ضبط جدول عرض الإعلانات كمعيار للحملة

يمكنك ضبط جدول عرض الإعلانات لـ "حملة خدمات محلية" كمعيار للحملة.

أنشئ AdScheduleInfo واضبطه على ad_schedule CampaignCriterion الذي يتم إرساله إلى Google Ads API، باستخدام CampaignCriterionService.MutateCampaignCriteria.

ضبط الاستهداف حسب الموقع الجغرافي

لتفعيل الاستهداف حسب الموقع الجغرافي في "حملة محلية"، أضِف LocationInfo واضبطه على الحقل location في CampaignCriterion الذي يتم إرساله إلى Google Ads API، باستخدام CampaignCriterionService.MutateCampaignCriteria. لمزيد من التفاصيل، يُرجى الاطّلاع على الاستهداف حسب الموقع الجغرافي.

استهداف أنواع خدمات معيّنة

لتفعيل الاستهداف لنوع خدمة معيّن، أنشئ LocalServiceIdInfo باستخدام أحد معرّفات فئات "الخدمات المحلّية"، واضبطه في حقل local_service_id في CampaignCriterion، وأرسِله باستخدام CampaignCriterionService.MutateCampaignCriteria.

يجب استخدام معرّف خدمة يتطابق مع الموقع الجغرافي والفئة المستهدَفين في حملتك.

إرسال ملاحظات بشأن العملاء المحتملين

استخدِم طريقة ProvideLeadFeedback في LocalServicesLeadService لإرسال التقييم والملاحظات لعميل محتمل. يمكنك أيضًا فحص حقل lead_feedback_submitted في LocalServicesLead للمساعدة في تحديد ما إذا تم تقييم عميل محتمل وإرسال ملاحظات.

العمليات غير المتوافقة

يسرد الجدول التالي العمليات غير المتوافقة مع حملات "الخدمات المحلّية" المستقلة (advertising_channel_type = 'LOCAL_SERVICES').

مراجع "الخدمات المحلّية"

يتم عرض بعض البيانات من إعلانات الخدمات المحلّية مباشرةً في Google Ads API من خلال مراجع تقارير القراءة فقط التالية:

• local_services_lead
• local_services_lead_conversation
• local_services_verification_artifact
• local_services_employee

كي تعرض هذه الموارد البيانات، يجب أن تكون هناك "حملة خدمات محلية" أو "حملة أداء أفضل" في "الخدمات المحلّية" في حساب العميل الذي يقدّم الطلب. يربط الحقل local_services_lead.campaign سجلّات العملاء المحتملين بالحملة المرتبطة بها (بما في ذلك "حملات الأداء الأفضل" المخصّصة لأهداف الدفع مقابل كل إحالة ناجحة محتملة حيث campaign.advertising_channel_type = 'PERFORMANCE_MAX' و campaign.pmax_campaign_settings.local_services_enabled = true). لتحديد الحملة التي ترتبط بها هذه الموارد، استخدِم طلب البحث التالي:

SELECT
  campaign.id,
  campaign.advertising_channel_type,
  campaign.pmax_campaign_settings.local_services_enabled
FROM campaign
WHERE campaign.advertising_channel_type IN ('LOCAL_SERVICES', 'PERFORMANCE_MAX')

عميل محتمل في "الخدمات المحلّية"

LocalServicesLead يعرض تفاصيل عميل محتمل يتم إنشاؤه عندما يتصل المستهلك أو يرسل رسالة أو يحجز خدمة أو يستخدم قسيمة من المعلِن.

يتم تحديد نوع العميل المحتمل من خلال LocalServicesLeadType. اعتبارًا من v26، ستتم إتاحة COUPON لتفعيل أنواع العملاء المحتملين الذين يستخدمون القسائم في "حملات الخدمات المحلّية" و"حملات الأداء الأفضل" في "الخدمات المحلّية".

يربط حقل campaign سجلّ العميل المحتمل بالحملة المرتبطة به. بالإضافة إلى اختيار حقول campaign المنسوبة (مثل campaign.id وcampaign.name)، يمكنك فلترة طلبات البحث عن العملاء المحتملين حسب اسم مورد الحملة (WHERE local_services_lead.campaign = ...) أو حسب نوع القناة الإعلانية (WHERE campaign.advertising_channel_type = ...) لتقسيم العملاء المحتملين حسب نوع الحملة.

يمكن استرداد بيانات العملاء المحتملين في "الخدمات المحلّية" من المورد local_services_lead. إليك مثال على طلب البحث:

SELECT
  local_services_lead.lead_type,
  local_services_lead.category_id,
  local_services_lead.service_id,
  local_services_lead.contact_details,
  local_services_lead.lead_status,
  local_services_lead.creation_date_time,
  local_services_lead.locale,
  local_services_lead.lead_charged,
  local_services_lead.credit_details.credit_state,
  local_services_lead.credit_details.credit_state_last_update_date_time,
  local_services_lead.campaign
FROM local_services_lead

القيود

• يكون الحقل contact_details فارغًا إذا كانت قيمة lead_status تساوي WIPED_OUT.
• اعتبارًا من v25، ستتم إزالة ContactDetails.email وستصبح ContactDetails.phone_number_extension متاحة في رسالة ContactDetails التي يعرضها local_services_lead.contact_details.
• لا تتوفّر البيانات من العملاء المحتملين عندما يكون category_id جزءًا من فئة الرعاية الصحية.

محادثة مع عميل محتمل في "الخدمات المحلّية"

LocalServicesLeadConversation يعرض تفاصيل المحادثات التي تم إجراؤها كجزء من LocalServicesLead. هناك علاقة واحد لمتعدد مع LocalServicesLead، حيث يمكن أن يكون لعميل محتمل واحد العديد من المحادثات. يمكن العثور على اسم المورد للعميل المحتمل ذي الصلة في الحقل lead.

يمكن استرداد بيانات المحادثة من المرجع local_services_lead_conversation. في ما يلي مثال على طلب بحث يفلتر النتائج التي تمثّل مكالمات هاتفية:

SELECT
  local_services_lead_conversation.id,
  local_services_lead_conversation.conversation_channel,
  local_services_lead_conversation.participant_type,
  local_services_lead_conversation.lead,
  local_services_lead_conversation.event_date_time,
  local_services_lead_conversation.phone_call_details.call_duration_millis,
  local_services_lead_conversation.phone_call_details.call_recording_url,
  local_services_lead_conversation.message_details.text,
  local_services_lead_conversation.message_details.attachment_urls
FROM local_services_lead_conversation
WHERE local_services_lead_conversation.conversation_channel = 'PHONE_CALL'

يمكنك استخدام الطريقة LocalServicesLeadService.AppendLeadConversation لإلحاق موارد LocalServicesLeadConversation بـ LocalServicesLead.

القيود

• للوصول إلى عنوان URL الخاص بتسجيل المكالمة، يجب تسجيل الدخول باستخدام عنوان بريد إلكتروني لديه إذن بالقراءة فقط على الأقل في حساب عميل "إعلانات Google" الذي يملك الحملة المرتبطة بالعميل المحتمل.

• قد يستغرق طلب جميع المحادثات في آنٍ واحد وقتًا طويلاً، لذا عليك فلترة المحادثات حسب العميل المحتمل، على سبيل المثال:

  SELECT
    local_services_lead_conversation.id,
    local_services_lead_conversation.event_date_time,
    local_services_lead_conversation.message_details.text
  FROM local_services_lead_conversation
  WHERE local_services_lead_conversation.lead = 'customers/CUSTOMER_ID/localServicesLeads/LEAD_ID'
  

بيانات التحقّق

LocalServicesVerificationArtifact تعرض بيانات التحقّق من هوية المؤسسات التابعة للمعلنين. يُرجى العِلم أنّ عمليات التحقّق هذه تتم على مستوى المؤسسة ولا تشمل عمليات التحقّق من الموظفين. تتضمّن البيانات ما يلي:

• عمليات التحقّق من التراخيص
• عمليات التحقّق من التأمين
• عمليات التحقّق من الفحص الأمني
• عمليات التحقّق من تسجيل المؤسسة

في أي وقت يتم فيه إرسال طلب تحقّق إلى "إعلانات الخدمات المحلّية"، يتم إنشاء مثيل جديد لبيانات التحقّق في Google Ads API، ويمثّل كل مثيل طلب تحقّق واحدًا. قد يحتوي كل عنصر من عناصر التحقّق على بعض المعلومات التالية، وذلك حسب نوع طلب التحقّق الذي يمثّله:

• حالة كل قطعة أثرية للتحقق
• عنوان URL للفحص الأمني الذي سيتم استخدامه للتحقّق من الفحص الأمني
• وقت الفصل في الفحص الأمني (إن وُجد)
• عنوان URL لمستند التأمين من أجل الاطّلاع على معلومات التأمين التي سبق إرسالها
• سبب رفض التأمين (إن توفّر)
• تفاصيل الترخيص (النوع والرقم والاسم الأول واسم العائلة)
• سبب رفض الترخيص (إن توفّر)
• عنوان URL لمستند الترخيص من أجل عرض صورة الترخيص التي سبق إرسالها (إذا كان ذلك منطبقًا)
• تفاصيل تسجيل المؤسسة (التحقّق من رقم التعريف ورقم التسجيل)
• سبب رفض تسجيل المؤسسة (إن وُجد)
• عنوان URL لمستند تسجيل المؤسسة من أجل الاطّلاع على صورة التسجيل التي تم إرسالها (إذا كان ذلك منطبقًا)

يمكن استرداد بيانات عناصر التحقّق من المورد local_services_verification_artifact. في ما يلي مثال على طلب بحث يستردّ بيانات جميع عناصر التحقّق المرتبطة بالترخيص لحساب عميل معيّن:

SELECT
  local_services_verification_artifact.id,
  local_services_verification_artifact.creation_date_time,
  local_services_verification_artifact.status,
  local_services_verification_artifact.artifact_type,
  local_services_verification_artifact.license_verification_artifact.license_type,
  local_services_verification_artifact.license_verification_artifact.license_number,
  local_services_verification_artifact.license_override_artifact.licensee_first_name,
  local_services_verification_artifact.license_verification_artifact.licensee_last_name,
  local_services_verification_artifact.license_verification_artifact.rejection_reason
FROM local_services_verification_artifact
WHERE local_services_verification_artifact.artifact_type = 'LICENSE'

بيانات التحقّق الجغرافية والفئوية

لتحديد حالة طلبات التحقّق من المعلنين آليًا حسب الموقع الجغرافي (تحديدًا رمز الموقع الجغرافي المستهدف) ورقم تعريف فئة "الخدمات المحلّية"، يمكنك استخدام حقل local_services_settings في مورد customer الذي يتضمّن النوع LocalServicesSettings.

يعرض هذا الحقل ملخّصًا عامًا لحالة طلبات التحقّق من الترخيص والتأمين حسب الموقع الجغرافي والفئة. في ما يلي مثال على طلب بحث يستردّ كل هذه البيانات:

SELECT
  customer.local_services_settings.granular_license_statuses,
  customer.local_services_settings.granular_insurance_statuses
FROM customer

موظف الخدمات المحلّية

LocalServicesEmployee يعرض البيانات حول موظفي الخدمة المحلية الذين حمّل المعلنون ملفهم الشخصي للإعلان في أنظمتنا.

في ما يلي مثال على طلب بحث يستردّ بيانات جميع موظّفي الخدمة المحلّية لحساب عميل معيّن:

SELECT
  local_services_employee.status,
  local_services_employee.type,
  local_services_employee.university_degrees,
  local_services_employee.residencies,
  local_services_employee.fellowships,
  local_services_employee.job_title,
  local_services_employee.year_started_practicing,
  local_services_employee.languages_spoken,
  local_services_employee.first_name,
  local_services_employee.middle_name,
  local_services_employee.last_name
FROM local_services_employee

"حملات الأداء الأفضل" في "الخدمات المحلّية"

تتيح حملات الأداء الأفضل الإعدادات المتعلّقة بـ "الخدمات المحلّية" اعتبارًا من ‎v24. تتيح لك هذه الإعدادات ضبط وتحديد "حملة أداء أفضل" تعرض "إعلانات الخدمات المحلّية" (GLS PMax).

إنشاء "حملات أداء أفضل" لـ "الخدمات المحلّية"

اعتبارًا من v26، ستتيح Google Ads API إنشاء "حملات الأداء الأفضل" في "الخدمات المحلّية" وتعديلها. يمكنك إنشاء "حملات أداء أفضل" جديدة في "الخدمات المحلّية" من خلال واجهة برمجة التطبيقات، وذلك عبر إنشاء "حملة أداء أفضل" (advertising_channel_type = 'PERFORMANCE_MAX') وضبط local_services_enabled = true على pmax_campaign_settings (لا يمكن تغييرها بعد الإنشاء). عند إنشاء "حملة أداء أفضل" في "الخدمات المحلّية"، يجب إدخال كلّ من country_code وlisting_id في local_services_pmax_campaign_settings. في الإصدارَين v24 وv25، تتيح واجهة برمجة التطبيقات إجراء تعديلات فقط على "حملات الأداء الأفضل" الحالية في "الخدمات المحلّية" التي تم إنشاؤها في واجهة المستخدم من خلال الحسابات المُدرَجة في القائمة المسموح بها. للحصول على تعليمات شاملة حول ضبط المتطلبات الأساسية وإنشاء الحملات بشكلٍ كامل، يُرجى الاطّلاع على دليل "حملات الأداء الأفضل" التي تستخدم أهداف الدفع مقابل كل إحالة ناجحة محتملة.

تحديد "حملات الأداء الأفضل" في "الخدمات المحلّية"

لتحديد ما إذا كانت "حملة الأداء الأفضل" هي "حملة خدمات محليّة"، اطّلِع على حقل local_services_enabled في pmax_campaign_settings للحملة. هذا الحقل هو قيمة منطقية غير قابلة للتغيير (CREATE ONLY) يتم ضبطها على true عند إنشاء الحملة.

ضبط الإعدادات

بالنسبة إلى الحملات التي يكون فيها local_services_enabled هو true، اضبط الإعدادات ضمن حقل local_services_pmax_campaign_settings:

• listing_id: معرّف بطاقة بيانات "الملف التجاري على Google" المرتبطة بالحملة اعتبارًا من v26، سيكون هذا الحقل مطلوبًا وغير قابل للتغيير أثناء إنشاء "حملة الأداء الأفضل" في "الخدمات المحلّية". يجب ربط معرّف البيانات بالحساب كمادة عرض LOCATION مفعَّلة، وإلا ستعرض واجهة برمجة التطبيقات الخطأ CampaignError.INVALID_LOCAL_SERVICES_PERFORMANCE_MAX_LISTING_ID. بما أنّ listing_id يحمل العلامة IMMUTABLE، ستفشل محاولة تعديل هذا الحقل بعد إنشاء الحملة، وسيظهر الخطأ RequestError.IMMUTABLE_FIELD. يمكن للمطوّرين العثور على أرقام تعريف البيانات المرتبطة أو التحقّق منها من خلال طلب البحث عن مورد Asset لمواد عرض LOCATION المفعَّلة (فحص location_asset.business_profile_locations). لمزيد من المعلومات، يُرجى الاطّلاع على مواد عرض المواقع الجغرافية.
• navigational_query_leads_enabled: تحدّد ما إذا كان سيتم استخدام فلتر لطلبات البحث التنقّلية.
• ‫founding_year: سنة تأسيس النشاط التجاري
• ‫country_code: رمز البلد الخاص بـ "إعلان الخدمات المحلّية". اعتبارًا من v26، سيكون هذا الحقل مطلوبًا وغير قابل للتغيير، ويتم ضبطه مرة واحدة أثناء إنشاء الحملة. وهو رمز بلد مكوّن من حرفَين كبيرَين (في الوقت الحالي، لا يتوفّر سوى US في "حملات الأداء الأفضل" في "الخدمات المحلّية")، ويُستخدَم لتحديد متطلبات إثبات الهوية والتحقّق من صحة اختيار معيار الموقع الجغرافي.
• phone_numbers: قائمة بأرقام الهواتف المرتبطة بمقدّم الخدمة، ويتم تمثيلها من خلال رسائل LocalServicesPhoneNumber. في حال حذف هذه السمة، يتم ضبط رقم الاتصال تلقائيًا على رقم الهاتف في بطاقة بيانات "الملف التجاري على Google" المرتبطة، ويكون مطلوبًا إذا لم تتضمّن بطاقة بيانات "الملف التجاري" رقم هاتف.

أرقام الهواتف

يستخدم كل إدخال في الحقل المتكرر phone_numbers نوع الرسالة LocalServicesPhoneNumber مع الحقول التالية:

• ‫phone_number: رقم الهاتف
• ‫country_code: رمز البلد المكوّن من حرفَين كبيرَين.
• phone_number_type: نوع رقم الهاتف، ويتم تحديده من خلال GlsPhoneNumberTypeEnum.GlsPhoneNumberType. تشمل الأنواع المتوافقة ما يلي:
  • DESTINATION_PHONE_NUMBER_FOR_ADS: رقم الوجهة المطلوب استخدامه للمكالمات من وحدة إعلانية في "الخدمات المحلّية" (لعملاء محتملين للمكالمات، الإعداد التلقائي)
  • ‫DESTINATION_PHONE_NUMBER_FOR_SMS_ONLY: رقم الوجهة الذي يتيح تلقّي الرسائل القصيرة (اختياري، للإشعارات عبر الرسائل القصيرة بشأن العملاء المحتملين الذين يرسلون رسائل).
  • ‫DESTINATION_PHONE_NUMBER_FOR_WHATSAPP_ONLY: رقم الوجهة لحساب مقدّم الخدمة على WhatsApp