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 admite la programación de anuncios, las ubicaciones incluidas y excluidas, las proximidades segmentadas y las plataformas. En esta guía, se muestra cómo trabajar con los objetivos de las campañas.

Programaciones de anuncios

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

Recupera

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 de 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 recibirá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, podrías 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 a.m. a 11 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
});

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 programaciones 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, 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 tus campañas para ubicaciones o excluirlas de ellas con las secuencias de comandos de Google Ads.

Recupera

Puedes recuperar la lista de ubicaciones objetivo con el método targetedLocations de los objetivos de la campaña. Las ubicaciones excluidas se pueden recuperar con el método excludedLocations. El siguiente fragmento de código selecciona 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 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 segmenta una campaña para EE.UU. con un modificador de ofertas de 1.15 y excluye la ciudad de Nueva York.

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

Puedes consultar la documentación sobre 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 por ubicación. Para hacer un seguimiento del rendimiento de tus segmentaciones por ubicación, puedes buscar en el recurso location_view Informe.

Quitar

Puedes quitar un objetivo de ubicación con el método remove.

Proximidades

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

Recupera

Puedes recuperar la lista de proximidades segmentadas con el método targetedProximities en los objetivos de la campaña. El siguiente fragmento de código selecciona todas las ubicaciones objetivo 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 proximidad para una campaña con su método addProximity. El siguiente fragmento de código segmenta una campaña para que se muestre en 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 proporcionadas. 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 del objeto targets 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 de 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 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.