Las secuencias de comandos de Google Ads te permiten administrar y generar informes sobre tus campañas de video basadas en YouTube. Puedes usar secuencias de comandos para administrar campañas de video existentes, crear y administrar anuncios y grupos de anuncios, configurar la orientación de las campañas y ejecutar informes. Sin embargo, no puede usar secuencias de comandos para crear campañas de video.
Cómo recuperar campañas y grupos de anuncios de video
Las campañas de video están disponibles a través de la colección videoCampaigns
de un objeto AdsApp
. Puedes
recuperarlas como lo harías normalmente con las campañas en secuencias de comandos:
const campaignName = "My first video campaign";
const campaignIterator = AdsApp.videoCampaigns()
.withCondition(`campaign.name = "${campaignName}"`)
.get();
for (const campaign of campaignIterator) {
...
}
Una vez que hayas recuperado una campaña, puedes obtener sus grupos de anuncios de la misma manera:
const adGroupIterator = campaign.videoAdGroups()
.withCondition(`ad_group.name = "${adGroupName}"`)
.get();
for (const adGroup of adGroupIterator) {
...
}
Como alternativa, puedes usar el método AdsApp.videoAdGroups()
:
const adGroupIterator = AdsApp.videoAdGroups()
.withCondition(`campaign.name = "${campaignName}" AND ad_group.name = "${adGroupName}")
.get();
for (const adGroup of adGroupIterator) {
...
}
Cómo crear anuncios de video
Las secuencias de comandos de Google Ads te permiten recuperar tus anuncios de video mediante el método videoAds()
de VideoAdGroup
.
Puedes crear nuevos anuncios de video con el método newVideoAd()
de VideoAdGroup
.
Formatos de anuncios de video
Los formatos de anuncios de video admitidos varían según el tipo de campaña de video. Para asegurarte
de seleccionar el tipo adecuado de campaña de video, agrega una llamada withCondition
en AdvertisingChannelSubType
.
Algunas campañas de video tienen subtipos que restringen los tipos de anuncios compatibles con cada campaña. Específicamente, las campañas VIDEO_ACTION
solo admiten el tipo de anuncio VIDEO_RESPONSIVE
, y las campañas VIDEO_NON_SKIPPABLE
solo admiten el tipo de anuncio NON_SKIPPABLE_INSTREAM_VIDEO_AD
.
La mejor manera de operar en tipos específicos de campañas es usar una cláusula withCondition
en el selector. Puedes actualizar el atributo AdvertisingChannelSubType
para el tipo de interés de campaña:
const campaignIterator = AdsApp.videoCampaigns()
.withCondition("AdvertisingChannelSubType = VIDEO_ACTION")
.get();
Las campañas de video sin subtipo admiten los siguientes formatos de anuncios de video:
- TrueView in-stream
- Video discovery de TrueView
- Anuncio bumper
Puedes seleccionar estas campañas mediante un withCondition
:
const campaignIterator = AdsApp.videoCampaigns()
.withCondition("AdvertisingChannelSubType = null")
.get();
Los anuncios de video in-stream pueden reproducirse antes, durante o después de otros videos, lo que les da a los usuarios la opción de omitirlos después de un tiempo específico. Los anuncios video discovery aparecen en la Red de Display y en varias páginas de YouTube, y solo se reproducen si un usuario primero hace clic activamente en la miniatura del anuncio. Los anuncios bumper duran 6 segundos o menos y pueden aparecer en videos de YouTube o en videos de sitios y apps de socios en la Red de Display. Para obtener detalles completos sobre cada uno de estos tipos de anuncios, consulta Acerca de los formatos de anuncios de video.
Crea el grupo de anuncios
Para crear un grupo de anuncios de video con el método newVideoAdGroupBuilder()
de una campaña de video, Cuando creas el grupo de anuncios, debes especificar un tipo y un nombre de grupo de anuncios. El tipo de grupo de anuncios debe ser uno de los siguientes y no se puede cambiar después de crearlo:
TRUE_VIEW_IN_STREAM
TRUE_VIEW_IN_DISPLAY
BUMPER
VIDEO_RESPONSIVE
(solo paraVIDEO_ACTION
campañas)NON_SKIPPABLE_INSTREAM_VIDEO_AD
(solo paraVIDEO_NON_SKIPPABLE
campañas)
Ejemplo:
const videoAdGroup =
videoCampaign.newVideoAdGroupBuilder()
.withAdGroupType("TRUE_VIEW_IN_STREAM")
.withName("Video Ad Group")
.build()
.getResult();
Crea el recurso de video
En general, los anuncios de video deben hacer referencia a un activo de video. Esto determina qué video se reproducirá para el anuncio. No puedes subir un video con secuencias de comandos, pero puedes vincular un video de YouTube existente que hayas subido con anterioridad para usarlo en tus anuncios.
Para ello, crea un Asset
con el YouTubeVideoAssetBuilder
.
const assetOperation = AdsApp.adAsset().newYouTubeVideoAssetBuilder()
.withName("name")
// This is the ID in the URL for the YouTube video.
.withYouTubeVideoId(youTubeVideoId)
.build();
const videoAsset = assetOperation.getResult();
Cree el anuncio
Para crear un anuncio nuevo, usa el método de creación que coincida con el tipo de grupo de anuncios (encadenado después de newVideoAd()
):
inStreamAdBuilder()
videoDiscoveryAdBuilder()
bumperAdBuilder()
responsiveVideoAdBuilder()
(solo paraVIDEO_ACTION
campañas)nonSkippableAdBuilder()
(solo paraVIDEO_NON_SKIPPABLE
campañas)
Ejemplo:
const videoAd = videoAdGroup.newVideoAd()
.inStreamAdBuilder()
.withAdName("Video Ad")
.withFinalUrl(
"http://www.example.com/video-ad")
// Specify the video asset created in the last step.
.withVideo(video)
.build()
.getResult();
Segmentación por video
Existen dos tipos diferentes de segmentación relevante para las campañas de video. El VideoCampaignTargeting
representa cualquier segmentación que se realiza a nivel de la cuenta para las campañas de video en general, y a la que se accede mediante AdsApp.videoCampaignTargeting()
. No se puede modificar a través de secuencias de comandos, pero se puede ver.
El otro tipo de segmentación te permite especificar criterios para las campañas y los grupos de anuncios de video de forma individual. Se puede acceder a esto con el método videoTargeting()
en la campaña o el grupo de anuncios, y proporciona acceso a selectores y compiladores para criterios positivos y negativos en todos los tipos aplicables a ese nivel de segmentación. El método AdsApp.videoTargeting()
también existe para ver criterios a nivel de la cuenta y, además, incluye un conjunto diferente de criterios de AdsApp.videoCampaignTargeting()
. Al igual que VideoCampaignTargeting
, no puedes administrar estos criterios con secuencias de comandos.
A continuación, presentamos un ejemplo para excluir una ubicación específica en una campaña:
videoCampaign.videoTargeting().newPlacementBuilder()
.withUrl("http://www.example.com")
.exclude();
Los criterios para los datos demográficos (edad, género) funcionan de una manera un poco diferente a los otros tipos de criterios. Cuando se crea un grupo de anuncios nuevo, los criterios para cada valor posible de edad y género se crean automáticamente, y ese grupo de anuncios se orienta a todos. Para excluir un segmento demográfico, recupera la segmentación existente y llama al método exclude()
. Para volver a incluir un segmento demográfico excluido, busca la segmentación de exclusión existente y llama a include()
.
A continuación, presentamos un ejemplo para excluir un género específico de un grupo de anuncios:
const videoGenderIterator = videoAdGroup.videoTargeting()
.genders()
.withCondition('GenderType = "GENDER_MALE"')
.get();
if (videoGenderIterator.hasNext()) {
const videoGender = videoGenderIterator.next();
videoGender.exclude();
}