Orientación de campaña

Las secuencias de comandos de Google Ads te permiten trabajar con la configuración de segmentación a nivel de la campaña en tus cuentas. Se ofrece asistencia para programaciones de anuncios, ubicaciones de segmentación y excluidas, proximidades de segmentación y plataformas. En esta guía, se muestra cómo trabajar con los objetivos de la campaña.

Programaciones de anuncios

Las programaciones de anuncios te permiten controlar cuándo se deben publicar tus anuncios.

Recuperar

Puedes recuperar los programas de anuncios de una campaña con el método adSchedules de los objetivos de la campaña. En el siguiente fragmento de código, se muestra cómo recuperar la lista de todos los criterios AdSchedule de una campaña:

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.
  ...
}

De forma predeterminada, una campaña se publica en todo momento, por lo que no recuperarás ninguna programación de anuncios si no configuraste una programación de anuncios personalizada para tu campaña.

Actualizar

Una vez que recuperas una programación de anuncios, puedes modificar sus propiedades directamente. Por ejemplo, puedes actualizar el modificador de ofertas de una programación de anuncios de la siguiente manera:

adSchedule.setBidModifier(1.1);

Crear

Para crear un programa de anuncios nuevo, puedes usar el método addAdSchedule de Campaign. El siguiente fragmento de código crea una programación de anuncios personalizada para la campaña de 7:00 a.m. a 11:00 a.m. en la zona horaria de la cuenta, todos los sábados, con un modificador de ofertas de 1.1.

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

Nota: Existe un límite de seis programas de anuncios para cada día de la semana. Por ejemplo, se admite dividir cada día en seis períodos de 4 horas, pero no se admite dividir cada día en 24 períodos de 1 hora.

Puedes consultar nuestra documentación para obtener más detalles sobre los valores permitidos para cada parámetro, así como las restricciones adicionales que debes tener en cuenta cuando crees programas de anuncios.

Quitar

Puedes quitar una programación de anuncios con su método remove. Para restablecer la programación de anuncios personalizada de una campaña, puede borrar todas sus programaciones de anuncios personalizadas de la siguiente manera:

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

Ubicaciones

También puedes segmentar o excluir ubicaciones de tu campaña con las secuencias de comandos de Google Ads.

Recuperar

Puedes recuperar la lista de ubicaciones segmentadas con el método targetedLocations de los objetivos de la campaña. Las ubicaciones excluidas se pueden recuperar con el método excludedLocations. Con el siguiente fragmento de código, se seleccionan todas las ubicaciones de segmentación que recibieron más de 100 impresiones el mes pasado.

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.
 ...
}

Si configuraste tu campaña para que se publique en todos los países y regiones, obtendrás una lista vacía de ubicaciones.

Actualizar

Una vez que recuperes una ubicación, podrás modificar sus propiedades directamente. Por ejemplo, puedes actualizar el modificador de ofertas de una ubicación de la siguiente manera:

location.setBidModifier(1.1);

Crear

Puedes crear ubicaciones de segmentación en una campaña con su método addLocation. Del mismo modo, puedes excluir una ubicación con el método excludeLocation. El siguiente fragmento de código se orienta a una campaña para Estados Unidos con un modificador de ofertas de 1.15, y no incluye la Ciudad de Nueva York.

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

Puedes consultar la documentación de la segmentación geográfica de la API de Google Ads para obtener la lista de IDs que debes usar cuando agregues la segmentación geográfica. Para hacer un seguimiento del rendimiento de tus objetivos de ubicación, puedes buscar en el recurso location_view Informe.

Quitar

Puedes quitar una ubicación de segmentación con el método remove.

Proximidades

Puedes segmentar una campaña para un radio (proximidad) alrededor de una ubicación con las secuencias de comandos de Google Ads.

Recuperar

Puedes recuperar la lista de proximidades segmentadas con el método targetedProximities en los objetivos de la campaña. Con el siguiente fragmento de código, se seleccionan todas las proximidades de destino que recibieron más de 100 impresiones el mes pasado.

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

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

Crear

Puedes crear un objetivo de segmentación por proximidad para una campaña mediante el método addProximity. En el siguiente fragmento de código, se segmenta una campaña para un radio de 20 kilómetros alrededor de las coordenadas (37.423021, -122.083739).

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

También puedes usar este método para crear el mismo objetivo de proximidad con un modificador de oferta y una dirección:

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"
  }
});

Ten en cuenta que no hay validación para verificar que la dirección realmente pertenezca a la latitud y longitud especificadas. La dirección no tiene otro propósito que cambiar lo que aparece en la interfaz de Administración de campañas.

Quitar

Puedes quitar un objetivo de proximidad con su método remove.

Plataformas

Puedes recuperar la lista de plataformas a las que se segmenta una campaña con el método platforms de los objetivos de la campaña. Dado que las campañas de Google Ads se segmentan para todas las plataformas (computadoras, dispositivos móviles y tablets), no puedes agregar ni quitar un criterio Platform. El uso más común de este criterio de segmentación es establecer el ajuste de la oferta por dispositivo de tu campaña:

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

Los IDs de plataforma se comparten entre campañas y tienen valores predefinidos según se especifica en el apéndice de plataformas de la API de Google Ads. Estos IDs pueden ser útiles cuando se analizan informes. Cuando selecciones criterios directamente, puedes usar los métodos auxiliares que proporciona PlatformSelector.