Campañas de video

Las secuencias de comandos de Google Ads le permiten administrar y generar informes sobre sus videos de YouTube basados en campañas. 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 sus campañas y ejecutar informes. Sin embargo, no puedes usar secuencias de comandos para crear campañas de video.

Recuperando campañas de video y grupos de anuncios

Las campañas de video están disponibles videoCampaigns colección de un objeto AdsApp. Tú puedes recuperarlos como lo harías normalmente con 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 recuperes una campaña, puedes obtener sus grupos de anuncios de forma similar:

const adGroupIterator = campaign.videoAdGroups()
    .withCondition(`ad_group.name = "${adGroupName}"`)
    .get();

for (const adGroup of adGroupIterator) {
  ...
}

También 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 le permiten recuperar sus anuncios de video mediante la videoAds() método de VideoAdGroup Puede crear anuncios de video nuevos con el newVideoAd() método 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 garantizar Si seleccionas 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 que se que se admiten en esa campaña. Específicamente, solo se agregaron VIDEO_ACTION campañas Se 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 utilizar un withCondition en el selector. Puedes actualizar el AdvertisingChannelSubType para el tipo de campaña que le 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 usando una 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 a los usuarios la opción de omitirlo después de un tiempo específico. Los anuncios video discovery aparecen en la Red de Display y varias páginas de YouTube, y solo se reproducirá 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 de Google. Para obtener detalles completos sobre cada uno de estos tipos de anuncios, consulta Acerca de formatos de anuncios de video.

Nota: Para una campaña determinada, puedes tener “TrueView” o anuncios bumper, pero no ambos.

Crear el grupo de anuncios

Crea un grupo de anuncios de video mediante la newVideoAdGroupBuilder() de una campaña de video. Debes especificar un tipo de grupo de anuncios y un anuncio el nombre del grupo de anuncios al crearlo. El tipo de grupo de anuncios debe ser uno de los siguientes: siguiente y no se puede cambiar después de crear el grupo de anuncios:

• TRUE_VIEW_IN_STREAM
• TRUE_VIEW_IN_DISPLAY
• BUMPER
• VIDEO_RESPONSIVE (solo para campañas de VIDEO_ACTION)
• NON_SKIPPABLE_INSTREAM_VIDEO_AD (solo para campañas de VIDEO_NON_SKIPPABLE)

Nota: El tipo de grupo de anuncios determina la clase de anuncios que puedes tener en ese grupo.

Ejemplo:

const videoAdGroup =
    videoCampaign.newVideoAdGroupBuilder()
    .withAdGroupType("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 usar secuencias de comandos para subir videos, pero sí vincular un video de YouTube que haya subido anteriormente para utilizarlo en sus 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();

Crea el anuncio

Para crear un anuncio nuevo, usa el método de creación correspondiente al tipo de grupo de anuncios (encadenado después de newVideoAd()):

• inStreamAdBuilder()
• videoDiscoveryAdBuilder()
• bumperAdBuilder()
• responsiveVideoAdBuilder() (solo para VIDEO_ACTION campañas)
• nonSkippableAdBuilder() (solo para VIDEO_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();

Orientación por video

Existen dos tipos diferentes de segmentación relevante para las campañas de video. El VideoCampaignTargeting representa cualquier orientación que se realiza a nivel de la cuenta para las campañas de video en general, y se accede a través de AdsApp.videoCampaignTargeting(). Esta no se pueden modificar a través de secuencias de comandos, pero sí pueden visualizarse.

El otro tipo de segmentación te permite especificar criterios para las campañas de video. y de video por separado. Se puede acceder con el videoTargeting() en la campaña o el grupo de anuncios, y proporciona acceso a selectores y compiladores de criterios positivos y negativos para todos los tipos aplicables a ese nivel de segmentación. El AdsApp.videoTargeting() también existe para ver los criterios a nivel de la cuenta e incluye un un conjunto diferente de criterios de AdsApp.videoCampaignTargeting(). Me gusta VideoCampaignTargeting, no puedes administrar estos criterios con secuencias de comandos.

A continuación, presentamos un ejemplo de cómo excluir una ubicación específica en una campaña:

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

Los criterios demográficos (edad, género) funcionan de manera un poco diferente. con otros tipos de criterios. Cuando se crea un grupo de anuncios nuevo, los criterios para cada los posibles valores de edad y género se crean automáticamente, y ese grupo de anuncios se dirige a todos ellos. Para excluir un segmento demográfico, recupera los datos existentes la segmentación y llamar al método exclude() en ella, y puedes volver a incluir un segmento demográfico excluido a través de la búsqueda de la exclusión existente include()

A continuación, le mostramos un ejemplo de cómo excluir un sexo 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();
}