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

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

يجب استخدام رقم تعريف خدمة يتطابق مع استهداف حملتك. location و category.

العمليات غير المتاحة

يمكن أن تتغير القيود المدرجة في الجدول التالي في الإصدارات المستقبلية من Google Ads API

العمليات غير المتاحة
إنشاء الحملات وإزالتها تحظر Google Ads API إنشاء حملات "الخدمات المحلّية" الجديدة.
العمليات المتعلّقة بالكيانات الفرعية في إحدى الحملات لا تتيح واجهة برمجة التطبيقات مع "إعلانات Google" إنشاء أو تعديل أو إزالة استرداد المجموعات الإعلانية أو الإعلانات أو المعايير في حملات "الخدمات المحلّية".

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

بدءًا من الإصدار 15 من إعلانات Google 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'

بدءًا من الإصدار 17 من Google Ads API، يمكنك استخدام 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، يُسمى LocalServicesSetting.

يعرض هذا الحقل ملخصًا عالي المستوى لحالة الترخيص والتأمين طلبات إثبات الملكية حسب الموقع الجغرافي والفئة فيما يلي مثال على الاستعلام الذي استرداد جميع هذه البيانات:

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