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

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

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

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

استخدِم الط0}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

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

تتيح "حملات الأداء الأفضل" إعدادات ذات صلة بـ "الخدمات المحلّية" بدءًا من الإصدار 24.2. تتيح لك هذه الإعدادات ضبط وتحديد "حملة أداء أفضل" تعرض "إعلانات الخدمات المحلّية" (GLS PMax).

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

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

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

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

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

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