REST Resource: advertisers.lineItems

Ressource: LineItem

Un seul élément de campagne

Représentation JSON 
{
  "name": string,
  "advertiserId": string,
  "campaignId": string,
  "insertionOrderId": string,
  "lineItemId": string,
  "displayName": string,
  "lineItemType": enum (LineItemType),
  "entityStatus": enum (EntityStatus),
  "updateTime": string,
  "partnerCosts": [
    {
      object (PartnerCost)
    }
  ],
  "flight": {
    object (LineItemFlight)
  },
  "budget": {
    object (LineItemBudget)
  },
  "pacing": {
    object (Pacing)
  },
  "frequencyCap": {
    object (FrequencyCap)
  },
  "partnerRevenueModel": {
    object (PartnerRevenueModel)
  },
  "conversionCounting": {
    object (ConversionCountingConfig)
  },
  "creativeIds": [
    string
  ],
  "bidStrategy": {
    object (BiddingStrategy)
  },
  "integrationDetails": {
    object (IntegrationDetails)
  },
  "inventorySourceIds": [
    string
  ],
  "targetingExpansion": {
    object (TargetingExpansionConfig)
  },
  "warningMessages": [
    enum (LineItemWarningMessage)
  ],
  "mobileApp": {
    object (MobileApp)
  },
  "reservationType": enum (ReservationType),
  "excludeNewExchanges": boolean
}
Champs
name

string

Uniquement en sortie. Nom de ressource de l'élément de campagne.
advertiserId

string (int64 format)

Uniquement en sortie. Identifiant unique de l'annonceur auquel appartient l'élément de campagne.
campaignId

string (int64 format)

Uniquement en sortie. ID unique de la campagne à laquelle appartient l'élément de campagne.
insertionOrderId

string (int64 format)

Obligatoire. Immuable. ID unique de l'ordre d'insertion auquel appartient l'élément de campagne.
lineItemId

string (int64 format)

Uniquement en sortie. Identifiant unique de l'élément de campagne. Attribué par le système.
displayName

string

Obligatoire. Nom à afficher de l'élément de campagne.

Doit être encodé au format UTF-8 avec une taille maximale de 240 octets.
lineItemType

enum (LineItemType)

Obligatoire. Immuable. Type de l'élément de campagne.
entityStatus

enum (EntityStatus)

Obligatoire. Détermine si l'élément de campagne peut dépenser son budget et définir des enchères sur l'inventaire.

  • Pour la méthode lineItems.create, seul ENTITY_STATUS_DRAFT est autorisé. Pour activer un élément de campagne, utilisez la méthode lineItems.patch et définissez l'état sur ENTITY_STATUS_ACTIVE après sa création.
  • Impossible de rétablir l'état ENTITY_STATUS_DRAFT pour un élément de campagne à partir d'un autre état.
  • Si l'ordre d'insertion parent de l'élément de campagne n'est pas actif, celui-ci ne peut pas dépenser son budget, même si son propre état est ENTITY_STATUS_ACTIVE.
updateTime

string (Timestamp format)

Uniquement en sortie. Horodatage de la dernière mise à jour de l'élément de campagne. Attribué par le système.

Code temporel au format RFC3339 UTC "Zulu", avec une résolution à la nanoseconde et jusqu'à neuf chiffres fractionnaires. Exemples: "2014-10-02T15:01:23Z" et "2014-10-02T15:01:23.045123456Z".
partnerCosts[]

object (PartnerCost)

Coûts associés au partenaire associés à l'élément de campagne.

Si cette valeur est absente ou vide dans la méthode lineItems.create, l'élément de campagne nouvellement créé hérite des coûts associés au partenaire de son ordre d'insertion parent.
flight

object (LineItemFlight)

Obligatoire. Heures de début et de fin de la période de diffusion de l'élément de campagne.
budget

object (LineItemBudget)

Obligatoire. Paramètre de répartition du budget de l'élément de campagne.
pacing

object (Pacing)

Obligatoire. Paramètre de vitesse de dépense du budget de l'élément de campagne.
frequencyCap

object (FrequencyCap)

Obligatoire. Paramètres de limite de la fréquence d'exposition des impressions de l'élément de campagne.

Le champ maxImpressions de cet objet de paramètres doit être utilisé si vous attribuez une limite limitée.
partnerRevenueModel

object (PartnerRevenueModel)

Obligatoire. Paramètre du modèle de revenus du partenaire de l'élément de campagne.
conversionCounting

object (ConversionCountingConfig)

Paramètre de suivi des conversions de l'élément de campagne.
creativeIds[]

string (int64 format)

ID des créations associées à l'élément de campagne.
bidStrategy

object (BiddingStrategy)

Obligatoire. Stratégie d'enchères de l'élément de campagne.
integrationDetails

object (IntegrationDetails)

Détails d'intégration de l'élément de campagne.
inventorySourceIds[]

string (int64 format)

ID des sources d'inventaire privées attribuées à l'élément de campagne.
targetingExpansion

object (TargetingExpansionConfig)

Paramètres de ciblage optimisé de l'élément de campagne.

Cette configuration ne s'applique qu'aux éléments de campagne display, vidéo ou audio qui utilisent les enchères automatiques et ciblent positivement les listes d'audience éligibles.
warningMessages[]

enum (LineItemWarningMessage)

Uniquement en sortie. Messages d'avertissement générés par l'élément de campagne. Ces avertissements n'empêchent pas l'enregistrement de l'élément de campagne, mais certains peuvent empêcher sa diffusion.
mobileApp

object (MobileApp)

Application mobile dont l'élément de campagne fait la promotion.

Cela n'est applicable que lorsque lineItemType est défini sur LINE_ITEM_TYPE_DISPLAY_MOBILE_APP_INSTALL ou LINE_ITEM_TYPE_VIDEO_MOBILE_APP_INSTALL.
reservationType

enum (ReservationType)

Uniquement en sortie. Type de réservation de l'élément de campagne.
excludeNewExchanges

boolean

Permet d'exclure ou non les nouvelles places de marché du ciblage automatique par l'élément de campagne. Par défaut, ce champ est défini sur "false".

LineItemType

Types possibles d'un élément de campagne.

Le type de l'élément de campagne détermine les paramètres et les options applicables, tels que le format des annonces ou les options de ciblage.

Enums
LINE_ITEM_TYPE_UNSPECIFIED

La valeur de type n'est pas spécifiée ou est inconnue dans cette version.

Impossible de créer ou de mettre à jour des éléments de campagne de ce type et leur ciblage à l'aide de l'API.
LINE_ITEM_TYPE_DISPLAY_DEFAULT Annonces illustrées, HTML5, natives ou rich media.
LINE_ITEM_TYPE_DISPLAY_MOBILE_APP_INSTALL Affichez des annonces qui incitent les utilisateurs à installer une application.
LINE_ITEM_TYPE_VIDEO_DEFAULT Annonces vidéo vendues au CPM pour divers environnements.
LINE_ITEM_TYPE_VIDEO_MOBILE_APP_INSTALL Annonces vidéo qui incitent les utilisateurs à installer une application
LINE_ITEM_TYPE_DISPLAY_MOBILE_APP_INVENTORY

Annonces display diffusées sur l'inventaire d'applications mobiles.

Impossible de créer ou de mettre à jour des éléments de campagne de ce type et leur ciblage à l'aide de l'API.
LINE_ITEM_TYPE_VIDEO_MOBILE_APP_INVENTORY

Annonces vidéo diffusées sur l'inventaire d'applications mobiles.

Impossible de créer ou de mettre à jour des éléments de campagne de ce type et leur ciblage à l'aide de l'API.
LINE_ITEM_TYPE_AUDIO_DEFAULT Annonces audio RTB vendues pour divers environnements.
LINE_ITEM_TYPE_VIDEO_OVER_THE_TOP Annonces de service de distribution par contournement présentes dans les ordres d'insertion de service de distribution par contournement. Ce type ne s'applique qu'aux éléments de campagne dont l'ordre d'insertion est insertionOrderType OVER_THE_TOP.

LineItemFlight

Paramètres qui contrôlent la durée active d'un élément de campagne.

Représentation JSON 
{
  "flightDateType": enum (LineItemFlightDateType),
  "dateRange": {
    object (DateRange)
  },
  "triggerId": string
}
Champs
flightDateType

enum (LineItemFlightDateType)

Obligatoire. Type de période de diffusion de l'élément de campagne.
dateRange

object (DateRange)

Dates de début et de fin de la période de diffusion de l'élément de campagne. Elles sont résolues en fonction du fuseau horaire de l'annonceur parent.

  • Obligatoire lorsque flightDateType est défini sur LINE_ITEM_FLIGHT_DATE_TYPE_CUSTOM. Sortie uniquement dans les autres cas.
  • Lors de la création d'une période de diffusion, les champs startDate et endDate doivent tous les deux se situer dans le futur.
  • Un vol existant avec un startDate dans le passé présente une endDate modifiable, mais une startDate immuable.
  • endDate doit être startDate ou une version ultérieure, antérieure à l'année 2037.
triggerId

string (int64 format)

ID du déclencheur manuel associé à l'élément de campagne.

  • Obligatoire lorsque flightDateType est défini sur LINE_ITEM_FLIGHT_DATE_TYPE_TRIGGER. Ne doit pas être défini dans les autres cas.
  • Lorsqu'elles sont définies, la période de diffusion de l'élément de campagne est héritées de l'ordre d'insertion parent.
  • Les éléments de campagne actifs généreront des dépenses lorsque le déclencheur sélectionné est activé dans la période de diffusion de l'ordre d'insertion parent.

Avertissement:Les éléments de campagne qui utilisent des déclencheurs manuels ne sont plus diffusés dans Display & Video 360. Ce champ ne sera plus disponible à partir du 1er août 2023. Pour en savoir plus, consultez notre annonce concernant l'abandon de cette fonctionnalité.

LineItemFlightDateType

Types possibles de période de diffusion d'un élément de campagne.

Enums
LINE_ITEM_FLIGHT_DATE_TYPE_UNSPECIFIED La valeur de type n'est pas spécifiée ou est inconnue dans cette version.
LINE_ITEM_FLIGHT_DATE_TYPE_INHERITED La période de diffusion de l'élément de campagne est issue de l'ordre d'insertion parent.
LINE_ITEM_FLIGHT_DATE_TYPE_CUSTOM L'élément de campagne utilise sa propre période de diffusion personnalisée.
LINE_ITEM_FLIGHT_DATE_TYPE_TRIGGER

L'élément de campagne utilise un déclencheur.

Avertissement:Les éléments de campagne qui utilisent des déclencheurs manuels ne sont plus diffusés dans Display & Video 360. Cette valeur ne sera plus disponible à partir du 1er août 2023. Pour en savoir plus, consultez notre annonce concernant l'abandon de cette fonctionnalité.

LineItemBudget

Paramètres qui contrôlent l'allocation du budget.

Représentation JSON 
{
  "budgetAllocationType": enum (LineItemBudgetAllocationType),
  "budgetUnit": enum (BudgetUnit),
  "maxAmount": string
}
Champs
budgetAllocationType

enum (LineItemBudgetAllocationType)

Obligatoire. Type de répartition du budget.

LINE_ITEM_BUDGET_ALLOCATION_TYPE_AUTOMATIC ne s'applique que lorsque la répartition automatique du budget est activée pour l'ordre d'insertion parent.
budgetUnit

enum (BudgetUnit)

Uniquement en sortie. L'unité budgétaire indique si le budget est basé sur la devise ou sur les impressions. Cette valeur est héritée de l'ordre d'insertion parent.
maxAmount

string (int64 format)

Montant maximal du budget dépensé par l'élément de campagne. Doit être supérieur à 0.

Lorsque budgetAllocationType est:

  • LINE_ITEM_BUDGET_ALLOCATION_TYPE_AUTOMATIC, ce champ est immuable et est défini par le système.
  • LINE_ITEM_BUDGET_ALLOCATION_TYPE_FIXED, si budgetUnit est :
    • BUDGET_UNIT_CURRENCY : ce champ représente le montant maximal du budget à dépenser, en micro-unités de la devise de l'annonceur. Par exemple, 1 500 000 représente 1,5 unité standard de la devise.
    • BUDGET_UNIT_IMPRESSIONS, ce champ représente le nombre maximal d'impressions à diffuser.
  • LINE_ITEM_BUDGET_ALLOCATION_TYPE_UNLIMITED, ce champ n'est pas applicable et sera ignoré par le système.

LineItemBudgetAllocationType

Types possibles de répartition du budget.

Enums
LINE_ITEM_BUDGET_ALLOCATION_TYPE_UNSPECIFIED La valeur de type n'est pas spécifiée ou est inconnue dans cette version.
LINE_ITEM_BUDGET_ALLOCATION_TYPE_AUTOMATIC La répartition automatique du budget est activée pour l'élément de campagne.
LINE_ITEM_BUDGET_ALLOCATION_TYPE_FIXED Un budget maximal fixe est alloué à l'élément de campagne.
LINE_ITEM_BUDGET_ALLOCATION_TYPE_UNLIMITED Aucune limite de budget n'est appliquée à l'élément de campagne.

PartnerRevenueModel

Paramètres qui contrôlent le mode de calcul des revenus du partenaire.

Représentation JSON 
{
  "markupType": enum (PartnerRevenueModelMarkupType),
  "markupAmount": string
}
Champs
markupType

enum (PartnerRevenueModelMarkupType)

Obligatoire. Type de balisage du modèle de revenus du partenaire.
markupAmount

string (int64 format)

Obligatoire. Montant de la majoration du modèle de revenus du partenaire. La valeur doit être supérieure ou égale à 0.

  • Lorsque la valeur de markupType est définie sur PARTNER_REVENUE_MODEL_MARKUP_TYPE_CPM, ce champ représente la majoration du CPM en micro-unités de la devise de l'annonceur. Par exemple, 1 500 000 représente 1,5 unité standard de la devise.
  • Lorsque markupType est défini sur PARTNER_REVENUE_MODEL_MARKUP_TYPE_MEDIA_COST_MARKUP, ce champ représente la majoration en pourcentage du coût média en millisecondes. Par exemple, 100 représente 0,1% (0,001 décimal).
  • Lorsque markupType est défini sur PARTNER_REVENUE_MODEL_MARKUP_TYPE_TOTAL_MEDIA_COST_MARKUP, ce champ représente la majoration en pourcentage du coût média total en millisecondes. Par exemple, 100 représente 0,1% (0,001 décimal).

PartnerRevenueModelMarkupType

Types de balisage possibles du modèle de revenus du partenaire.

Enums
PARTNER_REVENUE_MODEL_MARKUP_TYPE_UNSPECIFIED La valeur de type n'est pas spécifiée ou est inconnue dans cette version.
PARTNER_REVENUE_MODEL_MARKUP_TYPE_CPM Calculer les revenus du partenaire sur la base d'un CPM fixe
PARTNER_REVENUE_MODEL_MARKUP_TYPE_MEDIA_COST_MARKUP

Calculer les revenus du partenaire sur la base d'un pourcentage supplémentaire de son coût média
PARTNER_REVENUE_MODEL_MARKUP_TYPE_TOTAL_MEDIA_COST_MARKUP Calculer les revenus du partenaire sur la base d'un pourcentage supplémentaire de son coût média total, qui comprend tous les coûts du partenaire et les coûts liés aux données

ConversionCountingConfig

Paramètres qui contrôlent la manière dont les conversions sont comptabilisées.

Toutes les conversions post-clic seront comptabilisées. Vous pouvez définir une valeur en pourcentage pour comptabiliser les conversions après affichage.

Représentation JSON 
{
  "postViewCountPercentageMillis": string,
  "floodlightActivityConfigs": [
    {
      object (TrackingFloodlightActivityConfig)
    }
  ]
}
Champs
postViewCountPercentageMillis

string (int64 format)

Pourcentage de conversions après affichage à comptabiliser, en millièmes (1/1 000 %). Doit être compris entre 0 et 100 000 inclus.

Par exemple, pour suivre 50% des conversions post-clic, définissez la valeur sur 50 000.
floodlightActivityConfigs[]

object (TrackingFloodlightActivityConfig)

Configurations d'activité Floodlight utilisées pour suivre les conversions.

Le nombre de conversions comptabilisé correspond à la somme de toutes les conversions comptabilisées par tous les ID d'activité Floodlight spécifiés dans ce champ.

TrackingFloodlightActivityConfig

Paramètres qui contrôlent le comportement d'une seule configuration d'activité Floodlight.

Représentation JSON 
{
  "floodlightActivityId": string,
  "postClickLookbackWindowDays": integer,
  "postViewLookbackWindowDays": integer
}
Champs
floodlightActivityId

string (int64 format)

Obligatoire. Identifiant de l'activité Floodlight.
postClickLookbackWindowDays

integer

Obligatoire. Nombre de jours pendant lesquels une conversion peut être comptabilisée après un clic sur une annonce. Doit être comprise entre 0 et 90 inclus.
postViewLookbackWindowDays

integer

Obligatoire. Nombre de jours pendant lesquels une conversion peut être comptabilisée après l'affichage d'une annonce. Doit être comprise entre 0 et 90 inclus.

TargetingExpansionConfig

Paramètres qui contrôlent les paramètres de ciblage optimisé de l'élément de campagne.

Représentation JSON 
{
  "targetingExpansionLevel": enum (TargetingExpansionLevel),
  "excludeFirstPartyAudience": boolean
}
Champs
targetingExpansionLevel

enum (TargetingExpansionLevel)

Obligatoire. Indique si le ciblage optimisé est activé.

Ce champ accepte les valeurs suivantes:

  • NO_EXPANSION: le ciblage optimisé est désactivé
  • LEAST_EXPANSION: le ciblage optimisé est activé

Si ce champ est défini sur une autre valeur, il sera automatiquement défini sur LEAST_EXPANSION.

NO_EXPANSION est la valeur par défaut du champ. Elle est automatiquement attribuée si vous ne définissez pas le champ.
excludeFirstPartyAudience
(deprecated)

boolean

Indique s'il faut exclure les audiences propriétaires de l'élargissement du ciblage.

Ce champ a été abandonné avec le lancement du ciblage optimisé.

La valeur de ce champ sera définie sur false. Si ce champ est défini sur true lorsqu'il est obsolète, tous les ciblages d'audiences propriétaires à inclure attribués à cet élément de campagne seront remplacés par le ciblage à exclure des mêmes audiences propriétaires afin que ces audiences continuent à être exclues.

TargetingExpansionLevel

Paramètre de ciblage optimisé.

Enums
TARGETING_EXPANSION_LEVEL_UNSPECIFIED Le paramètre de ciblage optimisé n'est pas spécifié ou est inconnu dans cette version.
NO_EXPANSION Le ciblage optimisé est désactivé.
LEAST_EXPANSION Le ciblage optimisé est activé.
SOME_EXPANSION

Si vous l'utilisez, il sera automatiquement défini sur LEAST_EXPANSION.
BALANCED_EXPANSION

Si vous l'utilisez, il sera automatiquement défini sur LEAST_EXPANSION.
MORE_EXPANSION

Si vous l'utilisez, il sera automatiquement défini sur LEAST_EXPANSION.
MOST_EXPANSION

Si vous l'utilisez, il sera automatiquement défini sur LEAST_EXPANSION.

LineItemWarningMessage

Messages d'avertissement générés par un élément de campagne. Ces types d'avertissements n'empêchent pas l'enregistrement d'un élément de campagne, mais ils peuvent empêcher sa diffusion.

Enums
LINE_ITEM_WARNING_MESSAGE_UNSPECIFIED Non spécifié ou inconnu.
INVALID_FLIGHT_DATES La période de diffusion de cet élément de campagne n'est pas valide. L'élément de campagne n'est pas diffusé.
EXPIRED La date de fin de cet élément de campagne est antérieure à la date du jour.
PENDING_FLIGHT Cet élément de campagne commencera à être diffusé ultérieurement.
ALL_PARTNER_ENABLED_EXCHANGES_NEGATIVELY_TARGETED Toutes les places de marché activées pour le partenaire font l'objet d'un ciblage par exclusion. L'élément de campagne n'est pas diffusé.
INVALID_INVENTORY_SOURCE Aucune source d'inventaire active n'est ciblée. L'élément de campagne n'est pas diffusé.
APP_INVENTORY_INVALID_SITE_TARGETING Le ciblage par application et par URL associé à cet élément de campagne n'inclut aucune application mobile. Ce type d'élément de campagne nécessite d'inclure des applications mobiles à votre canal, votre liste de sites ou votre ciblage par applications. L'élément de campagne n'est pas diffusé.
APP_INVENTORY_INVALID_AUDIENCE_LISTS Cet élément de campagne ne cible aucun utilisateur de mobile. Ce type d'élément de campagne nécessite de cibler une liste d'utilisateurs sur mobile. L'élément de campagne n'est pas diffusé.
NO_VALID_CREATIVE Cet élément de campagne ne contient aucune création valide. L'élément de campagne n'est pas diffusé.
PARENT_INSERTION_ORDER_PAUSED L'ordre d'insertion de cet élément de campagne a été mis en pause. L'élément de campagne n'est pas diffusé.
PARENT_INSERTION_ORDER_EXPIRED La date de fin de l'ordre d'insertion de cet élément de campagne est antérieure à la date du jour. L'élément de campagne n'est pas diffusé.
NO_POSITIVE_AUDIENCE_LIST_TARGETED Cet élément de campagne ne cible aucune liste d'audience. Par conséquent, votre budget risque d'être dépensé trop rapidement.
APP_INSTALL_NO_CONVERSION_PIXEL Aucun pixel de conversion n'est configuré pour cet élément de campagne d'installation d'applications.
TARGETING_REVOKED_OR_CLOSED_USER_LIST Cet élément de campagne cible une ou plusieurs listes d'utilisateurs qui ne sont plus disponibles. À l'avenir, l'élément de campagne ne pourra plus être diffusé. Nous vous conseillons donc de supprimer ces listes de votre ciblage.
APP_INSTALL_NO_OPTIMAL_BIDDING_STRATEGY La stratégie d'enchères de cet élément de campagne associé à l'installation d'applications n'est pas optimale.
CREATIVE_SIZE_NOT_IN_USE_FOR_TARGETED_DEALS Les accords ciblés par cet élément de campagne acceptent des tailles de créations qui ne sont pas utilisées. Cela peut limiter la diffusion ou les performances de l'élément de campagne.
NO_CREATIVE_FOR_TARGETED_DEALS Cet élément de campagne ne contient aucune création pour les accords ciblés.
TARGETING_DEPRECATED_GEO_TARGET Cet élément de campagne cible une cible géographique obsolète.
DEPRECATED_FIRST_PARTY_AUDIENCE_EXCLUSION

Cet élément de campagne utilise le paramètre excludeFirstPartyAudience, qui est obsolète et doit s'arrêter après le 25 mars 2023.

Modifiez l'intégration de l'API pour exclure directement toutes les audiences propriétaires utilisant le ciblage d'audience avant le 25 mars 2023 afin de tenir compte de l'abandon du champ excludeFirstPartyAudience.

MobileApp

Application mobile promue par un élément de campagne associé à l'installation d'applications mobiles.

Représentation JSON 
{
  "appId": string,
  "platform": enum (Platform),
  "displayName": string,
  "publisher": string
}
Champs
appId

string

Obligatoire. ID de l'application fourni par la plate-forme de téléchargement.

Les applications Android sont identifiées par l'ID de bundle utilisé par le Play Store d'Android, tel que com.google.android.gm.

Les applications iOS sont identifiées par un ID d'application à neuf chiffres utilisé par l'App Store d'Apple (par exemple, 422689480).
platform

enum (Platform)

Uniquement en sortie. Plate-forme de l'application
displayName

string

Uniquement en sortie. Nom de l'application
publisher

string

Uniquement en sortie. Éditeur de l'application.

Plate-forme

Plates-formes d'applications mobiles possibles.

Enums
PLATFORM_UNSPECIFIED La plate-forme n'est pas spécifiée.
IOS plate-forme iOS.
ANDROID plate-forme Android.

Méthodes

bulkEditLineItemAssignedTargetingOptions

 Modifier les options de ciblage de façon groupée sous un seul élément de campagne

bulkListLineItemAssignedTargetingOptions

 Liste les options de ciblage attribuées à un élément de campagne pour différents types de ciblage.

create

 Crée un élément de campagne.

delete

 Supprime un élément de campagne.

generateDefault

 Permet de créer un élément de campagne avec des paramètres (y compris le ciblage) hérités de l'ordre d'insertion et une entity_status de type "ENTITY_STATUS_DRAFT".

get

 Récupère un élément de campagne.

list

 Liste les éléments de campagne d'un annonceur.

patch

 Met à jour un élément de campagne existant.