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

Um grupo de anúncios da Geração de demanda oferece controle preciso de lances e veiculação para os anúncios nele. Essa configuração é feita nos recursos AdGroup usando a estratégia de lances , as configurações de inventário e a segmentação.

Os grupos de anúncios têm recursos filhos chamados anúncios, que são os criativos configurados veiculados após um leilão ser ganho.

Escolher configurações

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

• 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 pai ao usar uma estratégia de lances de CPA desejado, CPC desejado ou ROAS desejado.
• adGroupInventoryControl pode ser definido para selecionar os inventários em que o grupo de anúncios vai dar lances e os anúncios serão veiculados.
• targetingExpansion permite 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 da Geração de demanda, você também precisa definir o adGroupFormat campo 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 US $12 por conversão, herdando uma estratégia de lances de CPA desejado do item de linha pai.
• Só vai dar lances no inventário de Shorts e in-stream do YouTube.

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

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