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

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

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

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

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

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

أنشئ 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 للمساعدة في تحديد ما إذا تم تقييم عميل محتمل وإرسال ملاحظات.

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

يمكن أن تتغيّر القيود المدرَجة في الجدول التالي في الإصدارات المستقبلية من 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.
  • اعتبارًا من 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، يمكنك إنشاء "حملات الأداء الأفضل في إعلانات الخدمات المحلية" جديدة من خلال واجهة برمجة التطبيقات عن طريق ضبط local_services_enabled = true على pmax_campaign_settings (لا يمكن تغيير هذا الإعداد بعد الإنشاء). عند إنشاء "حملة أداء أفضل" على "إعلانات الخدمات المحلية"، يجب توفير كل من country_code وlisting_id في local_services_pmax_campaign_settings. في الإصدار 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