Crea un annuncio Demand Gen

Beta: il recupero e la gestione delle risorse Demand Gen sono in versione beta. Questa funzionalità è disponibile solo per i partner inclusi nella lista consentita.

Un annuncio Demand Gen crea la creatività pubblicata per un utente quando viene vinta un'asta dell'annuncio. AdGroupAd risorse configurano le opzioni della creatività pertinenti in il campo di unione ad_details.

Configurare i dettagli dell'annuncio

Esistono quattro tipi di annunci Demand Gen. Ogni AdGroupAd risorsa può essere di un solo tipo. Ogni tipo viene configurato in un campo individuale nel campo di unione ad_details:

• demandGenVideoAd
• demandGenImageAd
• demandGenCarouselAd
• demandGenProductAd

Nella descrizione di ogni campo è disponibile un link ai requisiti del tipo di annuncio pertinente. Quando crei una risorsa AdGroupAd, puoi compilare solo uno di questi campi.

Requisiti di dimensione e risoluzione delle immagini per tipo

Ogni tipo di annuncio richiede dimensioni diverse degli asset immagine.

La tabella seguente elenca i tipi di immagine e le relative restrizioni sui file:

Tipo di immagine
Companion banner	Dimensione massima del file: 150 kB Dimensioni: 300 x 60
Immagine orizzontale	Dimensione massima del file: 5120 kB Dimensioni consigliate: 1200 x 628, minime: 600 x 314
Immagine logo	Dimensione massima del file: 5120 kB Dimensioni consigliate: 1200 x 1200, minime: 128 x 128
Immagine verticale	Dimensione massima del file: 5120 kB Dimensioni consigliate: 960 x 1200, minime: 480 x 600
Immagine quadrata	Dimensione massima del file: 5120 kB Dimensioni consigliate: 1200 x 1200, minime: 300 x 300

Crea un annuncio

Ecco come creare un annuncio video Demand Gen:

Nota: in questo esempio, crei una risorsa annuncio in stato "In pausa". Questa operazione viene eseguita a scopo precauzionale per garantire che l'annuncio non inizi immediatamente la pubblicazione prima della revisione.

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