حملات "الخدمات المحلّية" تتيح لك الإعلان عن نشاطك التجاري على 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
وضبطه على
نوع من
خدمة ما.
يجب استخدام رقم تعريف خدمة يتطابق مع استهداف حملتك. location و category.
العمليات غير المتاحة
يمكن أن تتغير القيود المدرجة في الجدول التالي في الإصدارات المستقبلية من Google Ads API
العمليات غير المتاحة | |
---|---|
إنشاء الحملات وإزالتها | تحظر Google Ads API إنشاء حملات "الخدمات المحلّية" الجديدة. |
العمليات المتعلّقة بالكيانات الفرعية في إحدى الحملات | لا تتيح واجهة برمجة التطبيقات مع "إعلانات Google" إنشاء أو تعديل أو إزالة استرداد المجموعات الإعلانية أو الإعلانات أو المعايير في حملات "الخدمات المحلّية". |
مراجع "الخدمات المحلّية"
بدءًا من الإصدار 15 من إعلانات Google API، فإن بعض البيانات من عرض إعلانات الخدمات المحلّية مباشرةً في Google Ads API من خلال موارد التقارير للقراءة فقط التالية:
local_services_lead
local_services_lead_conversation
local_services_verification_artifact
local_services_employee
لكي تعرض هذه الموارد بيانات، يجب أن يتوفر "خدمات محلية" حملة في حساب العميل الذي أرسل الطلب. ونظرًا لأنه لا يمكن أن يكون هناك حملة "الخدمات المحلّية" واحدة لكل حساب عميل، لن يكون لهذه الموارد لتحديد حملة. لتحديد الحملة التي تنتمي إليها هذه الموارد مع، استخدم الاستعلام التالي:
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