Search Ads 360 Reporting API के पुराने वर्शन को बंद किया जा रहा है. इसे 30 जून, 2024 को बंद कर दिया जाएगा. ध्यान दें कि Search Ads 360 Conversion API पर इसका कोई असर नहीं पड़ा है. साथ ही, यह पहले की तरह काम करता रहेगा. सभी नए रिपोर्टिंग डेवलपमेंट में, Search Ads 360 Reporting API के नए वर्शन का इस्तेमाल होना चाहिए.

अप्रैल 2024 से, रिपोर्ट का अनुरोध करते समय, काम न करने वाला ApiVersion गड़बड़ी दिखेगी. विवरण यहां देखें.

हमारा यह सुझाव भी है कि आप Search Ads 360 पर लागू होने वाले सभी मौजूदा वर्शन को एपीआई के नए वर्शन पर माइग्रेट करें. ज़्यादा जानकारी के लिए, Search Ads 360 Reporting API का नया वर्शन शुरू करने का तरीका और माइग्रेशन गाइड देखें.

इस पेज का अनुवाद Cloud Translation API से किया गया है.

Conversion

कन्वर्ज़न संसाधन में ऐसे तरीके मौजूद हैं जिनकी मदद से उपयोगकर्ता एक साथ कई Floodlight कन्वर्ज़न बना सकते हैं, उनमें बदलाव कर सकते हैं, और उन्हें वापस पा सकते हैं.

इस संसाधन के तरीकों की सूची के लिए, इस पेज का अंत देखें.

रिसॉर्स प्रतिनिधित्व

कन्वर्ज़न की सूची.

{
  "kind": "doubleclicksearch#conversionList",
  "conversion": [
    {
      "agencyId": long,
      "advertiserId": long,
      "engineAccountId": long,
      "campaignId": long,
      "customerId": string,
      "adGroupId": long,
      "criterionId": long,
      "adId": long,
      "clickId": string,
      "dsConversionId": long,
      "conversionId": string,
      "state": string,
      "type": string,
      "revenueMicros": long,
      "currencyCode": string,
      "quantityMillis": long,
      "segmentationType": string,
      "segmentationId": long,
      "segmentationName": string,
      "conversionTimestamp": unsigned long,
      "conversionModifiedTimestamp": unsigned long,
      "floodlightOrderId": string,
      "customMetric": [
        {
          "name": string,
          "value": double
        }
      ],
      "customDimension": [
        {
          "name": string,
          "value": string
        }
      ],
      "countMillis": long,
      "attributionModel": string,
      "productGroupId": long,
      "inventoryAccountId": long,
      "productId": string,
      "productCountry": string,
      "productLanguage": string,
      "channel": string,
      "storeId": string,
      "deviceType": string,
      "adUserDataConsent": string
    }
  ]
}

प्रॉपर्टी का नाम	वैल्यू	जानकारी	ज़रूरी जानकारी
`conversion[]`	`list`	अनुरोध किए जा रहे कन्वर्ज़न.
`conversion[].adGroupId`	`long`	DS विज्ञापन ग्रुप का आईडी.
`conversion[].adId`	`long`	DS विज्ञापन आईडी.
`conversion[].adUserDataConsent`	`string`	सेटिंग में जाकर, मुख्य प्लैटफ़ॉर्म की सेवाओं (सीपीएस) की प्राथमिकताओं के लिए सहमति दी जाती है. कोई डिफ़ॉल्ट वैल्यू नहीं है. स्वीकार की जाने वाली वैल्यू ये हैं: GRANTED: सहमति के लिए मनमुताबिक स्टेटस देना है. GTE की सेटिंग में जाकर, सीपीएस से जुड़ी प्राथमिकताएं पढ़ें. अनुमति नहीं दी गई: मनमुताबिक सहमति का स्टेटस 'अस्वीकार किया गया' है; सीपीएस की सूची खाली है.
`conversion[].advertiserId`	`long`	DS विज्ञापन देने वाले का आईडी.
`conversion[].agencyId`	`long`	DS एजेंसी का आईडी.
`conversion[].attributionModel`	`string`	यह विकल्प DoubleClick Search ग्राहक सहायता से संपर्क करने के बाद ही विज्ञापन देने वालों के लिए उपलब्ध होता है.
`conversion[].campaignId`	`long`	DS कैंपेन आईडी.
`conversion[].channel`	`string`	प्रॉडक्ट का बिक्री चैनल. मान्य वैल्यू ये हैं: "`local`": दुकान "`online`": एक ऑनलाइन स्टोर
`conversion[].clickId`	`string`	कन्वर्ज़न के लिए DS क्लिक आईडी.
`conversion[].conversionId`	`string`	ऑफ़लाइन कन्वर्ज़न के लिए, विज्ञापन देने वाले यह आईडी देते हैं. विज्ञापन देने वाले, अपनी पसंद का कोई भी आईडी तय कर सकते हैं. किसी अनुरोध में होने वाले हर कन्वर्ज़न के लिए एक यूनीक आईडी दिया जाना चाहिए. साथ ही, विज्ञापन देने वाले के सभी कन्वर्ज़न में, आईडी और टाइमस्टैंप का कॉम्बिनेशन अलग-अलग होना चाहिए. ऑनलाइन कन्वर्ज़न के लिए, DS, विज्ञापन देने वाले के Floodlight निर्देशों के आधार पर, `dsConversionId` या `floodlightOrderId` को इस प्रॉपर्टी में कॉपी करता है.
`conversion[].conversionModifiedTimestamp`	`unsigned long`	वह समय जब कन्वर्ज़न में पिछली बार बदलाव किया गया था. यह Epoch Millis UTC के बारे में होता है.
`conversion[].conversionTimestamp`	`unsigned long`	कन्वर्ज़न होने का समय, Epoch Millis UTC में होता है.
`conversion[].countMillis`	`long`	यह विकल्प DoubleClick Search ग्राहक सहायता से संपर्क करने के बाद ही विज्ञापन देने वालों के लिए उपलब्ध होता है.
`conversion[].criterionId`	`long`	DS मानदंड (कीवर्ड) आईडी.
`conversion[].currencyCode`	`string`	कन्वर्ज़न से होने वाली आय का मुद्रा कोड. यह ISO 4217 वर्णमाला (3-वर्ण) फ़ॉर्मैट में होना चाहिए.	लिखा जा सकता है
`conversion[].customDimension[]`	`list`	कन्वर्ज़न के लिए कस्टम डाइमेंशन, जिनका इस्तेमाल रिपोर्ट में डेटा को फ़िल्टर करने के लिए किया जा सकता है.
`conversion[].customDimension[].name`	`string`	कस्टम डाइमेंशन का नाम.
`conversion[].customDimension[].value`	`string`	कस्टम डाइमेंशन की वैल्यू.
`conversion[].customMetric[]`	`list`	कन्वर्ज़न के लिए कस्टम मेट्रिक.
`conversion[].customMetric[].name`	`string`	कस्टम मेट्रिक का नाम.
`conversion[].customMetric[].value`	`double`	कस्टम मेट्रिक की संख्या के तौर पर वैल्यू.
`conversion[].customerId`	`string`	Search Ads 360 के नए वर्शन का ग्राहक आईडी. क्लाइंट खाता होना चाहिए. इस फ़ील्ड को सेट करने के बाद, बाकी सभी आईडी फ़ील्ड, Search Ads 360 के नए आईडी पर सेट होने चाहिए.
`conversion[].deviceType`	`string`	वह डिवाइस जिस पर कन्वर्ज़न हुआ. इन वैल्यू को इस्तेमाल किया जा सकता है: "`DESKTOP`" "`HIGH_END_MOBILE`" "`OTHER_DEVICE`" "`TABLET`"
`conversion[].dsConversionId`	`long`	आईडी, जिसे DoubleClick Search हर कन्वर्ज़न के लिए जनरेट करता है.
`conversion[].engineAccountId`	`long`	DS इंजन खाता आईडी.
`conversion[].floodlightOrderId`	`string`	कन्वर्ज़न के लिए, विज्ञापन देने वाले से मिला Floodlight ऑर्डर आईडी.
`conversion[].inventoryAccountId`	`long`	ऐसा आईडी जिसे DS जनरेट करता है. इसका इस्तेमाल, प्रॉडक्ट वाले इन्वेंट्री खाते की खास तरह से पहचान करने के लिए किया जाता है.
`conversion[].productCountry`	`string`	Merchant Center फ़ीड के लिए रजिस्टर किया गया देश जिसमें वह प्रॉडक्ट शामिल है. किसी देश की जानकारी देने के लिए, ISO 3166 कोड का इस्तेमाल करें.
`conversion[].productGroupId`	`long`	DS प्रॉडक्ट ग्रुप आईडी.
`conversion[].productId`	`string`	प्रॉडक्ट आईडी (SKU).
`conversion[].productLanguage`	`string`	Merchant Center फ़ीड के लिए रजिस्टर की गई वह भाषा जिसमें प्रॉडक्ट शामिल है. भाषा की जानकारी देने के लिए, ISO 639 कोड का इस्तेमाल करें.
`conversion[].quantityMillis`	`long`	इस कन्वर्ज़न की संख्या, मिलीसेकंड में.	लिखा जा सकता है
`conversion[].revenueMicros`	`long`	माइक्रो में (वैल्यू को 10,00,000 से गुणा किया गया, लेकिन दशमलव के बिना). `TRANSACTION` कन्वर्ज़न से हुई आय की रकम. उदाहरण के लिए, रेवेन्यू की वैल्यू "10" तय करने के लिए, अपने अनुरोध में "10,00,000" (1 करोड़) डालें.	लिखा जा सकता है
`conversion[].segmentationId`	`long`	संख्या वाला सेगमेंटेशन आइडेंटिफ़ायर (उदाहरण के लिए, DoubleClick Search Floodlight गतिविधि आईडी).
`conversion[].segmentationName`	`string`	फ़्रेंडली सेगमेंटेशन आइडेंटिफ़ायर (उदाहरण के लिए, DoubleClick Search Floodlight गतिविधि का नाम).
`conversion[].segmentationType`	`string`	इस कन्वर्ज़न का सेगमेंटेशन टाइप (उदाहरण के लिए, `FLOODLIGHT`). ये वैल्यू स्वीकार की जाती हैं: "`FLOODLIGHT`"
`conversion[].state`	`string`	कन्वर्ज़न की स्थिति, यानी `ACTIVE` या `REMOVED`. ध्यान दें: 'मिटाया गया' स्टेटस अब काम नहीं करता. इन वैल्यू को इस्तेमाल किया जा सकता है: "`ACTIVE`" "`DELETED`": (अब काम नहीं करता) "`REMOVED`"	लिखा जा सकता है
`conversion[].storeId`	`string`	उस स्थानीय स्टोर का आईडी जिसके लिए प्रॉडक्ट का विज्ञापन दिखाया गया था. यह सिर्फ़ तब लागू होगा, जब चैनल "`local`" पर सेट हो.
`conversion[].type`	`string`	कन्वर्ज़न का टाइप, यानी कि `ACTION` या `TRANSACTION`. `ACTION` कन्वर्ज़न, उपयोगकर्ता की वह कार्रवाई होती है जिसका आकलन करने के लिए कोई भी मान नहीं होता. वहीं, `TRANSACTION` कन्वर्ज़न ऐसी कार्रवाई होती है जिसका आकलन किया जा सकने वाला मान हो. उदाहरण के लिए, ईमेल सूची में किए जाने वाले साइन अप (`ACTION`) बनाम ई-कॉमर्स खरीदारी (`TRANSACTION`). ये वैल्यू स्वीकार की जाती हैं: "`ACTION`" "`TRANSACTION`"
`kind`	`string`	इसकी पहचान, ConversionList संसाधन के तौर पर करती है. वैल्यू: तय स्ट्रिंग `doubleclicksearch#conversionList`.

तरीके

get: यह नीति, DoubleClick Search इंजन खाते से कन्वर्ज़न की सूची को फ़ेच करती है.
getByCustomerId: Search Ads 360 के नए ग्राहक आईडी का इस्तेमाल करके, DoubleClick Search इंजन खाते से कन्वर्ज़न की सूची के बारे में जानकारी देता है.
डालें: DoubleClick Search में नए कन्वर्ज़न का बैच डालता है.
अपडेट: DoubleClick Search में कन्वर्ज़न के बैच को अपडेट करता है.
updateAvailability: DoubleClick Search में Floodlight गतिविधियों के बैच की उपलब्धता अपडेट करता है.