تتيح لك حملات الخدمات المحلّية الإعلان عن نشاطك التجاري على 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
واضبطها على نوع الخدمة.
يجب استخدام معرّف خدمة يتطابق مع الموقع الجغرافي والفئة المستهدفَين في حملتك.
العمليات غير المتوافقة
يمكن أن تتغيّر القيود الواردة في الجدول التالي في الإصدارات المستقبلية من Google Ads API.
العمليات غير المتوافقة | |
---|---|
إنشاء الحملات وإزالتها | تحظر Google Ads API إنشاء حملات جديدة على "الخدمات المحلّية". |
العمليات على العناصر الفرعية في الحملة | لا تتيح Google Ads API إنشاء أو تعديل أو إزالة أو استرجاع المجموعات الإعلانية أو الإعلانات أو المعايير في "حملات الخدمات المحلّية". |
موارد "الخدمات المحلّية"
بدءًا من الإصدار 15 من Google Ads 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'
القيود
- للوصول إلى عنوان 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