इस गाइड में, Google Analytics Data API v1 में कन्वर्ज़न रिपोर्टिंग की सुविधा इस्तेमाल करने का तरीका बताया गया है. इस सुविधा की मदद से, अलग-अलग एट्रिब्यूशन मॉडल के साथ कन्वर्ज़न इवेंट पर फ़ोकस करने वाली रिपोर्ट जनरेट की जा सकती हैं. Data API की मदद से बनाई गई कन्वर्ज़न रिपोर्ट, एट्रिब्यूशन रिपोर्ट की तरह होती हैं. ये रिपोर्ट, आपको Google Analytics यूज़र इंटरफ़ेस (यूआई) के विज्ञापन > कन्वर्ज़न सेक्शन में मिल सकती हैं. ज़्यादा जानकारी के लिए, कन्वर्ज़न परफ़ॉर्मेंस रिपोर्ट के बारे में सहायता केंद्र का लेख पढ़ें.
कन्वर्ज़न रिपोर्टिंग का मकसद
कन्वर्ज़न रिपोर्टिंग की मदद से, अपने मार्केटिंग कैंपेन की परफ़ॉर्मेंस का विश्लेषण किया जा सकता है. इसके लिए, कन्वर्ज़न को अलग-अलग कैंपेन, सोर्स, और मीडियम के हिसाब से एट्रिब्यूट किया जाता है. स्टैंडर्ड इवेंट-आधारित रिपोर्ट सिर्फ़ इवेंट को गिनती हैं. वहीं, कन्वर्ज़न रिपोर्टिंग, एट्रिब्यूशन मॉडल लागू करती है, ताकि कन्वर्ज़न पर ले जाने वाले टचपॉइंट के बीच क्रेडिट को बांटा जा सके.
कन्वर्ज़न बनाम इवेंट पर आधारित रिपोर्ट
- इवेंट पर आधारित रिपोर्ट: इनमें इवेंट की कुल संख्या (जैसे,
eventCount) दिखती है. ये रिपोर्ट, आपकी प्रॉपर्टी पर होने वाली सामान्य गतिविधि को समझने के लिए काम की होती हैं. - कन्वर्ज़न रिपोर्ट: उन इवेंट पर फ़ोकस करें जिन्हें कन्वर्ज़न के तौर पर मार्क किया गया है. ये खास डाइमेंशन और मेट्रिक का इस्तेमाल करते हैं. कन्वर्ज़न रिपोर्ट का स्कीमा देखें. साथ ही, ये आपको डेटा-ड्रिवन या लास्ट क्लिक जैसे मॉडल के आधार पर एट्रिब्यूट किया गया डेटा देखने की अनुमति देते हैं.
कन्वर्ज़न रिपोर्ट चालू करना
कन्वर्ज़न रिपोर्ट जनरेट करने के लिए, runReport तरीके का इस्तेमाल करें. किसी अनुरोध को कन्वर्ज़न रिपोर्ट माना जाता है. ऐसा तब होता है, जब वह एक या उससे ज़्यादा कन्वर्ज़न मेट्रिक (उदाहरण के लिए, allConversionsByInteractionDate) के लिए क्वेरी करता है या अनुरोध के मुख्य हिस्से में conversionSpec फ़ील्ड भरा जाता है.
conversionSpec ऑब्जेक्ट में ये फ़ील्ड शामिल होते हैं:
conversionActions: रिपोर्ट में शामिल करने के लिए, कन्वर्ज़न ऐक्शन के संसाधन नामों की सूची (उदाहरण के लिए,["conversionActions/12345"]). अगर यह खाली है, तो सभी कन्वर्ज़न शामिल किए जाते हैं. मान्य कन्वर्ज़न ऐक्शन आईडी,GetMetadataतरीके के जवाब मेंconversionsसूची में मौजूदconversion_actionफ़ील्ड से वापस पाए जा सकते हैं.attributionModel: इस्तेमाल किया जाने वाला एट्रिब्यूशन मॉडल.DATA_DRIVEN(डिफ़ॉल्ट) औरLAST_CLICKको वैल्यू के तौर पर इस्तेमाल किया जा सकता है.
कन्वर्ज़न रिपोर्ट जनरेट करना
यहां runReport
मेथड का इस्तेमाल करके, कन्वर्ज़न रिपोर्ट जनरेट करने का एक सैंपल अनुरोध दिया गया है. इस रिपोर्ट में, डेटा-ड्रिवन एट्रिब्यूशन मॉडल का इस्तेमाल करके, कैंपेन के नाम के हिसाब से कन्वर्ज़न दिखाए गए हैं.
HTTP
{ "dateRanges": [ { "startDate": "2026-04-01", "endDate": "2026-04-30" } ], "dimensions": [ { "name": "campaignName" } ], "metrics": [ { "name": "allConversionsByConversionDate" } ], "conversionSpec": { "conversionActions": [], "attributionModel": "DATA_DRIVEN" } }
उदाहरण: कन्वर्ज़न परफ़ॉर्मेंस रिपोर्ट को फिर से बनाना
इस उदाहरण में बताया गया है कि किसी प्रॉपर्टी के लिए उपलब्ध कन्वर्ज़न ऐक्शन को पहले कैसे वापस पाया जाए. इसके बाद, उनका इस्तेमाल करके कन्वर्ज़न परफ़ॉर्मेंस रिपोर्ट जैसी रिपोर्ट कैसे बनाई जाए. यह रिपोर्ट, Google Analytics के यूज़र इंटरफ़ेस (यूआई) में विज्ञापन > कन्वर्ज़न > कन्वर्ज़न परफ़ॉर्मेंस में दिखती है.
पहला चरण: कन्वर्ज़न ऐक्शन वापस पाना
अपनी प्रॉपर्टी के लिए मान्य कन्वर्ज़न ऐक्शन आईडी ढूंढने के लिए, getMetadata तरीके का इस्तेमाल करें. अपनी प्रॉपर्टी के लिए बनाए गए कन्वर्ज़न ऐक्शन देखने के लिए, पक्का करें कि आपने GA प्रॉपर्टी आईडी डाला हो. इसके बजाय, 0 का इस्तेमाल करके सभी प्रॉपर्टी के लिए सामान्य फ़ील्ड पाने का विकल्प न चुनें.
जवाब में, उपलब्ध कन्वर्ज़न कार्रवाइयों की conversions सूची दी गई है:
{
...
"conversions": [
{
"conversionAction": "conversionActions/12345",
"displayName": "purchase"
},
{
"conversionAction": "conversionActions/67890",
"displayName": "sign_up"
}
]
}
दूसरा चरण: रिपोर्ट जनरेट करना
runReport तरीके को कॉल करें.
अपनी रिपोर्ट को फ़िल्टर करने के लिए, पहले चरण में मिले कन्वर्ज़न ऐक्शन आईडी का इस्तेमाल करें. इसके अलावा, सभी कन्वर्ज़न की रिपोर्ट बनाने के लिए, conversionActions को खाली छोड़ दें. इस अनुरोध में, कन्वर्ज़न परफ़ॉर्मेंस की यूज़र इंटरफ़ेस (यूआई) रिपोर्ट को फिर से बनाया गया है. इसमें विज्ञापन पर हुए क्लिक, विज्ञापन की लागत, विज्ञापन पर हर क्लिक की लागत, सभी कन्वर्ज़न के हिसाब से विज्ञापन की लागत, विज्ञापन के इंप्रेशन, विज्ञापन खर्च पर रिटर्न, कुल रेवेन्यू, और डिफ़ॉल्ट चैनल ग्रुप के हिसाब से सभी कन्वर्ज़न दिखाए गए हैं.
HTTP
{ "dateRanges": [ { "startDate": "2026-04-01", "endDate": "2026-04-30" } ], "dimensions": [ { "name": "defaultChannelGroup" } ], "metrics": [ { "name": "allConversionsByInteractionDate" }, { "name": "advertiserAdCost" }, { "name": "advertiserAdCostPerAllConversionsByInteractionDate" }, { "name": "advertiserAdImpressions" }, { "name": "advertiserAdClicks" }, { "name": "advertiserAdCostPerClick" }, { "name": "totalRevenueByInteractionDate" }, { "name": "returnOnAdSpendByInteractionDate" } ], "conversionSpec": { "conversionActions": [ "conversionActions/12345" ], "attributionModel": "DATA_DRIVEN" } }
इस अनुरोध के लिए, यहां जवाब का एक सैंपल दिया गया है:
{
"dimensionHeaders": [
{
"name": "defaultChannelGroup"
}
],
"metricHeaders": [
{
"name": "allConversionsByInteractionDate",
"type": "TYPE_FLOAT"
},
{
"name": "advertiserAdCost",
"type": "TYPE_CURRENCY"
},
{
"name": "advertiserAdCostPerAllConversionsByInteractionDate",
"type": "TYPE_CURRENCY"
},
{
"name": "advertiserAdImpressions",
"type": "TYPE_INTEGER"
},
{
"name": "advertiserAdClicks",
"type": "TYPE_INTEGER"
},
{
"name": "advertiserAdCostPerClick",
"type": "TYPE_CURRENCY"
},
{
"name": "totalRevenueByInteractionDate",
"type": "TYPE_CURRENCY"
},
{
"name": "returnOnAdSpendByInteractionDate",
"type": "TYPE_FLOAT"
}
],
"rows": [
{
"dimensionValues": [
{
"value": "Paid Search"
}
],
"metricValues": [
{
"value": "75.2"
},
{
"value": "500"
},
{
"value": "6.65"
},
{
"value": "10000"
},
{
"value": "500"
},
{
"value": "1"
},
{
"value": "1500"
},
{
"value": "3"
}
]
}
],
"rowCount": 1,
"metadata": {
"schemaRestrictionResponse": {},
"currencyCode": "USD",
"timeZone": "America/Los_Angeles",
"section": "SECTION_ADVERTISING"
},
"kind": "analyticsData#runReport"
}
इस बात की पुष्टि की जा सकती है कि जवाब को कन्वर्ज़न रिपोर्ट के तौर पर माना गया है या नहीं. इसके लिए, यह देखें कि जवाब में metadata.section फ़ील्ड को SECTION_ADVERTISING पर सेट किया गया है या नहीं.
कन्वर्ज़न रिपोर्ट के लिए उपलब्ध डाइमेंशन और मेट्रिक की पूरी सूची देखने के लिए, कन्वर्ज़न रिपोर्ट का स्कीमा देखें.