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

تتيح لك حملات الخدمات المحلية الإعلان عن مؤسستك على 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 في الحملة والميزانية المرتبطة بها.

تحديد استراتيجية عروض الأسعار في "حملات الخدمات المحلية"

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

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

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

أنشئ 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 للمساعدة في تحديد ما إذا تم تقييم عميل محتمل وتم إرسال ملاحظات.

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

يمكن أن تتغيّر القيود المدرَجة في الجدول التالي في الإصدارات المستقبلية من Google Ads API.

العمليات غير المتوافقة
إنشاء الحملات وإزالتها تمنع Google Ads API إنشاء "حملات خدمات محلية" جديدة.
عمليات على الكيانات الفرعية في حملة لا تتيح واجهة Google Ads API إنشاء المجموعات الإعلانية أو الإعلانات أو معايير الاستهداف في "حملات الخدمات المحلية" أو تعديلها أو إزالتها أو استردادها.

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

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

لكي تعرض هذه المراجع بيانات، يجب أن تتضمّن حساب العميل الذي يقدّم الطلب حملة "الخدمات المحلية". بما أنّه لا يمكن أن تكون هناك سوى حملة واحدة ضمن "الخدمات المحلية" لكل حساب عميل، لا تحدّد هذه المراجع حملة. لتحديد الحملة التي ترتبط بها هذه المراجع، استخدِم طلب البحث التالي:

SELECT campaign.id
FROM campaign
WHERE campaign.advertising_channel_type = 'LOCAL_SERVICES'

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

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

يمكن استرداد بيانات العملاء المحتملين في "الخدمات المحلّية" من مصدر 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
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_verification_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).

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

لمعرفة ما إذا كانت "حملة الأداء الأفضل" هي "حملة خدمات محلية"، تحقّق من الحقل local_services_enabled للقراءة فقط في pmax_campaign_settings الخاص بالحملة.

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

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

  • navigational_query_leads_enabled: تحدّد هذه السمة ما إذا كان سيتم استخدام فلتر طلب البحث الخاص بالتصفّح.
  • ‫founding_year: تمثّل هذه السمة سنة تأسيس النشاط التجاري.
  • ‫country_code: رمز البلد الخاص بـ "إعلان الخدمات المحلّية". هذا الحقل غير قابل للتغيير ويتم ضبطه مرة واحدة أثناء إنشاء الإعلان. وهو رمز بلد مكوّن من حرفين كبيرين، ويُستخدم لتحديد متطلبات إثبات الملكية والتحقّق من صحة اختيار معيار الموقع الجغرافي.
  • ‫phone_numbers: قائمة بأرقام الهواتف المرتبطة بمقدّم الخدمة، ويتم تمثيلها من خلال رسائل LocalServicesPhoneNumber.

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

يستخدم كل إدخال في الحقل المتكرّر 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