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 फ़ील्ड अपडेट किए जा सकते हैं.

बिडिंग की रणनीति सेट करना

लोकल सेवाओं के कैंपेन के लिए, बिडिंग की इन रणनीतियों को स्टैंडर्ड बिडिंग रणनीति के तौर पर सेट किया जा सकता है:

विज्ञापन शेड्यूल को कैंपेन के मानदंड के तौर पर सेट करना

कैंपेन के मानदंड के तौर पर, स्थानीय सेवाओं के कैंपेन के लिए विज्ञापन शेड्यूल सेट किया जा सकता है.

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

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

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

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

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

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

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

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

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

यहां दी गई टेबल में बताई गई पाबंदियां, Google Ads API के आने वाले वर्शन में बदल सकती हैं.

इन कार्रवाइयों के लिए यह सुविधा उपलब्ध नहीं है
कैंपेन बनाना और हटाना Google Ads API, Local Services के नए कैंपेन बनाने से रोकता है.
किसी कैंपेन में मौजूद सब-इकाई पर की जाने वाली कार्रवाइयाँ Google Ads API, Local Services कैंपेन में विज्ञापन ग्रुप, विज्ञापनों या शर्तों को बनाने, उनमें बदलाव करने, उन्हें हटाने या वापस पाने की सुविधा नहीं देता.

Local Services के संसाधन

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

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

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

सीमाएं

  • कॉल रिकॉर्डिंग के यूआरएल को ऐक्सेस करने के लिए, आपको उस ईमेल पते से साइन इन करना होगा जिसके पास 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_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'

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

भौगोलिक जगह (खास तौर पर, इलाके के हिसाब से टारगेट करने का कोड) और 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 में, स्थानीय सेवा देने वाले उन कर्मचारियों का डेटा दिखता है जिनकी विज्ञापन प्रोफ़ाइल को विज्ञापन देने वाले लोगों या कंपनियों ने हमारे सिस्टम में अपलोड किया है.

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

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 (जीएलएस पीमैक्स) दिखाने वाला कैंपेन कौन-सा है.

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

लोकल सेवाओं के लिए परफ़ॉर्मेंस मैक्स कैंपेन की पहचान करना

कोई परफ़ॉर्मेंस मैक्स कैंपेन, Local Services कैंपेन है या नहीं, यह जानने के लिए कैंपेन के pmax_campaign_settings पर local_services_enabled फ़ील्ड देखें.

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

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

  • listing_id: कैंपेन से लिंक की गई Google Business Profile लिस्टिंग का आईडी. v26 से, लोकल सेवाओं के लिए परफ़ॉर्मेंस मैक्स कैंपेन बनाते समय यह फ़ील्ड ज़रूरी होगा. साथ ही, इसमें बदलाव नहीं किया जा सकेगा. लिस्टिंग आईडी को खाते से, चालू की गई 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 विज्ञापन के देश का कोड. इस फ़ील्ड में बदलाव नहीं किया जा सकता. इसे विज्ञापन बनाते समय सिर्फ़ एक बार सेट किया जाता है. यह दो अक्षरों वाला देश कोड होता है, जो अंग्रेज़ी के बड़े अक्षरों में लिखा जाता है. इसका इस्तेमाल, पुष्टि करने से जुड़ी ज़रूरी शर्तों को तय करने और जगह के हिसाब से टारगेटिंग की शर्तों की पुष्टि करने के लिए किया जाता है.
  • phone_numbers: सेवा देने वाली कंपनी से जुड़े फ़ोन नंबर की सूची. इसे LocalServicesPhoneNumber मैसेज से दिखाया जाता है.

फ़ोन नंबर

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

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