Creare un gruppo di annunci Demand Gen

Beta: il recupero e la gestione delle risorse Demand Gen sono in versione beta. Il deployment di questa funzionalità per tutti i partner inizierà il 10 giugno 2026 e sarà disponibile per tutti i partner il 24 giugno 2026.

Un gruppo di annunci Demand Gen offre un controllo preciso delle offerte e della pubblicazione degli annunci al suo interno. Questa configurazione viene eseguita nelle risorse AdGroup tramite la strategia di offerta , le impostazioni dell'inventario e il targeting.

I gruppi di annunci hanno risorse secondarie chiamate annunci, ovvero le creatività configurate pubblicate dopo aver vinto un'asta.

Scegliere le configurazioni

Prima di creare un gruppo di annunci Demand Gen, prendi in considerazione queste impostazioni facoltative per consentire un maggiore controllo della pubblicazione degli annunci:

• bidStrategy può essere configurato con un DemandGenBiddingStrategy per impostare un valore target diverso per il gruppo di annunci rispetto all'elemento pubblicitario principale quando si utilizza una strategia di offerta basata sul CPA target, sul CPC target o sul ROAS target.
• adGroupInventoryControl può essere impostato per selezionare gli inventari su cui il gruppo di annunci farà offerte e in cui verranno pubblicati gli annunci.
• targetingExpansion ti consente di attivare il targeting ottimizzato per il gruppo di annunci che utilizza il targeting per pubblico. Il targeting ottimizzato espande la pubblicazione oltre il targeting demografico impostato. Puoi limitare questa espansione escludendo l'espansione demografica.

Quando crei un gruppo di annunci Demand Gen, devi anche impostare il adGroupFormat campo su AD_GROUP_FORMAT_DEMAND_GEN.

Creare un gruppo di annunci

Ecco come creare un gruppo di annunci Demand Gen con le seguenti impostazioni:

• Una strategia di offerta che esegue l'ottimizzazione in base a un costo medio di 12 $per conversione, ereditando una strategia di offerta basata sul CPA target dall'elemento pubblicitario principale.
• Farà offerte solo per l'inventario in-stream e Shorts di YouTube.

Nota: in questo esempio, crei il gruppo di annunci in stato "In pausa". Questa operazione viene eseguita a scopo precauzionale per garantire che il gruppo di annunci non inizi a pubblicare annunci prima della configurazione e della revisione del targeting.

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