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

تتيح لك حملات "الخدمات المحلّية" الإعلان عن نشاطك التجاري على 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'

بدءًا من الإصدار 17 من Google Ads API، يمكنك استخدام الطريقة 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 باسمه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