Local Services कैंपेन

Local Services कैंपेन की मदद से, Google पर अपने कारोबार का विज्ञापन दिया जा सकता है. इससे आपको सीधे संभावित ग्राहकों की लीड मिल सकती है. इस गाइड में, Google Ads API में इस्तेमाल किए जा सकने वाले ऑपरेशन और पाबंदियों के बारे में बताया गया है.

इन कार्रवाइयों के लिए यह सुविधा उपलब्ध है

Google Ads API, Local Services कैंपेन के लिए इन कार्रवाइयों के साथ काम करता है.

Local Services कैंपेन और बजट की जानकारी पाना

Local Services कैंपेन और बजट को वापस पाने के लिए, GoogleAdsService.Search या GoogleAdsService.SearchStream तरीके का इस्तेमाल करके, Campaign संसाधनों के लिए क्वेरी की जा सकती है. यहां 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 कैंपेन के लिए, विज्ञापन शेड्यूल को कैंपेन की शर्त के तौर पर सेट किया जा सकता है.

AdScheduleInfo बनाएं और उसे CampaignCriterionService.MutateCampaignCriteria का इस्तेमाल करके, Google Ads API को भेजे गए CampaignCriterion के ad_schedule पर सेट करें.

जगह के हिसाब से टारगेटिंग सेट करना

Local Services कैंपेन के लिए जगह के हिसाब से टारगेटिंग की सुविधा चालू करने के लिए, LocationInfo जोड़ें. साथ ही, इसे CampaignCriterionService.MutateCampaignCriteria का इस्तेमाल करके, Google Ads API को भेजे गए CampaignCriterion के location फ़ील्ड पर सेट करें. ज़्यादा जानकारी के लिए, जगह के हिसाब से टारगेटिंग लेख पढ़ें.

सेवा के खास टाइप टारगेट करना

किसी खास तरह की सेवा के लिए टारगेटिंग चालू करने के लिए, Local Services की कैटगरी आईडी में से किसी एक का इस्तेमाल करके, LocalServiceIdInfo बनाएं. इसके बाद, इसे CampaignCriterion के local_service_id फ़ील्ड पर सेट करें और CampaignCriterionService.MutateCampaignCriteria का इस्तेमाल करके सबमिट करें.

आपको ऐसे सेवा आईडी का इस्तेमाल करना चाहिए जो आपके कैंपेन की टारगेट की गई जगह और कैटगरी से मेल खाता हो.

लीड के बारे में सुझाव/राय सबमिट करना

किसी लीड के लिए रेटिंग और सुझाव सबमिट करने के लिए, LocalServicesLeadService के ProvideLeadFeedback तरीके का इस्तेमाल करें. LocalServicesLead के lead_feedback_submitted फ़ील्ड की जांच करके भी यह पता लगाया जा सकता है कि लीड को रेटिंग दी गई थी और सुझाव सबमिट किया गया था या नहीं.

इन कार्रवाइयों के लिए यह सुविधा उपलब्ध नहीं है

यहां दी गई टेबल में, Local Services के स्टैंडअलोन कैंपेन (advertising_channel_type = 'LOCAL_SERVICES') के लिए काम न करने वाले ऑपरेशन की सूची दी गई है.

इन कार्रवाइयों के लिए यह सुविधा उपलब्ध नहीं है
कैंपेन बनाना और हटाना Google Ads API, लोकल सर्विसेज़ के स्टैंडअलोन कैंपेन (advertising_channel_type = 'LOCAL_SERVICES') बनाने और हटाने की सुविधा को ब्लॉक करता है. v26 से, pmax_campaign_settings.local_services_enabled = true को सेट करके, लोकल सर्विसेज़ के लिए नए परफ़ॉर्मेंस मैक्स कैंपेन (advertising_channel_type = 'PERFORMANCE_MAX') बनाए जा सकते हैं. इसके बारे में ज़्यादा जानने के लिए, लोकल सर्विसेज़ के लिए परफ़ॉर्मेंस मैक्स कैंपेन बनाना लेख पढ़ें.
कैंपेन में सब-एंटिटी पर कार्रवाइयां अलग से मौजूद Local Services कैंपेन (advertising_channel_type = 'LOCAL_SERVICES') के लिए, Google Ads API, विज्ञापन ग्रुप, विज्ञापनों या शर्तों को बनाने, उनमें बदलाव करने, उन्हें हटाने या वापस लाने की सुविधा नहीं देता. हालांकि, इस्तेमाल किए जा सकने वाले ऑपरेशन में दी गई कैंपेन की शर्तों को बनाने, उनमें बदलाव करने, उन्हें हटाने या वापस लाने की सुविधा देता है. Local Services के परफ़ॉर्मेंस मैक्स कैंपेन के लिए, ऐसेट ग्रुप और कैंपेन की शर्तें इस्तेमाल करें.

Local Services के संसाधन

Local Services Ads का कुछ डेटा, Google Ads API में सीधे तौर पर दिखता है. यह डेटा, रीड-ओनली रिपोर्ट के इन संसाधनों के ज़रिए दिखता है:

इन रिसॉर्स से डेटा पाने के लिए, अनुरोध करने वाले क्लाइंट खाते में Local Services कैंपेन या Local Services के लिए परफ़ॉर्मेंस मैक्स कैंपेन होना चाहिए. local_services_lead.campaign फ़ील्ड, लीड रिकॉर्ड को उनसे जुड़े कैंपेन से लिंक करता है. इसमें हर लीड के पेमेंट के लक्ष्यों के लिए परफ़ॉर्मेंस मैक्स कैंपेन भी शामिल हैं, जहां campaign.advertising_channel_type = 'PERFORMANCE_MAX' और campaign.pmax_campaign_settings.local_services_enabled = true. इन संसाधनों से जुड़े कैंपेन की पहचान करने के लिए, इस क्वेरी का इस्तेमाल करें:

SELECT
  campaign.id,
  campaign.advertising_channel_type,
  campaign.pmax_campaign_settings.local_services_enabled
FROM campaign
WHERE campaign.advertising_channel_type IN ('LOCAL_SERVICES', 'PERFORMANCE_MAX')

Local Services से मिली लीड

LocalServicesLead से उस लीड की जानकारी मिलती है जो तब जनरेट होती है, जब कोई उपभोक्ता, विज्ञापन देने वाले व्यक्ति या कंपनी को कॉल करता है, मैसेज भेजता है, कोई सेवा बुक करता है या कूपन का इस्तेमाल करता है.

लीड टाइप को LocalServicesLeadType ने तय किया है. v26 से, COUPON का इस्तेमाल करके Local Services और Local Services के परफ़ॉर्मेंस मैक्स कैंपेन में, कूपन लीड टाइप चालू किए जा सकते हैं.

campaign फ़ील्ड, लीड रिकॉर्ड को उससे जुड़े कैंपेन से लिंक करता है. एट्रिब्यूट किए गए campaign फ़ील्ड (जैसे कि campaign.id और campaign.name) चुनने के अलावा, लीड क्वेरी को कैंपेन के रिसॉर्स नेम (WHERE local_services_lead.campaign = ...) या विज्ञापन चैनल टाइप (WHERE campaign.advertising_channel_type = ...) के हिसाब से फ़िल्टर किया जा सकता है. इससे लीड को कैंपेन टाइप के हिसाब से सेगमेंट किया जा सकता है.

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,
  local_services_lead.campaign
FROM local_services_lead

सीमाएं

  • अगर lead_status की वैल्यू WIPED_OUT के बराबर है, तो contact_details फ़ील्ड की वैल्यू शून्य होगी.
  • v25 से, ContactDetails.email को हटा दिया गया है और ContactDetails.phone_number_extension, local_services_lead.contact_details से मिले ContactDetails मैसेज पर उपलब्ध है.
  • उन लीड का डेटा उपलब्ध नहीं है जिनमें 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'

LocalServicesLeadService.AppendLeadConversation तरीके का इस्तेमाल करके, LocalServicesLeadConversation संसाधनों को LocalServicesLead में जोड़ा जा सकता है.

सीमाएं

  • कॉल रिकॉर्डिंग का यूआरएल ऐक्सेस करने के लिए, आपको उस ईमेल पते से साइन इन करना होगा जिसके पास 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_conversation.lead = 'customers/CUSTOMER_ID/localServicesLeads/LEAD_ID'

पुष्टि करने के लिए आर्टफ़ैक्ट

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_override_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'

जगह और कैटगरी के हिसाब से, पहचान की पुष्टि के लिए सबमिट किया गया डेटा

भौगोलिक जगह (खास तौर पर, इलाके के हिसाब से टारगेट करने का कोड) और Local Services की कैटगरी के आईडी के हिसाब से, पुष्टि के अनुरोधों की स्थिति का पता लगाने के लिए, customer संसाधन पर local_services_settings फ़ील्ड का इस्तेमाल किया जा सकता है. इसका टाइप LocalServicesSettings है.

इस फ़ील्ड में, लाइसेंस और बीमा की पुष्टि के अनुरोधों की स्थिति की खास जानकारी दी जाती है. यह जानकारी, जगह और कैटगरी के हिसाब से दी जाती है. यहां एक क्वेरी का उदाहरण दिया गया है, जो इस तरह का सारा डेटा वापस लाती है:

SELECT
  customer.local_services_settings.granular_license_statuses,
  customer.local_services_settings.granular_insurance_statuses
FROM customer

Local Services का कर्मचारी

LocalServicesEmployee से, स्थानीय सेवा देने वाले कर्मचारियों का वह डेटा दिखता है जिसे विज्ञापन देने वाले लोगों या कंपनियों ने हमारे सिस्टम में अपनी विज्ञापन प्रोफ़ाइल में अपलोड किया है.

यहां एक क्वेरी का उदाहरण दिया गया है. इससे किसी क्लाइंट खाते के लिए, Local Services के सभी कर्मचारियों का डेटा वापस पाया जा सकता है:

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

Local Services के परफ़ॉर्मेंस मैक्स कैंपेन

v24 से, परफ़ॉर्मेंस मैक्स कैंपेन में Local Services से जुड़ी सेटिंग इस्तेमाल की जा सकेंगी. इन सेटिंग की मदद से, Local Services Ads (GLS PMax) दिखाने वाले परफ़ॉर्मेंस मैक्स कैंपेन को कॉन्फ़िगर और पहचाना जा सकता है.

Local Services के लिए परफ़ॉर्मेंस मैक्स कैंपेन बनाना

v26 से, Google Ads API का इस्तेमाल करके, Local Services के लिए परफ़ॉर्मेंस मैक्स कैंपेन बनाए और अपडेट किए जा सकते हैं. एपीआई का इस्तेमाल करके, Local Services के लिए नए परफ़ॉर्मेंस मैक्स कैंपेन बनाए जा सकते हैं. इसके लिए, परफ़ॉर्मेंस मैक्स कैंपेन (advertising_channel_type = 'PERFORMANCE_MAX') बनाएं और pmax_campaign_settings पर local_services_enabled = true सेट करें. कैंपेन बनाने के बाद, इसे बदला नहीं जा सकता. Local Services के लिए परफ़ॉर्मेंस मैक्स कैंपेन बनाते समय, local_services_pmax_campaign_settings में country_code और listing_id, दोनों ज़रूरी हैं. v24 और v25 में, एपीआई सिर्फ़ उन मौजूदा लोकल सर्विसेज़ परफ़ॉर्मेंस मैक्स कैंपेन के लिए अपडेट की सुविधा देता है जिन्हें अनुमति वाली सूची में शामिल खातों ने यूज़र इंटरफ़ेस (यूआई) में बनाया है. ज़रूरी शर्तों को कॉन्फ़िगर करने और कैंपेन बनाने के बारे में पूरी जानकारी पाने के लिए, हर लीड के हिसाब से पेमेंट के लक्ष्यों वाले परफ़ॉर्मेंस मैक्स कैंपेन की गाइड देखें.

Local Services के परफ़ॉर्मेंस मैक्स कैंपेन की पहचान करना

कोई परफ़ॉर्मेंस मैक्स कैंपेन, Local Services कैंपेन है या नहीं, यह जानने के लिए कैंपेन के pmax_campaign_settings पर local_services_enabled फ़ील्ड देखें. यह फ़ील्ड, एक ऐसा बूलियन (CREATE ONLY) है जिसमें बदलाव नहीं किया जा सकता. कैंपेन बनाते समय, इसे true पर सेट किया जाता है.

सेटिंग कॉन्फ़िगर करें

जिन कैंपेन में local_services_enabled, true पर सेट है उनके लिए, local_services_pmax_campaign_settings फ़ील्ड में जाकर सेटिंग कॉन्फ़िगर करें:

  • listing_id: कैंपेन से लिंक की गई Google Business Profile लिस्टिंग का आईडी. v26 से, Local Services के परफ़ॉर्मेंस मैक्स कैंपेन बनाते समय यह फ़ील्ड ज़रूरी है और इसमें बदलाव नहीं किया जा सकता. लिस्टिंग आईडी को खाते से, चालू की गई LOCATION ऐसेट के तौर पर लिंक किया जाना चाहिए. ऐसा न होने पर, एपीआई CampaignError.INVALID_LOCAL_SERVICES_PERFORMANCE_MAX_LISTING_ID गड़बड़ी दिखाता है. listing_id को IMMUTABLE के तौर पर मार्क किया गया है. इसलिए, कैंपेन बनाने के बाद इस फ़ील्ड को अपडेट करने की कोशिश करने पर, RequestError.IMMUTABLE_FIELD गड़बड़ी का मैसेज दिखता है. डेवलपर, लिंक किए गए लिस्टिंग आईडी का पता लगा सकते हैं या उनकी पुष्टि कर सकते हैं. इसके लिए, उन्हें चालू की गई LOCATION ऐसेट के लिए Asset रिसॉर्स को क्वेरी करना होगा. साथ ही, location_asset.business_profile_locations की जांच करनी होगी. ज़्यादा जानकारी के लिए, लोकेशन ऐसेट देखें.
  • navigational_query_leads_enabled: इससे यह तय होता है कि नेविगेशनल क्वेरी फ़िल्टर का इस्तेमाल करना है या नहीं.
  • founding_year: कारोबार की स्थापना का साल.
  • country_code: Local Services विज्ञापन के देश का कोड. v26 से, यह फ़ील्ड ज़रूरी है और इसे बदला नहीं जा सकता. इसे कैंपेन बनाते समय एक बार सेट किया जाता है. यह दो अक्षरों वाला देश का कोड होता है, जो अंग्रेज़ी के बड़े अक्षरों में लिखा जाता है. फ़िलहाल, Local Services के परफ़ॉर्मेंस मैक्स कैंपेन के लिए, सिर्फ़ US का इस्तेमाल किया जा सकता है. इसका इस्तेमाल, पुष्टि करने से जुड़ी ज़रूरी शर्तों को तय करने और जगह की जानकारी की शर्त की पुष्टि करने के लिए किया जाता है.
  • phone_numbers: सेवा देने वाली कंपनी से जुड़े फ़ोन नंबर की सूची. इसे LocalServicesPhoneNumber मैसेज से दिखाया जाता है. अगर इसे शामिल नहीं किया जाता है, तो कॉल नंबर, लिंक की गई Google Business Profile लिस्टिंग में मौजूद फ़ोन नंबर पर डिफ़ॉल्ट रूप से सेट हो जाता है. अगर Business Profile लिस्टिंग में कोई फ़ोन नंबर नहीं है, तो इसे शामिल करना ज़रूरी है.

फ़ोन नंबर

phone_numbers दोहराया गया फ़ील्ड में मौजूद हर एंट्री, इन फ़ील्ड के साथ LocalServicesPhoneNumber मैसेज टाइप का इस्तेमाल करती है:

  • phone_number: फ़ोन नंबर.
  • country_code: दो अक्षरों वाला देश का कोड, जो अपरकेस में हो.
  • phone_number_type: फ़ोन नंबर का टाइप, जिसे GlsPhoneNumberTypeEnum.GlsPhoneNumberType ने तय किया है. इन फ़ाइल टाइप का इस्तेमाल किया जा सकता है:
    • DESTINATION_PHONE_NUMBER_FOR_ADS: Local Services की विज्ञापन यूनिट से आने वाले कॉल के लिए इस्तेमाल किया जाने वाला डेस्टिनेशन नंबर (कॉल लीड के लिए, डिफ़ॉल्ट).
    • DESTINATION_PHONE_NUMBER_FOR_SMS_ONLY: डेस्टिनेशन नंबर, जिस पर एसएमएस भेजा जा सकता है (ज़रूरी नहीं, मैसेज लीड की एसएमएस सूचनाओं के लिए).
    • DESTINATION_PHONE_NUMBER_FOR_WHATSAPP_ONLY: सेवा देने वाली कंपनी के WhatsApp खाते का डेस्टिनेशन नंबर.