रिपोर्टिंग

रिपोर्टिंग की सुविधा की मदद से, लिंक किए गए खातों के विज्ञापन की परफ़ॉर्मेंस और लीड की जानकारी वापस पाई जा सकती है.

खाते की रिपोर्ट

खाते की रिपोर्ट में, मैनेजर खाते से लिंक किए गए लोकल सेवाओं वाले खातों की परफ़ॉर्मेंस और मेट्रिक दिखती हैं. इस डेटा को तय की गई समयावधि के हिसाब से देखा जा सकता है. डेटा 30 मिनट तक पुराना हो सकता है.

रिपोर्ट पाने के लिए, https://localservices.googleapis.com/v1/accountReports:search पर एचटीटीपी GET अनुरोध भेजें. इसके साथ, कॉन्फ़िगर किए जा सकने वाले ये यूआरएल पैरामीटर शामिल करें:

यूआरएल पैरामीटर
query

ज़रूरी है

इसमें एक या उससे ज़्यादा आईडी वैल्यू होती हैं. इनमें से एक आईडी, क्वेरी के लिए मैनेजर खाते का आईडी होना चाहिए. query में एक से ज़्यादा वैल्यू डाली जा सकती हैं. हालांकि, इसके लिए आपको हर वैल्यू को सेमीकोलन से अलग करना होगा:

  • ज़रूरी है: manager_customer_id:<manager_cid>
  • ज़रूरी नहीं: customer_id:<linked_cid>

उदाहरण: query=manager_customer_id:123;customer_id:456
startDate.day

वैकल्पिक

महीने का वह दिन जब रिपोर्टिंग अवधि शुरू होती है. इसकी वैल्यू 1 और 31 के बीच हो सकती है. डिफ़ॉल्ट रूप से, यह 1 पर सेट होती है.
startDate.month

वैकल्पिक

रिपोर्टिंग अवधि का शुरुआती महीना. इसकी वैल्यू 1 और 12 के बीच हो सकती है. डिफ़ॉल्ट रूप से, यह मौजूदा महीने पर सेट होता है.
startDate.year

वैकल्पिक

रिपोर्टिंग की अवधि शुरू होने का साल, YYYY फ़ॉर्मैट में. डिफ़ॉल्ट रूप से, यह मौजूदा साल पर सेट होती है.
endDate.day

वैकल्पिक

महीने का वह दिन जब रिपोर्टिंग अवधि खत्म होती है. इसकी वैल्यू 1 और 31 के बीच हो सकती है. डिफ़ॉल्ट रूप से, यह आज की तारीख पर सेट होती है.
endDate.month

वैकल्पिक

रिपोर्टिंग की अवधि खत्म होने का महीना. इसकी वैल्यू 1 और 12 के बीच हो सकती है. डिफ़ॉल्ट रूप से, यह मौजूदा महीने पर सेट होता है.
endDate.year

वैकल्पिक

YYYY फ़ॉर्मैट में, रिपोर्टिंग की अवधि खत्म होने का साल. डिफ़ॉल्ट रूप से, यह मौजूदा साल पर सेट होती है.
pageSize

वैकल्पिक

यह एक पॉज़िटिव पूर्णांक होता है. इससे यह पता चलता है कि कितनी एंट्री दिखानी हैं. डिफ़ॉल्ट रूप से, यह 1000 पर सेट होती है. इसकी ज़्यादा से ज़्यादा वैल्यू 10000 हो सकती है.
pageToken

वैकल्पिक

एक स्ट्रिंग. इस फ़ील्ड में, पिछले जवाब से मिला next_page_token डालें.

पिछली टेबल में मौजूद फ़ील्ड का इस्तेमाल करके, SearchAccountReportsRequest बनाया जाता है. अनुरोध में मौजूद हर ग्राहक आईडी के लिए, SearchAccountReportsResponse में उससे जुड़ा AccountReports शामिल होता है. हर खाता रिपोर्ट, लिंक किए गए उस ग्राहक खाते से मैप होती है जो Local Services विज्ञापन दिखाता है.

यहां दी गई टेबल में, AccountReports में मौजूद फ़ील्ड दिखाए गए हैं:

फ़ील्ड
accountId Local Services खाते से लिंक किया गया ग्राहक आईडी.
businessName ग्राहक के कारोबार का नाम.
averageWeeklyBudget ग्राहक का मौजूदा औसत हफ़्तावार बजट.
averageFiveStarRating पांच स्टार वाली औसत रेटिंग. इसका हिसाब, खरीदार की सभी उपलब्ध समीक्षाओं के आधार पर लगाया जाता है.
totalReview ग्राहक के लिए उपलब्ध समीक्षाओं की कुल संख्या.
impressionsLastTwoDays पिछले दो दिनों में खाते को मिले कुल इंप्रेशन की संख्या.
phoneLeadResponsiveness पिछले 90 दिनों में, फ़ोन कॉल से मिली लीड के लिए खाते की रिस्पॉन्सिवनेस. इसे कैलकुलेट करने के लिए, शुल्क लिए गए फ़ोन कॉल की लीड से कनेक्ट किए गए कॉल की कुल संख्या को मिले कॉल की कुल संख्या से भाग दिया जाता है.
currentPeriodChargedLeads तारीख की चुनी गई सीमा के दौरान, शुल्क वाली लीड की संख्या.
previousPeriodChargedLeads पिछली अवधि में चार्ज की गई लीड की संख्या. उदाहरण के लिए, अगर तारीख की सीमा 21 जनवरी से 30 जनवरी के बीच सेट की गई है, तो पिछली अवधि 11 जनवरी से 20 जनवरी के बीच होगी.
currentPeriodTotalCost तय की गई तारीख की सीमा के दौरान, चार्ज की गई लीड की लागत का योग.
previousPeriodTotalCost पिछली अवधि में चार्ज की गई लीड की लागत का योग. उदाहरण के लिए, अगर तारीख की सीमा 21 जनवरी से 30 जनवरी के बीच सेट की गई है, तो पिछली अवधि 11 जनवरी से 20 जनवरी के बीच होगी.
currencyCode ग्राहक खाते का मुद्रा कोड.
currentPeriodPhoneCalls तय की गई तारीख की सीमा के दौरान किए गए फ़ोन कॉल की संख्या. इसमें कनेक्ट हुए और कनेक्ट न हुए, दोनों तरह के कॉल शामिल हैं.
previousPeriodPhoneCalls पिछले समय में किए गए फ़ोन कॉल की संख्या. इसमें कनेक्ट हुए और कनेक्ट न हुए, दोनों तरह के कॉल शामिल हैं.
currentPeriodConnectedPhoneCalls तय की गई तारीख की सीमा में, 30 सेकंड से ज़्यादा अवधि वाली कनेक्ट की गई फ़ोन कॉल की संख्या.
previousPeriodConnectedPhoneCalls पिछली अवधि में, 30 सेकंड से ज़्यादा अवधि वाले कनेक्ट किए गए फ़ोन कॉल की संख्या.

उदाहरण

एचटीटीपी अनुरोध का यूआरएल

https://localservices.googleapis.com/v1/accountReports:search?query=manager_customer_id:{manager_customer_id}

एचटीटीपी अनुरोध का पूरा सैंपल

GET /v1/accountReports:search?query=manager_customer_id:{manager_customer_id} HTTP/1.1
Host: localservices.googleapis.com
User-Agent: curl
Content-Type: application/json
Accept: application/json
Authorization: Bearer [Enter OAuth 2.0 access token here]

लीड की ज़्यादा जानकारी वाली रिपोर्ट

लीड की पूरी जानकारी वाली रिपोर्ट में, मैनेजर खाते से लिंक किए गए Local Services खातों से जुड़ी लीड की पूरी जानकारी दिखती है. इस डेटा को तय की गई समयावधि के हिसाब से देखा जा सकता है. तय की गई समयावधि के लिए, रिपोर्ट में बनाई गई लीड या ऐसी लीड शामिल होती हैं जिनके विवाद की स्थिति अपडेट की गई है. डेटा 30 मिनट तक पुराना हो सकता है.

रिपोर्ट पाने के लिए, https://localservices.googleapis.com/v1/detailedLeadReports:search पर एचटीटीपी GET अनुरोध भेजें. इसके साथ, कॉन्फ़िगर किए जा सकने वाले ये यूआरएल पैरामीटर शामिल करें:

यूआरएल पैरामीटर
query

ज़रूरी है

इसमें एक या उससे ज़्यादा आईडी वैल्यू होती हैं. इनमें से एक आईडी, क्वेरी के लिए मैनेजर खाते का आईडी होना चाहिए. query में एक से ज़्यादा वैल्यू डाली जा सकती हैं. हालांकि, इसके लिए आपको हर वैल्यू को सेमीकोलन से अलग करना होगा:

  • ज़रूरी है: manager_customer_id:<manager_cid>
  • ज़रूरी नहीं: customer_id:<linked_cid>

उदाहरण: query=manager_customer_id:123;customer_id:456
startDate.day

वैकल्पिक

महीने का वह दिन जब रिपोर्टिंग अवधि शुरू होती है. इसकी वैल्यू 1 और 31 के बीच हो सकती है. डिफ़ॉल्ट रूप से, यह 1 पर सेट होती है.
startDate.month

वैकल्पिक

रिपोर्टिंग अवधि का शुरुआती महीना. इसकी वैल्यू 1 और 12 के बीच हो सकती है. डिफ़ॉल्ट रूप से, यह मौजूदा महीने पर सेट होता है.
startDate.year

वैकल्पिक

रिपोर्टिंग की अवधि शुरू होने का साल, YYYY फ़ॉर्मैट में. डिफ़ॉल्ट रूप से, यह मौजूदा साल पर सेट होती है.
endDate.day

वैकल्पिक

महीने का वह दिन जब रिपोर्टिंग अवधि खत्म होती है. इसकी वैल्यू 1 और 31 के बीच हो सकती है. डिफ़ॉल्ट रूप से, यह आज की तारीख पर सेट होती है.
endDate.month

वैकल्पिक

रिपोर्टिंग की अवधि खत्म होने का महीना. इसकी वैल्यू 1 और 12 के बीच हो सकती है. डिफ़ॉल्ट रूप से, यह मौजूदा महीने पर सेट होता है.
endDate.year

वैकल्पिक

YYYY फ़ॉर्मैट में, रिपोर्टिंग की अवधि खत्म होने का साल. डिफ़ॉल्ट रूप से, यह मौजूदा साल पर सेट होती है.
pageSize

वैकल्पिक

यह एक पॉज़िटिव पूर्णांक होता है. इससे यह पता चलता है कि कितनी एंट्री दिखानी हैं. डिफ़ॉल्ट रूप से, यह 1000 पर सेट होती है. इसकी ज़्यादा से ज़्यादा वैल्यू 10000 हो सकती है.
pageToken

वैकल्पिक

एक स्ट्रिंग. इस फ़ील्ड में, पिछले जवाब से मिला next_page_token डालें.

पिछले फ़ील्ड का इस्तेमाल करके SearchDetailedLeadReportsRequest बनाया जाता है. अनुरोध में मौजूद हर ग्राहक आईडी के लिए, DetailedLeadReports को SearchDetailedLeadReportsResponse में शामिल किया जाता है. ज़्यादा जानकारी वाली हर लीड रिपोर्ट, किसी ऐसी लीड से मैप होती है जो लिंक किए गए किसी ऐसे ग्राहक खाते से जुड़ी होती है जो Local Services विज्ञापन दिखाता है.

यहां दी गई टेबल में, DetailedLeadReports में मौजूद फ़ील्ड दिखाए गए हैं:

फ़ील्ड
leadId लीड का यूनीक आइडेंटिफ़ायर.
accountId इस कुकी से उस खाते की पहचान होती है जिसे लीड मिली है.
businessName खाते से जुड़ा कारोबार का नाम.
leadCreationTimestamp

लीड बनाए जाने का टाइमस्टैंप. इसमें तारीख M/D/YYYY फ़ॉर्मैट में और समय HH:MM:SS फ़ॉर्मैट में शामिल होता है.

उदाहरण: 11/1/2019 12:13:20
leadType लीड का टाइप: MESSAGE या PHONE_CALL.
leadCategory

लीड से जुड़ी सेवा की कैटगरी.

उदाहरण: housecleaner
geo

जुड़े हुए खाते के होम सिटी की लोकेशन.

उदाहरण: San Francisco, California, United States
messageLead सिर्फ़ मैसेज लीड से जुड़ी जानकारी: customerName, jobType, postalCode, और consumerPhoneNumber.
phoneLead सिर्फ़ फ़ोन कॉल से मिली लीड से जुड़ी जानकारी: chargedCallTimestamp, chargedConnectedCallDurationSeconds, और consumerPhoneNumber.
bookingLead सिर्फ़ बुकिंग से मिलने वाली लीड से जुड़ी जानकारी: customerName, consumerPhoneNumber, jobType, consumerEmail, और bookingAppointmentTimestamp.
chargeStatus लीड के लिए शुल्क लिया गया है या नहीं. यह true या false हो सकता है.
currencyCode उस खाते का मुद्रा कोड जिसके लिए लीड बनाई गई थी.
disputeStatus लीड के विवाद की स्थिति.
aggregatorInfo

तीसरे पक्ष के एग्रीगेटर पार्टनर के लिए खास जानकारी. यह फ़ील्ड, सिर्फ़ उन एपीआई क्लाइंट के लिए भरा जाता है जो तीसरे पक्ष के एग्रीगेटर पार्टनर से जुड़े हैं.
timezone लीड से जुड़े खाते का टाइमज़ोन. यह आईएएनए टाइम ज़ोन डेटाबेस फ़ॉर्मैट में दिया गया है.

उदाहरण

एचटीटीपी अनुरोध का यूआरएल

https://localservices.googleapis.com/v1/detailedLeadReports:search?query=manager_customer_id:{manager_customer_id}

एचटीटीपी अनुरोध का पूरा सैंपल

GET /v1/detailedReports:search?query=manager_customer_id:{manager_customer_id} HTTP/1.1
Host: localservices.googleapis.com
User-Agent: curl
Content-Type: application/json
Accept: application/json
Authorization: Bearer [Enter OAuth 2.0 access token here]