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

تتيح لك حملات "الخدمات المحلّية" الإعلان عن مؤسستك على Google والوصول مباشرةً إلى العملاء المهتمّين. يلخّص هذا الدليل العمليات والقيود المتاحة في Google Ads API.

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

تتيح Google Ads API العمليات التالية في "حملات الخدمات المحلّية".

استرداد حملات "الخدمات المحلّية" وميزانياتها

يمكن استرداد حملات "الخدمات المحلّية" وميزانياتها باستخدام طريقة GoogleAdsService.Search أو GoogleAdsService.SearchStream لطلب موارد Campaign حيث 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 لميزانية الحملة المرتبطة بها.

تحديد استراتيجية عروض الأسعار

يمكنك ضبط استراتيجيات عروض الأسعار التالية كاستراتيجية عروض الأسعار العادية في "حملات الخدمات المحلية":

• ManualCpa من خلال ضبط الحقل manual_cpa

  يمكنك ضبط عروض أسعار "ManualCpa" من خلال LocalServicesCampaignSettings.category_bids. يمكنك استرداد وضبط LocalServicesCampaignSettings من حملات "الخدمات المحلّية" من خلال Campaign.local_services_campaign_settings.

• MaximizeConversions من خلال ضبط الحقل maximize_conversions

ضبط جدول عرض الإعلانات كمعيار للحملة

يمكنك ضبط جدول عرض الإعلانات في "حملة الخدمات المحلية" كأحد معايير الحملة.

أنشئ AdScheduleInfo واضبطه على ad_schedule الخاص بـ CampaignCriterion الذي يتم إرساله إلى Google Ads API، باستخدام CampaignCriterionService.MutateCampaignCriteria.

ضبط الاستهداف حسب الموقع الجغرافي

لتفعيل الاستهداف حسب الموقع الجغرافي في "حملة محلية"، أضِف LocationInfo واضبطه على الحقل location في CampaignCriterion الذي يتم إرساله إلى Google Ads API، باستخدام CampaignCriterionService.MutateCampaignCriteria. لمزيد من التفاصيل، يُرجى الاطّلاع على الاستهداف حسب الموقع الجغرافي.

استهداف أنواع خدمات معيّنة

لتفعيل الاستهداف لنوع خدمة معيّن، أنشئ LocalServiceIdInfo باستخدام أحد معرّفات فئات "الخدمات المحلّية"، واضبطه في حقل local_service_id في CampaignCriterion، وأرسِله باستخدام CampaignCriterionService.MutateCampaignCriteria.

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

إرسال ملاحظات بشأن العملاء المحتملين

استخدِم طريقة ProvideLeadFeedback في LocalServicesLeadService لإرسال التقييم والملاحظات لعميل محتمل. يمكنك أيضًا فحص الحقل lead_feedback_submitted في LocalServicesLead للمساعدة في تحديد ما إذا تم تقييم عميل محتمل وتم إرسال ملاحظات.

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

يسرد الجدول التالي العمليات غير المتوافقة مع حملات "الخدمات المحلّية" المستقلة (advertising_channel_type = 'LOCAL_SERVICES').

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

يتم عرض بعض البيانات من إعلانات الخدمات المحلّية مباشرةً في Google Ads API من خلال مراجع تقارير القراءة فقط التالية:

• local_services_lead
• local_services_lead_conversation
• local_services_verification_artifact
• local_services_employee

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

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.
• اعتبارًا من v25، ستتم إزالة ContactDetails.email وسيتوفّر ContactDetails.phone_number_extension في الرسالة ContactDetails التي تعرضها local_services_lead.contact_details.
• لا تتوفّر البيانات من العملاء المحتملين عندما يكون 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_conversation.lead = 'customers/CUSTOMER_ID/localServicesLeads/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'

بيانات التحقّق الجغرافية والفئوية

لتحديد حالة طلبات التحقّق آليًا حسب الموقع الجغرافي (تحديدًا، رمز الموقع الجغرافي المستهدف) ومعرّف فئة "الخدمات المحلية"، يمكنك استخدام الحقل local_services_settings في المرجع 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

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

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

إنشاء "حملات أداء أفضل" لـ "الخدمات المحلّية"

اعتبارًا من v26، يمكنك إنشاء "حملات أداء أفضل" جديدة في "إعلانات الخدمات المحلّية" من خلال واجهة برمجة التطبيقات عن طريق إنشاء "حملة أداء أفضل" (advertising_channel_type = 'PERFORMANCE_MAX') وضبط local_services_enabled = true على pmax_campaign_settings (لا يمكن تغييرها بعد الإنشاء). عند إنشاء "حملة أداء أفضل" في "الخدمات المحلّية"، يجب إدخال كلّ من country_code وlisting_id في local_services_pmax_campaign_settings.

في v24 وv25، تتيح واجهة برمجة التطبيقات التعديلات فقط على "حملات الأداء الأفضل" الحالية لـ "الخدمات المحلية" التي أنشأتها الحسابات في واجهة المستخدم والمدرَجة في القائمة المسموح بها.

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

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

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

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

• listing_id: معرّف بطاقة بيانات "الملف التجاري على Google" المرتبطة بالحملة اعتبارًا من v26، سيكون هذا الحقل مطلوبًا وغير قابل للتغيير أثناء إنشاء "حملة الأداء الأفضل" في "الخدمات المحلّية". يجب ربط معرّف البيانات بالحساب كمادة عرض LOCATION مفعَّلة، وإلا ستعرض واجهة برمجة التطبيقات الخطأ CampaignError.INVALID_LOCAL_SERVICES_PERFORMANCE_MAX_LISTING_ID. بما أنّ listing_id يحمل العلامة IMMUTABLE، ستفشل محاولة تعديل هذا الحقل بعد إنشاء الحملة، وسيظهر الخطأ RequestError.IMMUTABLE_FIELD. يمكن للمطوّرين العثور على أرقام تعريف البيانات المرتبطة أو التحقّق منها من خلال طلب البحث عن مورد Asset لمواد عرض LOCATION المفعَّلة (فحص location_asset.business_profile_locations). لمزيد من المعلومات، يُرجى الاطّلاع على مواد عرض المواقع الجغرافية.
• navigational_query_leads_enabled: تحدّد هذه السمة ما إذا كان سيتم استخدام فلتر طلب البحث الخاص بالتصفّح.
• founding_year: تمثّل هذه السمة سنة تأسيس النشاط التجاري.
• ‫country_code: رمز البلد الخاص بـ "إعلان الخدمات المحلّية". هذا الحقل غير قابل للتغيير ويتم ضبطه مرة واحدة أثناء إنشاء الإعلان. وهو رمز بلد مكوّن من حرفين كبيرين، ويُستخدم لتحديد متطلبات إثبات الملكية والتحقّق من صحة اختيار معيار الموقع الجغرافي.
• phone_numbers: قائمة بأرقام الهواتف المرتبطة بمقدّم الخدمة، ويتم تمثيلها من خلال رسائل LocalServicesPhoneNumber.

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

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