Segmentação de campanha

Os scripts do Google AdWords permitem que você trabalhe com as configurações de segmentação no nível da campanha da sua conta. Há suporte disponível para agendamento de anúncios, regiões de segmentação e regiões excluídas, proximidades segmentadas e plataformas. Este guia resume como trabalhar com os destinos de campanha.

Agendamento de anúncios

Com o agendamento de anúncios você pode personalizar quando os anúncios devem ser exibidos.

Recuperação e atualização de agendamento de anúncios

Você pode recuperar os agendamentos de anúncios da campanha usando o método adSchedules dos destinos da campanha. O snippet de código a seguir mostra como recuperar a lista de todos os critérios de AdSchedule de uma campanha:

var campaign = AdWordsApp.campaigns()
    .withCondition("CampaignName = 'My campaign'")
    .get()
    .next();

var adSchedules = campaign.targeting().adSchedules().get();
while (adSchedules.hasNext()) {
  var adSchedule = adSchedules.next();

  // Process your ad schedule.
  …
}

Por padrão, uma campanha é veiculada sempre. Então, você não recuperará nenhum agendamento de anúncios se não tiver configurado um agendamento de anúncios personalizado para a campanha.

Assim que você recuperar um agendamento de anúncios, poderá modificar suas propriedades diretamente, por exemplo, você poderia atualizar um modificador de lances do agendamento da seguinte forma:

adSchedule.setBidModifier(1.1);

Criação de agendamentos de anúncios

Para criar um novo agendamento de anúncios, você pode usar o método addAdSchedule da Campanha. O snippet de código a seguir cria um agendamento de anúncios personalizado para a campanha das 7h às 11h, no fuso horário da conta, todos os sábados, com um modificador de lance de 1,1.

campaign.addAdSchedule({
   dayOfWeek: "SATURDAY",
   startHour: 7,
   startMinute: 0,
   endHour: 11,
   endMinute: 0,
   bidModifier: 1.1
 });

Você pode consultar a documentação para ver mais detalhes sobre quais valores são permitidos para cada parâmetro e sobre restrições adicionais que devem ser consideradas ao criar agendamentos de anúncios.

Remoção de agendamentos de anúncios

Você pode remover um agendamento de anúncios usando seu método remove. Para redefinir um agendamento de anúncios personalizado de uma campanha, você pode excluir todos os agendamentos referentes desta forma:

var adSchedules = campaign.adSchedules().get();
while (adSchedules.hasNext()) {
  var adSchedule = adSchedules.next();
  adSchedule.remove();
}

Locais

Você pode segmentar ou excluir os locais da sua campanha usando os scripts do Google AdWords.

Recuperação e atualização de regiões de segmentação

Você pode recuperar a lista de regiões de segmentação usando o método targetedLocations dos destinos da campanha. As regiões excluídas podem ser recuperadas usando o método excludedLocations. O snippet de código a seguir seleciona todas as regiões de segmentação que geraram mais de cem impressões no mês anterior.

var locationSelector = AdWordsApp.targeting()
    .locations()
    .withCondition("Impressions > 100")
    .forDateRange("LAST_MONTH")
    .orderBy("Clicks DESC");

 var locationIterator = locationSelector.get();
 while (locationIterator.hasNext()) {
   var location = locationIterator.next();

   // Process the campaign target here.
   ...
 }

Se você tiver definido a veiculação da campanha em todos os países e regiões, receberá uma lista vazia de locais.

Assim que você recuperar um local, poderá modificar suas propriedades diretamente. Por exemplo, você poderia atualizar um modificador de lance do local da seguinte forma:

location.setBidModifier(1.1);

Você pode remover uma região segmentada usando o método remove.

Criação de áreas de segmentação

Você pode criar áreas de segmentação em uma campanha usando seu método addLocation. Da mesma forma, você pode excluir um local usando o método excludeLocation. O snippet de código a seguir segmenta uma campanha dos EUA com um modificador de lances de 1,15, excluindo New York City.

campaign.addLocation(2840, 1.15);     // United States
campaign.excludeLocation(1023191);    // New York city

Consulte a documentação sobre segmentação geográfica da Google AdWords API para ver a lista de IDs a ser usada quando adicionar a segmentação por local. Para acompanhar o desempenho das suas áreas de segmentação, gere o Relatório de área de segmentação da campanha.

Proximidades

Você pode segmentar um raio (proximidade) ao redor de um local para uma campanha usando os scripts do Google AdWords.

Recuperação e atualização de proximidades

Você pode recuperar a lista de proximidades segmentadas usando o método targetedProximities nos destinos da campanha. O snippet de código a seguir seleciona todas as proximidades segmentadas que geraram mais de cem impressões no mês anterior.

var proximitySelector = AdWordsApp.targeting()
    .targetedProximities()
    .withCondition("Impressions > 100")
    .forDateRange("LAST_MONTH")
    .orderBy("Clicks DESC");

var proximityIterator = proximitySelector.get();
while (proximityIterator.hasNext()) {
  var proximity = proximityIterator.next();
  …
}

É possível remover uma área de segmentação por proximidade usando o método remove.

Criação de áreas de segmentação por proximidade

Você pode criar uma área de segmentação por proximidade para uma campanha usando o método addProximity. O snippet de código a seguir segmenta uma campanha a 20 km ao redor da localização geográfica (37.423021, -122.083739).

campaign.addProximity(37.423021, -122.083739, 20, "KILOMETERS");

Você pode usar esse método para criar a mesma área de segmentação por proximidade com um modificador de lance e um endereço:

campaign.addProximity(37.423021, -122.083739, 20, "KILOMETERS", {
  bidModifier: 1.15,
  address: {
    streetAddress: "1600 Amphitheatre Parkway",
    cityName: "Mountain View",
    provinceName: "California",
    provinceCode: "CA",
    postalCode: "94043",
    countryCode: "US"
  }
});

Lembre-se de que não há validação para verificar se o endereço efetivamente pertence à latitude e à longitude indicadas. O endereço serve exclusivamente para alterar o que é exibido na interface do Gerenciamento de campanhas.

Plataformas

Você pode recuperar a lista de plataformas que uma campanha segmenta usando o método platforms nos destinos da campanha. Como as campanhas do Google AdWords segmentam todas as plataformas (desktop, celular e tablet), não é possível adicionar ou remover um critério de plataforma. O uso mais comum desse critério de segmentação é definir seu ajuste de lance de dispositivos da campanha, como exibido abaixo:

campaign.targeting()
    .platforms()
    .mobile()
    .get()
    .next().
    setBidModifier(1.2);

Os IDs de plataforma são compartilhados com todas as campanhas e têm valores predefinidos como especificado no apêndice de plataformas da Google AdWords API. Esses IDs podem ser úteis ao analisar relatórios. Ao selecionar critérios diretamente, você pode usar os métodos fornecidos pelo PlatformSelector.

Enviar comentários sobre…

Precisa de ajuda? Acesse nossa página de suporte.