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. La asistencia está disponible para programaciones de anuncios, ubicaciones segmentadas 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
La programación de anuncios te permite controlar cuándo se deben publicar tus anuncios.
Recupera
Puedes recuperar las programaciones de anuncios de una campaña con el método adSchedules
de los segmentos 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 publica anuncios en todo momento, por lo que no se recuperará ninguna programación de anuncios si no configuraste una programación de anuncios personalizada para la campaña.
Actualizar
Una vez que recuperes una programación de anuncios, puedes 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 una programación de anuncios nueva, puedes utilizar el método addAdSchedule
de Campaign
.
El siguiente fragmento de código crea una programación de anuncios personalizada para la campaña todos los sábados de 7 a.m. a 11 a.m. en la zona horaria de la cuenta, 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 que se permiten 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 personalizada de anuncios de una campaña, puedes eliminar 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 orientar o excluir ubicaciones de tu campaña mediante las secuencias de comandos de Google Ads.
Recupera
Puedes recuperar la lista de ubicaciones de segmentación 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 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, verás una lista de ubicaciones vacía.
Actualizar
Una vez que recuperas una ubicación, puedes modificar sus propiedades directamente. Por ejemplo, podrías 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 mediante su método addLocation
. Del mismo modo, puedes excluir una ubicación mediante el método excludeLocation
. El siguiente fragmento de código se orienta a 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 los ID que se usarán cuando agregues la segmentación geográfica. Para realizar un seguimiento del rendimiento de tus
orientaciones geográficas, puedes buscar en el recurso location_view
Denunciar.
Quitar
Para quitar una ubicación de segmentación, puedes usar el método remove
.
Proximidades
Con las secuencias de comandos de Google Ads, puedes segmentar una campaña para un radio (proximidad) alrededor de una ubicación.
Recupera
Para recuperar la lista de proximidades de segmentación, puedes usar el método targetedProximities
en los objetivos de la campaña.
En el siguiente fragmento de código, se seleccionan todas las proximidades de segmentación 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 una orientación por proximidad para una campaña mediante su método addProximity
. El siguiente fragmento de código orienta una campaña a 20 kilómetros alrededor de las coordenadas (37.423021, -122.083739).
campaign.addProximity(37.423021, -122.083739, 20, "KILOMETERS");
También puedes utilizar este método para crear el mismo objetivo de proximidad con un modificador de ofertas 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 una validación para verificar si la dirección realmente pertenece a la latitud y longitud determinadas. 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 mediante su método remove
.
Plataformas
Para recuperar la lista de plataformas a las que se orienta una campaña, puedes usar el método platforms
de sus segmentos.
Dado que las campañas de Google Ads se segmentan para todas las plataformas (computadoras de escritorio, 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 según se especifica en el apéndice de plataformas de la API de Google Ads. Estos IDs pueden ser útiles cuando se analizan los informes. Si seleccionas criterios directamente, puedes usar los métodos auxiliares que proporciona PlatformSelector
.