Créer un élément de campagne de génération de la demande

**Bêta** : La récupération et la gestion des ressources de génération de la demande sont en version bêta. Cette fonctionnalité n'est disponible que pour les partenaires figurant sur la liste d'autorisation.

Un élément de campagne de génération de la demande diffuse des groupes d'annonces et des annonces dans plusieurs formats sur les surfaces les plus efficaces de Google, y compris YouTube, Discover, Gmail et le Réseau Display de Google. Comme les autres types d'éléments de campagne, les éléments de campagne de génération de la demande, sont gérés à l'aide des LineItem ressources et fonctionnent en fonction du budget défini, de la stratégie d'enchères et du ciblage. Des paramètres spécifiques aux éléments de campagne de génération de la demande sont également disponibles dans le demandGenSettings champ.

Les éléments de campagne de génération de la demande comportent des ressources enfants appelées groupes d'annonces. Les groupes d'annonces offrent un autre niveau de contrôle sous l'élément de campagne individuel.

Sélectionner des configurations

Avant de créer un élément de campagne de génération de la demande, examinez les paramètres pertinents et choisissez-les.

Pour les éléments de campagne de génération de la demande :

• lineItemType doit être défini sur LINE_ITEM_TYPE_DEMAND_GEN.
• bidStrategy doit être défini à l'aide du champ demandGenBid de l'objet BiddingStrategy.
• budget doit être défini sur un montant fixe au niveau de l'élément de campagne et ne peut pas être hérité de l'ordre d'insertion parent.
• demandGenSettings permet de définir des configurations spécifiques aux éléments de campagne de génération de la demande. Le geoLanguageTargetingEnabled champ de l'objet DemandGenSettings indique si le ciblage géographique et linguistique est défini au niveau de l'élément de campagne ou pour des groupes d'annonces individuels. Ce champ ne peut pas être mis à jour après la création de l'élément de campagne. Définissez le champ sur true si vous préférez configurer ce ciblage au niveau de l'élément de campagne.
• creativeIds ne doit pas être défini. Les éléments sont directement attribués et configurés dans les AdGroupAd.

Les champs suivants sont obligatoires pour les éléments de campagne de génération de la demande et fonctionnent de la même manière que dans les autres types d'éléments de campagne :

• flight
• pacing
• partnerRevenueModel

La ressource LineItem comporte également de nombreux champs facultatifs qui peuvent être définis. Pour en savoir plus, consultez la documentation de référence.

Créer un élément de campagne

Voici comment créer un élément de campagne de génération de la demande avec les paramètres suivants :

• Une période de diffusion héritée et un budget de 100 $.
• Un modèle de revenus du partenaire de 0,1 % du coût médias total.
• Une stratégie d'enchères qui optimise le coût moyen par conversion de 10 $.

• La préférence pour l'attribution du ciblage géographique et linguistique directement aux groupes d'annonces sous l'élément de campagne.

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.")