ऐसेट

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

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

टेक्स्ट ऐसेट और इमेज ऐसेट, मुख्य तौर पर ज़रूरी ऐसेट टाइप होती हैं. इसलिए, इस गाइड में बताया गया है कि इनमें से हर ऐसेट को कैसे अपलोड करें. इन सिद्धांतों को अन्य ऐसेट टाइप पर भी लागू किया जा सकता है. आपको जिस तरह की भी ऐसेट बनानी हो, उसे बनाने के लिए 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())
      }
    }
  }
}

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

const file = UrlFetchApp.fetch(imageUrl);

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