デマンド ジェネレーション広告を作成する

デマンド ジェネレーション広告では、広告オークションで落札したときにユーザーに配信されるクリエイティブが作成されます。 AdGroupAd リソースは、 ユニオン フィールド ad_details の下で関連するクリエイティブ オプションを構成します。

広告の詳細を設定する

デマンド ジェネレーション広告には 4 種類あります。各 AdGroupAd リソースは 1 種類のみです。各タイプは、ユニオン フィールド ad_details の下の個々のフィールドで構成されます。

各フィールドの説明には、関連する広告タイプの要件へのリンクが記載されています。 AdGroupAd リソースを作成するときに、これらのフィールドに入力できるのは 1 つのみです。

タイプ別の画像のサイズと解像度の要件

広告タイプごとに、異なるサイズの画像アセットが必要です。

次の表に、画像タイプと関連するファイル制限を示します。

画像の種類
コンパニオン バナー

ファイルサイズ上限: 150 KB

サイズ: 300×60

横長の画像

ファイルサイズ上限: 5,120 KB

推奨サイズ: 1200x628、最小: 600x314

ロゴ画像

ファイルサイズ上限: 5,120 KB

推奨サイズ: 1200x1200、最小: 128x128

縦向きの画像

ファイルサイズ上限: 5,120 KB

推奨サイズ: 960x1200、最小: 480x600

スクエア画像

ファイルサイズ上限: 5,120 KB

推奨サイズ: 1200x1200、最小: 300x300

広告の作成

デマンド ジェネレーション動画広告を作成する方法は次のとおりです。

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