REST Resource: advertisers.lineItems

Ressource: LineItem

Élément de campagne unique.

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

string

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

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. Identifiant 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 son état sur ENTITY_STATUS_ACTIVE après sa création.
  • Impossible de rétablir l'état ENTITY_STATUS_DRAFT d'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, ce dernier ne peut pas dépenser son budget, même si son état est ENTITY_STATUS_ACTIVE.
updateTime

string (Timestamp format)

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

Horodatage au format RFC3339 UTC "Zulu", avec une résolution de l'ordre de la nanoseconde et jusqu'à neuf chiffres décimaux. Exemples : "2014-10-02T15:01:23Z" et "2014-10-02T15:01:23.045123456Z".

partnerCosts[]

object (PartnerCost)

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

S'ils sont absents ou vides dans la méthode lineItems.create, l'élément de campagne nouvellement créé héritera des coûts partenaires 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épenses du budget de l'élément de campagne.

frequencyCap

object (FrequencyCap)

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

Le champ maxImpressions de cet objet de paramètres doit être utilisé si vous attribuez un plafond limité.

partnerRevenueModel

object (PartnerRevenueModel)

Obligatoire. Paramètre de 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.

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 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 promue par l'élément de campagne.

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 de l'élément de campagne. Par défaut, la valeur de ce champ est "false".

youtubeAndPartnersSettings

object (YoutubeAndPartnersSettings)

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

LineItemType

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

Le type d'é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 du type n'est pas spécifiée ou est inconnue dans cette version.

Impossible de créer ou de mettre à jour les é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 Annonces display qui génèrent des installations d'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 génèrent des installations d'une application.
LINE_ITEM_TYPE_DISPLAY_MOBILE_APP_INVENTORY

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

Impossible de créer ou de mettre à jour les é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 les é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 (OTT, over-the-top). Ce type ne s'applique qu'aux éléments de campagne associés à un ordre d'insertion de type OVER_THE_TOP insertionOrderType.
LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_ACTION

Annonces vidéo YouTube qui favorisent les conversions.

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

LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_NON_SKIPPABLE

Annonces vidéo YouTube (15 secondes maximum) ne pouvant pas être ignorées.

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

LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_VIDEO_SEQUENCE

Annonces vidéo YouTube qui diffusent une histoire dans une séquence particulière à l'aide de différents formats.

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

LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_AUDIO

Les annonces audio YouTube.

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

LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_REACH

Annonces vidéo YouTube optimisées pour toucher plus d'utilisateurs uniques à moindre coût. Il peut s'agir d'annonces bumper, d'annonces InStream désactivables ou de différents types.

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

LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_SIMPLE

Annonces vidéo YouTube par défaut.

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

LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_NON_SKIPPABLE_OVER_THE_TOP

Annonces vidéo YouTube pour TV connectée (d'une durée maximale de 15 secondes) ne pouvant pas être ignorées.

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

LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_REACH_OVER_THE_TOP

Annonces vidéo YouTube pour la TV connectée optimisées pour toucher plus d'utilisateurs uniques à moindre coût. Il peut s'agir d'annonces bumper, d'annonces InStream désactivables ou de différents types.

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

LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_SIMPLE_OVER_THE_TOP

Annonces vidéo YouTube par défaut pour la TV connectée. N'inclure que le format d'annonce InStream.

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

LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_TARGET_FREQUENCY

L'objectif de ce type d'élément de campagne est de diffuser les annonces YouTube un nombre de fois auprès d'une même personne au cours d'une période donnée.

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

LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_VIEW

Annonces vidéo YouTube visant à générer plus de vues à l'aide de différents formats d'annonces.

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

LINE_ITEM_TYPE_DISPLAY_OUT_OF_HOME

Annonces display diffusées sur l'inventaire de publicité extérieure numérique.

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

LINE_ITEM_TYPE_VIDEO_OUT_OF_HOME

Annonces vidéo diffusées sur l'inventaire de publicité extérieure numérique.

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

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)
  }
}
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 le cas contraire.
  • Lorsque vous créez une période de diffusion, les valeurs startDate et endDate doivent toutes les deux se situer dans le futur.
  • Un vol existant ayant un startDate dans le passé présente un endDate modifiable, mais un startDate immuable.
  • endDate doit être la valeur startDate ou une valeur ultérieure, toutes deux antérieures à l'année 2037.

LineItemFlightDateType

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

Enums
LINE_ITEM_FLIGHT_DATE_TYPE_UNSPECIFIED La valeur du 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 héritée 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.

LineItemBudget

Paramètres qui contrôlent la manière dont le budget est alloué.

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 une devise ou sur un nombre d'impressions. Cette valeur est héritée de l'ordre d'insertion parent.

maxAmount

string (int64 format)

Montant du budget maximal que l'élément de campagne dépensera. 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: <ph type="x-smartling-placeholder">
      </ph>
    • BUDGET_UNIT_CURRENCY, ce champ représente le montant maximal du budget à dépenser, en 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 du 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 permettant de contrôler le mode de calcul des revenus du partenaire.

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

enum (PartnerRevenueModelMarkupType)

Obligatoire. Type de majoration 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 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 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 majoration possibles pour le modèle de revenus du partenaire.

Enums
PARTNER_REVENUE_MODEL_MARKUP_TYPE_UNSPECIFIED La valeur du type n'est pas spécifiée ou est inconnue dans cette version.
PARTNER_REVENUE_MODEL_MARKUP_TYPE_CPM Calculez les revenus du partenaire en fonction d'un CPM fixe.
PARTNER_REVENUE_MODEL_MARKUP_TYPE_MEDIA_COST_MARKUP

Calculer les revenus du partenaire en fonction d'un pourcentage supplémentaire du 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 du coût média total, qui inclut l'ensemble des coûts partenaires et des coûts liés aux données.

ConversionCountingConfig

Paramètres régissant la comptabilisation des conversions.

Toutes les conversions post-clic seront comptabilisées. Vous pouvez définir un pourcentage pour la comptabilisation des 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 millisecondes (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 50 000.

floodlightActivityConfigs[]

object (TrackingFloodlightActivityConfig)

Configurations d'activités Floodlight utilisées pour suivre les 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.

TrackingFloodlightActivityConfig

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

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

string (int64 format)

Obligatoire. ID de l'activité Floodlight.

postClickLookbackWindowDays

integer

Obligatoire. Il s'agit du nombre de jours au cours desquels une conversion peut être comptabilisée après un clic sur une annonce. Doit être compris entre 0 et 90 inclus.

postViewLookbackWindowDays

integer

Obligatoire. Il s'agit du nombre de jours au cours desquels une conversion peut être comptabilisée après qu'une annonce a été vue. Doit être compris entre 0 et 90 inclus.

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 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 cette ligne de commande n'est pas valide. L'élément de campagne ne sera 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 ne sera pas diffusé.
INVALID_INVENTORY_SOURCE Aucune source d'inventaire active n'est ciblée. L'élément de campagne ne sera pas diffusé.
APP_INVENTORY_INVALID_SITE_TARGETING Cet élément de campagne Le ciblage par URL n'inclut aucune application mobile. Avec ce type d'élément de campagne, vous devez inclure des applications mobiles à votre canal, votre liste de sites ou votre ciblage par applications. L'élément de campagne ne sera pas diffusé.
APP_INVENTORY_INVALID_AUDIENCE_LISTS Cet élément de campagne ne cible aucun utilisateur mobile. Ce type d'élément de campagne nécessite que vous proposiez une liste d'utilisateurs composée d'utilisateurs mobiles. L'élément de campagne ne sera pas diffusé.
NO_VALID_CREATIVE Cet élément de campagne ne contient aucune création valide. L'élément de campagne ne sera 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 ne sera pas diffusé.
PARENT_INSERTION_ORDER_EXPIRED La date de fin de l'ordre d'insertion de cet élément de campagne est passée. L'élément de campagne ne sera pas diffusé.
DEPRECATED_FIRST_PARTY_AUDIENCE_EXCLUSION

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

Mettez à jour l'intégration de votre API pour exclure directement les audiences propriétaires utilisant le ciblage d'audience avant le 25 mars 2023 afin de tenir compte de l'arrêt du champ excludeFirstPartyAudience.

MobileApp

Application mobile dont la promotion est assurée par un élément de campagne d'installation d'application mobile.

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 d'applications.

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

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

platform

enum (Platform)

Uniquement en sortie. La 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.

YoutubeAndPartnersSettings

Paramètres des éléments de campagne YouTube et partenaires.

Représentation JSON
{
  "biddingStrategy": {
    object (YoutubeAndPartnersBiddingStrategy)
  },
  "viewFrequencyCap": {
    object (FrequencyCap)
  },
  "thirdPartyMeasurementSettings": {
    object (YoutubeAndPartnersThirdPartyMeasurementSettings)
  },
  "inventorySourceSettings": {
    object (YoutubeAndPartnersInventorySourceConfig)
  },
  "contentCategory": enum (YoutubeAndPartnersContentCategory),
  "effectiveContentCategory": enum (YoutubeAndPartnersContentCategory),
  "targetFrequency": {
    object (TargetFrequency)
  },
  "linkedMerchantId": string,
  "relatedVideoIds": [
    string
  ],
  "leadFormId": string,
  "videoAdSequenceSettings": {
    object (VideoAdSequenceSettings)
  }
}
Champs
biddingStrategy

object (YoutubeAndPartnersBiddingStrategy)

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

viewFrequencyCap

object (FrequencyCap)

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

Le champ maxViews de cet objet de paramètres doit être utilisé si vous attribuez un plafond limité.

thirdPartyMeasurementSettings

object (YoutubeAndPartnersThirdPartyMeasurementSettings)

Facultatif. Paramètres de mesure tierce de l'élément de campagne.

inventorySourceSettings

object (YoutubeAndPartnersInventorySourceConfig)

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

contentCategory

enum (YoutubeAndPartnersContentCategory)

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

effectiveContentCategory

enum (YoutubeAndPartnersContentCategory)

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

targetFrequency

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.

linkedMerchantId

string (int64 format)

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

relatedVideoIds[]

string

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

leadFormId

string (int64 format)

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

videoAdSequenceSettings

object (VideoAdSequenceSettings)

Paramètres associés à VideoAdSequence.

YoutubeAndPartnersThirdPartyMeasurementSettings

Paramètres qui contrôlent quels fournisseurs tiers mesurent des métriques spécifiques concernant les éléments de campagne.

Représentation JSON
{
  "viewabilityVendorConfigs": [
    {
      object (ThirdPartyVendorConfig)
    }
  ],
  "brandSafetyVendorConfigs": [
    {
      object (ThirdPartyVendorConfig)
    }
  ],
  "reachVendorConfigs": [
    {
      object (ThirdPartyVendorConfig)
    }
  ],
  "brandLiftVendorConfigs": [
    {
      object (ThirdPartyVendorConfig)
    }
  ]
}
Champs
viewabilityVendorConfigs[]

object (ThirdPartyVendorConfig)

Fournisseurs tiers mesurant 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
brandSafetyVendorConfigs[]

object (ThirdPartyVendorConfig)

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
reachVendorConfigs[]

object (ThirdPartyVendorConfig)

Fournisseurs tiers mesurant la couverture.

Les fournisseurs tiers suivants sont concernés:

  • THIRD_PARTY_VENDOR_NIELSEN
  • THIRD_PARTY_VENDOR_COMSCORE
  • THIRD_PARTY_VENDOR_KANTAR
brandLiftVendorConfigs[]

object (ThirdPartyVendorConfig)

Les fournisseurs tiers mesurant le brand lift.

Les fournisseurs tiers suivants sont concernés:

  • THIRD_PARTY_VENDOR_DYNATA
  • THIRD_PARTY_VENDOR_KANTAR

ThirdPartyVendorConfig

Paramètres qui contrôlent la façon dont les fournisseurs de solutions de mesure tiers sont configurés.

Représentation JSON
{
  "vendor": enum (ThirdPartyVendor),
  "placementId": string
}
Champs
vendor

enum (ThirdPartyVendor)

Le fournisseur de mesure tiers.

placementId

string

ID utilisé par la plate-forme du fournisseur tiers pour identifier l'élément de campagne.

ThirdPartyVendor

Fournisseurs qui effectuent des mesures tierces.

Enums
THIRD_PARTY_VENDOR_UNSPECIFIED Fournisseur tiers inconnu.
THIRD_PARTY_VENDOR_MOAT Douve.
THIRD_PARTY_VENDOR_DOUBLE_VERIFY DoubleVerify.
THIRD_PARTY_VENDOR_INTEGRAL_AD_SCIENCE Integral Ad Science.
THIRD_PARTY_VENDOR_COMSCORE Comscore
THIRD_PARTY_VENDOR_TELEMETRY Télémétrie.
THIRD_PARTY_VENDOR_MEETRICS Meetrics
THIRD_PARTY_VENDOR_ZEFR ZEFR.
THIRD_PARTY_VENDOR_NIELSEN Nielsen,
THIRD_PARTY_VENDOR_KANTAR Kantar.
THIRD_PARTY_VENDOR_DYNATA Dynata

YoutubeAndPartnersInventorySourceConfig

Paramètres permettant de contrôler les inventaires YouTube associés que l'élément de campagne YouTube et partenaires ciblera.

Représentation JSON
{
  "includeYoutubeSearch": boolean,
  "includeYoutubeVideos": boolean,
  "includeGoogleTv": boolean,
  "includeYoutubeVideoPartners": boolean
}
Champs
includeYoutubeVideos

boolean

Permet de cibler ou non l'inventaire de chaînes et de vidéos sur YouTube, ainsi que les vidéos YouTube intégrées sur d'autres sites.

includeGoogleTv

boolean

Facultatif. Cibler ou non l'inventaire dans les applications vidéo disponibles avec Google TV.

includeYoutubeVideoPartners

boolean

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

YoutubeAndPartnersContentCategory

Catégories de brand safety pour les contenus YouTube et partenaires

Enums
YOUTUBE_AND_PARTNERS_CONTENT_CATEGORY_UNSPECIFIED La catégorie de contenu n'est pas spécifiée ou est inconnue dans cette version.
YOUTUBE_AND_PARTNERS_CONTENT_CATEGORY_STANDARD Catégorie qui comprend un large éventail de contenus et est adaptée à la plupart des marques. Le contenu est basé sur les Consignes relatives aux contenus adaptés aux annonceurs de YouTube.
YOUTUBE_AND_PARTNERS_CONTENT_CATEGORY_EXPANDED Catégorie incluant tous les contenus de YouTube et des partenaires vidéo qui respectent les normes de monétisation.
YOUTUBE_AND_PARTNERS_CONTENT_CATEGORY_LIMITED Catégorie composée d'une gamme réduite de contenus répondant à des exigences plus strictes, en particulier en ce qui concerne le langage inapproprié et le contenu suggestif à caractère sexuel.

TargetFrequency

Paramètre permettant de contrôler le nombre moyen de fois que les annonces sont diffusées auprès de la même personne au cours d'une période donnée.

Représentation JSON
{
  "targetCount": string,
  "timeUnit": enum (TimeUnit),
  "timeUnitCount": integer
}
Champs
targetCount

string (int64 format)

Nombre cible de diffusions, en moyenne, des annonces auprès de la même personne au cours de la période définie par timeUnit et timeUnitCount.

timeUnit

enum (TimeUnit)

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

L'unité de temps suivante s'applique:

  • TIME_UNIT_WEEKS
timeUnitCount

integer

Nombre de timeUnit pendant lesquels la fréquence cible durera.

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

  • TIME_UNIT_WEEKS - doit être 1

VideoAdSequenceSettings

Paramètres associés à VideoAdSequence.

Représentation JSON
{
  "minimumDuration": enum (VideoAdSequenceMinimumDuration),
  "steps": [
    {
      object (VideoAdSequenceStep)
    }
  ]
}
Champs
minimumDuration

enum (VideoAdSequenceMinimumDuration)

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

steps[]

object (VideoAdSequenceStep)

Étapes composant la séquence.

VideoAdSequenceMinimumDuration

Énumération indiquant l'intervalle de temps minimal possible avant que le même utilisateur ne voie à nouveau le VideoAdSequence.

Enums
VIDEO_AD_SEQUENCE_MINIMUM_DURATION_UNSPECIFIED Non spécifié ou inconnu.
VIDEO_AD_SEQUENCE_MINIMUM_DURATION_WEEK 7 jours.
VIDEO_AD_SEQUENCE_MINIMUM_DURATION_MONTH 30 jours.

VideoAdSequenceStep

Détails d'une étape unique dans un VideoAdSequence.

Représentation JSON
{
  "stepId": string,
  "adGroupId": string,
  "previousStepId": string,
  "interactionType": enum (InteractionType)
}
Champs
stepId

string (int64 format)

ID de l'étape.

adGroupId

string (int64 format)

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

previousStepId

string (int64 format)

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

interactionType

enum (InteractionType)

Interaction à l'étape précédente qui mène l'utilisateur à cette étape. La première étape ne comporte pas interactionType.

InteractionType

Types d'interactions au niveau d'une étape.

Enums
INTERACTION_TYPE_UNSPECIFIED Non spécifié ou inconnu
INTERACTION_TYPE_PAID_VIEW Une vue payante.
INTERACTION_TYPE_SKIP Ignoré par le spectateur.
INTERACTION_TYPE_IMPRESSION Une impression d'annonce (vue)
INTERACTION_TYPE_ENGAGED_IMPRESSION Une impression d'annonce qui n'a pas été immédiatement ignorée par l'utilisateur, mais qui n'a pas non plus atteint l'événement facturable.

Méthodes

bulkEditAssignedTargetingOptions

Permet de modifier de manière groupée les options de ciblage sous plusieurs éléments de campagne.

bulkListAssignedTargetingOptions

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

bulkUpdate

Met à jour plusieurs éléments de campagne.

create

Crée un élément de campagne.

delete

Supprime un élément de campagne.

duplicate

Duplique un élément de ligne.

generateDefault

Crée un élément de campagne dont les paramètres (y compris le ciblage) sont hérités de l'ordre d'insertion et un élément entity_status 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.