پویش‌های «خدمات محلی»

پویش‌های «خدمات محلی» به شما امکان می‌دهد کسب‌وکارتان را در 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 ایجاد کنید و آن را بااستفاده از CampaignCriterionService.MutateCampaignCriteria روی ad_schedule مربوط به CampaignCriterion که به Google Ads API ارسال می‌شود تنظیم کنید.

تنظیم هدف‌یابی مکانی

برای فعال کردن هدف‌یابی مکانی برای پویش «خدمات محلی»، 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 ایجاد و حذف پویش‌های مستقل «خدمات محلی» (advertising_channel_type = 'LOCAL_SERVICES') را مسدود می‌کند. از v26، می‌توانید با تنظیم pmax_campaign_settings.local_services_enabled = true، پویش‌های «بیشینه‌سازی عملکرد» جدید «خدمات محلی» (advertising_channel_type = 'PERFORMANCE_MAX') ایجاد کنید؛ به ایجاد پویش‌های «بیشینه‌سازی عملکرد» «خدمات محلی» مراجعه کنید.
عملیات روی زیرنهادها در پویش برای کمپین‌های مستقل «خدمات محلی» (advertising_channel_type = 'LOCAL_SERVICES')، Google Ads API از ایجاد، اصلاح، حذف، یا بازیابی گروه‌های آگهی، آگهی‌ها، یا معیارهایی غیراز معیارهای کمپین فهرست‌شده در عملیات پشتیبانی‌شده پشتیبانی نمی‌کند. برای پویش‌های «عملکرد بیشینه» «خدمات محلی»، از گروه‌های دارایی و معیارهای پویش استفاده کنید.

منابع «خدمات محلی»

برخی‌از داده‌های آگهی‌های خدمات محلی مستقیماً در Google Ads API ازطریق منابع گزارش فقط خواندنی زیر نمایش داده می‌شوند:

برای اینکه این منابع داده‌ها را برگردانند، باید یک پویش «خدمات محلی» یا پویش «بیشینه‌سازی عملکرد خدمات محلی» در حساب مشتری که درخواست را ارسال می‌کند وجود داشته باشد. فیلد local_services_lead.campaign سوابق مشتریان بالقوه را به پویش مرتبط با آن‌ها پیوند می‌دهد (ازجمله «عملکرد بیشینه» برای پویش‌های اهداف پرداخت به‌ازای مشتری بالقوه که در آن campaign.advertising_channel_type = 'PERFORMANCE_MAX' و campaign.pmax_campaign_settings.local_services_enabled = true). برای شناسایی پویشی که این منابع به آن وابسته هستند، از پُرسمان زیر استفاده کنید:

SELECT
  campaign.id,
  campaign.advertising_channel_type,
  campaign.pmax_campaign_settings.local_services_enabled
FROM campaign
WHERE campaign.advertising_channel_type IN ('LOCAL_SERVICES', 'PERFORMANCE_MAX')

مشتری بالقوه «خدمات محلی»

LocalServicesLead جزئیات مشتری بالقوه‌ای را که هنگام تماس، پیام، رزرو خدمات، یا استفاده از کوپن تبلیغ‌کننده توسط مصرف‌کننده ایجاد می‌شود نشان می‌دهد.

نوع مشتری بالقوه توسط LocalServicesLeadType تعریف می‌شود. از v26، COUPON برای فعال کردن انواع مشتری بالقوه کوپنی در سراسر کمپین‌های «خدمات محلی» و «عملکرد بیشینه خدمات محلی» پشتیبانی می‌شود.

فیلد campaign سابقه مشتری بالقوه را به پویش مرتبط با آن پیوند می‌دهد. علاوه‌بر انتخاب فیلدهای campaign منسوب (مانند campaign.id و campaign.name)، می‌توانید پُرسمان‌های مشتری بالقوه را براساس نام منبع پویش (WHERE local_services_lead.campaign = ...) یا براساس نوع کانال تبلیغات (WHERE campaign.advertising_channel_type = ...) فیلتر کنید تا مشتریان بالقوه را براساس نوع پویش بخش‌بندی کنید.

داده‌های مشتری بالقوه «خدمات محلی» را می‌توان از منبع 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,
  local_services_lead.campaign
FROM local_services_lead

محدودیت‌ها

  • اگر lead_status برابر با WIPED_OUT باشد، فیلد contact_details تهی است.
  • از 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 استفاده کنید.

محدودیت‌ها

  • برای دسترسی به نشانی وب ضبط تماس، باید با نشانی ایمیلی به سیستم وارد شوید که حداقل دسترسی فقط خواندنی به حساب مشتری Google Ads داشته باشد که مالک پویشی است که مشتری بالقوه با آن مرتبط است.

  • درخواست همه مکالمه‌ها به‌طور هم‌زمان می‌تواند درخواستی زمان‌بر باشد، بنابراین باید مکالمه‌ها را براساس مشتری بالقوه فیلتر کنید، برای مثال:

    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 ایجاد می‌شود و هر مصنوع درستی‌سنجی نشان‌دهنده یک درخواست درستی‌سنجی است. هر مصنوع درستی‌سنجی ممکن است حاوی برخی‌از اطلاعات زیر باشد، بسته به اینکه چه نوع درخواست درستی‌سنجی را نشان می‌دهد:

  • وضعیت هریک از مصنوعات درستی‌سنجی
  • نشانی وب بررسی پیشینه که برای درستی‌سنجی بررسی پیشینه استفاده می‌شود
  • زمان داوری بررسی پیشینه (درصورت وجود)
  • نشانی وب سند بیمه برای مشاهده اطلاعات بیمه ارسال‌شده
  • دلیل رد شدن بیمه (درصورت وجود)
  • جزئیات پروانه (نوع، شماره، نام، نام خانوادگی)
  • دلیل رد شدن پروانه (درصورت وجود)
  • نشانی وب سند پروانه برای مشاهده تصویر پروانه ارسال‌شده (درصورت وجود)
  • جزئیات ثبت کسب‌وکار (بررسی شناسه، شماره ثبت)
  • دلیل رد شدن ثبت کسب‌وکار (درصورت وجود)
  • نشانی وب سند ثبت کسب‌وکار برای مشاهده تصویر ثبت ارسال‌شده (درصورت وجود)

داده‌های مصنوع درستی‌سنجی را می‌توان از منبع 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_override_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، Google Ads API هم از ایجاد و هم از به‌روزرسانی پویش‌های «بیشینه‌سازی عملکرد» «خدمات محلی» پشتیبانی می‌کند. می‌توانید ازطریق API با ایجاد کردن پویش «عملکرد بیشینه» (advertising_channel_type = 'PERFORMANCE_MAX') و تنظیم کردن local_services_enabled = true روی pmax_campaign_settings (پس‌از ایجاد کردن تغییرناپذیر است)، پویش‌های «عملکرد بیشینه» جدید برای «خدمات محلی» ایجاد کنید. هنگام ایجاد پویش «عملکرد بیشینه» خدمات محلی، هر دو country_code و listing_id در local_services_pmax_campaign_settings الزامی هستند. در v24 و v25، این API فقط از به‌روزرسانی برای پویش‌های «عملکرد بیشینه» موجود در «خدمات محلی» که در واسط کاربر توسط حساب‌های موجود در فهرست مجاز ایجاد شده‌اند پشتیبانی می‌کند. برای دستورالعمل‌های گام‌به‌گام درباره پیکربندی پیش‌نیازها و ایجاد پویش‌ها به‌صورت اتمی، به راهنمای «عملکرد بیشینه» برای اهداف پرداخت به‌ازای مشتری بالقوه مراجعه کنید.

شناسایی پویش‌های «عملکرد بیشینه» در «خدمات محلی»

برای تشخیص اینکه آیا پویش «عملکرد بیشینه» پویش «خدمات محلی» است یا نه، فیلد local_services_enabled را در pmax_campaign_settings پویش بررسی کنید. این فیلد یک مقدار بولی تغییرناپذیر (CREATE ONLY) است که هنگام ایجاد پویش روی true تنظیم شده است.

پیکربندی تنظیمات

برای پویش‌هایی که 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: کد کشور «آگهی خدمات محلی». از v26، این فیلد الزامی و تغییرناپذیر است و یک‌بار درطول ایجاد پویش تنظیم می‌شود. این کد کشور دوحرفی با حروف بزرگ است کد کشور (درحال‌حاضر، فقط US برای پویش‌های «بیشینه‌سازی عملکرد» خدمات محلی پشتیبانی می‌شود)، که برای تعیین الزامات درستی‌سنجی و اعتبارسنجی انتخاب معیار مکان استفاده می‌شود.
  • phone_numbers: فهرستی از شماره تلفن‌های مرتبط با ارائه‌دهنده، که با پیام‌های LocalServicesPhoneNumber نشان داده می‌شود. اگر حذف شود، شماره تماس به‌طور پیش‌فرض شماره تلفن موجود در فهرستگان «نمایه کسب‌وکار Google» پیوندشده خواهد بود، و اگر فهرستگان «نمایه کسب‌وکار» شماره تلفن نداشته باشد، الزامی است.

شماره‌های تلفن

هر ورودی در فیلد تکراری 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: شماره مقصد برای حساب واتساپ ارائه‌دهنده.