Campanha de segmentação

Com os scripts do Google Ads, você pode trabalhar com as configurações de segmentação no nível da campanha nas suas contas. 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 mostra como trabalhar com segmentações de campanha.

Programações de anúncios

Com as programações de anúncios, você pode controlar quando seus anúncios devem ser exibidos.

Recuperar

Use o método adSchedules da segmentação da campanha para recuperar as programações de anúncios. O snippet de código a seguir mostra como recuperar a lista de todos os critérios AdSchedule de uma campanha:

const campaign = AdsApp.campaigns()
    .withCondition("campaign.name = 'My campaign'")
    .get()
    .next();

const adSchedules = campaign.targeting().adSchedules().get();
for (const adSchedule of adSchedules) {
  // Process your ad schedule.
  ...
}

Por padrão, uma campanha é veiculada sempre. Assim, você não terá nenhum agendamento de anúncios novamente se não tiver definido uma programação personalizada para sua campanha.

Atualizar

Depois de recuperar uma programação de anúncios, é possível modificar suas propriedades diretamente. Por exemplo, você pode atualizar o modificador de lances de uma programação de anúncios da seguinte maneira:

adSchedule.setBidModifier(1.1);

Criar

Para criar uma nova programação de anúncios, use o método addAdSchedule de Campaign. O snippet de código a seguir cria uma programação de anúncios personalizada 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
});

Confira nossa documentação para mais detalhes sobre quais valores são permitidos para cada parâmetro, assim como outras restrições a serem consideradas ao criar programações de anúncios.

Remover

É possível remover uma programação de anúncios usando o método remove. Para redefinir a programação de anúncios personalizada de uma campanha, exclua todas as programações da seguinte forma:

const adSchedules = campaign.adSchedules().get();
for (const adSchedule of adSchedules) {
  adSchedule.remove();
}

Locais

Também é possível segmentar ou excluir os locais da sua campanha usando os scripts do Google Ads.

Recuperar

É possível recuperar a lista de locais segmentados usando o método targetedLocations dos destinos da campanha. Os locais excluídos podem ser recuperados usando o método excludedLocations. O snippet de código a seguir seleciona todas as regiões de segmentação que receberam mais de 100 impressões no último mês.

const locations = AdsApp.targeting()
  .targetedLocations()
  .withCondition("metrics.impressions > 100")
  .forDateRange("LAST_MONTH")
  .orderBy("metrics.clicks DESC")
  .get();

for (const location of locations) {
 // Process the campaign target here.
 ...
}

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

Atualizar

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

location.setBidModifier(1.1);

Criar

É possível criar locais de segmentação em uma campanha usando o 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 lance de 1,15, excluindo Nova York.

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

Consulte a documentação sobre segmentação geográfica da API Google Ads para ver a lista de IDs a ser usada quando adicionar a segmentação por local. Para acompanhar a performance das suas segmentações por local, pesquise no recurso Relatório location_view.

Remover

Você pode remover uma segmentação por local usando o método remove.

Proximidades

É possível segmentar uma campanha para um raio (proximidade) ao redor de um local usando os scripts do Google Ads.

Recuperar

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 receberam mais de 100 impressões no último mês.

const proximities = AdsApp.targeting()
    .targetedProximities()
    .withCondition("metrics.impressions > 100")
    .forDateRange("LAST_MONTH")
    .orderBy("metrics.clicks DESC")
    .get();

for (const proximity of proximities) {
  ...
}

Criar

É possível 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 quilômetros ao redor das coordenadas (37.423021, -122.083739).

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

Também é possível 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"
  }
});

Não há validação para verificar se o endereço realmente pertence à latitude e longitude indicadas. O endereço serve apenas para alterar o que é exibido na interface do Gerenciamento de campanhas.

Remover

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

Plataformas

Recupere a lista de plataformas que uma campanha segmenta usando o método platforms dos destinos da campanha. Como as campanhas do Google Ads segmentam todas as plataformas (computador, smartphone e tablet), não é possível adicionar ou remover um critério Platform. O uso mais comum desse critério de segmentação é definir o ajuste de lance por dispositivo da sua campanha:

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, conforme especificado no apêndice das plataformas da API Google Ads. Esses IDs podem ser úteis ao analisar relatórios. Ao selecionar critérios diretamente, você pode usar os métodos auxiliares fornecidos por PlatformSelector.