Parâmetros de anúncio
    
    
      
    
    
      
      Mantenha tudo organizado com as coleções
    
    
      
      Salve e categorize o conteúdo com base nas suas preferências.
    
  
    
  
      
    
  
  
  
  
  
    
    
    
  
  
    
    
    
Criar anúncio de texto com parâmetros de anúncio para um grupo de anúncios
function setupAdParamsInAdGroup(adGroupName) {
  // If you have multiple adGroups with the same name, this snippet will
  // pick an arbitrary matching ad group each time. In such cases, just
  // filter on the campaign name as well:
  //
  // AdsApp.adGroups()
  //     .withCondition('ad_group.name = "INSERT_ADGROUP_NAME_HERE"')
  //     .withCondition('campaign.name = "INSERT_CAMPAIGN_NAME_HERE"')
  const adGroupIterator = AdsApp.adGroups()
      .withCondition(`ad_group.name = "${adGroupName}"`)
      .get();
  if (!adGroupIterator.hasNext()) {
    throw new Error(`No ad group with name "${adGroupName} found`);
  }
  const adGroup = adGroupIterator.next();
  adGroup.newAd().expandedTextAdBuilder()
      .withHeadlinePart1('Holiday sale')
      .withHeadlinePart2(
          'Starts in {param1: a few} days {param2: and} hours!')
      .withDescription('Everything must go!')
      .withFinalUrl('http://www.example.com/holidaysales')
      .build();
  const keywordIterator = adGroup.keywords().get();
  if (!keywordIterator.hasNext()) {
    console.log(`No keywords found in ad group ${adGroupName}.`);
  } else {
    const keyword = keywordIterator.next();
    // Setup Ad to show as 'Doors open in 5 days, 7 hours!' when searched
    // using this keyword. If the ad is triggered using a keyword
    // without ad param, the ad shows as
    // 'Doors open in a few days, and hours!'
    keyword.setAdParam(1, 5);
    keyword.setAdParam(2, 7);
  }
}
Recuperar os parâmetros de anúncio de uma palavra-chave
function getAdParamsForKeyword(adGroupName) {
  // If you have multiple adGroups with the same name, this snippet will
  // pick an arbitrary matching ad group each time. In such cases, just
  // filter on the campaign name as well:
  //
  // AdsApp.adGroups()
  //     .withCondition('ad_group.name = "INSERT_ADGROUP_NAME_HERE"')
  //     .withCondition('campaign.name = "INSERT_CAMPAIGN_NAME_HERE"')
  const adGroupIterator = AdsApp.adGroups()
      .withCondition(`ad_group.name = "${adGroupName}"`)
      .get();
  if (!adGroupIterator.hasNext()) {
    throw new Error(`No ad group with name "${adGroupName} found`);
  }
  const adGroup = adGroupIterator.next();
  const keywordIterator = adGroup.keywords()
      .withCondition('ad_group_criterion.keyword.text = "Holiday sales"')
      .get();
  if (!keywordIterator.hasNext()) {
    console.log(`No keywords found in ad group ${adGroupName}.`);
  } else {
    const keyword = keywordIterator.next();
    const adParamIterator = keyword.adParams().get();
    for (const adParam of adParamIterator) {
      logAdParam(adParam);
    }
  }
}
function logAdParam(adParam) {
  console.log('Keyword : ' + adParam.getKeyword().getText());
  console.log('MatchType : ' + adParam.getKeyword().getMatchType());
  console.log('Index : ' + adParam.getIndex());
  console.log('Insertion Text : ' + adParam.getInsertionText());
}
  
  
  
  
    
  
 
  
    
      
      
    
    
      
    
    
  
       
    
    
      
    
  
  
  Exceto em caso de indicação contrária, o conteúdo desta página é licenciado de acordo com a Licença de atribuição 4.0 do Creative Commons, e as amostras de código são licenciadas de acordo com a Licença Apache 2.0. Para mais detalhes, consulte as políticas do site do Google Developers. Java é uma marca registrada da Oracle e/ou afiliadas.
  Última atualização 2025-08-21 UTC.
  
  
  
    
      [[["Fácil de entender","easyToUnderstand","thumb-up"],["Meu problema foi resolvido","solvedMyProblem","thumb-up"],["Outro","otherUp","thumb-up"]],[["Não contém as informações de que eu preciso","missingTheInformationINeed","thumb-down"],["Muito complicado / etapas demais","tooComplicatedTooManySteps","thumb-down"],["Desatualizado","outOfDate","thumb-down"],["Problema na tradução","translationIssue","thumb-down"],["Problema com as amostras / o código","samplesCodeIssue","thumb-down"],["Outro","otherDown","thumb-down"]],["Última atualização 2025-08-21 UTC."],[],[]]