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

تتيح لك حملات الخدمات المحلّية الإعلان عن نشاطك التجاري على 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 إنشاء المجموعات الإعلانية أو الإعلانات أو المعايير أو تعديلها أو إزالتها أو استرجاعها في "حملات الخدمات المحلّية".

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

يتم عرض بعض البيانات من إعلانات الخدمات المحلّية مباشرةً في 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 يُسمى 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