ऐसेट

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

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

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