Partager via

Objet de données AdGroup - Gestion des campagnes

  • Article

Définit un groupe d’annonces dans une campagne publicitaire.

Remarque

Depuis juillet 2024, vous ne pouvez plus définir le réseau de recherche où vous souhaitez que vos annonces s’affichent sur SyndicatedSearchOnly. Si vous essayez de le définir sur SyndicatedSearchOnly, l’erreur CampaignServiceInvalidNetwork est retournée.

<xs:complexType name="AdGroup" xmlns:xs="http://www.w3.org/2001/XMLSchema">
  <xs:sequence>
    <xs:element minOccurs="0" name="AdRotation" nillable="true" type="tns:AdRotation" />
    <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="CommissionRate" nillable="true" type="tns:RateBid">
      <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="CpcBid" nillable="true" type="tns:Bid" />
    <xs:element minOccurs="0" name="EndDate" nillable="true" type="tns:Date" />
    <xs:element minOccurs="0" name="FinalUrlSuffix" nillable="true" type="xs:string" />
    <xs:element xmlns:q21="http://schemas.datacontract.org/2004/07/System.Collections.Generic" minOccurs="0" name="ForwardCompatibilityMap" nillable="true" type="q21:ArrayOfKeyValuePairOfstringstring" />
    <xs:element minOccurs="0" name="FrequencyCapSettings" nillable="true" type="tns:ArrayOfFrequencyCapSettings">
      <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="Language" nillable="true" type="xs:string" />
    <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="Network" nillable="true" type="tns:Network" />
    <xs:element minOccurs="0" name="PercentCpcBid" nillable="true" type="tns:RateBid">
      <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="PrivacyStatus" nillable="true" type="tns:AdGroupPrivacyStatus" />
    <xs:element minOccurs="0" name="Settings" nillable="true" type="tns:ArrayOfSetting" />
    <xs:element minOccurs="0" name="StartDate" nillable="true" type="tns:Date" />
    <xs:element minOccurs="0" name="Status" nillable="true" type="tns:AdGroupStatus" />
    <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="UseOptimizedTargeting" 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="UsePredictiveTargeting" 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="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="AdGroupType" nillable="true" type="xs:string">
      <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="CpvBid" nillable="true" type="tns:Bid">
      <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="CpmBid" nillable="true" type="tns:Bid">
      <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="McpaBid" nillable="true" type="tns:Bid">
      <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 AdGroup a les éléments suivants : AdGroupType, AdRotation, AdScheduleUseSearcherTimeZone, AudienceAdsBidAdjustment, BiddingScheme, CommissionRate, CpcBid, CpmBid, CpvBid, EndDate, FinalUrlSuffix, ForwardCompatibilityMap, FrequencyCapSettings, Id, Language, McpaBid, MultimediaAdsBidAdjustment, Name, Network, PercentCpcBid, PrivacyStatus, Settings, StartDate, Status, TrackingUrlTemplate, UrlCustomParameters, UseOptimizedTargeting, UsePredictiveTargeting.

Élément Description Type de données
AdGroupType Type de groupe d’annonces.

Dans une campagne mixte où CampaignType est « Search », l’ExperimentId n’est pas défini et les Paramètres ont déjà un DynamicSearchAdsSetting valide, les valeurs possibles sont « SearchDynamic » et « SearchStandard ». Sinon, le type de groupes d’annonces dans les campagnes « Recherche » ne peut être défini que sur « SearchStandard ». Si le type de groupe d’annonces est « SearchDynamic », vous pouvez uniquement ajouter des annonces de recherche dynamique dans ce groupe d’annonces. Si le type de groupe d’annonces est « SearchStandard », vous pouvez ajouter des annonces textuelles développées ou des annonces de recherche réactives dans ce groupe d’annonces.

Le type de groupes d’annonces dans les campagnes « DynamicSearchAds » peut uniquement être défini sur « SearchDynamic ». Vous n’avez pas besoin de définir le type de groupe d’annonces pour les campagnes « DynamicSearchAds », mais notez que lorsque vous récupérez des groupes d’annonces, cet élément est défini sur « SearchDynamic ».

Ce champ peut être défini sur HotelAds pour les types de campagne « Hôtel » ou « Rechercher ».

Cet élément ne peut pas être défini pour les types de campagnes « Audience » ou « Shopping ». Lorsque vous récupérez un groupe d’annonces dans des campagnes non prises en charge, cet élément n’est pas défini.

Ajouter: Optionnel. La valeur par défaut des campagnes « Search » est « SearchStandard ». La valeur par défaut des campagnes « DynamicSearchAds » est « SearchDynamic ».
Mettre à jour: En lecture seule. Vous ne pouvez pas mettre à jour le type de groupe d’annonces.		 chaîne
AdRotation La rotation des annonces définit la fréquence à laquelle Microsoft Advertising sélectionne les annonces à diffuser, si vous avez plusieurs annonces au sein d’un groupe d’annonces. Étant donné qu’une seule annonce de votre compte ne peut s’afficher à la fois, la rotation des publicités hiérarchise les annonces qui semblent statistiquement plus susceptibles d’être plus performantes.

Remarque : La rotation des annonces publicitaires ne s’applique pas aux annonces de produit.

Les valeurs possibles pour le type de rotation des annonces sont OptimizeForClicks et RotateAdsEvenly.

S’il est défini sur OptimizeForClicks, Microsoft Advertising hiérarchise la publicité du groupe d’annonces qui semble avoir les meilleures chances de s’exécuter correctement, en fonction de caractéristiques ou de facteurs de vente aux enchères, tels que la mot clé, le terme de recherche, l’appareil ou l’emplacement. Les annonces plus performantes s’afficheront plus fréquemment, et d’autres seront servies moins souvent, voire du tout.

S’il est défini sur RotateAdsEvenly, Microsoft Advertising offre un meilleur équilibre dans la rotation entre vos publicités. Autrement dit, les publicités d’un groupe d’annonces particulier ont une chance similaire d’être affichées en réponse à la requête d’un utilisateur de recherche. Les annonces sont classées par ordre de priorité plus faible si elles ont une qualité publicitaire inférieure, et peuvent donc s’afficher moins souvent, ou pas du tout.
- Le paramètre RotateAdsEvenly peut permettre aux publicités moins performantes de s’afficher aussi souvent que les publicités plus performantes. Cela peut avoir un impact sur les performances du groupe d’annonces.
- Le paramètre RotateAdsEvenly sera ignoré si vous utilisez une stratégie d’enchère automatisée, c’est-à-dire MaxClicks, MaxConversions, TargetCpa ou TargetRoas, car ces stratégies d’enchère donnent la priorité aux publicités plus performantes.

Ajouter: Optionnel. La valeur par défaut est OptimizeForClicks.
Mettre à jour: Optionnel. Si aucune valeur n’est définie pour la mise à jour, ce paramètre n’est pas modifié.		 AdRotation
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 GetAdGroupsByCampaignId et GetAdGroupsByIds .

Ajouter: Optionnel. Si vous ne spécifiez pas cet élément ou laissez-le vide, la valeur par défaut true est définie et le fuseau horaire de l’utilisateur de recherche est utilisé. Après le 30 septembre 2020, si vous ne spécifiez pas ce champ 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 de 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êche l’affichage des publicités d’audience pour ce groupe d’annonces.

Définissez cet élément sur zéro (0) si vous ne souhaitez pas d’ajustement des enchères pour les publicités d’audience. Si cet élément a la valeur Null, vous héritez du paramètre AudienceAdsBidAdjustment de la campagne du groupe d’annonces.

Ajouter: Optionnel
Mettre à jour: Optionnel. Cette propriété n’est mise à jour que si vous définissez également l’élément UpdateAudienceAdsBidAdjustment sur true, sinon cette propriété sera ignorée. Si le groupe d’annonces a déjà un ajustement d’enchère natif et que vous souhaitez le supprimer pour hériter efficacement du paramètre AudienceAdsBidAdjustment de la campagne du groupe d’annonces, définissez cet élément sur null.		 int
BiddingScheme Type de stratégie d’enchère pour la façon dont vous souhaitez gérer vos enchères.

NOTE: 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. 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.

Ajouter: Optionnel. Si vous ne définissez pas cet élément, InheritFromParentBiddingScheme est utilisé par défaut.
Mettre à jour: Optionnel. Si aucune valeur n’est définie pour la mise à jour, ce paramètre n’est pas modifié.		 BiddingScheme
Taux de commission Le taux de commission facturé à l’annonceur lorsque quelqu’un réserve un hôtel et y séjourne. RateBid
CpcBid Enchère par défaut à utiliser lorsque la requête de l’utilisateur et les mots clés du groupe d’annonces correspondent à l’aide d’une comparaison de correspondances large, exacte ou d’expression.

La plage d’enchères minimale et maximale dépend de la devise du compte. Pour plus d’informations, consultez Devises.

La spécification d’une enchère de correspondance large, exacte ou d’expression au niveau mot clé remplace la valeur d’enchère Cpc du groupe d’annonces pour le type de correspondance correspondant.

Ajouter: Optionnel. Si vous ne définissez pas d’enchère, elle sera définie sur le minimum en fonction de la devise de votre compte.
Mettre à jour: Optionnel. Si aucune valeur n’est définie pour la mise à jour, ce paramètre n’est pas modifié.		 Offre
CpmBid Type de stratégie d’enchère CPM manuelle. Avec la stratégie d’enchère ManualCpm (coût manuel par milliers), vous définissez le montant le plus élevé que vous souhaitez payer par millier d’impressions, et Microsoft Advertising utilise ces enchères à chaque fois.

Cet élément n’est pas retourné par défaut. Pour obtenir cet élément, incluez la valeur CpmBid dans l’élément ReturnAdditionalFields lorsque vous appelez les opérations de service GetAdGroupsByCampaignId et GetAdGroupsByIds .		 Offre
CpvBid Type de stratégie d’enchère CPV manuelle. Avec la stratégie d’enchère ManualCpv (coût manuel par affichage), vous définissez le montant le plus élevé que vous souhaitez payer par affichage ou par clic sur une publicité vidéo, et Microsoft Advertising utilise ces enchères à chaque fois.

Cet élément n’est pas retourné par défaut. Pour obtenir cet élément, incluez la valeur Cpv dans l’élément ReturnAdditionalFields lorsque vous appelez les opérations de service GetAdGroupsByCampaignId et GetAdGroupsByIds .		 Offre
EndDate Date d’expiration des annonces dans le groupe d’annonces.

Si vous ne spécifiez pas de date de fin, les annonces n’expirent pas. La date de fin peut être prolongée pour rendre les annonces d’un groupe d’annonces éligibles à la remise, même après l’expiration du groupe d’annonces.

La date de fin est incluse. Par exemple, si vous définissez EndDate sur 31/12/2020, les annonces du groupe d’annonces expireront à 23h59 le 31/12/2020. L’heure est basée sur le fuseau horaire que vous spécifiez au niveau de la campagne.

Ajouter: Optionnel. Pour ne définir aucune date de fin lors de l’ajout d’un groupe d’annonces, définissez cet élément sur null.
Mettre à jour: Optionnel. Si aucune valeur n’est définie pour la mise à jour, ce paramètre n’est pas modifié. Pour supprimer le paramètre de date de fin existant et ne définir aucune date de fin lors de la mise à jour d’un groupe d’annonces, définissez la date de fin égale ou ultérieure au 2 janvier 2050. Lorsque vous récupérez le groupe d’annonces la prochaine fois, cet élément sera nul, c’est-à-dire qu’il ne sera pas défini sur le 2 janvier 2050.		 Date
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
FrequencyCapSettings Paramètres de la limite de fréquence. Tableau FrequencyCapSettings
ID Identificateur généré par le système du groupe d’annonces.

Ajouter: Non autorisé.
Mettre à jour: Lecture seule et Obligatoire		 long
Langue 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.

Les chaînes linguistiques prises en charge pour les campagnes de recherche et d’achat sont les suivantes : bulgare, croate, tchèque, danois, néerlandais, anglais, estonien, finnois, français, allemand, grec, hongrois, italien, 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, letton, lituanien, maltais, polonais, roumain, slovaque, slovène.

Pour les campagnes d’annonces de recherche dynamique, 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.

Pour les groupes d’annonces dans les campagnes d’audience, la langue au niveau du groupe d’annonces n’est pas prise en charge et vous devez définir l’élément Languages de la campagne du groupe d’annonces sur « All ».

Ajouter: Facultatif si la campagne a une ou plusieurs langues définies, sinon la langue est requise pour la plupart des types de campagne. Vous n’êtes pas autorisé à définir cet élément pour les groupes d’annonces dans les campagnes d’audience.
Mettre à jour: Optionnel. Si aucune valeur n’est définie pour la mise à jour, ce paramètre n’est pas modifié. Pour supprimer la langue et vous reporter aux langues au niveau de la campagne, définissez cet élément sur une valeur de chaîne vide («  »).		 chaîne
McpaBid Type de stratégie d’enchère CPA manuelle. Avec la stratégie d’enchère ManualCpa (coût manuel par action), vous définissez votre action big par annonceur spécifiée. Offre
MultimediaAdsBidAdjustment Pourcentage par lequel ajuster votre enchère pour les annonces multimédias au-dessus ou en dessous du groupe d’annonces de base ou mot clé enchère. int
Nom Nom du groupe d’annonces.

Le nom doit être unique parmi tous les groupes d’annonces actifs au sein de la campagne. Le nom peut contenir un maximum de 256 caractères.

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
Réseau Réseaux de recherche dans lesquels vous souhaitez que vos annonces s’affichent.

Les valeurs réseau prises en charge pour les groupes d’annonces dans la plupart des types de campagne sont OwnedAndOperatedAndSyndicatedSearch et OwnedAndOperatedOnly.

Pour les groupes d’annonces dans les campagnes d’audience, le réseau au niveau du groupe d’annonces n’est pas pris en charge. Les groupes d’annonces se trouvent dans le réseau d’audience Microsoft.

Pour les groupes d’annonces dans les campagnes d’achat intelligent, vous ne pouvez pas définir le réseau. Le service définit le réseau sur OwnedAndOperatedAndSyndicatedSearch.

Pour les groupes de publicités dans les campagnes d’achat pour les marques, le réseau InHousePromotion (Réseau de détaillants uniquement) est pris en charge en plus de OwnedAndOperatedAndSyndicatedSearch et OwnedAndOperatedOnly.

Si vous sélectionnez l’une des options de recherche syndiquée, vous pouvez appeler l’opération SetNegativeSitesToAdGroups ou SetNegativeSitesToCampaigns pour empêcher l’affichage des annonces sur des sites web de recherche syndiqués spécifiques.

Pour plus d’informations sur les réseaux et la distribution d’annonces, consultez l’article d’aide À propos de la distribution d’annonces .

Ajouter: Optionnel. La valeur par défaut est OwnedAndOperatedAndSyndicatedSearch.
Mettre à jour: Optionnel. Si aucune valeur n’est définie pour la mise à jour, ce paramètre n’est pas modifié.		 Réseau
PercentCpcBid Le type de stratégie d’offre de pourcentage AUCP (prix total de l’hôtel par nuit, taxes et frais inclus). RateBid
PrivacyStatus Indique si les critères cibles de votre groupe d’annonces, par exemple ProfileCriterion , sont trop étroits pour les groupes d’annonces dans les campagnes d’audience.

Ajouter: En lecture seule
Mettre à jour: En lecture seule		 AdGroupPrivacyStatus
Paramètres Les paramètres de groupe d’annonces qui varient généralement selon le type de campagne.

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

TargetSetting peut être utilisé avec n’importe quel type de campagne et détermine si les critères Age, Audience, CompanyName, Gender, Industry et JobFunction associés à ce groupe d’annonces utilisent l’option « cible et enchère » ou l’option cible « enchère uniquement ». Dans targetSetting , vous pouvez avoir plusieurs objets TargetSettingDetail , c’est-à-dire un par CriterionTypeGroup.

Ajouter: Optionnel. 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é.		 Définition d’un tableau
StartDate Date à laquelle les annonces du groupe d’annonces peuvent commencer à être diffusées ; sinon, le service peut commencer à diffuser les annonces dans le groupe d’annonces le jour où le groupe d’annonces devient actif.

La date de début est incluse. Par exemple, si vous définissez la date de début sur 5/5/2021, les annonces dans le groupe d’annonces commenceront à 12h00 le 5/5/2021. L’heure est basée sur le fuseau horaire que vous spécifiez au niveau de la campagne.

Ajouter: Optionnel. Si vous ne définissez pas la date de début, la valeur par défaut est la date du jour et le service peut commencer à diffuser les annonces dans le groupe d’annonces dès que le groupe d’annonces status est actif.
Mettre à jour: Optionnel. Si aucune valeur n’est définie pour la mise à jour, ce paramètre n’est pas modifié. La date de début ne peut pas être mise à jour après l’envoi du groupe d’annonces, c’est-à-dire une fois la date de début arrivée.		 Date
Statut Status du groupe d’annonces.

Les valeurs possibles sont Actif, Expiré et Suspendu. Le status Expiré est en lecture seule.

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é.		 AdGroupStatus
TrackingUrlTemplate Modèle de suivi à utiliser par défaut pour toutes les URL de votre groupe d’annonces.

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
UseOptimizedTargeting Cela sera déconseillé. Utilisez UsePredictiveTargeting à la place. boolean
UsePredictiveTargeting Indique si le ciblage prédictif est activé pour un AdGroup.

Remarque : UsePredictiveTargeting est disponible uniquement pour les campagnes d’audience.

Ajouter: Optionnel
Mettre à jour: Optionnel.		 boolean

Configuration requise

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

Utilisé par

AddAdGroups
GetAdGroupsByCampaignId
GetAdGroupsByIds
UpdateAdGroups