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 en version bêta. Cette fonctionnalité n'est disponible que pour les partenaires figurant sur la liste d'autorisation.

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. Les ressources AdGroupAd configurent les options de création pertinentes sous le champ union ad_details.

Configurer les détails des annonces

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

• demandGenVideoAd
• demandGenImageAd
• demandGenCarouselAd
• demandGenProductAd

Un lien vers les exigences concernant le type d'annonce concerné 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 images de différentes tailles.

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 : 300 x 60
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, dimensions minimales : 128 x 128
Image au format 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 "Mis en veille". Cette mesure de précaution permet de s'assurer que l'annonce ne commence pas à être diffusée immédiatement avant d'être examinée.

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.")