Membuat grup 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.

Grup iklan Peningkat Permintaan menawarkan kontrol bidding dan penayangan yang akurat untuk iklan di dalamnya. Hal ini dikonfigurasi di AdGroup resource melalui strategi bid, setelan inventaris, dan penargetan.

Grup iklan memiliki resource turunan yang disebut iklan, yang merupakan materi iklan yang dikonfigurasi dan ditayangkan setelah lelang dimenangkan.

Memilih konfigurasi

Sebelum membuat grup iklan Peningkat Permintaan, pertimbangkan setelan opsional berikut untuk mengaktifkan kontrol penayangan iklan lebih lanjut:

• bidStrategy dapat dikonfigurasi dengan DemandGenBiddingStrategy untuk menetapkan nilai target yang berbeda untuk grup iklan dibandingkan dengan item baris induk saat menggunakan strategi bidding target CPA, target CPC, atau target ROAS.
• adGroupInventoryControl dapat ditetapkan untuk memilih inventaris tempat grup iklan akan melakukan bidding dan iklan akan ditayangkan.
• targetingExpansion memungkinkan Anda mengaktifkan penargetan yang dioptimalkan untuk grup iklan yang menggunakan penargetan audiens. Penargetan yang dioptimalkan memperluas penayangan di luar penargetan demografis yang Anda tetapkan. Anda dapat membatasi hal ini dengan mengecualikan perluasan demografi.

Saat membuat grup iklan Peningkat Permintaan, Anda juga harus menetapkan kolom adGroupFormat ke AD_GROUP_FORMAT_DEMAND_GEN.

Membuat grup iklan

Berikut cara membuat grup iklan Peningkat Permintaan dengan setelan berikut:

• Strategi bidding yang dioptimalkan untuk biaya rata-rata $12 per konversi, yang mewarisi strategi bidding target CPA dari item baris induknya.
• Hanya akan melakukan bidding pada inventaris dalam stream dan Shorts YouTube.

Catatan: Dalam contoh ini, Anda membuat grup iklan dalam status "dijeda". Hal ini dilakukan sebagai tindakan pencegahan untuk memastikan grup iklan tidak mulai menayangkan iklan sebelum konfigurasi dan peninjauan penargetan.

Java

// Provide the ID of the parent advertiser.
long advertiserId = advertiser-id;

// Provide the ID of the parent line item.
long lineItemId = line-item-id;

// Provide the display name of the ad group.
String displayName = display-name;

// Create the ad group structure.
AdGroup adGroup =
    new AdGroup()
        .setLineItemId(lineItemId)
        .setDisplayName(displayName)
        .setAdGroupFormat("AD_GROUP_FORMAT_DEMAND_GEN")
        .setEntityStatus("ENTITY_STATUS_PAUSED");

// Create and set the bidding strategy.
BiddingStrategy biddingStrategy =
    new BiddingStrategy()
        .setDemandGenBid(new DemandGenBiddingStrategy().setValue(12000000L));
adGroup.setBidStrategy(biddingStrategy);

// Create and set inventory controls.
AdGroupInventoryControl inventoryControl = new AdGroupInventoryControl();
SelectedInventories selectedInventories =
    new SelectedInventories()
        .setAllowYoutubeStream(true)
        .setAllowYoutubeShorts(true);
inventoryControl.setSelectedInventories(selectedInventories);
adGroup.setAdGroupInventoryControl(inventoryControl);

// Configure the create request.
AdGroups.Create request =
    service.advertisers().adGroups().create(advertiserId, adGroup);

// Create the ad group.
AdGroup response = request.execute();

// Display the new ad group.
System.out.printf("Demand Gen ad group %s was created.", response.getName());

Python

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

# Provide the ID of the parent line item.
line_item_id = line-item-id

# Provide the display name of the ad group.
display_name = display-name

# Create an ad group object with example values.
ad_group_obj = {
    "lineItemId": line_item_id,
    "displayName": display_name,
    "entityStatus": "ENTITY_STATUS_PAUSED",
    "adGroupFormat": "AD_GROUP_FORMAT_DEMAND_GEN",
    "bidStrategy": {
        "demandGenBid": {
            "value": "12000000"
        }
    },
    "adGroupInventoryControl": {
        "selectedInventories": {
            "allowYoutubeStream": True,
            "allowYoutubeShorts": True,
        }
    }
}

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

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

PHP

// Provide the ID of the parent advertiser.
$advertiserId = advertiser-id;

// Provide the ID of the parent line item.
$lineItemId = line-item-id;

// Provide the display name of the ad group.
$displayName = display-name;

// Create the Demand Gen ad group structure.
$adGroup = new Google_Service_DisplayVideo_AdGroup();
$adGroup->setLineItemId($lineItemId);
$adGroup->setDisplayName($displayName);
$adGroup->setAdGroupFormat('AD_GROUP_FORMAT_DEMAND_GEN');
$adGroup->setEntityStatus('ENTITY_STATUS_PAUSED');

// Create and set the bidding strategy.
$demandGenBidStrategy =
    new Google_Service_DisplayVideo_DemandGenBiddingStrategy();
$demandGenBidStrategy->setValue(12000000);
$biddingStrategy = new Google_Service_DisplayVideo_BiddingStrategy();
$biddingStrategy->setDemandGenBid($demandGenBidStrategy);
$adGroup->setBidStrategy($biddingStrategy);

// Create and set the inventory control.
$selectedInventories =
    new Google_Service_DisplayVideo_SelectedInventories();
$selectedInventories->setAllowYoutubeStream(true);
$selectedInventories->setAllowYoutubeShorts(true);
$inventoryControl =
    new Google_Service_DisplayVideo_AdGroupInventoryControl();
$inventoryControl->setSelectedInventories($selectedInventories);
$adGroup->setAdGroupInventoryControl($inventoryControl);

// Call the API, creating the ad group under the advertiser and
// line item given.
try {
    $result = $this->service->advertisers_adGroups->create(
        $advertiserId,
        $adGroup
    );
} catch (\Exception $e) {
    $this->renderError($e);
    return;
}

// Display the new ad group.
printf('<p>Demand Gen Ad Group %s was created.</p>', $result['name']);