Objet de données RadiusCriterion - Gestion des campagnes

Article
12/21/2023

Définit un critère qui peut être utilisé pour afficher des publicités aux utilisateurs dans le rayon d’un emplacement géographique spécifique.

Avec les critères de rayon, vous pouvez choisir d’afficher des publicités aux clients potentiels dans, rechercher ou afficher des pages sur un rayon spécifié autour d’un code postal, des coordonnées, d’un point de repère ou d’une zone.

Chaque critère de rayon définit un rayon, une latitude et une longitude pour l’ajustement d’enchère du critère associé.

Le nombre maximal de critères de rayon que vous pouvez spécifier par campagne ou groupe d’annonces est de 2 000.

Remarque

Vous ne pouvez avoir qu’un seul LocationIntentCriterion par campagne ou groupe d’annonces pour déterminer l’option d’intention d’emplacement qui s’applique à tous les critères géographiques de la campagne ou du groupe d’annonces (emplacement, emplacement négatif et critères de rayon). Lorsque vous créez le premier critère de la campagne ou du groupe d’annonces, un LocationIntentCriterion est également ajouté automatiquement avec la valeur par défaut IntentOption définie sur PeopleInOrSearchingForOrViewingPages. Vous pouvez ajouter ou mettre à jour l’élément LocationIntentCriterion d’une campagne ou d’un groupe d’annonces, que la campagne ou le groupe d’annonces ait ou non d’autres critères. Vous ne pouvez pas supprimer un LocationIntentCriterion, bien qu’il n’ait aucun but sans critères d’emplacement ou de rayon.

Le critère RadiusCriterion peut être inclus dans les objets BiddableAdGroupCriterion et BiddableCampaignCriterion . Si des critères de rayon au niveau du groupe d’annonces sont spécifiés, les critères de rayon au niveau de la campagne sont ignorés pour ce groupe d’annonces. En d’autres termes, les critères de rayon de groupe d’annonces remplacent les critères de rayon de campagne et ne sont pas appliqués en tant qu’union.

Notez également que vous devez considérer les critères d’emplacement, d’emplacement négatif et de rayon comme un ensemble de critères géographiques. Si le groupe d’annonces a des critères géographiques, aucun des critères géographiques de la campagne n’est hérité. Si le groupe d’annonces n’a pas de critères géographiques, tous les critères géographiques de la campagne sont hérités. Les critères géographiques peuvent être hérités de la campagne même si le groupe d’annonces a un critère d’intention d’emplacement. Si les critères géographiques du groupe d’annonces sont utilisés, le critère d’intention d’emplacement du groupe d’annonces est utilisé ; si les critères géographiques de la campagne sont hérités, le critère d’intention d’emplacement de la campagne est utilisé et le critère d’intention d’emplacement du groupe d’annonces est ignoré. Vous ne pouvez pas supprimer le critère d’intention d’emplacement d’une campagne ou d’un groupe d’annonces, bien qu’il n’ait aucun but sans critères d’emplacement ou de rayon.

Syntaxe

<xs:complexType name="RadiusCriterion" xmlns:xs="http://www.w3.org/2001/XMLSchema">
  <xs:complexContent mixed="false">
    <xs:extension base="tns:Criterion">
      <xs:sequence>
        <xs:element minOccurs="0" name="LatitudeDegrees" nillable="true" type="xs:double" />
        <xs:element minOccurs="0" name="LongitudeDegrees" nillable="true" type="xs:double" />
        <xs:element minOccurs="0" name="Name" nillable="true" type="xs:string" />
        <xs:element minOccurs="0" name="Radius" nillable="true" type="xs:long" />
        <xs:element minOccurs="0" name="RadiusUnit" nillable="true" type="tns:DistanceUnit" />
      </xs:sequence>
    </xs:extension>
  </xs:complexContent>
</xs:complexType>

Éléments

L’objet RadiusCriterion contient les éléments suivants : LatitudeDegrees, LongitudeDegrees, Name, Radius, RadiusUnit.

Élément	Description	Type de données
LatitudeDegrees	Latitude, en degrés, de l’emplacement cible. La latitude doit être supérieure ou égale à -85,0 et inférieure ou égale à +85,0. Ajouter: Obligatoire Mettre à jour: Non autorisé. Si vous spécifiez cet élément, il doit correspondre au paramètre existant.	Double
LongitudeDegrees	Longitude, en degrés, de l’emplacement cible. La longitude doit être supérieure ou égale à -180,0 et inférieure ou égale à +180,0. Ajouter: Obligatoire Mettre à jour: Non autorisé. Si vous spécifiez cet élément, il doit correspondre au paramètre existant.	Double
Nom	Nom de l’emplacement géographique ciblé. Le nom peut contenir un maximum de 50 caractères. Ajouter: Optionnel Mettre à jour: En lecture seule	chaîne
Rayon	Rayon qui spécifie la zone entourant l’emplacement géographique à cibler. Si radiusUnit est défini sur Miles, les valeurs entières positives comprises entre 1 et 500 sont acceptées. Si RadiusUnit est défini sur Kilomètres, les valeurs entières positives comprises entre 1 et 800 sont acceptées. Le type de données est double et peut être pris en charge dans une version ultérieure. Actuellement, le service accepte et retourne uniquement des valeurs entières. Ajouter: Obligatoire Mettre à jour: Non autorisé. Si vous spécifiez cet élément, il doit correspondre au paramètre existant.	Long
RadiusUnit	Unité de mesure du rayon spécifié, par exemple des kilomètres ou des miles. Ajouter: Obligatoire Mettre à jour: Non autorisé. Si vous spécifiez cet élément, il doit correspondre au paramètre existant.	DistanceUnit

L’objet RadiusCriterion possède des éléments hérités.

Éléments hérités

Éléments hérités du critère

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

Élément	Description	Type de données
Type	Type du critère. Cette valeur est Radius lorsque vous récupérez un critère de rayon. Pour plus d’informations sur les types de critères, consultez les remarques sur les objets de données critères. Ajouter: En lecture seule Mettre à jour: En lecture seule	chaîne

Configuration requise

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

Share via