Campañas de video

Las secuencias de comandos de Google Ads te permiten administrar tus campañas de video basadas en YouTube y generar informes sobre ellas. Puedes usar secuencias de comandos para administrar campañas de video existentes, crear y administrar grupos de anuncios y anuncios, configurar la segmentación de las campañas y generar informes. Sin embargo, no puedes usar secuencias de comandos para crear campañas de video.

Cómo recuperar campañas de video y grupos de anuncios

Las campañas de video están disponibles a través de la colección videoCampaigns de un objeto AdsApp. Puedes recuperarlos como lo harías normalmente con las campañas en las 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 recuperes una campaña, podrás obtener sus grupos de anuncios de manera similar:

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 con el método videoAds() de VideoAdGroup. Puedes crear anuncios de video nuevos 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 de campaña de video adecuado, agrega una llamada withCondition en AdvertisingChannelSubType.

Algunas campañas de video tienen subtipos que restringen los tipos de anuncios que se admiten en esa campaña. Específicamente, las campañas de VIDEO_ACTION solo admiten el tipo de anuncio VIDEO_RESPONSIVE, y las campañas de 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 tu selector. Puedes actualizar el AdvertisingChannelSubType para el tipo de campaña que te interesa:

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 con un withCondition:

const campaignIterator = AdsApp.videoCampaigns()
  .withCondition("AdvertisingChannelSubType = null")
  .get();

Los anuncios de video in-stream se pueden reproducir antes, durante o después de otros videos, lo que les brinda 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 hace clic de forma activa 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 aplicaciones asociados 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

Creas un grupo de anuncios de video a través del método newVideoAdGroupBuilder() de una campaña de video. Cuando crees el grupo de anuncios, deberás especificar un tipo y un nombre para él. El tipo de grupo de anuncios debe ser uno de los siguientes y no se puede cambiar después de que se crea el grupo de anuncios:

  • VIDEO_BUMPER
  • VIDEO_EFFICIENT_REACH
  • VIDEO_NON_SKIPPABLE_IN_STREAM (solo para campañas de VIDEO_NON_SKIPPABLE)
  • VIDEO_RESPONSIVE (solo para campañas de VIDEO_ACTION)
  • VIDEO_TRUE_VIEW_IN_DISPLAY
  • VIDEO_TRUE_VIEW_IN_STREAM
  • YOUTUBE_AUDIO

Ejemplo:

const videoAdGroup =
    videoCampaign.newVideoAdGroupBuilder()
    .withAdGroupType("VIDEO_TRUE_VIEW_IN_STREAM")
    .withName("Video Ad Group")
    .build()
    .getResult();

Crea el recurso de video

Por lo general, los anuncios de video deben hacer referencia a un recurso 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 existente de YouTube que hayas subido anteriormente para usarlo en tus anuncios. Para ello, crea un Asset con 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();

Cómo crear el anuncio

Para crear un anuncio nuevo, usa el método de compilador que coincida con el tipo de grupo de anuncios (encadenado después de newVideoAd()):

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();

Orientación por video

Existen dos tipos diferentes de segmentación pertinente para las campañas de video. El objeto VideoCampaignTargeting representa cualquier segmentación que se realice a nivel de la cuenta para las campañas de video en general y se accede a él con 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 de video y los grupos de anuncios de video de forma individual. Se puede acceder a esta información con el método videoTargeting() en la campaña o el grupo de anuncios, y proporciona acceso a selectores y compiladores para los criterios positivos y negativos de todos los tipos aplicables a ese nivel de segmentación. El método AdsApp.videoTargeting() también existe para ver los criterios a nivel de la cuenta y contiene un conjunto diferente de criterios de AdsApp.videoCampaignTargeting(). Al igual que con VideoCampaignTargeting, no puedes administrar estos criterios con secuencias de comandos.

A continuación, se muestra un ejemplo para excluir una posición específica en una campaña:

videoCampaign.videoTargeting().newPlacementBuilder()
    .withUrl("http://www.example.com")
    .exclude();

Los criterios demográficos (edad y género) funcionan de manera un poco diferente a los otros tipos de criterios. Cuando se crea un grupo de anuncios nuevo, se generan automáticamente criterios para cada valor posible de edad y género, y ese grupo de anuncios segmenta sus anuncios para todos ellos. Puedes excluir un segmento demográfico recuperando la segmentación existente y llamando al método exclude() en ella, y puedes volver a incluir un segmento demográfico excluido buscando la segmentación de exclusión existente y llamando a include().

A continuación, se muestra 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();
}