REST Resource: advertisers.lineItems

{
  "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)
  },
  "targetingExpansion": {
    object (TargetingExpansionConfig)
  },
  "warningMessages": [
    enum (LineItemWarningMessage)
  ],
  "mobileApp": {
    object (MobileApp)
  },
  "reservationType": enum (ReservationType),
  "excludeNewExchanges": boolean,
  "youtubeAndPartnersSettings": {
    object (YoutubeAndPartnersSettings)
  }
}

string

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

string (int64 format)

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

string (int64 format)

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

string (int64 format)

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

string (int64 format)

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

string

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

Il doit être encodé au format UTF-8 et ne doit pas dépasser 240 octets.

enum (LineItemType)

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

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, puis définissez son é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 de tout 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.

string (Timestamp format)

Uniquement en sortie. Date et heure 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 après la virgule. Exemples: "2014-10-02T15:01:23Z" et "2014-10-02T15:01:23.045123456Z".

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 partenaires de l'ordre d'insertion parent.

object (LineItemFlight)

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

object (LineItemBudget)

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

object (Pacing)

Obligatoire. Paramètre "Vitesse de dépenses du budget" de l'élément de campagne.

object (FrequencyCap)

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

Vous devez utiliser le champ maxImpressions dans cet objet de paramètres si vous attribuez une limite limitée.

object (PartnerRevenueModel)

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

object (ConversionCountingConfig)

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

string (int64 format)

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

object (BiddingStrategy)

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

object (IntegrationDetails)

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

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 des listes d'audience éligibles.

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.

object (MobileApp)

Application mobile promue par l'élément de campagne.

Cela n'est applicable que lorsque lineItemType correspond à LINE_ITEM_TYPE_DISPLAY_MOBILE_APP_INSTALL ou LINE_ITEM_TYPE_VIDEO_MOBILE_APP_INSTALL.

enum (ReservationType)

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

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

object (YoutubeAndPartnersSettings)

Uniquement en sortie. Paramètres propres aux éléments de campagne YouTube et partenaires.

{
  "flightDateType": enum (LineItemFlightDateType),
  "dateRange": {
    object (DateRange)
  }
}

enum (LineItemFlightDateType)

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

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. Résultat uniquement.
• Lorsque vous créez un vol, les champs startDate et endDate doivent tous deux se situer dans le futur.
• Un vol existant avec un startDate dans le passé possède un endDate modifiable, mais un startDate immuable.
• endDate doit être startDate ou une date ultérieure, antérieure à l'année 2037.

{
  "budgetAllocationType": enum (LineItemBudgetAllocationType),
  "budgetUnit": enum (BudgetUnit),
  "maxAmount": string
}

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.

enum (BudgetUnit)

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

string (int64 format)

Montant du budget maximal 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 du budget maximal à 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.

{
  "markupType": enum (PartnerRevenueModelMarkupType),
  "markupAmount": string
}

enum (PartnerRevenueModelMarkupType)

Obligatoire. Type de majoration du modèle de revenus du partenaire.

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 markupType est défini 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 du pourcentage du coût média en millièmes. 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 du pourcentage du coût média total en millièmes. Par exemple, 100 représente 0,1% (0,001 décimal).

{
  "postViewCountPercentageMillis": string,
  "floodlightActivityConfigs": [
    {
      object (TrackingFloodlightActivityConfig)
    }
  ]
}

string (int64 format)

Pourcentage de conversions après affichage à comptabiliser, en millièmes (1/1 000 de pourcentage). La valeur doit être comprise entre 0 et 100 000 inclus.

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

object (TrackingFloodlightActivityConfig)

Configurations d'activité Floodlight utilisées pour effectuer le suivi des conversions.

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

{
  "floodlightActivityId": string,
  "postClickLookbackWindowDays": integer,
  "postViewLookbackWindowDays": integer
}

string (int64 format)

Obligatoire. Identifiant de l'activité Floodlight.

integer

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

integer

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

{
  "appId": string,
  "platform": enum (Platform),
  "displayName": string,
  "publisher": string
}

string

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

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

enum (Platform)

Uniquement en sortie. Plate-forme d'applications

string

Uniquement en sortie. Nom de l'application.

string

Uniquement en sortie. Éditeur de l'application.

{
  "viewFrequencyCap": {
    object (FrequencyCap)
  },
  "thirdPartyMeasurementConfigs": {
    object (ThirdPartyMeasurementConfigs)
  },
  "inventorySourceSettings": {
    object (YoutubeAndPartnersInventorySourceConfig)
  },
  "contentCategory": enum (YoutubeAndPartnersContentCategory),
  "effectiveContentCategory": enum (YoutubeAndPartnersContentCategory),
  "targetFrequency": {
    object (TargetFrequency)
  },
  "linkedMerchantId": string,
  "relatedVideoIds": [
    string
  ],
  "leadFormId": string,
  "videoAdSequenceSettings": {
    object (VideoAdSequenceSettings)
  }
}

object (FrequencyCap)

Afficher les paramètres de limite de la fréquence d'exposition de l'élément de campagne.

Vous devez utiliser le champ maxViews dans cet objet de paramètres si vous attribuez une limite limitée.

object (ThirdPartyMeasurementConfigs)

Facultatif. Configurations de mesure tierces de l'élément de campagne.

object (YoutubeAndPartnersInventorySourceConfig)

Paramètres qui contrôlent les inventaires YouTube et partenaires que l'élément de campagne va cibler.

enum (YoutubeAndPartnersContentCategory)

Type de contenu sur lequel les annonces YouTube et partenaires seront diffusées.

enum (YoutubeAndPartnersContentCategory)

Uniquement en sortie. Catégorie de contenu qui prend effet lors de la diffusion de l'élément de campagne. Lorsque la catégorie de contenu est définie à la fois au niveau de l'élément de campagne et de l'annonceur, la catégorie la plus stricte est appliquée lors de la diffusion de l'élément de campagne.

object (TargetFrequency)

Nombre moyen de fois que vous souhaitez que les annonces de cet élément de campagne soient diffusées auprès de la même personne au cours d'une période donnée.

string (int64 format)

Identifiant du marchand associé à la ligne du flux de produits.

string

Les ID des vidéos apparaissent sous l'annonce vidéo principale lorsque celle-ci est diffusée dans l'application YouTube sur un appareil mobile.

string (int64 format)

ID du formulaire permettant de générer des prospects.

object (VideoAdSequenceSettings)

Paramètres associés à VideoAdSequence.

{
  "viewabilityVendorConfigs": [
    {
      object (ThirdPartyVendorConfig)
    }
  ],
  "brandSafetyVendorConfigs": [
    {
      object (ThirdPartyVendorConfig)
    }
  ],
  "reachVendorConfigs": [
    {
      object (ThirdPartyVendorConfig)
    }
  ],
  "brandLiftVendorConfigs": [
    {
      object (ThirdPartyVendorConfig)
    }
  ]
}

object (ThirdPartyVendorConfig)

Facultatif. Les fournisseurs tiers qui mesurent la visibilité.

Les fournisseurs tiers suivants sont concernés:

• THIRD_PARTY_VENDOR_MOAT
• THIRD_PARTY_VENDOR_DOUBLE_VERIFY
• THIRD_PARTY_VENDOR_INTEGRAL_AD_SCIENCE
• THIRD_PARTY_VENDOR_COMSCORE
• THIRD_PARTY_VENDOR_TELEMETRY
• THIRD_PARTY_VENDOR_MEETRICS

object (ThirdPartyVendorConfig)

Facultatif. Les fournisseurs tiers qui mesurent la brand safety.

Les fournisseurs tiers suivants sont concernés:

• THIRD_PARTY_VENDOR_ZERF
• THIRD_PARTY_VENDOR_DOUBLE_VERIFY
• THIRD_PARTY_VENDOR_INTEGRAL_AD_SCIENCE

object (ThirdPartyVendorConfig)

Facultatif. Les fournisseurs tiers qui mesurent la couverture

Les fournisseurs tiers suivants sont concernés:

• THIRD_PARTY_VENDOR_NIELSEN
• THIRD_PARTY_VENDOR_COMSCORE
• THIRD_PARTY_VENDOR_KANTAR

object (ThirdPartyVendorConfig)

Facultatif. Les fournisseurs tiers qui mesurent le brand lift.

Les fournisseurs tiers suivants sont concernés:

• THIRD_PARTY_VENDOR_DYNATA
• THIRD_PARTY_VENDOR_KANTAR

{
  "vendor": enum (ThirdPartyVendor),
  "placementId": string
}

enum (ThirdPartyVendor)

Le fournisseur de mesure tiers.

string

ID permettant à la plate-forme du fournisseur tiers d'identifier l'élément de campagne.

{
  "includeYoutube": boolean,
  "includeGoogleTv": boolean,
  "includeYoutubeVideoPartners": boolean
}

boolean

Facultatif. Permet de cibler ou non l'inventaire YouTube. Cela inclut à la fois la recherche, les chaînes et les vidéos.

boolean

Facultatif. Permet de cibler ou non l'inventaire des applications vidéo disponibles avec Google TV.

boolean

Permet de cibler l'inventaire sur un ensemble de sites et d'applications partenaires qui respectent les mêmes normes de brand safety que YouTube.

{
  "targetCount": string,
  "timeUnit": enum (TimeUnit),
  "timeUnitCount": integer
}

string (int64 format)

Il s'agit du nombre cible de fois que les annonces seront diffusées en moyenne auprès de la même personne au cours de la période déterminée par timeUnit et timeUnitCount.

enum (TimeUnit)

Unité de temps dans laquelle la fréquence cible sera appliquée.

L'unité de temps suivante s'applique:

• TIME_UNIT_WEEKS

integer

Nombre de timeUnit correspondant à la fréquence cible.

Les restrictions suivantes s'appliquent en fonction de la valeur de timeUnit:

• TIME_UNIT_WEEKS : la valeur doit être égale à 1

{
  "minimumDuration": enum (VideoAdSequenceMinimumDuration),
  "steps": [
    {
      object (VideoAdSequenceStep)
    }
  ]
}

enum (VideoAdSequenceMinimumDuration)

Intervalle de temps minimal avant que le même utilisateur ne revoie cette séquence.

object (VideoAdSequenceStep)

Étapes composant la séquence.

{
  "stepId": string,
  "adGroupId": string,
  "previousStepId": string,
  "interactionType": enum (InteractionType)
}

string (int64 format)

ID de l'étape.

string (int64 format)

ID du groupe d'annonces correspondant à l'étape.

string (int64 format)

ID de l'étape précédente. La première étape n'a pas d'étape précédente.

enum (InteractionType)

Interaction de l'étape précédente qui redirigera l'utilisateur vers cette étape. La première étape ne comporte pas d'interactionType.