Objet de données de campagne - Gestion des campagnes

  • Article

Définit une campagne.

Remarque

Vous ne pouvez plus ajouter, mettre à jour ou récupérer des campagnes qui prennent uniquement en charge les annonces de recherche dynamique. Le type de campagne de vos campagnes existantes a été mis à jour de « DynamicSearchAds » à « Recherche ». Les groupes d’annonces sont désormais considérés comme des groupes d’annonces « dynamiques », mais il n’y a aucun changement structurel, c’est-à-dire qu’ils contiennent les mêmes cibles automatiques et les mêmes annonces de recherche dynamique qu’auparavant.

Remarque

À compter d’avril 2021, la stratégie d’enchère manuelle du CCP ne peut être utilisée qu’avec des campagnes d’audience et des campagnes d’hébergement (anciennement des campagnes d’hôtel). Si vous essayez de définir la SCP manuelle pour tout autre type de campagne, la demande est ignorée sans erreur et la stratégie d’enchère est définie sur LA SCP améliorée.

Depuis avril 2021, vous ne pouvez pas définir de stratégies d’enchères pour les groupes d’annonces ou les mots clés. Les stratégies d’enchère ne peuvent être définies qu’au niveau de la campagne. Si vous essayez de définir des stratégies d’enchère pour des groupes d’annonces ou des mots clés, la demande est ignorée sans erreur. Les groupes d’annonces et les mots clés héritent de la stratégie d’enchère de leur campagne.

Syntaxe

<xs:complexType name="Campaign" xmlns:xs="http://www.w3.org/2001/XMLSchema">
  <xs:sequence>
    <xs:element minOccurs="0" name="AudienceAdsBidAdjustment" nillable="true" type="xs:int" />
    <xs:element minOccurs="0" name="BiddingScheme" nillable="true" type="tns:BiddingScheme" />
    <xs:element minOccurs="0" name="BudgetType" nillable="true" type="tns:BudgetLimitType" />
    <xs:element minOccurs="0" name="DailyBudget" nillable="true" type="xs:double" />
    <xs:element xmlns:q8="http://schemas.microsoft.com/2003/10/Serialization/Arrays" minOccurs="0" name="DealIds" nillable="true" type="q8:ArrayOflong">
      <xs:annotation>
        <xs:appinfo>
          <DefaultValue EmitDefaultValue="false" xmlns="http://schemas.microsoft.com/2003/10/Serialization/" />
        </xs:appinfo>
      </xs:annotation>
    </xs:element>
    <xs:element minOccurs="0" name="ExperimentId" nillable="true" type="xs:long" />
    <xs:element minOccurs="0" name="FinalUrlSuffix" nillable="true" type="xs:string" />
    <xs:element xmlns:q9="http://schemas.datacontract.org/2004/07/System.Collections.Generic" minOccurs="0" name="ForwardCompatibilityMap" nillable="true" type="q9:ArrayOfKeyValuePairOfstringstring" />
    <xs:element xmlns:q10="http://schemas.microsoft.com/2003/10/Serialization/Arrays" minOccurs="0" name="GoalIds" nillable="true" type="q10:ArrayOflong">
      <xs:annotation>
        <xs:appinfo>
          <DefaultValue EmitDefaultValue="false" xmlns="http://schemas.microsoft.com/2003/10/Serialization/" />
        </xs:appinfo>
      </xs:annotation>
    </xs:element>
    <xs:element minOccurs="0" name="Id" nillable="true" type="xs:long" />
    <xs:element minOccurs="0" name="MultimediaAdsBidAdjustment" nillable="true" type="xs:int">
      <xs:annotation>
        <xs:appinfo>
          <DefaultValue EmitDefaultValue="false" xmlns="http://schemas.microsoft.com/2003/10/Serialization/" />
        </xs:appinfo>
      </xs:annotation>
    </xs:element>
    <xs:element minOccurs="0" name="Name" nillable="true" type="xs:string" />
    <xs:element minOccurs="0" name="Status" nillable="true" type="tns:CampaignStatus" />
    <xs:element minOccurs="0" name="SubType" nillable="true" type="xs:string" />
    <xs:element minOccurs="0" name="TimeZone" nillable="true" type="xs:string" />
    <xs:element minOccurs="0" name="TrackingUrlTemplate" nillable="true" type="xs:string" />
    <xs:element minOccurs="0" name="UrlCustomParameters" nillable="true" type="tns:CustomParameters" />
    <xs:element minOccurs="0" name="CampaignType" nillable="true" type="tns:CampaignType" />
    <xs:element minOccurs="0" name="Settings" nillable="true" type="tns:ArrayOfSetting" />
    <xs:element minOccurs="0" name="BudgetId" nillable="true" type="xs:long" />
    <xs:element xmlns:q11="http://schemas.microsoft.com/2003/10/Serialization/Arrays" minOccurs="0" name="Languages" nillable="true" type="q11:ArrayOfstring" />
    <xs:element minOccurs="0" name="AdScheduleUseSearcherTimeZone" nillable="true" type="xs:boolean">
      <xs:annotation>
        <xs:appinfo>
          <DefaultValue EmitDefaultValue="false" xmlns="http://schemas.microsoft.com/2003/10/Serialization/" />
        </xs:appinfo>
      </xs:annotation>
    </xs:element>
    <xs:element minOccurs="0" name="BidStrategyId" nillable="true" type="xs:long">
      <xs:annotation>
        <xs:appinfo>
          <DefaultValue EmitDefaultValue="false" xmlns="http://schemas.microsoft.com/2003/10/Serialization/" />
        </xs:appinfo>
      </xs:annotation>
    </xs:element>
  </xs:sequence>
</xs:complexType>

Éléments

L’objet Campaign a les éléments suivants : AdScheduleUseSearcherTimeZone, AudienceAdsBidAdjustment, BiddingScheme, BidStrategyId, BudgetId, BudgetType, CampaignType, DailyBudget, DealIds, ExperimentId, FinalUrlSuffix, ForwardCompatibilityMap, GoalIds, Id, Languages, MultimediaAdsBidAddAdjustment, Name, Settings, Status, SubType, TimeZone, TrackingUrlTemplate, UrlCustomParameters.

Élément Description Type de données
AdScheduleUseSearcherTimeZone Détermine s’il faut utiliser le fuseau horaire du compte ou le fuseau horaire de l’utilisateur de recherche où les publicités peuvent être remises.

Affectez à cette propriété la valeur true si vous souhaitez que les annonces s’affichent dans le fuseau horaire de l’utilisateur de recherche, et définissez-la sur false.

Cet élément n’est pas retourné par défaut. Pour obtenir cet élément, incluez la valeur AdScheduleUseSearcherTimeZone dans l’élément ReturnAdditionalFields lorsque vous appelez les opérations de service GetCampaignsByAccountId et GetCampaignsByIds .

Ajouter: Optionnel. Si vous ne spécifiez pas cet élément ou laissez-le vide, la valeur par défaut false est définie et le fuseau horaire du compte est utilisé.
Mettre à jour: Optionnel. Si aucune valeur n’est définie pour la mise à jour, ce paramètre n’est pas modifié.		 boolean
AudienceAdsBidAdjustment Pourcentage d’ajustement de votre enchère pour les annonces d’audience au-dessus ou en dessous du groupe d’annonces de base ou mot clé enchère.

Cette propriété est disponible dans les campagnes Recherche si le client est activé pour le réseau d’audience Microsoft. Cette propriété n’est pas disponible avec les campagnes d’achat intelligentes.

Les valeurs prises en charge sont négatives de cent (-100) à neuf cents (900) positives. La définition de l’ajustement de l’enchère sur -100 empêchera les publicités d’audience de s’afficher pour cette campagne.

Définissez cet élément sur zéro (0) si vous souhaitez utiliser le groupe d’annonces de base ou mot clé enchère au lieu de spécifier un ajustement d’enchère pour les annonces d’audience.

Il est recommandé de toujours spécifier une valeur d’ajustement de l’enchère. Si vous définissez cet élément sur null, l’ajustement de l’enchère par défaut du système sera utilisé. L’ajustement de l’enchère par défaut du système est actuellement égal à zéro (0) et est susceptible d’être modifié.

Ajouter: Optionnel
Mettre à jour: Optionnel. Si aucune valeur n’est définie pour la mise à jour, ce paramètre n’est pas modifié.		 int
BiddingScheme Type de stratégie d’enchère pour la façon dont vous souhaitez gérer vos enchères.

Pour plus d’informations sur les stratégies d’enchère prises en charge par type de campagne, consultez Stratégies de budget et d’enchère.

IMPORTANT: Pour certains types de stratégie d’enchère, vos paramètres de rotation des enchères et des annonces sont ignorés et le suivi des conversions (via une balise de suivi des événements universels et un objectif de conversion) est requis. Pour plus d’informations, notamment sur les emplacements pris en charge, consultez Laisser Microsoft Advertising gérer vos enchères avec des stratégies d’enchères.

Cet élément est nul ou vide par défaut si la campagne utilise la stratégie d’enchère MaxConversionValueBiddingScheme ou TargetImpressionShareBiddingScheme . Pour obtenir les objets MaxConversionValueBiddingScheme ou TargetImpressionShareBiddingScheme , incluez les valeurs Respectives MaxConversionValueBiddingScheme et TargetImpressionShareBiddingScheme dans l’élément ReturnAdditionalFields lorsque vous appelez les opérations de service GetCampaignsByAccountId et GetCampaignsByIds .

Ajouter: Optionnel. Le type de stratégie d’enchère par défaut pour les campagnes Recherche et DynamicSearchAds est EnhancedCpcBiddingScheme. Le type de stratégie d’enchère par défaut pour la plupart des campagnes Shopping est EnhancedCpcBiddingScheme ; Toutefois, les seuls types de stratégies d’enchères pris en charge pour les campagnes d’achat intelligentes sont MaxConversionsBiddingScheme et MaxConversionValueBiddingScheme. Les types de stratégie d’enchères pris en charge pour les campagnes Audience sont EnhancedCpcBiddingScheme, ManualCpcBiddingScheme, ManualCpmBiddingScheme et TargetCpaBiddingScheme. Les types de stratégie de soumission pris en charge pour les campagnes de logement sont CommissionBiddingScheme, ManualCpcBiddingScheme et PercentCpcBiddingScheme. Les stratégies d’enchère prises en charge pour les campagnes Performance Max sont MaxConversionsBiddingScheme (avec TCPA facultatif) et MaxConversionValueBiddingScheme (avec TROAS facultatif). Les stratégies d’enchère prises en charge pour les nouvelles campagnes vidéo sont ManualCpmBiddingScheme et ManualCpvBiddingScheme. NOTE: À compter de mai 2024, vous ne pouvez plus utiliser la stratégie d’enchères manuelle de la SCP pour les campagnes d’audience natives. Vous pouvez uniquement utiliser la SCP manuelle pour les campagnes vidéo et d’affichage d’audience, ainsi que pour les campagnes d’hébergement. Nous convertirons automatiquement toutes les campagnes natives d’audiences d’audience manuelles existantes en CPC améliorée. Si vous essayez de définir la SCP manuelle pour tout autre type de campagne, la demande est ignorée sans erreur et la stratégie d’enchère est définie sur LA SCP améliorée. Depuis avril 2021, vous ne pouvez pas définir de stratégies d’enchères pour les groupes d’annonces ou les mots clés. Les stratégies d’enchère ne peuvent être définies qu’au niveau de la campagne. Si vous essayez de définir des stratégies d’enchère pour des groupes d’annonces ou des mots clés, la demande est ignorée sans erreur. Les groupes d’annonces et les mots clés héritent de la stratégie d’enchère de leur campagne.
Mettre à jour: Optionnel. Si aucune valeur n’est définie pour la mise à jour, ce paramètre n’est pas modifié.		 BiddingScheme
BidStrategyId Identificateur généré par le système de la BidStrategy que cette campagne partage avec d’autres campagnes dans le compte.

Si le champ est vide, la campagne n’utilise pas de stratégie d’offre de portefeuille. Si le champ n’est pas vide et que la valeur est supérieure à zéro, la campagne utilise une stratégie d’offre de portefeuille. Si la campagne utilise une stratégie d’offre de portefeuille et que vous préférez qu’elle utilise sa propre stratégie d’offre, définissez ce champ sur « 0 » (zéro).

Note: Les stratégies d’enchère de portefeuille ne sont pas prises en charge avec les campagnes d’achat intelligentes ou les campagnes de performances maximales.

Ajouter: Optionnel
Mettre à jour: Optionnel. Si aucune valeur n’est définie pour la mise à jour, ce paramètre n’est pas modifié.		 Long
BudgetId Identificateur Microsoft Advertising unique du budget que cette campagne partage avec d’autres campagnes dans le compte.

Si la valeur n’est pas null et supérieure à zéro, la campagne utilise un budget partagé. Si la valeur est null, la campagne n’utilise pas de budget partagé. Si la campagne utilise un budget partagé et que vous préférez qu’elle utilise son propre budget, par exemple le montant DailyBudget , définissez cet élément sur « 0 » (zéro) et définissez DailyBudget sur un montant budgétaire valide.

Note: Les budgets partagés ne sont pas pris en charge avec les campagnes d’achat intelligentes ou les campagnes Performance Max. Avec les campagnes d’achat intelligentes, vous devez définir le montant DailyBudget .

Ajouter: Optionnel
Mettre à jour: Optionnel. Si aucune valeur n’est définie pour la mise à jour, ce paramètre n’est pas modifié.		 Long
BudgetType Le type de budget détermine la façon dont le budget est dépensé.

Les valeurs possibles sont DailyBudgetAccelerated et DailyBudgetStandard. Le type de budget DailyBudgetAccelerated est uniquement disponible pour les campagnes d’audience qui utilisent des budgets non partagés au niveau de la campagne.

Dans le contexte des budgets partagés, le type de budget est une propriété en lecture seule qui est toujours retournée, que la campagne utilise ou non un budget partagé. Pour déterminer si la campagne utilise un budget partagé, case activée la valeur de l’élément BudgetId comme décrit ci-dessus.

Avec les campagnes d’expérience, vous ne pouvez pas définir le budget, le type de budget ou l’état. Le budget et les status d’une campagne d’expérience sont toujours hérités des paramètres de campagne de base.

Ajouter: Obligatoire si le BudgetId n’est pas défini. En lecture seule si la campagne utilise un budget partagé.
Mettre à jour: Facultatif si budgetId n’est pas défini. Si aucune valeur n’est définie pour la mise à jour, ce paramètre n’est pas modifié. Non autorisé si la campagne utilise un budget partagé. Si vous essayez de mettre à jour le type de budget d’une campagne dont le budget est partagé, le service retourne le code d’erreur CampaignServiceCannotUpdateSharedBudget .		 BudgetLimitType
CampaignType Le type de campagne détermine s’il s’agit d’une campagne d’audience, de publicité dynamique Recherche, de Recherche, de campagne Shopping, d’annonces d’hôtels ou de performances maximales.

Ajouter: Optionnel. Si elle n’est pas spécifiée, la valeur par défaut de Recherche est utilisée.
Mettre à jour: Non autorisé.		 CampaignType
DailyBudget Montant à dépenser quotidiennement pour la campagne.

Vous devez définir le montant du budget quotidien si BudgetId n’est pas défini.

Votre budget est une cible ; vos dépenses réelles peuvent être supérieures ou inférieures. Les variations sont provoquées par un certain nombre de facteurs, tels que différents volumes de trafic dans différents jours de la semaine, ou la détection automatique et le remboursement des clics de fraude qui peuvent redonner de l’argent à une campagne quelques heures après le clic. Microsoft Advertising anticipe et compense automatiquement les fluctuations, et conserve généralement un dépassement de 100 % au-dessus de votre limite quotidienne.

Notez également que Microsoft Advertising ne nécessite pas que votre budget de campagne soit supérieur au groupe d’annonces et mot clé enchères. En d’autres termes, les offres de groupe d’annonces et de mot clé sont validées indépendamment du budget de campagne.

Dans le contexte des budgets partagés, le montant du budget est une propriété en lecture seule qui est toujours retournée, que la campagne utilise ou non un budget partagé. Lorsqu’une campagne est associée à un budget partagé, le montant retourné est celui du budget partagé. Pour déterminer si la campagne utilise un budget partagé, case activée la valeur de l’élément BudgetId comme décrit ci-dessus.

Avec les campagnes d’expérience, vous ne pouvez pas définir le budget, le type de budget ou l’état. Le budget et les status d’une campagne d’expérience sont toujours hérités des paramètres de campagne de base.

Ajouter: Obligatoire si le BudgetId n’est pas défini. En lecture seule si la campagne utilise un budget partagé.
Mettre à jour: Facultatif si budgetId n’est pas défini. Si aucune valeur n’est définie pour la mise à jour, ce paramètre n’est pas modifié. Non autorisé si la campagne utilise un budget partagé. Si vous essayez de mettre à jour le montant du budget d’une campagne dont le budget est partagé, le service retourne le code d’erreur CampaignServiceCannotUpdateSharedBudget .		 Double
DealIds Liste des identificateurs système uniques correspondant aux transactions qui ont été ajoutées.

La liste des identificateurs correspond directement à la liste des transactions dans la demande. Les éléments de la liste peuvent être retournés comme null. Pour chaque index de liste où aucune transaction n’a été ajoutée, l’élément correspondant est null.		 tableau long
ExperimentId Identificateur généré par le système de l’expérience.

Cet élément est défini uniquement pour les campagnes d’expérience, c’est-à-dire les campagnes qui ont été créées pour les tests A/B basés sur une autre campagne Recherche.

Les campagnes de base ne contiennent pas d’ID d’expérience. De même, une fois qu’une expérience a été graduée à une campagne indépendante, cet élément sera vide, même si la campagne était auparavant une campagne d’expérimentation.

Avec les campagnes d’expérience, vous ne pouvez pas définir le budget, le type de budget ou l’état. Le budget et les status d’une campagne d’expérience sont toujours hérités des paramètres de campagne de base. Si vous souhaitez modifier le budget d’une expérience, vous devez modifier le budget de la campagne de base. La modification de la valeur sera ensuite fractionnée en fonction du paramètre TrafficSplitPercent de votre expérience.

Ajouter: En lecture seule
Mettre à jour: En lecture seule		 Long
FinalUrlSuffix Le suffixe d’URL final peut inclure des paramètres de suivi qui seront ajoutés à la fin de l’URL de votre page d’accueil. Nous vous recommandons de placer les paramètres de suivi requis par votre page d’accueil dans un suffixe d’URL final afin que vos clients soient toujours envoyés à votre page d’accueil. Pour plus d’informations et les règles de validation, consultez Suffixe d’URL final dans les guides techniques.

Ajouter: Optionnel
Mettre à jour: Optionnel. Si aucune valeur n’est définie pour la mise à jour, ce paramètre n’est pas modifié. Si vous définissez cet élément sur une chaîne vide («  »), le paramètre précédent est supprimé.		 chaîne
ForwardCompatibilityMap Liste des chaînes de clé et de valeur pour la compatibilité avant afin d’éviter les changements cassants lorsque de nouveaux éléments sont ajoutés dans la version actuelle de l’API.

Les modifications de compatibilité avant seront notées ici dans les versions ultérieures. Il n’existe actuellement aucune modification de compatibilité avant pour cet objet.		 Tableau KeyValuePairOfstringstring
GoalIds Réservé. tableau long
ID Identificateur Microsoft Advertising unique de la campagne.

Ajouter: En lecture seule
Mettre à jour: Obligatoire		 Long
Langues Votre paramètre de langue d’annonce détermine la langue que vous utiliserez lors de la rédaction de vos annonces et qui doit être la langue de vos clients.

IMPORTANT: Si les langues sont définies au niveau du groupe d’annonces et de la campagne, la langue au niveau du groupe d’annonces remplace la langue au niveau de la campagne.

Vous pouvez spécifier plusieurs langues individuellement dans la liste, ou inclure un seul élément de liste défini sur Tous si vous souhaitez cibler toutes les langues.

Les chaînes linguistiques prises en charge pour les campagnes Recherche et Shopping sont les suivantes : albanais, bulgare, croate, tchèque, danois, néerlandais, anglais, estonien, finnois, Français, allemand, grec, hongrois, italien, japonais, letton, lituanien, maltais, norvégien, polonais, portugais, roumain, slovaque, slovène, espagnol, suédois et traditionnelchinese.

NOTE: Les langues suivantes ne sont pas encore disponibles pour tout le monde : bulgare, croate, tchèque, estonien, grec, hongrois, japonais, letton, lituanien, maltais, polonais, roumain, slovaque, slovène.

Pour les campagnes d’audience, vous devez inclure toutes les langues, c’est-à-dire définir cet élément sur Tout.

Pour les campagnes Dynamic Recherche Ads, les paramètres de langue au niveau de la campagne et du groupe d’annonces sont ignorés au profit de la langue du domaine du site web. Vous devez définir les langues de campagne sur « Tout » et laisser la langue au niveau du groupe d’annonces vide.

Ajouter: Obligatoire pour les campagnes d’audience, sinon cet élément est facultatif. Si aucune langue de campagne n’est définie, la langue de chaque groupe d’annonces au sein de la campagne sera requise.
Mettre à jour: Optionnel. Si aucune valeur n’est définie pour la mise à jour, ce paramètre n’est pas modifié. Une fois les langues de campagne définies, vous ne pouvez pas les supprimer toutes. La liste des langues que vous spécifiez lors de la mise à jour remplace les paramètres précédents, c’est-à-dire ne s’ajoute pas à l’ensemble de langues existant.		 tableau de chaînes
MultimediaAdsBidAdjustment Réservé. int
Nom Nom de la campagne. Le nom doit être unique parmi toutes les campagnes actives ou suspendues au sein du compte. Le nom peut contenir un maximum de 128 caractères.

Le service effectue une comparaison qui ne respecte pas la casse lorsqu’il compare le nom aux noms de campagne existants.

Ajouter: Obligatoire
Mettre à jour: Optionnel. Si aucune valeur n’est définie pour la mise à jour, ce paramètre n’est pas modifié.		 chaîne
Paramètres Paramètres pris en charge qui varient selon le type de campagne.

Remarque : VerifiedTrackingSetting n’est pas disponible actuellement.

Vous pouvez inclure un maximum d’un objet par type de paramètre dans la liste des paramètres, par exemple, un Objet TargetSetting.

Si CampaignType est défini sur Recherche et si l’élément ExperimentId n’est pas défini, cette liste peut éventuellement inclure un objet DynamicSearchAdsSetting. Les campagnes d’expérimentation et les campagnes de base des expériences ne peuvent pas inclure de paramètres de recherche dynamique. Si vous envisagez d’utiliser cette campagne pour des expériences, n’incluez pas les paramètres d’annonces de recherche dynamique. Si une expérience existante est déjà basée sur cette campagne, vous ne pouvez pas mettre à jour la campagne pour inclure des paramètres d’annonces de recherche dynamique.

Si CampaignType est défini sur Shopping, cette liste doit inclure un objet ShoppingSetting .

Si CampaignType est défini sur Audience, cette liste peut inclure ou non un objet ShoppingSetting , selon que la campagne Audience prend ou non en charge les publicités de produit.

Si CampaignType est défini sur DynamicSearchAds, cette liste doit inclure un objet DynamicSearchAdsSetting .

Si CampaignType est défini sur Hôtel, cette liste doit inclure un objet HotelSetting .

Si CampaignType est défini sur PerformanceMax, cette liste doit inclure un objet PerformanceMaxSetting . Si la campagne Performance Max est associée à un magasin, elle prend également en charge un ShoppingSetting.

TargetSetting peut être utilisé avec n’importe quel type de campagne, à l’exception de Performace Max, et détermine si les critères d’audience associés à cette campagne utilisent l’option « cible et enchère » ou l’option cible « enchère uniquement ». Dans targetSetting , vous pouvez avoir un objet TargetSettingDetail , c’est-à-dire un par CriterionTypeGroup pris en charge. La seule valeur de type de critère actuellement prise en charge pour le paramètre cible au niveau de la campagne est « Audience ». L’objet TargetSetting n’est pas retourné par défaut. Pour obtenir cet objet, incluez la valeur TargetSetting dans l’élément ReturnAdditionalFields lorsque vous appelez les opérations de service GetCampaignsByAccountId et GetCampaignsByIds .

Ajouter: Obligatoire si CampaignType est défini sur DynamicSearchAds ou Shopping, sinon cet élément est facultatif. Si cet élément n’inclut pas d’objet TargetSetting , l’option d’enchère par défaut pour tous les groupes de types de critères est en fait « enchère uniquement ».
Mettre à jour: Optionnel. Si aucune valeur n’est définie pour la mise à jour, ce paramètre n’est pas modifié. Les objets DynamicSearchAdsSetting et ShoppingSetting ne peuvent pas être supprimés pendant la mise à jour.		 Définition d’un tableau
État Le status de la campagne.

Les valeurs possibles sont Active et Paused.

Le service suspend automatiquement la campagne si le budget est épuisé.

Avec les campagnes d’expérience, vous ne pouvez pas définir le budget, le type de budget ou l’état. Le budget et les status d’une campagne d’expérience sont toujours hérités des paramètres de campagne de base.

Ajouter: Optionnel. La valeur par défaut est Paused.
Mettre à jour: Optionnel. Si aucune valeur n’est définie pour la mise à jour, ce paramètre n’est pas modifié.		 CampaignStatus
SubType Sous-type de campagne.

Si le sous-type n’est pas défini, la campagne est créée en fonction du type de campagne.

Si le sous-type est défini sur AudienceVideoAds et que le type de campagne est Audience, la campagne est une campagne d’audience vidéo.

Si le sous-type est défini sur ShoppingSmartAds, la campagne est une campagne Microsoft Smart Shopping.

Si le sous-type est défini sur ShoppingSponsoredProductAd, la campagne est une campagne d’achat Microsoft pour les marques.

Ajouter: Facultatif et non applicable pour la plupart des types de campagnes. Pour les campagnes d’achat intelligentes Microsoft, vous devez définir le sous-type sur ShoppingSmartAds. Pour les campagnes d’achat Microsoft pour les marques , vous devez définir le sous-type sur ShoppingSponsoredProductAd.
Mettre à jour: En lecture seule		 chaîne
Timezone Cette colonne est déconseillée.

Fuseau horaire dans lequel la campagne s’exécute.

Le fuseau horaire est utilisé pour la création de rapports et l’application des dates de début et de fin d’un groupe d’annonces.

Pour connaître les valeurs possibles, consultez Fuseaux horaires.

Avec les campagnes d’expérience, vous ne pouvez pas définir le budget, le type de budget, l’état ou le fuseau horaire. Le budget, la status et le fuseau horaire d’une campagne d’expérience sont toujours hérités des paramètres de campagne de base.

Ajouter: Obligatoire
Mettre à jour: Optionnel. Si aucune valeur n’est définie pour la mise à jour, ce paramètre n’est pas modifié. Vous ne pouvez pas mettre à jour le fuseau horaire si la campagne contient ou a déjà contenu des groupes d’annonces dans l’état Actif ou Suspendu .		 chaîne
TrackingUrlTemplate Modèle de suivi à utiliser par défaut pour toutes les URL de votre campagne.

Les règles de validation suivantes s’appliquent aux modèles de suivi. Pour plus d’informations sur les modèles et paramètres pris en charge, consultez l’article d’aide Microsoft Advertising Quels paramètres de suivi ou d’URL puis-je utiliser ?
- Les modèles de suivi définis pour les entités de niveau inférieur, par exemple, les publicités remplacent celles définies pour les entités de niveau supérieur, par exemple la campagne. Pour plus d’informations, consultez Limites d’entité.
- La longueur du modèle de suivi est limitée à 2 048 caractères. La chaîne de protocole HTTP ou HTTPS compte pour la limite de 2 048 caractères.
- Le modèle de suivi doit être une URL bien formée commençant par l’une des suivantes : http://, https://, {lpurl} ou {unscapedlpurl}.
- Microsoft Advertising ne valide pas l’existence de paramètres personnalisés. Si vous utilisez des paramètres personnalisés dans votre modèle de suivi et qu’ils n’existent pas, l’URL de la page d’accueil inclut les espaces réservés de clé et de valeur de vos paramètres personnalisés sans substitution. Par exemple, si votre modèle de suivi est https://tracker.example.com/?season={_season}&promocode={_promocode}&u={lpurl} et que ni {_season} ni {_promocode} ne sont définis au niveau de la campagne, du groupe d’annonces, du critère, du mot clé ou de la publicité, l’URL de la page d’accueil sera la même.

Ajouter: Optionnel
Mettre à jour: Optionnel. Si aucune valeur n’est définie pour la mise à jour, ce paramètre n’est pas modifié. Si vous définissez cet élément sur une chaîne vide («  »), le paramètre précédent est supprimé.		 chaîne
UrlCustomParameters Votre collection personnalisée de paramètres de clé et de valeur pour le suivi des URL.

Microsoft Advertising accepte les 8 premiers objets CustomParameter que vous incluez dans l’objet CustomParameters , et si vous incluez plus de 8 paramètres personnalisés, une erreur est retournée. Chaque CustomParameter comprend des éléments Key et Value .

Ajouter: Optionnel
Mettre à jour: Optionnel. Si aucune valeur n’est définie pour la mise à jour, ce paramètre n’est pas modifié. Définissez l’élément UrlCustomParameters sur null ou vide pour conserver tous les paramètres personnalisés existants. Pour supprimer tous les paramètres personnalisés, définissez l’élément Parameters de l’objet CustomParameters sur null ou vide. Pour supprimer un sous-ensemble de paramètres personnalisés, spécifiez les paramètres personnalisés que vous souhaitez conserver dans l’élément Parameters de l’objet CustomParameters .		 CustomParameters

Conditions requises

Service : CampaignManagementService.svc v13
Noms: https://bingads.microsoft.com/CampaignManagement/v13

Utilisé par

AddCampaigns
GetCampaignsByAccountId
GetCampaignsByIds
UpdateCampaigns