تتيح لك حملات "الخدمات المحلّية" الإعلان عن نشاطك التجاري على 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'
بدءًا من الإصدار 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