کمپین های خدمات محلی به شما امکان می دهند کسب و کار خود را در 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
تنظیم کنید. میتوانید از طریقCampaign.local_services_campaign_settings
،LocalServicesCampaignSettings
کمپینهای خدمات محلی را بازیابی و تنظیم کنید.MaximizeConversions
با تنظیم فیلدmaximize_conversions
یک برنامه تبلیغاتی را به عنوان معیار کمپین تنظیم کنید
می توانید یک برنامه تبلیغاتی برای کمپین خدمات محلی به عنوان معیار کمپین تنظیم کنید.
یک AdScheduleInfo
ایجاد کنید و با استفاده از CampaignCriterionService.MutateCampaignCriteria
، آن را روی ad_schedule
CampaignCriterion
که به API Google Ads ارسال میشود، تنظیم کنید.
تعیین مکان یابی
برای فعال کردن مکان یابی برای کمپین خدمات محلی، یک LocationInfo
اضافه کنید و آن را با استفاده از CampaignCriterionService.MutateCampaignCriteria
روی location
CampaignCriterion
که به API Google Ads ارسال میشود، تنظیم کنید. برای جزئیات بیشتر، مکان یابی را ببینید.
انواع خدمات خاص را هدف قرار دهید
برای فعال کردن هدفیابی برای یک نوع سرویس خاص، یک LocalServiceIdInfo
اضافه کنید و آن را روی نوع سرویس تنظیم کنید.
باید از شناسه سرویسی استفاده کنید که با مکان و دسته هدف کمپین شما مطابقت داشته باشد.
عملیات پشتیبانی نشده
محدودیتهای فهرستشده در جدول زیر میتوانند در نسخههای بعدی Google Ads API تغییر کنند.
عملیات پشتیبانی نشده | |
---|---|
ایجاد و حذف کمپین ها | Google Ads API ایجاد کمپین های جدید خدمات محلی را مسدود می کند. |
عملیات بر روی نهادهای فرعی در یک کمپین | Google Ads API از ایجاد، اصلاح، حذف، یا بازیابی گروههای تبلیغاتی، آگهیها یا معیارها در کمپینهای خدمات محلی پشتیبانی نمیکند. |
منابع خدمات محلی
با شروع در Google Ads API نسخه 15، برخی از دادههای تبلیغات خدمات محلی مستقیماً در Google Ads API از طریق منابع گزارش فقط خواندنی زیر در معرض دید قرار میگیرند:
-
local_services_lead
-
local_services_lead_conversation
-
local_services_verification_artifact
-
local_services_employee
برای اینکه این منابع داده ها را برگردانند، باید یک کمپین Local Services در حساب مشتری وجود داشته باشد که درخواست را انجام می دهد. و از آنجایی که برای هر حساب مشتری فقط یک کمپین خدمات محلی می تواند وجود داشته باشد، این منابع یک کمپین را مشخص نمی کنند. برای شناسایی کمپینی که این منابع به آن وابسته هستند، از پرس و جو زیر استفاده کنید:
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
خالی است. - دادههای سرنخهایی که در آنها
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 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.id = LEAD_ID
مصنوع تأیید خدمات محلی
LocalServicesVerificationArtifact
دادههای راستیآزمایی را برای کسبوکارهای تبلیغکنندگان در معرض دید قرار میدهد. توجه داشته باشید که این راستیآزماییها در سطح کسبوکار هستند و تأییدیههای کارمندان را شامل نمیشوند. داده ها شامل موارد زیر است:
- تاییدیه های مجوز
- تاییدیه های بیمه
- راستیآزماییهای بررسی پسزمینه
- تاییدیه های ثبت کسب و کار
هر زمان که یک درخواست تأیید به تبلیغات خدمات محلی ارسال میشود، یک نمونه مصنوع تأیید جدید برای آن در API Google Ads ایجاد میشود و هر مصنوع تأیید یک درخواست تأیید واحد را نشان میدهد. هر مصنوع تأیید ممکن است حاوی برخی از اطلاعات زیر باشد، بسته به نوع درخواست تأیید:
- وضعیت هر مصنوع تأیید
- نشانی وب بررسی پسزمینه برای تأیید صحت بررسی پسزمینه
- زمان داوری بررسی پیشینه (در صورت وجود)
- نشانی اینترنتی سند بیمه برای مشاهده اطلاعات بیمه ارسال شده از قبل
- دلیل رد بیمه (در صورت وجود)
- جزئیات مجوز (نوع، شماره، نام، نام خانوادگی)
- دلیل رد مجوز (در صورت وجود)
- 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