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

تتيح لك "حملات الخدمات المحلّية" الإعلان عن مؤسستك على 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

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

تتيح "حملات الأداء الأفضل" الإعدادات المرتبطة بـ "الخدمات المحلّية" بدءًا من الإصدار 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