Orientación de campaña

Los secuencias de comandos de Google Ads te permiten trabajar con la configuración de la segmentación a nivel de la campaña en tus cuentas. La asistencia está disponible para las programaciones de anuncios, las ubicaciones segmentadas y excluidas, las proximidades segmentadas y las 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.

Recupera

Puedes recuperar las programaciones de anuncios de una campaña con el adSchedules método de los objetivosde la campaña. En el siguiente fragmento de código, se muestra cómo recuperar la lista de todos los AdSchedule criterios 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 obtendrás ninguna programación de anuncios si no estableciste una personalizada para tu campaña.

Actualizar

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

adSchedule.setBidModifier(1.1);

Crear

Para crear una nueva programación de anuncios, puedes usar el addAdSchedule método de Campaign. En el siguiente fragmento de código, se crea una programación de anuncios personalizada para la campaña de 7 a.m. a 11 a.m. en la zona horaria de la cuenta, todos los sábados, con un modificador de oferta 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 programaciones 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 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 creas programaciones de anuncios.

Quitar

Puedes quitar una programación de anuncios con su remove método. Para restablecer la programación de anuncios personalizada de una campaña, puedes 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 para tu campaña con los secuencias de comandos de Google Ads.

Recupera

Puedes recuperar la lista de ubicaciones segmentadas con el targetedLocations método de los objetivosde la campaña. Las ubicaciones excluidas se pueden recuperar con el excludedLocations método. En el siguiente fragmento de código, se seleccionan todas las ubicaciones segmentadas 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 de ubicaciones vacía.

Actualizar

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

location.setBidModifier(1.1);

Crear

Puedes crear segmentaciones por ubicación en una campaña con su addLocation método. Del mismo modo, puedes excluir una ubicación con el excludeLocation método. En el siguiente fragmento de código, se segmenta una campaña para EE.UU. con un modificador de oferta de 1.15, mientras que se excluye la ciudad de Nueva York.

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

Puedes consultar la documentación de segmentación geográfica de la API de Google Ads para obtener la lista de IDs que se deben usar cuando se agrega la segmentación por ubicación. Para hacer un seguimiento del rendimiento de tus segmentaciones por ubicación, puedes buscar en location_view recurso de informe.

Quitar

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

Proximidades

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

Recupera

Puedes recuperar la lista de proximidades segmentadas con el targetedProximities método de los objetivosde la campaña. En el siguiente fragmento de código, se seleccionan todas las proximidades segmentadas 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 con su addProximity método. En el siguiente fragmento de código, se segmenta una campaña para 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 segmentación por 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 dadas. 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 segmentación por proximidad con el remove método.

Plataformas

Puedes recuperar la lista de plataformas a las que se segmenta una campaña con el platforms método 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 Platform criterio. 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 las campañas y tienen valores predefinidos, como se especifica en el apéndice de plataformas de la API de Google Ads. Estos IDs pueden ser útiles cuando se analizan informes. Cuando seleccionas criterios directamente, puedes usar los métodos auxiliares que proporciona PlatformSelector.