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

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

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

تتوفّر العمليات التالية.

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

يمكن استرداد حملات وميزانيات "الخدمات المحلية" باستخدام الطريقتَين GoogleAdsService.Search أو GoogleAdsService.SearchStream لطلب البحث عن موارد الحملة حيث 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 واضبطه على نوع الخدمة.

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

إرسال ملاحظات حول العملاء المحتملين

استخدِم طريقة 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.
  • لا تتوفّر بيانات من العملاء المحتملين الذين يشكّل 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.id = 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'

بيانات التراخيص والتأمين الجغرافية والفئوية

لتحديد حالة طلبات إثبات الملكية آليًا حسب الموقع الجغرافي، وتحديدًا رمز الاستهداف الجغرافي ومعرّف فئة الخدمات المحلية، يمكنك استخدام حقل جديد في مرجع 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