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 कैंपेन के लिए, बिडिंग की इन रणनीतियों को स्टैंडर्ड बिडिंग की रणनीति के तौर पर सेट किया जा सकता है:

• ManualCpa फ़ील्ड सेट करके manual_cpa

  LocalServicesCampaignSettings.category_bids की मदद से, ManualCpa की बिड सेट की जा सकती हैं. Campaign.local_services_campaign_settings की मदद से, Local Services कैंपेन के LocalServicesCampaignSettings को वापस पाया जा सकता है और सेट किया जा सकता है.

• MaximizeConversions को maximize_conversions फ़ील्ड सेट करके

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

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

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

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

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

सेवाओं के किसी खास टाइप को टारगेट करना

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

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

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

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

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

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

Local Services के संसाधन

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 फ़ील्ड की वैल्यू शून्य होगी.
• 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 (GLS PMax) दिखाने वाले परफ़ॉर्मेंस मैक्स कैंपेन को कॉन्फ़िगर और पहचाना जा सकता है.

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

v26 से, एपीआई के ज़रिए परफ़ॉर्मेंस मैक्स कैंपेन (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 फ़ील्ड देखें.

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

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

फ़ोन नंबर

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