Google uses AI technology to translate content into your preferred language. AI translations can contain errors.

सबसे अच्छे तरीके

इस पेज पर, Google Ads स्क्रिप्ट का इस्तेमाल करके डेवलपमेंट करने के सबसे सही तरीकों के बारे में बताया गया है.

सिलेक्टर

चुनने वालों के साथ फ़िल्टर करें

जब भी मुमकिन हो, सिर्फ़ उन इकाइयों का अनुरोध करने के लिए फ़िल्टर का इस्तेमाल करें जिनकी आपको ज़रूरत है. सही फ़िल्टर लगाने के ये फ़ायदे हैं:

कोड को समझना और इस्तेमाल करना आसान है.
स्क्रिप्ट बहुत तेज़ी से काम करेगी.

यहां दिए गए कोड स्निपेट की तुलना करें:

कोडिंग का तरीका	कोड स्निपेट
चुनने वाले टूल का इस्तेमाल करके फ़िल्टर करना (सुझाया गया)	var keywords = AdsApp.keywords() .withCondition('Clicks > 10') .forDateRange('LAST_MONTH') .get(); while (keywords.hasNext()) { var keyword = keywords.next(); // Do work here. }
कोड में फ़िल्टर करना (इसका सुझाव नहीं दिया जाता)	var keywords = AdsApp.keywords().get(); while (keywords.hasNext()) { var keyword = keywords.next(); var stats = keyword.getStatsFor( 'LAST_MONTH'); if (stats.getClicks() > 10) { // Do work here. } }

कोडिंग का तरीका

कोड स्निपेट

चुनने वाले टूल का इस्तेमाल करके फ़िल्टर करना (सुझाया गया)

var keywords = AdsApp.keywords()
    .withCondition('Clicks > 10')
    .forDateRange('LAST_MONTH')
    .get();
while (keywords.hasNext()) {
  var keyword = keywords.next();
  // Do work here.
}

कोड में फ़िल्टर करना (इसका सुझाव नहीं दिया जाता)

var keywords = AdsApp.keywords().get();

while (keywords.hasNext()) {
  var keyword = keywords.next();
  var stats = keyword.getStatsFor(
      'LAST_MONTH');
  if (stats.getClicks() > 10) {
    // Do work here.
  }
}

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

कैंपेन हैरारकी को ट्रैवर्स करने से बचें

जब आपको किसी खास लेवल पर मौजूद इकाइयां वापस लानी हों, तो पूरे कैंपेन के स्ट्रक्चर को ट्रैवर्स करने के बजाय, उस लेवल पर मौजूद कलेक्शन मेथड का इस्तेमाल करें. यह तरीका आसान होने के साथ-साथ, बेहतर परफ़ॉर्म भी करेगा. सिस्टम को सभी कैंपेन और विज्ञापन ग्रुप में गैर-ज़रूरी तौर पर डेटा नहीं पढ़ना पड़ेगा.

अपने खाते में मौजूद सभी विज्ञापन वापस पाने वाले इन कोड स्निपेट की तुलना करें:

कोडिंग का तरीका	कोड स्निपेट
कलेक्शन के सही तरीके का इस्तेमाल करें (सुझाया गया)	var ads = AdsApp.ads();
हैरारकी को ट्रैवर्स करना (इसका सुझाव नहीं दिया जाता)	var campaigns = AdsApp.campaigns().get(); while (campaigns.hasNext()) { var adGroups = campaigns.next(). adGroups().get(); while (adGroups.hasNext()) { var ads = adGroups.next().ads().get(); // Do your work here. } }

दूसरे तरीके का इस्तेमाल करने का सुझाव नहीं दिया जाता, क्योंकि इसमें सिर्फ़ विज्ञापनों की ज़रूरत होने पर भी, ऑब्जेक्ट (कैंपेन, विज्ञापन ग्रुप) की पूरी हैरारकी फ़ेच करने की कोशिश की जाती है.

अभिभावक के लिए उपलब्ध ऐक्सेस कोड डालें

कभी-कभी आपको किसी ऑब्जेक्ट की पैरंट इकाई का पता लगाना होता है. ऐसे मामले में, आपको पूरी हायरार्की फ़ेच करने के बजाय, उपलब्ध कराए गए ऐक्सेसर तरीके का इस्तेमाल करना चाहिए.

यहां दिए गए कोड स्निपेट की तुलना करें. ये ऐसे विज्ञापन ग्रुप को वापस लाते हैं जिनमें पिछले महीने 50 से ज़्यादा क्लिक वाले टेक्स्ट विज्ञापन मौजूद हैं:

कोडिंग का तरीका	कोड स्निपेट
पैरंट ऐक्सेसर के सही तरीके का इस्तेमाल करना (इसका सुझाव दिया जाता है)	var ads = AdsApp.ads() .withCondition('Clicks > 50') .forDateRange('LAST_MONTH') .get(); while (ads.hasNext()) { var ad = ads.next(); var adGroup = ad.getAdGroup(); var campaign = ad.getCampaign(); // Store (campaign, adGroup) to an array. }
हैरारकी को ट्रैवर्स करना (इसका सुझाव नहीं दिया जाता)	var campaigns = AdsApp.campaigns().get(); while (campaigns.hasNext()) { var adGroups = campaigns.next() .adGroups() .get(); while (adGroups.hasNext()) { var ads = adGroups.ads() .withCondition('Clicks > 50') .forDateRange('LAST_MONTH') .get(); if (ads.totalNumEntities() > 0) { // Store (campaign, adGroup) to an array. } } }

कोडिंग का तरीका

कोड स्निपेट

पैरंट ऐक्सेसर के सही तरीके का इस्तेमाल करना (इसका सुझाव दिया जाता है)

var ads = AdsApp.ads()
    .withCondition('Clicks > 50')
    .forDateRange('LAST_MONTH')
    .get();

while (ads.hasNext()) {
  var ad = ads.next();
  var adGroup = ad.getAdGroup();
  var campaign = ad.getCampaign();
  // Store (campaign, adGroup) to an array.
}

हैरारकी को ट्रैवर्स करना (इसका सुझाव नहीं दिया जाता)

var campaigns = AdsApp.campaigns().get();
while (campaigns.hasNext()) {
  var adGroups = campaigns.next()
      .adGroups()
      .get();
  while (adGroups.hasNext()) {
    var ads = adGroups.ads()
       .withCondition('Clicks > 50')
       .forDateRange('LAST_MONTH')
       .get();
    if (ads.totalNumEntities() > 0) {
      // Store (campaign, adGroup) to an array.
    }
  }
}

हम दूसरे तरीके का इस्तेमाल करने का सुझाव नहीं देते. इसकी वजह यह है कि इससे आपके खाते में मौजूद कैंपेन और विज्ञापन ग्रुप की पूरी जानकारी मिलती है. हालांकि, आपको सिर्फ़ उन कैंपेन और विज्ञापन ग्रुप की जानकारी चाहिए होती है जो आपके विज्ञापनों के सेट से जुड़े हैं. पहले तरीके में, सिर्फ़ काम के विज्ञापनों का कलेक्शन फ़ेच किया जाता है. साथ ही, पैरंट ऑब्जेक्ट को ऐक्सेस करने के लिए सही तरीके का इस्तेमाल किया जाता है.

अभिभावक के लिए उपलब्ध फ़िल्टर का इस्तेमाल करना

किसी कैंपेन या विज्ञापन ग्रुप में मौजूद इकाइयों को ऐक्सेस करने के लिए, किसी खास फ़िल्टर का इस्तेमाल करें. इसके लिए, पहले इकाइयों को फ़ेच करने और फिर उन्हें किसी क्रम में व्यवस्थित करने की ज़रूरत नहीं है.

यहां दिए गए कोड स्निपेट की तुलना करें. ये स्निपेट, किसी कैंपेन और विज्ञापन ग्रुप में मौजूद टेक्स्ट विज्ञापनों की सूची को फिर से हासिल करते हैं. इस कैंपेन और विज्ञापन ग्रुप को पिछले महीने 50 से ज़्यादा क्लिक मिले थे.

कोडिंग का तरीका	कोड स्निपेट
पैरंट लेवल के सही फ़िल्टर इस्तेमाल करना (सुझाया गया)	var ads = AdsApp.ads() .withCondition('CampaignName = "Campaign 1"') .withCondition('AdGroupName = "AdGroup 1"') .withCondition('Clicks > 50') .forDateRange('LAST_MONTH') .get(); while (ads.hasNext()) { var ad = ads.next(); var adGroup = ad.getAdGroup(); var campaign = ad.getCampaign(); // Store (campaign, adGroup, ad) to // an array. }
हैरारकी को ट्रैवर्स करना (इसका सुझाव नहीं दिया जाता)	var campaigns = AdsApp.campaigns() .withCondition('Name = "Campaign 1"') .get(); while (campaigns.hasNext()) { var adGroups = campaigns.next() .adGroups() .withCondition('Name = "AdGroup 1"') .get(); while (adGroups.hasNext()) { var ads = adGroups.ads() .withCondition('Clicks > 50') .forDateRange('LAST_MONTH') .get(); while (ads.hasNext()) { var ad = ads.next(); // Store (campaign, adGroup, ad) to // an array. } } }

कोडिंग का तरीका

कोड स्निपेट

पैरंट लेवल के सही फ़िल्टर इस्तेमाल करना (सुझाया गया)

var ads = AdsApp.ads()
    .withCondition('CampaignName = "Campaign 1"')
    .withCondition('AdGroupName = "AdGroup 1"')
    .withCondition('Clicks > 50')
    .forDateRange('LAST_MONTH')
    .get();

while (ads.hasNext()) {
  var ad = ads.next();
  var adGroup = ad.getAdGroup();
  var campaign = ad.getCampaign();
  // Store (campaign, adGroup, ad) to
  // an array.
}

हैरारकी को ट्रैवर्स करना (इसका सुझाव नहीं दिया जाता)

var campaigns = AdsApp.campaigns()
    .withCondition('Name = "Campaign 1"')
    .get();

while (campaigns.hasNext()) {
  var adGroups = campaigns.next()
      .adGroups()
      .withCondition('Name = "AdGroup 1"')
      .get();
  while (adGroups.hasNext()) {
    var ads = adGroups.ads()
       .withCondition('Clicks > 50')
       .forDateRange('LAST_MONTH')
       .get();
    while (ads.hasNext()) {
      var ad = ads.next();
      // Store (campaign, adGroup, ad) to
      // an array.
    }
  }
}

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

जब मुमकिन हो, तब फ़िल्टर करने के लिए आईडी का इस्तेमाल करें

इकाइयों के लिए फ़िल्टर करते समय, इकाइयों को उनके आईडी के हिसाब से फ़िल्टर करना बेहतर होता है. इसके बजाय, अन्य फ़ील्ड के हिसाब से फ़िल्टर न करें.

कैंपेन चुनने वाले इन कोड स्निपेट पर विचार करें.

कोडिंग का तरीका	कोड स्निपेट
आईडी के हिसाब से फ़िल्टर करना (हम इसका सुझाव देते हैं)	var campaign = AdsApp.campaigns() .withIds([12345]) .get() .next();
नाम के हिसाब से फ़िल्टर करें (कम बेहतर)	var campaign = AdsApp.campaigns() .withCondition('Name="foo"') .get() .next();

दूसरा तरीका कम बेहतर है, क्योंकि हम आईडी के अलावा किसी दूसरे फ़ील्ड के हिसाब से फ़िल्टर कर रहे हैं.

जब भी मुमकिन हो, पैरंट आईडी के हिसाब से फ़िल्टर करें

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

यहां दिए गए कोड स्निपेट पर विचार करें. यह कोड स्निपेट, विज्ञापन ग्रुप को उसके आईडी के हिसाब से वापस पाता है. मान लें कि पैरंट कैंपेन आईडी पता है.

कोडिंग का तरीका	कोड स्निपेट
कैंपेन और विज्ञापन ग्रुप के आईडी के हिसाब से फ़िल्टर करें (सुझाया गया)	var adGroup = AdsApp.adGroups() .withIds([12345]) .withCondition('CampaignId="54678"') .get() .next();
सिर्फ़ विज्ञापन ग्रुप आईडी के हिसाब से फ़िल्टर करना (कम बेहतर)	var adGroup = AdsApp.adGroups() .withIds([12345]) .get() .next();

दोनों कोड स्निपेट से एक जैसे नतीजे मिलते हैं. हालांकि, कोड स्निपेट 1 में पैरंट आईडी (CampaignId="54678") का इस्तेमाल करके अतिरिक्त फ़िल्टरिंग की जाती है. इससे कोड ज़्यादा असरदार हो जाता है, क्योंकि यह उन इकाइयों की सूची को सीमित कर देता है जिन्हें सर्वर को नतीजों को फ़िल्टर करते समय दोहराना पड़ता है.

फ़िल्टर करने की कई शर्तें होने पर लेबल का इस्तेमाल करना

अगर फ़िल्टर करने की कई शर्तें हैं, तो प्रोसेस की जाने वाली इकाइयों के लिए लेबल बनाना बेहतर होता है. इसके बाद, उस लेबल का इस्तेमाल करके अपनी इकाइयों को फ़िल्टर करें.

यहां दिए गए कोड के स्निपेट पर ध्यान दें. यह कोड, नाम के हिसाब से कैंपेन की सूची को वापस पाता है.

कोडिंग का तरीका	कोड स्निपेट
लेबल का इस्तेमाल करना (इसका सुझाव दिया जाता है)	var label = AdsApp.labels() .withCondition('Name = "My Label"') .get() .next(); var campaigns = label.campaigns.get(); while (campaigns.hasNext()) { var campaign = campaigns.next(); // Do more work }
मुश्किल सिलेक्टर बनाना (इसका सुझाव नहीं दिया जाता)	var campaignNames = ['foo', 'bar', 'baz']; for (var i = 0; i < campaignNames.length; i++) { campaignNames[i] = '"' + campaignNames[i] + '"'; } var campaigns = AdsApp.campaigns .withCondition('CampaignName in [' + campaignNames.join(',') + ']') .get(); while (campaigns.hasNext()) { var campaign = campaigns.next(); // Do more work. }

कोडिंग का तरीका

कोड स्निपेट

लेबल का इस्तेमाल करना (इसका सुझाव दिया जाता है)

var label = AdsApp.labels()
    .withCondition('Name = "My Label"')
    .get()
    .next();
var campaigns = label.campaigns.get();
while (campaigns.hasNext()) {
  var campaign = campaigns.next();
  // Do more work
}

मुश्किल सिलेक्टर बनाना (इसका सुझाव नहीं दिया जाता)

var campaignNames = ['foo', 'bar', 'baz'];

for (var i = 0; i < campaignNames.length; i++) {
  campaignNames[i] = '"' + campaignNames[i] + '"';
}

var campaigns = AdsApp.campaigns
    .withCondition('CampaignName in [' + campaignNames.join(',') + ']')
    .get();

while (campaigns.hasNext()) {
  var campaign = campaigns.next();
  // Do more work.
}

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

अपने IN क्लॉज़ में शर्तों की संख्या सीमित करें

स्क्रिप्ट चलाने के दौरान, आम तौर पर कई इकाइयों के लिए रिपोर्ट जनरेट की जाती है. डेवलपर आम तौर पर, एक बहुत लंबी GAQL क्वेरी बनाते हैं. यह क्वेरी, IN क्लॉज़ का इस्तेमाल करके, इकाई आईडी पर फ़िल्टर करती है. जब इकाइयों की संख्या सीमित होती है, तब यह तरीका ठीक से काम करता है. हालांकि, क्वेरी की लंबाई बढ़ने पर, आपकी स्क्रिप्ट की परफ़ॉर्मेंस इन दो वजहों से खराब हो जाती है:

लंबी क्वेरी को पार्स करने में ज़्यादा समय लगता है.
IN क्लॉज़ में जोड़ा गया हर आईडी, आकलन करने के लिए एक अतिरिक्त शर्त होती है. इसलिए, इसमें ज़्यादा समय लगता है.

ऐसी स्थितियों में, इकाइयों पर लेबल लगाना बेहतर होता है. इसके बाद, LabelId के हिसाब से फ़िल्टर करें.

कोडिंग का तरीका	कोड स्निपेट
लेबल लागू करना और लेबल आईडी के हिसाब से फ़िल्टर करना (सुझाया गया)	// The label applied to the entity is "Report Entities" var label = AdsApp.labels() .withCondition('LabelName contains "Report Entities"') .get() .next(); var report = AdsApp.report('SELECT AdGroupId, Id, Clicks, ' + 'Impressions, Cost FROM KEYWORDS_PERFORMANCE_REPORT ' + 'WHERE LabelId = "' + label.getId() + '"');
IN क्लॉज़ का इस्तेमाल करके लंबी क्वेरी बनाना (इसका सुझाव नहीं दिया जाता)	var report = AdsApp.report('SELECT AdGroupId, Id, Clicks, ' + 'Impressions, Cost FROM KEYWORDS_PERFORMANCE_REPORT WHERE ' + 'AdGroupId IN (123, 456) and Id in (123,345, 456…)');

कोडिंग का तरीका

कोड स्निपेट

लेबल लागू करना और लेबल आईडी के हिसाब से फ़िल्टर करना (सुझाया गया)

// The label applied to the entity is "Report Entities"
var label = AdsApp.labels()
    .withCondition('LabelName contains "Report Entities"')
    .get()
    .next();

var report = AdsApp.report('SELECT AdGroupId, Id, Clicks, ' +
    'Impressions, Cost FROM KEYWORDS_PERFORMANCE_REPORT ' +
    'WHERE LabelId = "' + label.getId() + '"');

IN क्लॉज़ का इस्तेमाल करके लंबी क्वेरी बनाना (इसका सुझाव नहीं दिया जाता)

var report = AdsApp.report('SELECT AdGroupId, Id, Clicks, ' +
    'Impressions, Cost FROM KEYWORDS_PERFORMANCE_REPORT WHERE ' +
    'AdGroupId IN (123, 456) and Id in (123,345, 456…)');

खाते से जुड़े अपडेट

एक साथ कई बदलाव करने की सुविधा

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

यहां दी गई स्क्रिप्ट, कीवर्ड की सूची की बिड अपडेट करती है.

कोडिंग का तरीका	कोड स्निपेट
अपडेट किए गए एलिमेंट को ट्रैक करना (सुझाया गया)	var keywords = AdsApp.keywords() .withCondition('Clicks > 50') .withCondition('CampaignName = "Campaign 1"') .withCondition('AdGroupName = "AdGroup 1"') .forDateRange('LAST_MONTH') .get(); var list = []; while (keywords.hasNext()) { var keyword = keywords.next(); keyword.bidding().setCpc(1.5); list.push(keyword); } for (var i = 0; i < list.length; i++) { var keyword = list[i]; Logger.log('%s, %s', keyword.getText(), keyword.bidding().getCpc()); }
टाइटल और ब्यौरे को बार-बार अपडेट करना (इसका सुझाव नहीं दिया जाता)	var keywords = AdsApp.keywords() .withCondition('Clicks > 50') .withCondition('CampaignName = "Campaign 1"') .withCondition('AdGroupName = "AdGroup 1"') .forDateRange('LAST_MONTH') .get(); while (keywords.hasNext()) { var keyword = keywords.next(); keyword.bidding().setCpc(1.5); Logger.log('%s, %s', keyword.getText(), keyword.bidding().getCpc()); }

कोडिंग का तरीका

कोड स्निपेट

अपडेट किए गए एलिमेंट को ट्रैक करना (सुझाया गया)

var keywords = AdsApp.keywords()
    .withCondition('Clicks > 50')
    .withCondition('CampaignName = "Campaign 1"')
    .withCondition('AdGroupName = "AdGroup 1"')
    .forDateRange('LAST_MONTH')
    .get();

var list = [];
while (keywords.hasNext()) {
  var keyword = keywords.next();
  keyword.bidding().setCpc(1.5);
  list.push(keyword);
}

for (var i = 0; i < list.length; i++) {
  var keyword = list[i];
  Logger.log('%s, %s', keyword.getText(),
      keyword.bidding().getCpc());
}

टाइटल और ब्यौरे को बार-बार अपडेट करना (इसका सुझाव नहीं दिया जाता)

var keywords = AdsApp.keywords()
    .withCondition('Clicks > 50')
    .withCondition('CampaignName = "Campaign 1"')
    .withCondition('AdGroupName = "AdGroup 1"')
    .forDateRange('LAST_MONTH')
    .get();

while (keywords.hasNext()) {
  var keyword = keywords.next();
  keyword.bidding().setCpc(1.5);
  Logger.log('%s, %s', keyword.getText(),
      keyword.bidding().getCpc());
}

हमारा सुझाव है कि आप दूसरे तरीके का इस्तेमाल न करें. ऐसा इसलिए, क्योंकि keyword.bidding().getCpc() को कॉल करने पर, Google Ads स्क्रिप्ट को setCpc() ऑपरेशन को फ़्लश करना पड़ता है. साथ ही, एक बार में सिर्फ़ एक ऑपरेशन को लागू किया जा सकता है. पहला तरीका, दूसरे तरीके से मिलता-जुलता है. हालांकि, इसमें बैचिंग की सुविधा भी मिलती है. ऐसा इसलिए, क्योंकि getCpc() कॉल को उस लूप से अलग लूप में किया जाता है जहां setCpc() को कॉल किया जाता है.

जब हो सके, तब बिल्डर का इस्तेमाल करें

Google Ads स्क्रिप्ट में, नए ऑब्जेक्ट बनाने के दो तरीके उपलब्ध हैं: बिल्डर और ऑब्जेक्ट बनाने के तरीके. बिल्डर, ऑब्जेक्ट बनाने के तरीकों से ज़्यादा फ़्लेक्सिबल होते हैं. ऐसा इसलिए, क्योंकि ये आपको एपीआई कॉल से बनाए गए ऑब्जेक्ट का ऐक्सेस देते हैं.

यहां दिए गए कोड स्निपेट देखें:

कोडिंग का तरीका	कोड स्निपेट
बिल्डर का इस्तेमाल करना (इसका सुझाव दिया जाता है)	var operation = adGroup.newKeywordBuilder() .withText('shoes') .build(); var keyword = operation.getResult();
नीति बनाने के तरीकों का इस्तेमाल करना (इसका सुझाव नहीं दिया जाता)	adGroup.createKeyword('shoes'); var keyword = adGroup.keywords() .withCondition('KeywordText="shoes"') .get() .next();

कीवर्ड को वापस पाने के लिए, अतिरिक्त सिलेक्शन ऑपरेशन की वजह से दूसरे तरीके को प्राथमिकता नहीं दी जाती. इसके अलावा, कॉन्टेंट बनाने के तरीके भी अब काम नहीं करेंगे.

हालांकि, ध्यान रखें कि बिल्डर का गलत तरीके से इस्तेमाल करने पर, Google Ads स्क्रिप्ट को एक साथ कई कार्रवाइयां करने से रोका जा सकता है.

यहां दिए गए कोड स्निपेट देखें. इनसे कीवर्ड की सूची बनाई जाती है और नए कीवर्ड का आईडी प्रिंट किया जाता है:

कोडिंग का तरीका	कोड स्निपेट
अपडेट किए गए एलिमेंट को ट्रैक करना (सुझाया गया)	var keywords = ['foo', 'bar', 'baz']; var list = []; for (var i = 0; i < keywords.length; i++) { var operation = adGroup.newKeywordBuilder() .withText(keywords[i]) .build(); list.push(operation); } for (var i = 0; i < list.length; i++) { var operation = list[i]; var result = operation.getResult(); Logger.log('%s %s', result.getId(), result.getText()); }
टाइटल और ब्यौरे को बार-बार अपडेट करना (इसका सुझाव नहीं दिया जाता)	var keywords = ['foo', 'bar', 'baz']; for (var i = 0; i < keywords.length; i++) { var operation = adGroup.newKeywordBuilder() .withText(keywords[i]) .build(); var result = operation.getResult(); Logger.log('%s %s', result.getId(), result.getText()); }

कोडिंग का तरीका

कोड स्निपेट

अपडेट किए गए एलिमेंट को ट्रैक करना (सुझाया गया)

var keywords = ['foo', 'bar', 'baz'];

var list = [];
for (var i = 0; i < keywords.length; i++) {
  var operation = adGroup.newKeywordBuilder()
      .withText(keywords[i])
      .build();
  list.push(operation);
}

for (var i = 0; i < list.length; i++) {
  var operation = list[i];
  var result = operation.getResult();
  Logger.log('%s %s', result.getId(),
      result.getText());
}

टाइटल और ब्यौरे को बार-बार अपडेट करना (इसका सुझाव नहीं दिया जाता)

var keywords = ['foo', 'bar', 'baz'];

for (var i = 0; i < keywords.length; i++) {
  var operation = adGroup.newKeywordBuilder()
      .withText(keywords[i])
      .build();
  var result = operation.getResult();
  Logger.log('%s %s', result.getId(),
      result.getText());
}

दूसरे तरीके का इस्तेमाल करने का सुझाव नहीं दिया जाता, क्योंकि यह उस लूप में operation.getResult() को कॉल करता है जो ऑपरेशन बनाता है. इसलिए, Google Ads स्क्रिप्ट को एक बार में एक ही ऑपरेशन को पूरा करना पड़ता है. पहला तरीका, दूसरे तरीके से मिलता-जुलता है. हालांकि, इसमें बैचिंग की अनुमति है, क्योंकि हम operation.getResult() को उस लूप से अलग लूप में कॉल करते हैं जहां इसे बनाया गया था.

बड़े अपडेट के लिए, एक साथ कई फ़ाइलें अपलोड करने की सुविधा का इस्तेमाल करें

डेवलपर, आम तौर पर रिपोर्ट जनरेट करते हैं. साथ ही, मौजूदा परफ़ॉर्मेंस वैल्यू के आधार पर, इकाई की प्रॉपर्टी (उदाहरण के लिए, कीवर्ड बिड) अपडेट करते हैं. जब आपको बड़ी संख्या में इकाइयां अपडेट करनी हों, तो बल्क अपलोड की सुविधा से आपको बेहतर परफ़ॉर्मेंस मिलती है. उदाहरण के लिए, यहां दी गई स्क्रिप्ट देखें. ये स्क्रिप्ट उन कीवर्ड के लिए MaxCpc बढ़ाती हैं जिनके लिए पिछले महीने TopImpressionPercentage > 0.4:

कोडिंग का तरीका	कोड स्निपेट
एक साथ कई फ़ाइलें अपलोड करने की सुविधा का इस्तेमाल करना (इसका सुझाव दिया जाता है)	var report = AdsApp.report( 'SELECT AdGroupId, Id, CpcBid FROM KEYWORDS_PERFORMANCE_REPORT ' + 'WHERE TopImpressionPercentage > 0.4 DURING LAST_MONTH'); var upload = AdsApp.bulkUploads().newCsvUpload([ report.getColumnHeader('AdGroupId').getBulkUploadColumnName(), report.getColumnHeader('Id').getBulkUploadColumnName(), report.getColumnHeader('CpcBid').getBulkUploadColumnName()]); upload.forCampaignManagement(); var reportRows = report.rows(); while (reportRows.hasNext()) { var row = reportRows.next(); row['CpcBid'] = row['CpcBid'] + 0.02; upload.append(row.formatForUpload()); } upload.apply();
आईडी के हिसाब से कीवर्ड चुनना और उन्हें अपडेट करना (यह तरीका ज़्यादा बेहतर नहीं है)	var reportRows = AdsApp.report('SELECT AdGroupId, Id, CpcBid FROM ' + 'KEYWORDS_PERFORMANCE_REPORT WHERE TopImpressionPercentage > 0.4 ' + ' DURING LAST_MONTH') .rows(); var map = { }; while (reportRows.hasNext()) { var row = reportRows.next(); var adGroupId = row['AdGroupId']; var id = row['Id']; if (map[adGroupId] == null) { map[adGroupId] = []; } map[adGroupId].push([adGroupId, id]); } for (var key in map) { var keywords = AdsApp.keywords() .withCondition('AdGroupId="' + key + '"') .withIds(map[key]) .get(); while (keywords.hasNext()) { var keyword = keywords.next(); keyword.bidding().setCpc(keyword.bidding().getCpc() + 0.02); } }

कोडिंग का तरीका

कोड स्निपेट

एक साथ कई फ़ाइलें अपलोड करने की सुविधा का इस्तेमाल करना (इसका सुझाव दिया जाता है)


var report = AdsApp.report(
  'SELECT AdGroupId, Id, CpcBid FROM KEYWORDS_PERFORMANCE_REPORT ' +
  'WHERE TopImpressionPercentage > 0.4 DURING LAST_MONTH');

var upload = AdsApp.bulkUploads().newCsvUpload([
  report.getColumnHeader('AdGroupId').getBulkUploadColumnName(),
  report.getColumnHeader('Id').getBulkUploadColumnName(),
  report.getColumnHeader('CpcBid').getBulkUploadColumnName()]);
upload.forCampaignManagement();

var reportRows = report.rows();
while (reportRows.hasNext()) {
  var row = reportRows.next();
  row['CpcBid'] = row['CpcBid'] + 0.02;
  upload.append(row.formatForUpload());
}

upload.apply();

आईडी के हिसाब से कीवर्ड चुनना और उन्हें अपडेट करना (यह तरीका ज़्यादा बेहतर नहीं है)

var reportRows = AdsApp.report('SELECT AdGroupId, Id, CpcBid FROM ' +
    'KEYWORDS_PERFORMANCE_REPORT WHERE TopImpressionPercentage > 0.4 ' +
    ' DURING LAST_MONTH')
    .rows();

var map = {
};

while (reportRows.hasNext()) {
  var row = reportRows.next();
  var adGroupId = row['AdGroupId'];
  var id = row['Id'];

  if (map[adGroupId] == null) {
    map[adGroupId] = [];
  }
  map[adGroupId].push([adGroupId, id]);
}

for (var key in map) {
  var keywords = AdsApp.keywords()
      .withCondition('AdGroupId="' + key + '"')
      .withIds(map[key])
      .get();

  while (keywords.hasNext()) {
    var keyword = keywords.next();
    keyword.bidding().setCpc(keyword.bidding().getCpc() + 0.02);
  }
}

दूसरे तरीके से आपको अच्छी परफ़ॉर्मेंस मिलती है. हालांकि, इस मामले में पहले तरीके को प्राथमिकता दी जाती है, क्योंकि

Google Ads स्क्रिप्ट में, एक बार में वापस पाए जा सकने वाले या अपडेट किए जा सकने वाले ऑब्जेक्ट की संख्या सीमित होती है. दूसरे तरीके में, चुनने और अपडेट करने की कार्रवाइयां उस सीमा में शामिल होती हैं.
बल्क अपलोड में, अपडेट की जा सकने वाली इकाइयों की संख्या और कुल समय, दोनों के हिसाब से ज़्यादा सीमाएं होती हैं.

एक साथ कई फ़ाइलें अपलोड करने की सुविधा का इस्तेमाल करके, कैंपेन के हिसाब से फ़ाइलें ग्रुप करें

एक साथ कई फ़ाइल अपलोड करते समय, अपनी कार्रवाइयों को पैरंट कैंपेन के हिसाब से ग्रुप करें. इससे, काम करने की क्षमता बढ़ती है और बदलावों के टकराव / एक साथ होने वाली गड़बड़ियों की संभावना कम हो जाती है.

मान लें कि एक साथ कई फ़ाइलें अपलोड करने के दो टास्क एक साथ चल रहे हैं. इनमें से एक, विज्ञापन ग्रुप में विज्ञापन दिखाने की सुविधा को रोकता है. वहीं, दूसरा कीवर्ड बिड में बदलाव करता है. भले ही, ये कार्रवाइयां एक-दूसरे से जुड़ी न हों, लेकिन ये एक ही विज्ञापन ग्रुप (या एक ही कैंपेन के दो अलग-अलग विज्ञापन ग्रुप) की इकाइयों पर लागू हो सकती हैं. ऐसा होने पर, सिस्टम पैरंट इकाई (शेयर किया गया विज्ञापन ग्रुप या कैंपेन) को लॉक कर देगा. इस वजह से, एक साथ कई ऐसेट अपलोड करने के टास्क एक-दूसरे को ब्लॉक कर देंगे.

Google Ads स्क्रिप्ट, एक साथ कई फ़ाइलें अपलोड करने के एक टास्क में ही बेहतर तरीके से काम कर सकती हैं. इसलिए, सबसे आसान तरीका यह है कि हर खाते के लिए, एक बार में सिर्फ़ एक साथ कई फ़ाइलें अपलोड करने का टास्क चलाया जाए. अगर आपको हर खाते के लिए एक से ज़्यादा बार में डेटा अपलोड करना है, तो पक्का करें कि हर बार में डेटा अपलोड करने के लिए, कैंपेन (और उनकी चाइल्ड इकाइयां) की अलग-अलग सूची का इस्तेमाल किया जाए, ताकि बेहतर परफ़ॉर्मेंस मिल सके.

रिपोर्टिंग

आंकड़े पाने के लिए रिपोर्ट का इस्तेमाल करना

जब आपको बड़ी संख्या में इकाइयों और उनके आंकड़े वापस पाने हों, तो अक्सर AdsApp के स्टैंडर्ड तरीकों के बजाय रिपोर्ट का इस्तेमाल करना बेहतर होता है. रिपोर्ट का इस्तेमाल इन वजहों से बेहतर होता है:

रिपोर्ट की मदद से, बड़ी क्वेरी को बेहतर तरीके से प्रोसेस किया जा सकता है.
रिपोर्ट, डेटा फ़ेच करने के सामान्य कोटे पर असर नहीं डालेंगी.

यहां दिए गए कोड स्निपेट की तुलना करें. ये स्निपेट, उन सभी कीवर्ड के क्लिक, इंप्रेशन, लागत, और टेक्स्ट फ़ेच करते हैं जिन्हें पिछले महीने 50 से ज़्यादा क्लिक मिले:

कोडिंग का तरीका	कोड स्निपेट
रिपोर्ट का इस्तेमाल करना (इसका सुझाव दिया जाता है)	report = AdsApp.search( 'SELECT ' + ' ad_group_criterion.keyword.text, ' + ' metrics.clicks, ' + ' metrics.cost_micros, ' + ' metrics.impressions ' + 'FROM ' + ' keyword_view ' + 'WHERE ' + ' segments.date DURING LAST_MONTH ' + ' AND metrics.clicks > 50'); while (report.hasNext()) { var row = report.next(); Logger.log('Keyword: %s Impressions: %s ' + 'Clicks: %s Cost: %s', row.adGroupCriterion.keyword.text, row.metrics.impressions, row.metrics.clicks, row.metrics.cost); }
AdsApp इटरेटर का इस्तेमाल करना (इसका सुझाव नहीं दिया जाता)	var keywords = AdsApp.keywords() .withCondition('metrics.clicks > 50') .forDateRange('LAST_MONTH') .get(); while (keywords.hasNext()) { var keyword = keywords.next(); var stats = keyword.getStatsFor('LAST_MONTH'); Logger.log('Keyword: %s Impressions: %s ' + 'Clicks: %s Cost: %s', keyword.getText(), stats.getImpressions(), stats.getClicks(), stats.getCost()); }

कोडिंग का तरीका

कोड स्निपेट

रिपोर्ट का इस्तेमाल करना (इसका सुझाव दिया जाता है)

  report = AdsApp.search(
      'SELECT ' +
      '   ad_group_criterion.keyword.text, ' +
      '   metrics.clicks, ' +
      '   metrics.cost_micros, ' +
      '   metrics.impressions ' +
      'FROM ' +
      '   keyword_view ' +
      'WHERE ' +
      '   segments.date DURING LAST_MONTH ' +
      '   AND metrics.clicks > 50');
  while (report.hasNext()) {
    var row = report.next();
    Logger.log('Keyword: %s Impressions: %s ' +
        'Clicks: %s Cost: %s',
        row.adGroupCriterion.keyword.text,
        row.metrics.impressions,
        row.metrics.clicks,
        row.metrics.cost);
  }

AdsApp इटरेटर का इस्तेमाल करना (इसका सुझाव नहीं दिया जाता)

var keywords = AdsApp.keywords()
    .withCondition('metrics.clicks > 50')
    .forDateRange('LAST_MONTH')
    .get();
while (keywords.hasNext()) {
  var keyword = keywords.next();
  var stats = keyword.getStatsFor('LAST_MONTH');
  Logger.log('Keyword: %s Impressions: %s ' +
      'Clicks: %s Cost: %s',
      keyword.getText(),
      stats.getImpressions(),
      stats.getClicks(),
      stats.getCost());
}

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

रिपोर्ट के बजाय खोज का इस्तेमाल करना

रिपोर्टिंग का यह तरीका, पुराने इन्फ़्रास्ट्रक्चर के लिए बनाया गया था. इसलिए, GAQL का इस्तेमाल करने पर भी नतीजे फ़्लैट फ़ॉर्मैट में दिखेंगे. इसका मतलब है कि क्वेरी के नतीजों को पुराने स्टाइल से मैच करने के लिए, इसे बदलना होगा. हालांकि, यह सुविधा सभी फ़ील्ड के लिए उपलब्ध नहीं है. साथ ही, इससे हर कॉल में ओवरहेड जुड़ जाता है.

हमारा सुझाव है कि Google Ads API की नई रिपोर्टिंग की सभी सुविधाओं का फ़ायदा पाने के लिए, खोज सुविधा का इस्तेमाल करें.

AWQL के बजाय GAQL का इस्तेमाल करना

तकनीकी तौर पर, AWQL अब भी रिपोर्ट क्वेरी और withCondition कॉल के लिए काम करता है. हालांकि, इसका इस्तेमाल करने का सुझाव नहीं दिया जाता. अपनी क्वेरी पर पूरा कंट्रोल रखने के लिए, पक्का करें कि GAQL का इस्तेमाल किया जा रहा हो.

ज़रूरत से ज़्यादा लाइनें न चुनें

रिपोर्ट (और सिलेक्टर) को प्रोसेस करने की स्पीड, रिपोर्ट से मिलने वाली लाइनों की कुल संख्या पर निर्भर करती है. इससे कोई फ़र्क़ नहीं पड़ता कि आपने उन्हें दोहराया है या नहीं. इसका मतलब है कि आपको हमेशा खास फ़िल्टर इस्तेमाल करने चाहिए, ताकि नतीजों के सेट को कम से कम किया जा सके. इससे, आपके इस्तेमाल के उदाहरण से मेल खाने वाले नतीजे मिलेंगे.

उदाहरण के लिए, मान लें कि आपको ऐसे विज्ञापन ग्रुप ढूंढने हैं जिनकी बिड किसी खास रेंज से बाहर हैं. सभी विज्ञापन ग्रुप फ़ेच करने और उनमें से अपनी पसंद के विज्ञापन ग्रुप को अनदेखा करने के बजाय, दो अलग-अलग क्वेरी करना ज़्यादा तेज़ होगा. पहली क्वेरी, सबसे कम थ्रेशोल्ड से कम बिड के लिए और दूसरी क्वेरी, सबसे ज़्यादा थ्रेशोल्ड से ज़्यादा बिड के लिए.

कोडिंग का तरीका	कोड स्निपेट
दो क्वेरी का इस्तेमाल करना (सुझाया गया)	var adGroups = [] var report = AdsApp.search( 'SELECT ad_group.name, ad_group.cpc_bid_micros' + ' FROM ad_group WHERE ad_group.cpc_bid_micros < 1000000'); while (report.hasNext()) { var row = report.next(); adGroups.push(row.adGroup); } var report = AdsApp.search( 'SELECT ad_group.name, ad_group.cpc_bid_micros' + ' FROM ad_group WHERE ad_group.cpc_bid_micros > 2000000'); while (report.hasNext()) { var row = report.next(); adGroups.push(row.adGroup); }
सामान्य क्वेरी से फ़िल्टर करना (इसका सुझाव नहीं दिया जाता)	var adGroups = [] var report = AdsApp.search( 'SELECT ad_group.name, ad_group.cpc_bid_micros' + ' FROM ad_group'); while (report.hasNext()) { var row = report.next(); var cpcBidMicros = row.adGroup.cpcBidMicros; if (cpcBidMicros < 1000000 \|\| cpcBidMicros > 2000000) { adGroups.push(row.adGroup); } }

कोडिंग का तरीका

कोड स्निपेट

दो क्वेरी का इस्तेमाल करना (सुझाया गया)

var adGroups = []
var report = AdsApp.search(
    'SELECT ad_group.name, ad_group.cpc_bid_micros' +
    ' FROM ad_group WHERE ad_group.cpc_bid_micros < 1000000');

while (report.hasNext()) {
  var row = report.next();
  adGroups.push(row.adGroup);
}
var report = AdsApp.search(
    'SELECT ad_group.name, ad_group.cpc_bid_micros' +
    ' FROM ad_group WHERE ad_group.cpc_bid_micros > 2000000');

while (report.hasNext()) {
  var row = report.next();
  adGroups.push(row.adGroup);
}

सामान्य क्वेरी से फ़िल्टर करना (इसका सुझाव नहीं दिया जाता)

var adGroups = []
var report = AdsApp.search(
    'SELECT ad_group.name, ad_group.cpc_bid_micros' +
    ' FROM ad_group');

while (report.hasNext()) {
  var row = report.next();
  var cpcBidMicros = row.adGroup.cpcBidMicros;
  if (cpcBidMicros < 1000000 || cpcBidMicros > 2000000) {
    adGroups.push(row.adGroup);
  }
}

Google Ads मैनेजर खाते (एमसीसी) की स्क्रिप्ट

सीरियल एक्ज़ीक्यूशन के बजाय executeInParallel को प्राथमिकता दें

मैनेजर खातों के लिए स्क्रिप्ट लिखते समय, जहां हो सके वहां सीरियल एक्ज़ीक्यूशन के बजाय executeInParallel() का इस्तेमाल करें. executeInParallel() से आपकी स्क्रिप्ट को ज़्यादा प्रोसेसिंग टाइम (एक घंटे तक) मिलता है. साथ ही, हर प्रोसेस किए गए खाते के लिए 30 मिनट तक का समय मिलता है. हालांकि, सीरियल एक्ज़ीक्यूशन के लिए कुल 30 मिनट का समय मिलता है. ज़्यादा जानकारी के लिए, सीमाएं पेज देखें.

स्प्रेडशीट

स्प्रेडशीट अपडेट करते समय, एक साथ कई कार्रवाइयों का इस्तेमाल करना

स्प्रेडशीट अपडेट करते समय, एक बार में एक सेल अपडेट करने वाले तरीकों के बजाय, एक साथ कई कार्रवाइयां करने वाले तरीकों (उदाहरण के लिए, getRange()) का इस्तेमाल करें.

यहां दिए गए कोड स्निपेट पर विचार करें. यह कोड, स्प्रेडशीट पर फ़्रैक्टल पैटर्न जनरेट करता है.

कोडिंग का तरीका	कोड स्निपेट
एक ही कॉल में सेल की रेंज अपडेट करना (इसका सुझाव दिया जाता है)	var colors = new Array(100); for (var y = 0; y < 100; y++) { xcoord = xmin; colors[y] = new Array(100); for (var x = 0; x < 100; x++) { colors[y][x] = getColor_(xcoord, ycoord); xcoord += xincrement; } ycoord -= yincrement; } sheet.getRange(1, 1, 100, 100).setBackgroundColors(colors);
एक बार में एक सेल अपडेट करना (इसका सुझाव नहीं दिया जाता)	var cell = sheet.getRange('a1'); for (var y = 0; y < 100; y++) { xcoord = xmin; for (var x = 0; x < 100; x++) { var c = getColor_(xcoord, ycoord); cell.offset(y, x).setBackgroundColor(c); xcoord += xincrement; } ycoord -= yincrement; SpreadsheetApp.flush(); }

कोडिंग का तरीका

कोड स्निपेट

एक ही कॉल में सेल की रेंज अपडेट करना (इसका सुझाव दिया जाता है)

var colors = new Array(100);
for (var y = 0; y < 100; y++) {
  xcoord = xmin;
  colors[y] = new Array(100);
  for (var x = 0; x < 100; x++) {
    colors[y][x] = getColor_(xcoord, ycoord);
    xcoord += xincrement;
  }
  ycoord -= yincrement;
}
sheet.getRange(1, 1, 100, 100).setBackgroundColors(colors);

एक बार में एक सेल अपडेट करना (इसका सुझाव नहीं दिया जाता)

var cell = sheet.getRange('a1');
for (var y = 0; y < 100; y++) {
  xcoord = xmin;
  for (var x = 0; x < 100; x++) {
    var c = getColor_(xcoord, ycoord);
    cell.offset(y, x).setBackgroundColor(c);
    xcoord += xincrement;
  }
  ycoord -= yincrement;
  SpreadsheetApp.flush();
}

Google Sheets, वैल्यू को कैश मेमोरी में सेव करके दूसरे कोड स्निपेट को ऑप्टिमाइज़ करने की कोशिश करता है. हालांकि, एपीआई कॉल की संख्या ज़्यादा होने की वजह से, यह अब भी पहले स्निपेट की तुलना में खराब परफ़ॉर्म करता है.