Créer une annonce de génération de la demande

Bêta : La récupération et la gestion des ressources de génération de la demande sont disponibles en version bêta. Cette fonctionnalité sera déployée auprès de tous les partenaires à partir du 10 juin 2026 et sera disponible pour tous les partenaires à partir du 24 juin 2026.

Une annonce de génération de la demande crée la création diffusée auprès d'un utilisateur lorsqu'une enchère publicitaire est remportée. AdGroupAd ressources configurent les options de création pertinentes sous le champ d'union ad_details.

Configurer les détails de l'annonce

Il existe quatre types d'annonces de génération de la demande. Chaque AdGroupAd ressource ne peut être que d'un seul type. Chaque type est configuré dans un champ individuel sous le champ d'union ad_details :

• demandGenVideoAd
• demandGenImageAd
• demandGenCarouselAd
• demandGenProductAd

Un lien vers les exigences concernant le type d'annonce approprié est disponible dans la description de chaque champ. Un seul de ces champs peut être renseigné lors de la création d'une ressource AdGroupAd.

Exigences concernant les dimensions et la résolution des images par type

Chaque type d'annonce nécessite des tailles différentes pour les éléments d'image.

Le tableau suivant répertorie les types d'images et les restrictions de fichiers correspondantes :

Type d'image
Bannière associée	Taille maximale du fichier : 150 Ko Dimensions: 300x60
Image en mode paysage	Taille maximale du fichier : 5 120 Ko Dimensions recommandées : 1 200 x 628, Minimum : 600 x 314
Image du logo	Taille maximale du fichier : 5 120 Ko Dimensions recommandées : 1 200 x 1 200, Minimum : 128 x 128
Image en mode portrait	Taille maximale du fichier : 5 120 Ko Dimensions recommandées : 960 x 1 200, Minimum : 480 x 600
Image carrée	Taille maximale du fichier : 5 120 Ko Dimensions recommandées : 1 200 x 1 200, Minimum : 300 x 300

Créer une annonce

Voici comment créer une annonce vidéo de génération de la demande :

Remarque : Dans cet exemple, vous créez une ressource d'annonce à l'état « en veille ». Cette précaution permet de s'assurer que l'annonce ne commence pas à être diffusée immédiatement avant d'être examinée.

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']);