Criar um item de linha da Geração de demanda

Beta: a recuperação e o gerenciamento de recursos de Geração de demanda estão na versão Beta. Esse recurso está disponível apenas para parceiros na lista de permissões.

Um item de linha de Geração de demanda veicula grupos de anúncios e anúncios em vários formatos nas plataformas mais impactantes do Google, incluindo YouTube, Discover, Gmail e a Rede de Display do Google. Os itens de linha de Geração de demanda, como outros tipos de itens de linha, são gerenciados usando LineItem recursos e operam com base no orçamento definido, estratégia de lances e segmentação. Também há configurações específicas para itens de linha de Geração de demanda disponíveis no campo demandGenSettings.

Os itens de linha de Geração de demanda têm recursos filhos chamados grupos de anúncios. Os grupos de anúncios oferecem outro nível de controle no item de linha individual.

Escolher configurações

Antes de criar um item de linha de Geração de demanda, revise e decida as configurações relevantes.

Para itens de linha de Geração de demanda:

• lineItemType precisa ser definido como LINE_ITEM_TYPE_DEMAND_GEN.
• bidStrategy precisa ser definido usando o BiddingStrategy objeto's demandGenBid campo.
• budget precisa ser definido como um valor fixo no nível do item de linha e não pode ser herdado do pedido de inserção pai.
• demandGenSettings é usado para definir configurações específicas para itens de linha de Geração de demanda. O geoLanguageTargetingEnabled campo do objeto DemandGenSettings controla se a segmentação por local e idioma é definida no nível do item de linha ou para grupos de anúncios individuais. Esse campo não pode ser atualizado após a criação do item de linha. Defina o campo como true se preferir configurar essa segmentação no nível do item de linha.
• creativeIds não deve ser definido. Os recursos são atribuídos diretamente e configurados nos recursos AdGroupAd.

Os campos a seguir são obrigatórios para itens de linha de Geração de demanda e funcionam da mesma forma que em outros tipos de itens de linha:

• flight.
• pacing.
• partnerRevenueModel.

O recurso LineItem também tem muitos campos opcionais que podem ser definidos. Leia a documentação de referência para mais informações.

Criar um item de linha

Saiba como criar um item de linha de Geração de demanda com as seguintes configurações:

• Um período de veiculação herdado e um orçamento de US $100.
• Um modelo de receita do parceiro de 0,1% do custo de mídia total.
• Uma estratégia de lances que otimiza para um custo médio de US $10 por conversão.

• A preferência por atribuir a segmentação por local e idioma diretamente aos grupos de anúncios no item de linha.

Python

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

# Provide the ID of the parent insertion order.
insertion_order_id = insertion-order-id

# Provide the display name of the line item.
display_name = display-video

# Provide the Floodlight activity ID to use for conversion tracking.
floodlight_activity_id = floodlight-activity-id

# Provide whether the line item will serve EU political ads.
contains_eu_political_ads = contains-eu-political-ads

# Create a line item object with example values.
line_item_obj = {
    "insertionOrderId": insertion_order_id,
    "displayName": display_name,
    "lineItemType": "LINE_ITEM_TYPE_DEMAND_GEN",
    "entityStatus": "ENTITY_STATUS_DRAFT",
    "flight": {"flightDateType": "LINE_ITEM_FLIGHT_DATE_TYPE_INHERITED"},
    "budget": {
        "budgetAllocationType": "LINE_ITEM_BUDGET_ALLOCATION_TYPE_FIXED",
        "maxAmount": 100000000
    },
    "pacing": {
        "pacingPeriod": "PACING_PERIOD_FLIGHT",
        "pacingType": "PACING_TYPE_EVEN",
        "dailyMaxMicros": 10000,
    },
    "partnerRevenueModel": {
        "markupType": (
            "PARTNER_REVENUE_MODEL_MARKUP_TYPE_TOTAL_MEDIA_COST_MARKUP"
        ),
        "markupAmount": 100,
    },
    "bidStrategy": {
        "demandGenBid": {
            "type": "DEMAND_GEN_BIDDING_STRATEGY_TYPE_TARGET_CPA",
            "value": "10000000"
        }
    },
    "conversionCounting": {
        "postViewCountPercentageMillis": "100000",
        "floodlightActivityConfigs": [
            {
                "floodlightActivityId": floodlight_activity_id,
                "postClickLookbackWindowDays": 90,
                "postViewLookbackWindowDays": 90
            }
        ]
    },
    "containsEuPoliticalAds": contains_eu_political_ads,
    "demandGenSettings": {
        "geoLanguageTargetingEnabled": False
    }
}

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

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