Local Services कैंपेन की मदद से, Google पर अपने कारोबार का विज्ञापन दिखाया जा सकता है. साथ ही, संभावित ग्राहकों से सीधे तौर पर लीड पाई जा सकती हैं. इस गाइड में, Google Ads API के मौजूदा वर्शन में इस्तेमाल की जा सकने वाली कार्रवाइयों और पाबंदियों के बारे में खास जानकारी दी गई है.
काम करने वाली कार्रवाइयां
Local Services के कैंपेन और बजट वापस पाना
Local Services के कैंपेन और बजट हासिल करने के लिए, 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'
Local Services कैंपेन में बदलाव करना
कैंपेन के status
और उससे जुड़े कैंपेन के बजट amount_micros
के फ़ील्ड अपडेट किए जा सकते हैं.
Local Services कैंपेन के लिए बिडिंग की रणनीति सेट करना
इन रणनीतियों को Local Services कैंपेन की स्टैंडर्ड बिडिंग की रणनीति के तौर पर सेट किया जा सकता है:
ManualCpa
फ़ील्डmanual_cpa
सेट करकेआपके पास
LocalServicesCampaignSettings.category_bids
तकManualCpa
की बिड सेट करने का विकल्प है.Campaign.local_services_campaign_settings
की मदद से, Local Services केLocalServicesCampaignSettings
कैंपेन फिर से हासिल किए जा सकते हैं और उन्हें सेट किया जा सकता है.MaximizeConversions
फ़ील्ड सेट करकेmaximize_conversions
विज्ञापन शेड्यूल को कैंपेन की शर्त के तौर पर सेट करना
Local Services कैंपेन के लिए, विज्ञापन शेड्यूल को कैंपेन की शर्तों के तौर पर सेट किया जा सकता है.
कोई AdScheduleInfo
बनाएं और उसे CampaignCriterionService.MutateCampaignCriteria
का इस्तेमाल करके, Google Ads API को भेजे गएCampaignCriterion
के ad_schedule
पर सेट करें.
लोकेशन टारगेटिंग सेट करना
Local Services कैंपेन के लिए जगह के हिसाब से टारगेटिंग की सुविधा चालू करने के लिए, LocationInfo
जोड़ें और उसे CampaignCriterionService.MutateCampaignCriteria
का इस्तेमाल करके Google Ads API को भेजे गएCampaignCriterion
के location
पर सेट करें.
ज़्यादा जानकारी के लिए, जगह के हिसाब से टारगेटिंग देखें.
खास तरह की सेवाओं को टारगेट करें
किसी खास सेवा के टाइप के लिए टारगेटिंग चालू करने के लिए, LocalServiceIdInfo
जोड़ें और उसे सेवा के टाइप पर सेट करें.
आपको ऐसे सेवा आईडी का इस्तेमाल करना चाहिए जो आपके कैंपेन की टारगेटिंग जगह और कैटगरी से मेल खाता हो.
असमर्थित कार्रवाइयां
नीचे दी गई टेबल में बताई गई पाबंदियां, Google Ads API के आने वाले वर्शन में बदल सकती हैं.
असमर्थित कार्रवाइयां | |
---|---|
कैंपेन बनाएं और हटाएं | Google Ads API, Local Services के नए कैंपेन बनाने पर रोक लगाता है. |
किसी कैंपेन की उप-इकाइयों पर होने वाली कार्रवाइयां | Google Ads API का इस्तेमाल करके, Local Services के कैंपेन में विज्ञापन ग्रुप, विज्ञापन या शर्तें बनाई नहीं जा सकतीं, उनमें बदलाव नहीं किया जा सकता या उन्हें हटाया जा सकता है. |
Local Services के संसाधन
Google Ads API v15 से, Local Services Ads के कुछ डेटा को रीड-ओनली रिपोर्ट संसाधनों की मदद से, सीधे Google Ads API में दिखाया जाता है:
local_services_lead
local_services_lead_conversation
local_services_verification_artifact
local_services_employee
इन संसाधनों को डेटा दिखाने के लिए यह ज़रूरी है कि अनुरोध करने वाले क्लाइंट खाते में, Local Services का कोई कैंपेन मौजूद हो. हर क्लाइंट खाते के लिए, सिर्फ़ एक Local Services कैंपेन हो सकता है. इसलिए, ये संसाधन किसी कैंपेन के बारे में नहीं बताते. ये संसाधन किस कैंपेन से जुड़े हैं, यह जानने के लिए नीचे दी गई क्वेरी का इस्तेमाल करें:
SELECT campaign.id
FROM campaign
WHERE campaign.advertising_channel_type = 'LOCAL_SERVICES'
Local Services लीड
LocalServicesLead
से आपको लीड की जानकारी मिलती है. यह जानकारी तब जनरेट होती है, जब कोई उपभोक्ता, विज्ञापन देने वाले को कॉल करता है, मैसेज भेजता है या उसकी सेवा बुक करता है.
Local Services का लीड डेटा,
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
, स्वास्थ्य सेवा की कैटगरी का हिस्सा है.
Local Services की लीड के लिए बातचीत
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'
Google Ads API के वर्शन 17 से, LocalServicesLeadService.AppendLeadConversation
वाले तरीके का इस्तेमाल करके, LocalServicesLead
में LocalServicesLeadConversation
संसाधनों को जोड़ा जा सकता है.
सीमाएं
- कॉल रिकॉर्डिंग के यूआरएल को ऐक्सेस करने के लिए, आपको एक ऐसे ईमेल पते से साइन इन करना होगा जिसके पास उस 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
Local Services की मदद से पुष्टि करने का आर्टफ़ैक्ट
LocalServicesVerificationArtifact
, विज्ञापन देने वाले लोगों या कंपनियों के कारोबारों की पुष्टि करने के लिए डेटा उपलब्ध कराता है. ध्यान दें कि ये पुष्टि कारोबार के स्तर पर होती हैं और इनमें कर्मचारियों की पुष्टि शामिल नहीं होती है. डेटा में ये चीज़ें शामिल होती हैं:
- लाइसेंस की पुष्टि
- बीमा की पुष्टि
- बैकग्राउंड की जांच से जुड़ी पुष्टि
- कारोबार के रजिस्ट्रेशन की पुष्टि
Local Services Ads में पुष्टि का अनुरोध सबमिट किए जाने पर, Google Ads API में इसके लिए पुष्टि करने वाला एक नया आर्टफ़ैक्ट इंस्टेंस बनाया जाता है. साथ ही, पुष्टि करने का हर आर्टफ़ैक्ट, पुष्टि करने के एक ही अनुरोध को दिखाता है. पुष्टि करने के हर आर्टफ़ैक्ट में, नीचे दी गई जानकारी शामिल हो सकती है. यह इस बात पर निर्भर करता है कि पुष्टि करने के किस तरह के अनुरोध के बारे में जानकारी दी गई है:
- पुष्टि करने के हर आर्टफ़ैक्ट की स्थिति
- बैकग्राउंड की जांच से जुड़ी पुष्टि के लिए, बैकग्राउंड की जांच का यूआरएल इस्तेमाल करना
- बैकग्राउंड की जांच के लिए फ़ैसला लेने का समय (अगर लागू हो)
- पहले से सबमिट की गई, बीमा से जुड़ी जानकारी देखने के लिए, बीमा के दस्तावेज़ का यूआरएल
- बीमा के अस्वीकार होने की वजह (अगर लागू हो)
- लाइसेंस की जानकारी (टाइप, नंबर, नाम, सरनेम)
- लाइसेंस अस्वीकार होने की वजह (अगर लागू हो)
- पहले से सबमिट की गई लाइसेंस की इमेज देखने के लिए, लाइसेंस के दस्तावेज़ का यूआरएल (अगर लागू हो)
- कारोबार के रजिस्ट्रेशन की जानकारी (आईडी और रजिस्ट्रेशन नंबर देखें)
- कारोबार के रजिस्ट्रेशन के अस्वीकार होने की वजह (अगर लागू हो)
- पहले से सबमिट की गई रजिस्ट्रेशन की इमेज देखने के लिए, कारोबार के रजिस्ट्रेशन के दस्तावेज़ का यूआरएल (अगर लागू हो)
पुष्टि करने के लिए इस्तेमाल होने वाला आर्टफ़ैक्ट का डेटा, 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
Local Services का कर्मचारी
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