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

تتيح لك حملات الخدمات المحلّية الإعلان عن نشاطك التجاري على 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 واضبطها على نوع الخدمة.

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

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

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

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

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

بدءًا من الإصدار 15 من 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'

القيود

  • للوصول إلى عنوان 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 باسم LocalServicesSetting.

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

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