Criar um grupo de anúncios da Geração de Demanda

Beta: a recuperação e o gerenciamento de recursos da Geração de demanda estão na versão Beta. Esse recurso vai começar a ser lançado para todos os parceiros em 10 de junho de 2026 e estará disponível para todos em 24 de junho de 2026.

Um grupo de anúncios Geração de Demanda oferece controle preciso de lances e veiculação para os anúncios nele. Isso é configurado em recursos AdGroup pela estratégia de lances, configurações de inventário e segmentação.

Os grupos de anúncios têm recursos filhos chamados anúncios, que são os criativos configurados veiculados depois que um leilão é vencido.

Escolher configurações

Antes de criar um grupo de anúncios da Geração de Demanda, considere estas configurações opcionais para ter mais controle sobre a veiculação de anúncios:

• O bidStrategy pode ser configurado com um DemandGenBiddingStrategy para definir um valor desejado diferente para o grupo de anúncios em comparação com o item de linha principal ao usar uma estratégia de lances de CPA desejado, CPC ou ROAS desejado.
• adGroupInventoryControl pode ser definido para selecionar os inventários em que o grupo de anúncios vai fazer lances e os anúncios serão veiculados.
• Com o targetingExpansion, é possível ativar a segmentação otimizada para o grupo de anúncios que usa a segmentação por público-alvo. A segmentação otimizada expande a veiculação além da segmentação demográfica definida. É possível restringir isso excluindo a expansão demográfica.

Ao criar um grupo de anúncios Geração de demanda, também é necessário definir o campo adGroupFormat como AD_GROUP_FORMAT_DEMAND_GEN.

Criar um grupo de anúncios

Saiba como criar um grupo de anúncios da Geração de Demanda com as seguintes configurações:

• Uma estratégia de lances que otimiza para um custo médio de R $12 por conversão, herdando uma estratégia de lances de CPA desejado do item de linha principal.
• Só vai dar lances no inventário in-stream e dos Shorts do YouTube.

Observação: neste exemplo, você cria o grupo de anúncios com o estado "pausado". Isso é feito como precaução para garantir que o grupo de anúncios não comece a veicular anúncios antes da configuração e revisão do direcionamento.

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