Objet de données LocationCriterion - Gestion des campagnes

Article
11/13/2024

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

Avec les critères d’emplacement, vous pouvez choisir d’afficher des publicités à des clients potentiels dans, de rechercher ou d’afficher des pages sur :

Tous les pays/régions disponibles
Villes sélectionnées, codes postaux, zones de métro Zone de marché Microsoft dans le États-Unis), comtés, états/provinces et pays/régions

Chaque critère d’emplacement définit un code d’emplacement pour l’ajustement d’enchère du critère associé.

Le nombre maximal de critères d’emplacement et d’emplacement négatifs combinés que vous pouvez spécifier par campagne ou groupe d’annonces est de 10 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.

LocationCriterion peut être inclus dans les objets BiddableAdGroupCriterion, NegativeAdGroupCriterion, BiddableCampaignCriterion et NegativeCampaignCriterion. Si les critères d’emplacement au niveau du groupe d’annonces sont spécifiés (positifs ou négatifs), les critères d’emplacement au niveau de la campagne sont ignorés pour ce groupe d’annonces. En d’autres termes, les critères d’emplacement du groupe d’annonces remplacent les critères d’emplacement 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.

<xs:complexType name="LocationCriterion" xmlns:xs="http://www.w3.org/2001/XMLSchema">
  <xs:complexContent mixed="false">
    <xs:extension base="tns:Criterion">
      <xs:sequence>
        <xs:element minOccurs="0" name="DisplayName" nillable="true" type="xs:string" />
        <xs:element xmlns:q81="http://schemas.microsoft.com/2003/10/Serialization/Arrays" minOccurs="0" name="EnclosedLocationIds" nillable="true" type="q81:ArrayOflong" />
        <xs:element minOccurs="0" name="LocationId" nillable="true" type="xs:long" />
        <xs:element minOccurs="0" name="LocationType" nillable="true" type="xs:string" />
      </xs:sequence>
    </xs:extension>
  </xs:complexContent>
</xs:complexType>

{
  "Type": "LocationCriterion",
  "DisplayName": "ValueHere",
  "EnclosedLocationIds": [
    "LongValueHere"
  ],
  "LocationId": "LongValueHere",
  "LocationType": "ValueHere"
}

Éléments

L’objet LocationCriterion contient les éléments suivants : DisplayName, EnclosedLocationIds, LocationId, LocationType.

Élément	Description	Type de données
DisplayName	Nom complet de l’emplacement. Ajouter: En lecture seule Mettre à jour: En lecture seule	chaîne
EnclosedLocationIds	Réservé à une utilisation interne. Ajouter: En lecture seule Mettre à jour: En lecture seule	tableau long
LocationId	Identificateur Microsoft Advertising unique pour l’emplacement où vous souhaitez afficher vos annonces. Pour connaître les valeurs possibles, consultez le champ Id d’emplacement du fichier d’emplacements géographiques. Vous pouvez appeler l’opération GetGeoLocationsFileUrl pour télécharger le fichier. IMPORTANT: Veuillez case activée le champ État dans le fichier d’emplacements géographiques avant d’ajouter ou de mettre à jour un critère d’emplacement. Si le status est PendingDeprecation, le critère d’emplacement n’est plus utilisé pour le ciblage ou les exclusions. Les critères d’emplacement déconseillés peuvent toujours être récupérés, mais vous ne pouvez pas ajouter ou mettre à jour des critères d’emplacement déconseillés. Ajouter: Obligatoire Mettre à jour: Non autorisé. Si vous spécifiez cet élément, il doit correspondre au paramètre existant.	long
LocationType	Type d’emplacement. Les valeurs possibles incluent, sans s’y limiter, Ville, Pays, MetroArea, Voisinage, Code Postal et État. De nouveaux sous-types d’emplacement peuvent être ajoutés à tout moment. Le type d’emplacement change rarement pour un ID d’emplacement donné. Ajouter: En lecture seule Mettre à jour: En lecture seule	chaîne

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

Éléments hérités

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

L’objet LocationCriterion dérive de l’objet Criterion et hérite des éléments suivants : Type. Les descriptions ci-dessous sont spécifiques à LocationCriterion 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 Location lorsque vous récupérez un critère d’emplacement. 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
Namespace: https://bingads.microsoft.com/CampaignManagement/v13

Partager via