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 पर सेट करें.

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

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

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

किसी खास तरह की सेवा के लिए टारगेटिंग चालू करने के लिए, 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, Local Services के अलग से मौजूद कैंपेन (advertising_channel_type = 'LOCAL_SERVICES') बनाने और हटाने की सुविधा को ब्लॉक करता है. v26 से, pmax_campaign_settings.local_services_enabled = true को सेट करके, Local Services के लिए नए परफ़ॉर्मेंस मैक्स कैंपेन (advertising_channel_type = 'PERFORMANCE_MAX') बनाए जा सकते हैं. Local Services के लिए परफ़ॉर्मेंस मैक्स कैंपेन बनाना देखें.
कैंपेन में सब-इकाई पर कार्रवाइयां अलग से मौजूद 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 ने तय किया है. COUPON का इस्तेमाल करके, Local Services और Local Services के परफ़ॉर्मेंस मैक्स कैंपेन में कूपन लीड टाइप को चालू किया जा सकता है. यह सुविधा v26 से उपलब्ध है.

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 के परफ़ॉर्मेंस मैक्स कैंपेन

परफ़ॉर्मेंस मैक्स कैंपेन में, Local Services से जुड़ी सेटिंग का इस्तेमाल v24 से किया जा सकेगा. इन सेटिंग की मदद से, 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 Performance Max कैंपेन के लिए अपडेट की सुविधा देता है जो अनुमति वाली सूची में शामिल खातों ने यूज़र इंटरफ़ेस (यूआई) में बनाए हैं. ज़रूरी शर्तों को कॉन्फ़िगर करने और कैंपेन बनाने के बारे में पूरी जानकारी पाने के लिए, हर लीड के हिसाब से पेमेंट के लक्ष्यों वाले परफ़ॉर्मेंस मैक्स कैंपेन की गाइड देखें.

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 खाते का डेस्टिनेशन नंबर.