ऐसेट

परफ़ॉर्मेंस मैक्स कैंपेन बनाने से पहले, यह ज़रूरी है कि आपने कैंपेन में इस्तेमाल की जाने वाली सभी ऐसेट इंपोर्ट कर ली हों. आपके पास बाद में भी ऐसेट जोड़ने का विकल्प होता है. हालांकि, कैंपेन बनाने के लिए भी आपके पास कुछ ऐसेट होनी चाहिए.

अपने कैंपेन की योजना बनाते समय, परफ़ॉर्मेंस मैक्स कैंपेन के लिए ऐसेट और ऐसेट की ज़रूरी शर्तों के बारे में पढ़ें.

टेक्स्ट ऐसेट और इमेज ऐसेट, ज़रूरी ऐसेट के मुख्य टाइप हैं. इसलिए, इस गाइड में इन दोनों को अपलोड करने का तरीका बताया जाएगा. इन सिद्धांतों को अन्य ऐसेट टाइप पर भी लागू किया जा सकता है. किसी भी तरह की ऐसेट बनाने के लिए, AssetOperation का इस्तेमाल करें.

ऐसेट बनाई जा सकती हैं AdsApp. इसके लिए, म्यूटेट का इस्तेमाल करना ज़रूरी नहीं है. हालांकि, एक जैसा तरीका बनाए रखने के लिए, इस गाइड में भी वही तरीका अपनाया गया है जो अन्य सभी कार्रवाइयों के लिए इस्तेमाल किया जाता है. ध्यान दें कि अगर आपके पास पहले से ही कुछ ऐसेट उपलब्ध हैं, तो उनका फिर से इस्तेमाल किया जा सकता है और किया जाना चाहिए. इसलिए, परफ़ॉर्मेंस मैक्स कैंपेन बनाने के लिए, आपके पास ऐसेट होना ज़रूरी है. हालांकि, कैंपेन बनाने की प्रोसेस के तहत, ऐसेट बनाना ज़रूरी नहीं है.

टेक्स्ट ऐसेट

टेक्स्ट ऐसेट, किसी भी अन्य कार्रवाई की तरह ही काम करती हैं. अगर कैंपेन बनाने की प्रोसेस के तहत ऐसेट अपलोड की जा रही हैं, तो अस्थायी आईडी का इस्तेमाल करें. इसके अलावा, वापस मिले संसाधन के नाम को नोट करें. इसका इस्तेमाल, ऐसेट ग्रुप में ऐसेट जोड़ने के लिए, आने वाली किसी कार्रवाई में किया जा सकता है.

const textAsset = {
  "assetOperation": {
    "create": {
      "resourceName": `customers/${customerId}/assets/${getNextTempId()}`,
      "textAsset": {
        "text": "Travel the World"
      }
    }
  }
}
operations.push(textAsset);

इमेज ऐसेट

इमेज ऐसेट, base-64 एनकोड किए गए फ़ॉर्मैट में अपलोड की जाती हैं. Google Ads स्क्रिप्ट में, इमेज सीधे अपलोड नहीं की जा सकतीं. इसलिए, इमेज का डेटा पाने और उसे अपलोड करने के लिए एनकोड करने के दो अलग-अलग तरीके हैं.

Google Drive से कोई इमेज फ़ेच करने के लिए, सबसे पहले आपको उसका आईडी चाहिए. यह इमेज की यूनीक पहचान करने का सबसे अच्छा तरीका है. आईडी पाने का एक तरीका यह है कि Google Drive के यूज़र इंटरफ़ेस (यूआई) से शेयर करने लायक लिंक कॉपी करें और आईडी एक्सट्रैक्ट करें. प्रोग्राम के ज़रिए, एक साथ कई फ़ाइलें भी फ़ेच की जा सकती हैं. इसके बाद, वे फ़ाइलें चुनी जा सकती हैं जिन्हें अपलोड करना है. इस कोड में, किसी ऐसी इमेज को अपलोड करने का तरीका बताया गया है जिसका आईडी पता है:

const file = DriveApp.getFileById(fileId);
const imageAsset =  {
  "assetOperation": {
    "create": {
      "resourceName": `customers/${customerId}/assets/${getNextTempId()}`,
      "name": "Marketing Logo",
      "type": "IMAGE",
      "imageAsset": {
        "data": Utilities.base64Encode(file.getBlob().getBytes())
      }
    }
  }
}
operations.push(imageAsset);

इसके अलावा, UrlFetchApp का इस्तेमाल करके, वेब सर्वर पर होस्ट की गई इमेज को उसके यूआरएल से फ़ेच किया जा सकता है:

const file = UrlFetchApp.fetch(imageUrl);

इसके बाद, इस फ़ाइल पर getBlob को कॉल किया जा सकता है. यह ठीक उसी तरह किया जाता है जैसे Drive की किसी फ़ाइल के लिए किया जाता है. इसलिए, कार्रवाई का स्ट्रक्चर, Google Drive की किसी फ़ाइल के लिए इस्तेमाल किए जाने वाले चरणों जैसा ही होता है.