تستخدم Google تكنولوجيا الذكاء الاصطناعي لترجمة المحتوى إلى لغتك المفضّلة، وقد تتضمّن بعض الأخطاء.

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

تتيح لك حملات الخدمات المحلية الإعلان عن نشاطك التجاري على 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 الخاصَين بميزانية الحملة المرتبطة.

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

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

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 واضبطه على نوع الخدمة.

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

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

استخدِم طريقة 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:

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

حملات "الخدمات المحلّية" تنظيم صفحاتك في مجموعات يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.

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

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

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

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

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

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

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

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

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

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

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

القيود

محادثة العملاء المحتملين في "الخدمات المحلّية"

القيود

مستند التحقّق من الأهلية في "الخدمات المحلّية"

البيانات الجغرافية والفئوية الخاصة بالتراخيص والتأمين

موظف الخدمات المحلّية

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

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

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

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

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