Crea un anuncio de generación de demanda

Beta: La recuperación y la administración de recursos de generación de demanda están en versión beta. Esta función solo está disponible para los socios que se encuentran en la lista de entidades permitidas.

Un anuncio de generación de demanda crea la creatividad que se publica para un usuario cuando se gana una subasta de anuncios. AdGroupAd recursos configuran las opciones de creatividad pertinentes en el campo de unión ad_details.

Cómo configurar los detalles del anuncio

Existen cuatro tipos de anuncios de generación de demanda. Cada AdGroupAd recurso solo puede ser de un tipo. Cada tipo se configura en un campo individual en el campo de unión ad_details:

• demandGenVideoAd
• demandGenImageAd
• demandGenCarouselAd
• demandGenProductAd

En la descripción de cada campo, se incluye un vínculo a los requisitos del tipo de anuncio pertinente. Solo se puede completar uno de estos campos cuando se crea un recurso AdGroupAd.

Requisitos de dimensión y resolución de imágenes por tipo

Cada tipo de anuncio requiere diferentes tamaños de elementos de imagen.

En la siguiente tabla, se enumeran los tipos de imágenes y las restricciones de archivos pertinentes:

Tipo de imagen
Companion banner	Tamaño máximo del archivo: 150 KB Dimensiones: 300 x 60
Imagen horizontal	Tamaño máximo del archivo: 5,120 KB Dimensiones recomendadas: 1,200 x 628, mínimas: 600 x 314
Imagen del logotipo	Tamaño máximo del archivo: 5,120 KB Dimensiones recomendadas: 1,200 x 1,200, mínimas: 128 x 128
Imagen vertical	Tamaño máximo del archivo: 5,120 KB Dimensiones recomendadas: 960 x 1,200, mínimas: 480 x 600
Imagen cuadrada	Tamaño máximo del archivo: 5,120 KB Dimensiones recomendadas: 1,200 x 1,200, mínimas: 300 x 300

Crear un anuncio

A continuación, te mostramos cómo crear un anuncio de video de generación de demanda:

Nota: En este ejemplo, crearás un recurso de anuncio en estado "en pausa". Esto se hace como precaución para garantizar que el anuncio no comience a publicarse de inmediato antes de la revisión.

Python

# Provide the ID of the parent advertiser.
advertiser_id = advertiser-id

# Provide the ID of the parent line item.
ad_group_id = ad-group-id

# Provide the display name of the ad.
display_name = display-name

# Provide the information for the ad creative.
final_ad_url = final-ad-url
call_to_action = call-to-action
headline = headline
long_headline = long-headline
description = description
business_name = business-name
youtube_asset_id = youtube-video-asset-id
logo_asset_id = logo-asset-id

# Create an ad object with example values.
ad_obj = {
    "adGroupId": ad_group_id,
    "displayName": display_name,
    "entityStatus": "ENTITY_STATUS_PAUSED",
    "demandGenVideoAd": {
        "finalUrl": final_ad_url,
        "callToAction": call_to_action,
        "headlines": [headline],
        "longHeadlines": [long_headline],
        "descriptions": [description],
        "businessName": business_name,
        "videos": [{"videoAssetId": youtube_asset_id}],
        "logo": {"assetId": logo_asset_id}
    }
}

# Build and execute request.
response = (
    service.advertisers()
    .adGroupAds()
    .create(advertiserId=advertiser_id, body=ad_obj)
    .execute()
)

# Display the new ad.
print(f"Demand Gen ad {response['name']} was created.")