Criar um anúncio da Geração de Demanda

Beta: a recuperação e o gerenciamento de recursos da Geração de demanda estão na versão Beta. Esse recurso vai começar a ser lançado para todos os parceiros em 10 de junho de 2026 e estará disponível para todos em 24 de junho de 2026.

Um anúncio da Geração de Demanda cria o criativo veiculado a um usuário quando um leilão de anúncios é vencido. Os recursos AdGroupAd configuram as opções de criativo relevantes no campo de união ad_details.

Configurar detalhes do anúncio

Há quatro tipos de anúncios Geração de demanda. Cada recurso AdGroupAd pode ser apenas de um tipo. Cada tipo é configurado em um campo individual no campo de união ad_details:

• demandGenVideoAd
• demandGenImageAd
• demandGenCarouselAd
• demandGenProductAd

Um link para os requisitos relevantes do tipo de anúncio está disponível na descrição de cada campo. Apenas um desses campos pode ser preenchido ao criar um recurso AdGroupAd.

Requisitos de dimensão e resolução da imagem por tipo

Cada tipo de anúncio exige tamanhos diferentes de recursos de imagem.

A tabela a seguir lista os tipos de imagem e as restrições de arquivo relevantes:

Tipo de imagem
Banner complementar	Tamanho máximo do arquivo: 150 KB Dimensões: 300 x 60
Imagem em modo paisagem	Tamanho máximo do arquivo: 5.120 KB Dimensões recomendadas: 1200 x 628, mínimo: 600 x 314
Imagem do logotipo	Tamanho máximo do arquivo: 5.120 KB Dimensões recomendadas: 1200 x 1200, mínimo: 128 x 128
Imagem em modo retrato	Tamanho máximo do arquivo: 5.120 KB Dimensões recomendadas: 960 x 1.200, mínimo: 480 x 600
Imagem quadrada	Tamanho máximo do arquivo: 5.120 KB Dimensões recomendadas: 1200 x 1200, mínimo: 300 x 300

Criar um anúncio

Saiba como criar um anúncio em vídeo da Geração de demanda:

Observação: neste exemplo, você cria um recurso de anúncio no estado "pausado". Isso é feito como precaução para garantir que o anúncio não comece a ser veiculado imediatamente antes da análise.

Java

// Provide the ID of the parent advertiser.
long advertiserId = advertiser-id;

// Provide the ID of the parent ad group.
long adGroupId = ad-group-id;

// Provide the display name of the ad.
String displayName = display-name;

// Provide the information for the ad creative.
String finalAdUrl = final-ad-url;
String callToAction = call-to-action;
String headline = headline;
String longHeadline = long-headline;
String description = description;
String businessName = business-name;
long youtubeAssetId = youtube-video-asset-id;
long logoAssetId = logo-asset-id;

// Create the ad structure.
AdGroupAd ad =
    new AdGroupAd()
        .setAdGroupId(adGroupId)
        .setDisplayName(displayName)
        .setEntityStatus("ENTITY_STATUS_PAUSED")
        .setDemandGenVideoAd(
            new DemandGenVideoAd()
                .setFinalUrl(finalAdUrl)
                .setCallToAction(callToAction)
                .setHeadlines(Arrays.asList(headline))
                .setLongHeadlines(Arrays.asList(longHeadline))
                .setDescriptions(Arrays.asList(description))
                .setBusinessName(businessName)
                .setVideos(
                    Arrays.asList(
                        new YoutubeVideoDetails()
                            .setVideoAssetId(youtubeAssetId)))
                .setLogo(new ImageAsset().setAssetId(logoAssetId)));

// Configure the create request.
AdGroupAds.Create request =
    service.advertisers().adGroupAds().create(advertiserId, ad);

// Create the ad group.
AdGroupAd response = request.execute();

// Display the new ad.
System.out.printf("Demand Gen ad %s was created.", response.getName());

Python

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

# Provide the ID of the parent ad group.
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 the ad object.
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.")

PHP

// Provide the ID of the parent advertiser.
$advertiserId = advertiser-id;

// Provide the ID of the parent ad group.
$adGroupId = ad-group-id;

// Provide the display name of the ad.
$displayName = display-name;

// Provide the information for the ad creative.
$finalAdUrl = final-ad-url;
$callToAction = call-to-action;
$headline = headline;
$longHeadline = long-headline;
$description = description;
$businessName = business-name;
$youtubeAssetId = youtube-video-asset-id;
$logoAssetId = logo-asset-id;

// Create the ad structure.
$ad = new Google_Service_DisplayVideo_AdGroupAd();
$ad->setAdGroupId($adGroupId);
$ad->setDisplayName($displayName);
$ad->setEntityStatus('ENTITY_STATUS_PAUSED');

// Create the Demand Gen video ad creative.
$demandGenVideoAd = new Google_Service_DisplayVideo_DemandGenVideoAd();
$demandGenVideoAd->setFinalUrl($finalAdUrl);
$demandGenVideoAd->setCallToAction($callToAction);
$demandGenVideoAd->setHeadlines(array($headline));
$demandGenVideoAd->setLongHeadlines(array($longHeadline));
$demandGenVideoAd->setDescriptions(array($description));
$demandGenVideoAd->setBusinessName($businessName);

// Assign the video asset to the ad creative.
$youtubeVideoAsset =
    new Google_Service_DisplayVideo_YoutubeVideoDetails();
$youtubeVideoAsset->setVideoAssetId($youtubeAssetId);
$demandGenVideoAd->setVideos(array($youtubeVideoAsset));

// Assign the logo asset to the ad creative.
$imageAsset = new Google_Service_DisplayVideo_ImageAsset();
$imageAsset->setAssetId($logoAssetId);
$demandGenVideoAd->setLogo($imageAsset);

// Assign the Demand Gen video ad to the ad.
$ad->setDemandGenVideoAd($demandGenVideoAd);

// Call the API, creating the ad under the advertiser and ad group given.
try {
    $result = $this->service->advertisers_adGroupAds->create(
        $advertiserId,
        $ad
    );
} catch (\Exception $e) {
    $this->renderError($e);
    return;
}

// Display the new ad.
printf('<p>Ad %s was created.</p>', $result['name']);