Campanha de segmentação

Com os scripts do Google Ads, você trabalha com 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ê controla quando seus anúncios são veiculados.

Recuperar

É possível recuperar as programações de anúncios de uma campanha usando o método adSchedules das metas da campanha. O snippet de código a seguir mostra como recuperar a lista de todos os critérios de 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 o tempo todo. Portanto, você não vai receber nenhuma programação de anúncios se não tiver definido uma para sua campanha.

Atualizar

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

adSchedule.setBidModifier(1.1);

Criar

Para criar uma 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 ajuste de lance de 1,1.

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

Observação :há um limite de seis programações de anúncios para cada dia da semana. Por exemplo, dividir cada dia em seis períodos de quatro horas é aceito, mas dividir cada dia em 24 períodos de uma hora não é.

Consulte nossa documentação para mais detalhes sobre os valores permitidos para cada parâmetro, além de 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 dela. Para redefinir a programação personalizada de anúncios de uma campanha, exclua todas as programações personalizadas da seguinte forma:

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

Locais

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

Recuperar

É possível recuperar a lista de locais segmentados usando o método targetedLocations dos targets da campanha. Os locais excluídos podem ser recuperados usando o método excludedLocations. O snippet de código a seguir seleciona todos os locais segmentados que receberam mais de 100 impressões no mês passado.

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 você configurou sua campanha para veiculação em todos os países e regiões, vai receber uma lista vazia de locais.

Atualizar

Assim que você recuperar um local, poderá modificar suas propriedades diretamente. Por exemplo, é possível atualizar o modificador de lance de um local da seguinte maneira:

location.setBidModifier(1.1);

Criar

É possível criar segmentações por local em uma campanha usando o método addLocation. Da mesma forma, é possível excluir um local usando o método excludeLocation. O snippet de código a seguir segmenta uma campanha nos EUA com um modificador de lance de 1,15, excluindo a cidade de Nova York.

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

Consulte a documentação da segmentação geográfica da API Google Ads para ver a lista de IDs a serem usados ao adicionar a segmentação por local. Para acompanhar a performance das suas segmentações por local, pesquise no recurso location_view Report.

Remover

Você pode remover um local de segmentação usando o método remove.

Proximidades

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

Recuperar

É possível recuperar a lista de proximidades segmentadas usando o método targetedProximities em targets da campanha. O snippet de código a seguir seleciona todas as proximidades segmentadas que receberam mais de 100 impressões no mês passado.

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 segmentação por proximidade para uma campanha usando o método addProximity. O snippet de código a seguir segmenta uma campanha para 20 quilômetros ao redor das coordenadas (37.423021, -122.083739).

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

Você também pode usar esse método para criar a mesma 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 especificadas. O endereço não tem outra finalidade além de mudar o que aparece na interface de gerenciamento de campanhas.

Remover

É possível remover uma meta de proximidade usando o método remove dela.

Plataformas

É possível recuperar a lista de plataformas segmentadas por uma campanha usando o método platforms de segmentações da campanha. Como as campanhas do Google Ads segmentam todas as plataformas (computador, dispositivos móveis e tablet), não é possível adicionar ou remover um critério de Platform. O uso mais comum desse critério de segmentação é definir o ajuste de lance por dispositivo da campanha:

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

Os IDs de plataforma são compartilhados entre campanhas e têm valores predefinidos, conforme especificado no apêndice de plataformas da API Google Ads. Esses IDs podem ser úteis ao analisar relatórios. Ao selecionar critérios diretamente, use os métodos auxiliares fornecidos por PlatformSelector.