Membuat iklan Peningkat Permintaan

Beta: Pengambilan dan pengelolaan resource Peningkat Permintaan masih dalam versi beta. Fitur ini akan mulai diluncurkan ke semua partner pada 10 Juni 2026 dan tersedia untuk semua partner pada 24 Juni 2026.

Iklan Peningkat Permintaan membuat materi iklan yang ditayangkan kepada pengguna saat lelang iklan dimenangkan. AdGroupAd resource mengonfigurasi opsi materi iklan yang relevan di bawah kolom gabungan ad_details.

Mengonfigurasi detail iklan

Ada empat jenis iklan Peningkat Permintaan. Setiap AdGroupAd resource hanya dapat berupa satu jenis. Setiap jenis dikonfigurasi di kolom individual di kolom gabungan ad_details:

• demandGenVideoAd
• demandGenImageAd
• demandGenCarouselAd
• demandGenProductAd

Link ke persyaratan jenis iklan yang relevan tersedia dalam deskripsi setiap kolom. Hanya satu kolom ini yang dapat diisi saat membuat resource AdGroupAd.

Persyaratan dimensi dan resolusi gambar menurut jenis

Setiap jenis iklan memerlukan ukuran aset gambar yang berbeda.

Tabel berikut mencantumkan jenis gambar dan batasan file yang relevan:

Jenis gambar
Banner pengiring	Ukuran file maksimum: 150 KB Dimensi: 300x60
Gambar lanskap	Ukuran file maksimum: 5120 KB Dimensi yang direkomendasikan: 1200x628, Minimum: 600x314
Gambar logo	Ukuran file maksimum: 5120 KB Dimensi yang direkomendasikan: 1200x1200, Minimum: 128x128
Gambar potret	Ukuran file maksimum: 5120 KB Dimensi yang direkomendasikan: 960x1200, Minimum: 480x600
Gambar persegi	Ukuran file maksimum: 5120 KB Dimensi yang direkomendasikan: 1200x1200, Minimum: 300x300

Membuat iklan

Berikut cara membuat iklan video Peningkat Permintaan:

Catatan: Dalam contoh ini, Anda membuat resource iklan dalam status "dijeda". Hal ini dilakukan sebagai tindakan pencegahan untuk memastikan iklan tidak langsung mulai ditayangkan sebelum ditinjau.

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