ऐसेट

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

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

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