- Ressource: LineItem
- LineItemType
- LineItemFlight
- LineItemFlightDateType
- LineItemBudget
- LineItemBudgetAllocationType
- PartnerRevenueModel
- PartnerRevenueModelMarkupType
- ConversionCountingConfig
- TrackingFloodlightActivityConfig
- TargetingExpansionConfig
- TargetingExpansionLevel
- LineItemWarningMessage
- MobileApp
- Platform
- Méthodes
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 ( |
Champs | |
---|---|
name |
Uniquement en sortie. Nom de ressource de l'élément de campagne. |
advertiserId |
Uniquement en sortie. Identifiant unique de l'annonceur auquel appartient l'élément de campagne. |
campaignId |
Uniquement en sortie. ID unique de la campagne à laquelle appartient l'élément de campagne. |
insertionOrderId |
Obligatoire. Immuable. ID unique de l'ordre d'insertion auquel appartient l'élément de campagne. |
lineItemId |
Uniquement en sortie. Identifiant unique de l'élément de campagne. Attribué par le système. |
displayName |
Obligatoire. Nom à afficher de l'élément de campagne. Doit être encodé au format UTF-8 avec une taille maximale de 240 octets. |
lineItemType |
Obligatoire. Immuable. Type de l'élément de campagne. |
entityStatus |
Obligatoire. Détermine si l'élément de campagne peut dépenser son budget et définir des enchères sur l'inventaire.
|
updateTime |
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: |
partnerCosts[] |
Coûts associés au partenaire associés à l'élément de campagne. Si cette valeur est absente ou vide dans la méthode |
flight |
Obligatoire. Heures de début et de fin de la période de diffusion de l'élément de campagne. |
budget |
Obligatoire. Paramètre de répartition du budget de l'élément de campagne. |
pacing |
Obligatoire. Paramètre de vitesse de dépense du budget de l'élément de campagne. |
frequencyCap |
Obligatoire. Paramètres de limite de la fréquence d'exposition des impressions de l'élément de campagne. Le champ |
partnerRevenueModel |
Obligatoire. Paramètre du modèle de revenus du partenaire de l'élément de campagne. |
conversionCounting |
Paramètre de suivi des conversions de l'élément de campagne. |
creativeIds[] |
ID des créations associées à l'élément de campagne. |
bidStrategy |
Obligatoire. Stratégie d'enchères de l'élément de campagne. |
integrationDetails |
Détails d'intégration de l'élément de campagne. |
inventorySourceIds[] |
ID des sources d'inventaire privées attribuées à l'élément de campagne. |
targetingExpansion |
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[] |
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 |
Application mobile dont l'élément de campagne fait la promotion. Cela n'est applicable que lorsque |
reservationType |
Uniquement en sortie. Type de réservation de l'élément de campagne. |
excludeNewExchanges |
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 ( |
Champs | |
---|---|
flightDateType |
Obligatoire. Type de période de diffusion de l'élément de campagne. |
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.
|
triggerId |
ID du déclencheur manuel associé à l'élément de campagne.
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 ( |
Champs | |
---|---|
budgetAllocationType |
Obligatoire. Type de répartition du budget.
|
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 |
Montant maximal du budget dépensé par l'élément de campagne. Doit être supérieur à 0. Lorsque
|
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 ( |
Champs | |
---|---|
markupType |
Obligatoire. Type de balisage du modèle de revenus du partenaire. |
markupAmount |
Obligatoire. Montant de la majoration du modèle de revenus du partenaire. La valeur doit être supérieure ou égale à 0.
|
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 ( |
Champs | |
---|---|
postViewCountPercentageMillis |
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[] |
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 |
Obligatoire. Identifiant de l'activité Floodlight. |
postClickLookbackWindowDays |
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 |
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 ( |
Champs | |
---|---|
targetingExpansionLevel |
Obligatoire. Indique si le ciblage optimisé est activé. Ce champ accepte les valeurs suivantes:
Si ce champ est défini sur une autre valeur, il sera automatiquement défini sur
|
excludeFirstPartyAudience |
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 |
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 |
BALANCED_EXPANSION |
Si vous l'utilisez, il sera automatiquement défini sur |
MORE_EXPANSION |
Si vous l'utilisez, il sera automatiquement défini sur |
MOST_EXPANSION |
Si vous l'utilisez, il sera automatiquement défini sur |
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 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 |
MobileApp
Application mobile promue par un élément de campagne associé à l'installation d'applications mobiles.
Représentation JSON |
---|
{
"appId": string,
"platform": enum ( |
Champs | |
---|---|
appId |
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 Les applications iOS sont identifiées par un ID d'application à neuf chiffres utilisé par l'App Store d'Apple (par exemple, |
platform |
Uniquement en sortie. Plate-forme de l'application |
displayName |
Uniquement en sortie. Nom de l'application |
publisher |
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 |
|
---|---|
|
Modifier les options de ciblage de façon groupée sous un seul élément de campagne |
|
Liste les options de ciblage attribuées à un élément de campagne pour différents types de ciblage. |
|
Crée un élément de campagne. |
|
Supprime un élément de campagne. |
|
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 ". |
|
Récupère un élément de campagne. |
|
Liste les éléments de campagne d'un annonceur. |
|
Met à jour un élément de campagne existant. |