Campanha de segmentação

Com os scripts do Google Ads, você trabalha 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 as metas de campanha.

Programações de anúncios

As programações de anúncios permitem controlar quando os anúncios devem ser exibidos.

Recuperar

É possível extrair 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 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. Por isso, você não receberá programações de anúncios se não tiver definido uma programação personalizada para sua campanha.

Atualizar

Depois de extrair uma programação de anúncios, é possível modificar as propriedades dela 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 do 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
});

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

Consulte nossa documentação para mais detalhes sobre quais valores são permitidos para cada parâmetro, bem como restrições adicionais 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 personalizados de uma campanha, exclua todas as programações de anúncios personalizados da seguinte maneira:

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 alvo usando o método targetedLocations das segmentações 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 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 a campanha para veicular 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 locais de segmentação 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 abaixo segmenta uma campanha para os 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 conferir 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 Relatório do location_view.

Remover

É possível remover um local de segmentação usando o método remove.

Proximidades

É possível segmentar uma campanha em 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 nos destinos 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 meta de proximidade para uma campanha usando o método addProximity. O snippet de código a seguir segmenta uma campanha a 20 quilômetros em torno das coordenadas (37.423021, -122.083739).

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

Também é possível usar esse método para criar o mesmo destino de 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 do Gerenciamento de campanhas.

Remover

É possível remover um alvo de proximidade usando o método remove.

Plataformas

É possível recuperar a lista de plataformas que uma campanha segmenta usando o método platforms das segmentações da campanha. Como as campanhas do Google Ads segmentam todas as plataformas (computador, dispositivo móvel 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 sua 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 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.