Crea gli asset annuncio

A differenza di quelle pubblicate da altri tipi di elementi pubblicitari, le creatività pubblicate dagli annunci Demand Gen vengono create nelle AdGroupAd risorse stesse. Gli asset immagine e video assegnati agli annunci per creare queste creatività sono rappresentati nell'API Display & Video 360 dalle risorse AdAsset.

Prima di creare una risorsa AdGroupAd, crea le risorse AdAsset pertinenti che l'annuncio utilizzerà se non esistono già. Se sono state create in precedenza utilizzando l'interfaccia utente o l'API, puoi recuperare gli asset esistenti utilizzando il servizio advertisers.adAssets get e i metodi list.

Le risorse AdAsset immagine e video vengono create utilizzando metodi diversi:

L'elemento adAssetId di una risorsa AdAsset viene utilizzato per associare un asset a un annuncio Demand Gen.

Caricare asset immagine

Carica i file immagine per creare asset AD_ASSET_TYPE_IMAGE che possono essere utilizzati come banner complementari, loghi e immagini di marketing.

Ecco come caricare un asset immagine per creare una AdAsset risorsa:

Python

# Import the object used as the media body for the upload request.
from apiclient.http import MediaFileUpload

# Provide the parent advertiser ID to upload the media file under.
advertiser_id = advertiser-id

# Provide the filename and local path to the media file.
asset_filename = asset-filename
asset_path = asset-path

# Create the request body.
body = {"filename": asset_filename, "adAssetType": "AD_ASSET_TYPE_IMAGE"}

# Create the upload object and use a default MIME type if not identified.
media = MediaFileUpload(asset_path)
if not media.mimetype():
  media = MediaFileUpload(asset_path, "application/octet-stream")

# Upload the asset.
upload_response = (
    service.advertisers()
    .adAssets()
    .upload(advertiserId=advertiser_id, body=body, media_body=media)
    .execute()
)

# Display the new ad asset.
print(f"Ad asset {upload_response['adAsset']['name']} was created.")

Creare asset di YouTube

Fornisci gli ID video di YouTube per creare asset AD_ASSET_TYPE_YOUTUBE_VIDEO che possono essere utilizzati negli annunci video Demand Gen.

Ecco come creare un asset video di YouTube per creare una AdAsset risorsa:

Python

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

# Provide the ID of the parent insertion order.
youtube_video_id = youtube-video-id

# Create a line item object with example values.
ad_asset_create_body = {
    "adAsset": {
        "adAssetType": "AD_ASSET_TYPE_YOUTUBE_VIDEO",
        "youtubeVideoAsset": {"youtubeVideoId": youtube_video_id},
    }
}

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

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