Campanha de segmentação

Os scripts do Google Ads permitem 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 as metas de campanha.

Programações de anúncios

As programações de anúncios permitem controlar quando os anúncios são veiculados.

Recuperar

É possível recuperar as programações de anúncios de uma campanha usando o adSchedules método das metas da campanha. O snippet de código a seguir mostra como recuperar a lista de todos os AdSchedule critérios 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 programação personalizada 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 lance 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 addAdSchedule método 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
});

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 em 24 períodos de uma hora.

Consulte nossa documentação para mais detalhes sobre os valores permitidos para cada parâmetro, bem 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 remove método. Para redefinir a programação de anúncios personalizada de uma campanha, exclua todas as programações personalizadas dela 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 os scripts do Google Ads.

Recuperar

É possível recuperar a lista de locais segmentados usando o targetedLocations método das metasda campanha. Os locais excluídos podem ser recuperados usando o excludedLocations método. 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ê tiver definido a campanha para ser veiculada 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 metas de local em uma campanha usando o addLocation método. Da mesma forma, é possível excluir um local usando o excludeLocation método. O snippet de código a seguir 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 de 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 metas de local, pesquise no location_view recurso de relatório.

Remover

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

Proximidades

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

Recuperar

É possível recuperar a lista de proximidades segmentadas usando o targetedProximities método nas metas 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 área de segmentação por proximidade para uma campanha usando o addProximity método. O snippet de código a seguir segmenta uma campanha para 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 a mesma área de segmentação por proximidade com um modificador de lances 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 fornecidas. 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 área de segmentação por proximidade usando o remove método.

Plataformas

É possível recuperar a lista de plataformas que uma campanha segmenta usando o platforms método das metas da campanha. Como as campanhas do Google Ads segmentam todas as plataformas (computador, dispositivos móveis e tablets), não é possível adicionar ou remover um Platform critério. 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, é possível usar os métodos auxiliares fornecidos por PlatformSelector.