این صفحه به‌وسیله ‏Cloud Translation API‏ ترجمه شده است.

کمپین های خدمات محلی

کمپین‌های خدمات محلی به شما امکان می‌دهند کسب‌وکارتان را در گوگل تبلیغ کنید و مستقیماً از مشتریان بالقوه سرنخ دریافت کنید. این راهنما خلاصه‌ای از عملیات و محدودیت‌های پشتیبانی‌شده در نسخه فعلی 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 کمپین‌های Local Services را از طریق Campaign.local_services_campaign_settings بازیابی و تنظیم کنید.
با تنظیم فیلد MaximizeConversions maximize_conversions

یک برنامه تبلیغاتی را به عنوان معیار کمپین تعیین کنید

شما می‌توانید یک برنامه تبلیغاتی برای یک کمپین خدمات محلی به عنوان معیار کمپین تعیین کنید.

یک AdScheduleInfo ایجاد کنید و آن را با استفاده از CampaignCriterionService.MutateCampaignCriteria ، روی ad_schedule مربوط به CampaignCriterion که به API گوگل ادز ارسال می‌شود، تنظیم کنید.

تنظیم هدف‌گذاری مکانی

برای فعال کردن هدف‌گیری موقعیت مکانی برای یک کمپین خدمات محلی، یک LocationInfo اضافه کنید و آن را با استفاده از CampaignCriterionService.MutateCampaignCriteria روی location CampaignCriterion که به API گوگل ادز ارسال می‌شود، تنظیم کنید. برای جزئیات بیشتر، به Location targeting مراجعه کنید.

انواع خدمات خاص را هدف قرار دهید

برای فعال کردن هدف‌گیری برای یک نوع سرویس خاص، یک LocalServiceIdInfo اضافه کنید و آن را روی نوع سرویس تنظیم کنید.

شما باید از شناسه سرویسی استفاده کنید که با مکان و دسته بندی هدف کمپین شما مطابقت داشته باشد.

بازخورد سرنخ‌ها را ارسال کنید

از متد ProvideLeadFeedback() در LocalServicesLeadService برای ارسال امتیاز و بازخورد برای یک سرنخ استفاده کنید. همچنین می‌توانید فیلد lead_feedback_submitted در LocalServicesLead را بررسی کنید تا مشخص شود که آیا به یک سرنخ امتیاز داده شده و بازخورد ارسال شده است یا خیر.

عملیات‌های پشتیبانی نشده

محدودیت‌های ذکر شده در جدول زیر می‌تواند در نسخه‌های بعدی API تبلیغات گوگل تغییر کند.

عملیات‌های پشتیبانی نشده
ایجاد و حذف کمپین‌ها	رابط برنامه‌نویسی کاربردی گوگل ادز (Google Ads API) ایجاد کمپین‌های جدید خدمات محلی را مسدود می‌کند.
عملیات روی زیرمجموعه‌ها در یک کمپین	رابط برنامه‌نویسی کاربردی گوگل ادز از ایجاد، اصلاح، حذف یا بازیابی گروه‌های تبلیغاتی، تبلیغات یا معیارهای موجود در کمپین‌های خدمات محلی پشتیبانی نمی‌کند.

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

برخی از داده‌های تبلیغات خدمات محلی مستقیماً از طریق منابع گزارش فقط خواندنی زیر در 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

محدودیت‌ها

اگر lead_status برابر با WIPED_OUT باشد، فیلد contact_details تهی (null) می‌شود.
داده‌های مربوط به سرنخ‌هایی که 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 ضبط تماس، باید با آدرس ایمیلی وارد شوید که حداقل دسترسی فقط خواندنی به حساب کاربری گوگل ادز مالک کمپینی که سرنخ به آن مرتبط است، داشته باشد.

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

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 داده‌های تأیید هویت کسب‌وکارهای تبلیغ‌کنندگان را افشا می‌کند. توجه داشته باشید که این تأییدیه‌ها در سطح کسب‌وکار هستند و شامل تأیید هویت کارمندان نمی‌شوند. این داده‌ها شامل موارد زیر است:

تأیید مجوزها
تأییدیه‌های بیمه
تأییدیه‌های بررسی پیشینه
تأییدیه‌های ثبت کسب‌وکار

هر بار که یک درخواست تأیید به Local Services Ads ارسال می‌شود، یک نمونه مصنوع تأیید جدید برای آن در API Google Ads ایجاد می‌شود و هر مصنوع تأیید، یک درخواست تأیید واحد را نشان می‌دهد. هر مصنوع تأیید، بسته به نوع درخواست تأییدی که نشان می‌دهد، ممکن است حاوی برخی از اطلاعات زیر باشد:

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

داده‌های مصنوعات تأیید را می‌توان از منبع 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'

داده‌های مجوز و بیمه جغرافیایی و طبقه‌بندی‌شده

برای تعیین وضعیت درخواست‌های تأیید هویت بر اساس موقعیت جغرافیایی، به طور خاص، کد هدف جغرافیایی (geo target code ) و شناسه دسته‌بندی سرویس‌های محلی ، می‌توانید از یک فیلد جدید در منبع customer به نام LocalServicesSettings استفاده کنید.

این فیلد خلاصه‌ای سطح بالا از وضعیت درخواست‌های تأیید مجوز و بیمه را بر اساس مکان و دسته‌بندی نمایش می‌دهد. در اینجا یک پرس‌وجوی نمونه آورده شده است که تمام این داده‌ها را بازیابی می‌کند:

SELECT
  customer.local_services_settings.granular_license_statuses,
  customer.local_services_settings.granular_insurance_statuses
FROM customer

کارمند خدمات محلی

LocalServicesEmployee داده‌های مربوط به کارمندان خدمات محلی را که تبلیغ‌کنندگان نمایه تبلیغاتی خود را در سیستم‌های ما بارگذاری کرده‌اند، افشا می‌کند.

در اینجا یک پرس و جو (query) نمونه آورده شده است که داده‌های مربوط به همه کارمندان سرویس محلی را برای یک حساب کاربری مشخص بازیابی می‌کند:

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