कन्वर्ज़न रिपोर्टिंग से जुड़ी बुनियादी बातें

इस गाइड में, Google Analytics Data API v1 में कन्वर्ज़न रिपोर्टिंग की सुविधा का इस्तेमाल करने का तरीका बताया गया है. इस सुविधा की मदद से, अलग-अलग एट्रिब्यूशन मॉडल के साथ, कन्वर्ज़न इवेंट पर फ़ोकस करने वाली रिपोर्ट जनरेट की जा सकती हैं. Data API की मदद से बनाई गई कन्वर्ज़न रिपोर्ट, Google Analytics यूज़र इंटरफ़ेस (यूआई) के विज्ञापन > कन्वर्ज़न सेक्शन में मौजूद एट्रिब्यूशन रिपोर्ट जैसी होती हैं . ज़्यादा जानकारी के लिए, कन्वर्ज़न परफ़ॉर्मेंस रिपोर्ट के बारे में जानकारी देने वाला सहायता केंद्र का लेख देखें.

कन्वर्ज़न रिपोर्टिंग का मकसद

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

कन्वर्ज़न रिपोर्ट बनाम इवेंट-आधारित रिपोर्ट

कन्वर्ज़न रिपोर्ट की सुविधा चालू करना

कन्वर्ज़न रिपोर्ट चलाने के लिए, 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"
    }
  ]
}

दूसरा चरण: रिपोर्ट चलाना

Call the 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 पर सेट है या नहीं.

कन्वर्ज़न रिपोर्ट के लिए उपलब्ध डाइमेंशन और मेट्रिक की पूरी सूची देखने के लिए, कन्वर्ज़न रिपोर्ट का स्कीमा देखें.