Objet de données BiddableAdGroupCriterion - Gestion des campagnes

Article
11/13/2024

Définit un critère biddable que vous souhaitez appliquer au groupe d’annonces spécifié.

Syntaxe

XML
JSON

<xs:complexType name="BiddableAdGroupCriterion" xmlns:xs="http://www.w3.org/2001/XMLSchema">
  <xs:complexContent mixed="false">
    <xs:extension base="tns:AdGroupCriterion">
      <xs:sequence>
        <xs:element minOccurs="0" name="CriterionBid" nillable="true" type="tns:CriterionBid" />
        <xs:element minOccurs="0" name="DestinationUrl" nillable="true" type="xs:string" />
        <xs:element minOccurs="0" name="EditorialStatus" nillable="true" type="tns:AdGroupCriterionEditorialStatus" />
        <xs:element minOccurs="0" name="FinalAppUrls" nillable="true" type="tns:ArrayOfAppUrl" />
        <xs:element xmlns:q82="http://schemas.microsoft.com/2003/10/Serialization/Arrays" minOccurs="0" name="FinalMobileUrls" nillable="true" type="q82:ArrayOfstring" />
        <xs:element minOccurs="0" name="FinalUrlSuffix" nillable="true" type="xs:string" />
        <xs:element xmlns:q83="http://schemas.microsoft.com/2003/10/Serialization/Arrays" minOccurs="0" name="FinalUrls" nillable="true" type="q83:ArrayOfstring" />
        <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="CriterionCashback" nillable="true" type="tns:CriterionCashback">
          <xs:annotation>
            <xs:appinfo>
              <DefaultValue EmitDefaultValue="false" xmlns="http://schemas.microsoft.com/2003/10/Serialization/" />
            </xs:appinfo>
          </xs:annotation>
        </xs:element>
      </xs:sequence>
    </xs:extension>
  </xs:complexContent>
</xs:complexType>

{
  "AdGroupId": "LongValueHere",
  "Criterion": {
    "Type": "AgeCriterion",
    "AgeRange": "ValueHere"
  },
  "Id": "LongValueHere",
  "Status": "ValueHere",
  "Type": "BiddableAdGroupCriterion",
  "CriterionBid": {
    "Type": "BidMultiplier",
    "Multiplier": DoubleValueHere
  },
  "CriterionCashback": {
    "Type": "CashbackAdjustment",
    "CashbackPercent": DoubleValueHere
  },
  "DestinationUrl": "ValueHere",
  "EditorialStatus": "ValueHere",
  "FinalAppUrls": [
    {
      "OsType": "ValueHere",
      "Url": "ValueHere"
    }
  ],
  "FinalMobileUrls": [
    "ValueHere"
  ],
  "FinalUrls": [
    "ValueHere"
  ],
  "FinalUrlSuffix": "ValueHere",
  "TrackingUrlTemplate": "ValueHere",
  "UrlCustomParameters": {
    "Parameters": [
      {
        "Key": "ValueHere",
        "Value": "ValueHere"
      }
    ]
  }
}

Éléments

L’objet BiddableAdGroupCriterion contient les éléments suivants : CriterionBid, CriterionClientback, DestinationUrl, EditorialStatus, FinalAppUrls, FinalMobileUrls, FinalUrls, FinalUrlSuffix, TrackingUrlTemplate, UrlCustomParameters.

Élément	Description	Type de données
CriterionBid	Offre à utiliser dans la vente aux enchères. Si le critère hérité est un critère de page web , vous devez utiliser un FixedBid. Si le critère hérité est un ProductPartition, vous devez utiliser un FixedBid , sauf si l’option BidOption des produits sponsorisés est définie sur BidBoost (pour plus d’informations, voir Utilisation de ProductPartition ci-dessous). Pour tous les autres critères de groupe d’annonces biddables, utilisez le BidMultiplier. Si vous n’utilisez pas le type d’objet correct, l’enchère demandée est ignorée : si l’enchère est requise, l’opération échoue ; Si l’enchère est facultative, l’enchère par défaut est utilisée. Ajouter: Les exigences varient en fonction du type de critère hérité. L’enchère est facultative et la valeur par défaut est 0 si elle n’est pas incluse pour les critères AgeCriterion, DayTimeCriterion, DeviceCriterion, GenderCriterion, LocationCriterion, ProfileCriterion, RadiusCriterion, AudienceCriterion et Page web . L’enchère n’est pas applicable à LocationIntentCriterion (le service ne retournera aucune erreur et l’enchère sera ignorée même si vous l’incluez). Lorsque vous ajoutez un ProductPartition avec l’opération ApplyProductPartitionActions , l’enchère est requise, sauf si le type de partition de produit est Subdivision, auquel cas l’enchère n’est pas autorisée. Mettre à jour: Les exigences varient en fonction du type de critère hérité. L’enchère est requise pour AgeCriterion, DayTimeCriterion, DeviceCriterion, GenderCriterion, LocationCriterion, ProfileCriterion et RadiusCriterion. L’enchère n’est pas applicable à LocationIntentCriterion (le service ne retournera aucune erreur et l’enchère sera ignorée même si vous l’incluez). Pour les critères AudienceCriterion et Page web , l’enchère est facultative, et si aucune valeur n’est définie pour la mise à jour, ce paramètre n’est pas modifié. Lorsque vous mettez à jour un ProductPartition avec l’opération ApplyProductPartitionActions , l’enchère est facultative et si aucune valeur n’est définie pour la mise à jour, ce paramètre n’est pas modifié.	CriterionBid
Criterion Cashback	Définit l’objet de données Criterion Cashback.	Criterion Cashback
DestinationUrl	URL de la page web vers laquelle l’utilisateur est redirigé lorsqu’il clique sur la publicité. Cet élément est utilisé uniquement si le critère hérité est un critère ProductPartition . Pour plus d’informations, consultez Utilisation de ProductPartition ci-dessous.	chaîne
EditorialStatus	Pour une utilisation ultérieure.	AdGroupCriterionEditorialStatus
FinalAppUrls	Pour une utilisation ultérieure.	Tableau AppUrl
FinalMobileUrls	Pour une utilisation ultérieure.	tableau de chaînes
FinalUrls	Pour une utilisation ultérieure.	tableau de chaînes
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. Cet élément est utilisé uniquement si le critère hérité est un critère ProductPartition ou Page web . Pour plus d’informations, consultez Utilisation de ProductPartition et Utilisation de la page web ci-dessous.	chaîne
TrackingUrlTemplate	Les modèles de suivi vous permettent de spécifier des paramètres de suivi d’URL qui sont utilisés en tandem avec votre URL finale ou votre page d’accueil. Nous vous recommandons d’ajouter le modèle de suivi au niveau du compte, puis il sera appliqué à toutes les URL pour les entités de niveau inférieur, telles que les campagnes, les groupes d’annonces et les publicités. Pour en savoir plus, consultez les articles d’aide de Microsoft Advertising Suivi des URL avec des URL mises à niveau. Cet élément est utilisé uniquement si le critère hérité est un critère ProductPartition ou Page web . Pour plus d’informations, consultez Utilisation de ProductPartition et Utilisation de la page web ci-dessous.	chaîne
UrlCustomParameters	Votre collection personnalisée de paramètres de clé et de valeur pour le suivi des URL. Cet élément est utilisé uniquement si le critère hérité est un critère ProductPartition ou Page web . Pour plus d’informations, consultez Utilisation de ProductPartition et Utilisation de la page web ci-dessous.	CustomParameters

L’objet BiddableAdGroupCriterion a des éléments hérités.

Éléments hérités

Éléments hérités d’AdGroupCriterion

L’objet BiddableAdGroupCriterion dérive de l’objet AdGroupCriterion et hérite des éléments suivants : AdGroupId, Criterion, Id, Status, Type. Les descriptions ci-dessous sont spécifiques à BiddableAdGroupCriterion et peuvent ne pas s’appliquer à d’autres objets qui héritent des mêmes éléments de l’objet AdGroupCriterion .

Élément	Description	Type de données
AdGroupId	Identificateur du groupe d’annonces auquel appliquer le critère. Ajouter: Obligatoire Mettre à jour: Obligatoire	long
Critère	Critère à appliquer au groupe d’annonces. Le critère permet de déterminer si les publicités du groupe d’annonces sont servies. Pour obtenir la liste des types de critères disponibles, consultez AdGroupCriterionType. Ajouter: Optionnel Mettre à jour: Optionnel. Si aucune valeur n’est définie pour la mise à jour, ce paramètre n’est pas modifié.	Critère
Id	Identificateur Microsoft Advertising unique pour le critère de groupe d’annonces. Ajouter: En lecture seule Mettre à jour: Obligatoire	long
Statut	Valeur status qui détermine si le critère s’applique au groupe d’annonces. Pour la plupart des critères de groupe d’annonces biddables, la seule valeur status prise en charge est Active. Pour les exceptions, consultez Utilisation de la page web ci-dessous. Ajouter: En lecture seule Mettre à jour: En lecture seule	AdGroupCriterionStatus
Type	Type du critère de groupe d’annonces. Cette valeur est BiddableAdGroupCriterion lorsque vous récupérez un critère de groupe d’annonces biddable. Pour plus d’informations sur les types de critères de groupe d’annonces, consultez les Remarques sur l’objet de données AdGroupCriterion. Ajouter: En lecture seule Mettre à jour: En lecture seule	chaîne

Remarques

Utilisation de ProductPartition

Si le critère hérité est un critère ProductPartition , notez l’utilisation suivante des propriétés BiddableAdGroupCriterion .

CriterionBid

Par défaut, la mise aux enchères utilise un FixedBid pour les groupes de produits. Vous devez utiliser un FixedBid , sauf si l’option BidOption des produits sponsorisés est définie sur BidBoost. si l’option BidOption des produits sponsorisés est définie sur BidBoost, le BidMultiplier représente le pourcentage (supérieur à zéro) utilisé pour amplifier l’offre de votre partenaire.

Par exemple, supposons que votre partenaire offre 5 USD dans son groupe de produits (FixedBid via CriterionBid). Si l’ajustement de votre offre (BidMultiplier via CriterionBid) est défini sur 20 (pour cent) et que la valeur BidMaxValue de votre groupe d’annonces est de 0,50 (50 centimes), votre part sera de 50 cents et non de 1 USD.

DestinationUrl

Si vous utilisez actuellement des URL de destination, vous devez les remplacer par des modèles de suivi. Pour plus d’informations, consultez Suivi des URL avec des URL mises à niveau.

L’URL peut contenir des paramètres dynamiques tels que {MatchType}. Pour obtenir la liste des paramètres pris en charge, consultez l’article d’aide microsoft Advertising Quels paramètres de suivi ou d’URL puis-je utiliser ?.

L’URL peut contenir un maximum de 1 024 caractères. Si l’URL ne spécifie pas de protocole, le système utilise le protocole HTTP lorsqu’un utilisateur clique sur la publicité. Si l’URL spécifie le protocole HTTP lorsque vous ajoutez une publicité, le service supprime la chaîne de protocole http:// (la chaîne de protocole HTTP ne compte pas dans la limite de 1 024 caractères) ; Toutefois, le service ne supprime pas de chaîne de protocole HTTPS (https://) de l’URL.

L’URL de destination est utilisée si elle est spécifiée ; sinon, l’URL de destination est déterminée par la valeur correspondante du lien que vous avez spécifié pour l’offre de produit dans votre catalogue Microsoft Merchant Center.

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

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.

TrackingUrlTemplate

Les modèles de suivi peuvent être utilisés en tandem avec l’URL spécifiée dans le champ « Lien » pour l’offre de produit que vous avez soumise via l’API de contenu. En combinant l’URL du flux avec le modèle de suivi, l’URL de la page d’accueil est assemblée à l’endroit où un utilisateur est dirigé après avoir cliqué sur la publicité. Lorsque vous utilisez l’élément TrackingUrlTemplate pour mettre à jour les paramètres d’URL au lieu de les mettre à jour dans l’URL du flux, l’URL du flux n’a pas besoin de passer par une révision éditoriale et vos publicités continueront à être diffusées sans interruption. Par exemple, si l’URL de votre offre de produit dans le flux de catalogue est https://contoso.com/, vous pouvez spécifier le modèle de suivi suivant : {lpurl} ?matchtype={matchtype}&device={device}.

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 ceux définis 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 vérifie pas s’il existe des 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} n’est défini 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.

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 .

Utilisation de la page web

Si le critère hérité est un critère de page web , notez l’utilisation suivante des propriétés BiddableAdGroupCriterion .

FinalUrlSuffix

Statut

Valeur status qui détermine si le critère s’applique au groupe d’annonces.

Vous pouvez définir le status sur Actif ou Suspendu. Vous ne pouvez pas définir le status sur Supprimé.

Ajouter: Optionnel.
Mettre à jour: Optionnel. Si aucune valeur n’est définie pour la mise à jour, ce paramètre n’est pas modifié.

TrackingUrlTemplate

Pour le critère de page web , les modèles de suivi peuvent être utilisés en tandem avec l’URL de la page d’accueil générée dynamiquement à partir du domaine que vous avez spécifié pour votre campagne d’annonces de recherche dynamique. En combinant le domaine avec le modèle de suivi, l’URL de la page d’accueil est assemblée à l’endroit où un utilisateur est dirigé après avoir cliqué sur la publicité. Voici un exemple de modèle de suivi : {lpurl} ?matchtype={matchtype}&device={device}.

Les modèles de suivi définis pour les entités de niveau inférieur, par exemple, les publicités remplacent ceux définis 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 vérifie pas s’il existe des 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} n’est défini 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.

UrlCustomParameters

Votre collection personnalisée de paramètres de clé et de valeur pour le suivi des URL.

Configuration requise

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

Partager via

Objet de données BiddableAdGroupCriterion - Gestion des campagnes

Syntaxe

Éléments

Éléments hérités

Éléments hérités d’AdGroupCriterion

Remarques

Utilisation de ProductPartition

CriterionBid

DestinationUrl

FinalUrlSuffix

TrackingUrlTemplate

UrlCustomParameters

Utilisation de la page web

FinalUrlSuffix

Statut

TrackingUrlTemplate

UrlCustomParameters

Configuration requise

Commentaires

Ressources supplémentaires