Públicos-alvo da Rede de Pesquisa
    
    
      
    
    
      
      Mantenha tudo organizado com as coleções
    
    
      
      Salve e categorize o conteúdo com base nas suas preferências.
    
  
    
  
      
    
  
  
  
  
  
    
    
    
  
  
    
    
    
Adicionar o público-alvo da Rede de Pesquisa a um grupo de anúncios
function addSearchAudienceToAdGroup(adGroupName, audienceId, bidModifier = 1.5) {
  // Retrieve the ad group.
  const adGroups = AdsApp.adGroups()
      .withCondition(`ad_group.name = "${adGroupName}"`)
      .get();
  if (!adGroups.hasNext()) {
    throw new Error(`Cannot find ad group with name "${adGroupName}"`);
  }
  const adGroup = adGroups.next();
  if (adGroups.totalNumEntities() > 1) {
    console.warn(`More than one ad group with name "${adGroupName}" was ` +
    `found. Using the ad group in campaign ` +
    `"${adGroup.getCampaign().getName()}"`);
  }
  // Create the search audience.
  const operation = adGroup.targeting()
      .newUserListBuilder()
      .withAudienceId(audienceId)
      .withBidModifier(bidModifier)
      .build();
  if (!operation.isSuccessful()) {
    console.warn(`Failed to attach search audience. ` +
    `Errors: ${operation.getErrors().join(', ')}'`);
  }
  const searchAudience = operation.getResult();
  // Display the results.
  console.log(`Search audience with name ${searchAudience.getName()} and ` +
      `ID = ${searchAudience.getId().toFixed(0)} was added to ` +
      `ad group "${adGroupName}".`);
}
Ver o público-alvo da Rede de Pesquisa do grupo de anúncios por nome
function getAdGroupSearchAudienceByName(campaignName, adGroupName, audienceName) {
  // Retrieve the search audience.
  const searchAudiences = AdsApp.adGroupTargeting().audiences()
      .withCondition(`campaign.name = "${campaignName}"`)
      .withCondition(`ad_group.name = "${adGroupName}"`)
      .get();
  for (const audience of searchAudiences) {
    if (audience.getName() == audienceName) {
      return audience;
    }
  }
  // Display the results.
  console.warn(`Cannot find an audience "${audienceName}" in the ad group
    "${adGroupName}" belonging to the campaign "${campaignName}".`);
}
Filtrar o público-alvo da Rede de Pesquisa do grupo de anúncios por estatísticas
function filterAdGroupAudienceByStats() {
  // Retrieve top performing search audiences.
  const topPerformingAudiences = AdsApp.adGrouptargeting().audiences()
      .withCondition(`campaign.name = "Campaign #1"`)
      .withCondition(`ad_group.name = "Ad Group #1"`)
      .withCondition("metrics.clicks > 34")
      .forDateRange("LAST_MONTH")
      .get();
  for (const audience of topPerformingAudiences) {
    const stats = audience.getStatsFor("LAST_MONTH");
    console.log(`Search audience with ID = ${audience.getId().toFixed(0)}, ` +
        `name = "${audience.getName()}" and audience list ID = ` +
        `${audience.getAudienceId()} had ${stats.getClicks()} clicks last ` +
        `month.`);
  }
}
Excluir o público-alvo da Rede de Pesquisa de uma campanha
function addExcludedAudienceToCampaign(campaignName, audienceId) {
  // Retrieve the campaign.
  const campaigns = AdsApp.campaigns()
      .withCondition(`campaign.name = "${campaignName}"`)
      .get();
  if (!campaigns.hasNext()) {
    throw new Error(`Cannot find campaign with name "${campaignName}"`);
  }
  const campaign = campaigns.next();
  // Create the excluded audience.
  const operation = campaign.targeting()
      .newUserListBuilder()
      .withAudienceId(`${audienceId}``)
      .exclude();
  if (!operation.isSuccessful()) {
    console.warn(`Failed to exclude audience ${audienceId}. Errors: ${operation.getErrors().join(', ')}`);
  }
  const audience = operation.getResult();
  console.log(`Excluded audience "${audience.getName()}" from campaign ` +
      ``"${campaignName}".`);
}
Recuperar os públicos-alvos excluídos da Rede de Pesquisa de uma campanha
function getExcludedAudiencesForCampaign(campaignName) {
  // Retrieve the campaign.
  const campaign = AdsApp.campaigns()
      .withCondition(`campaign.name = "${campaignName}"`)
      .get();
  if (!campaigns.hasNext()) {
    throw new Error(`Cannot find campaign with name "${campaignName}"`);
  }
  const campaign = campaigns.next();
  return campaign.targeting().excludedAudiences().get();
}
Definir a configuração de segmentação do grupo de anúncios
function setAdGroupTargetSetting(campaignName, adGroupName, group = "USER_INTEREST_AND_ALL", setting = "TARGET_ALL_TRUE") {
  // Retrieve the ad group.
  const adGroups = AdsApp.adGroups()
      .withCondition(`campaign.name = "${campaignName}"`)
      .withCondition(`ad_group.name = "${adGroupName}"`)
      .get();
  if (!adGroups.hasNext()) {
    throw new Error(`Cannot find ad group with name "${adGroupName}" in ` +
        `campaign "${campaignName}"`);
  }
  // Change the target setting.
  adGroup.targeting().setTargetingSetting(group, setting);
}
Atualizar o modificador de lance de público-alvo
function updateAudienceBidModifer(campaignName, adGroupName, audienceName, bidModifier = 1.5) {
  // Create the search audience.
  const audiences = AdsApp.adGrouptargeting().audiences()
      .withCondition(`campaign.name = "${campaignName}"`)
      .withCondition(`ad_group.name = "${adGroupName}"`)
      .get();
  for (const audience of audiences) {
    if (audience.getName() == audienceName) {
      audience.bidding().setBidModifier(bidModifier);
    }
  }
}
  
  
  
  
    
  
 
  
    
      
      
    
    
      
    
    
  
       
    
    
      
    
  
  
  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."],[],[]]