Objet de données LocationAdExtension - Gestion des campagnes

Article
11/14/2024

Définit une extension d’annonce qui spécifie une adresse professionnelle et un numéro de téléphone à inclure dans une annonce texte.

Vous pouvez associer une extension d’annonce d’emplacement au compte ou à des campagnes dans le compte. Chaque entité (compte ou campagne) peut être associée à autant d’extensions d’annonce d’emplacement que vous le souhaitez, jusqu’au nombre total d’extensions d’annonces d’emplacement dans votre compte.

<xs:complexType name="LocationAdExtension" xmlns:xs="http://www.w3.org/2001/XMLSchema">
  <xs:complexContent mixed="false">
    <xs:extension base="tns:AdExtension">
      <xs:sequence>
        <xs:element minOccurs="0" name="Address" nillable="true" type="tns:Address" />
        <xs:element minOccurs="0" name="CompanyName" nillable="true" type="xs:string" />
        <xs:element minOccurs="0" name="GeoCodeStatus" nillable="true" type="tns:BusinessGeoCodeStatus" />
        <xs:element minOccurs="0" name="GeoPoint" nillable="true" type="tns:GeoPoint" />
        <xs:element minOccurs="0" name="PhoneNumber" nillable="true" type="xs:string" />
      </xs:sequence>
    </xs:extension>
  </xs:complexContent>
</xs:complexType>

{
  "DevicePreference": "LongValueHere",
  "ForwardCompatibilityMap": [
    {
      "key": "ValueHere",
      "value": "ValueHere"
    }
  ],
  "Id": "LongValueHere",
  "Scheduling": {
    "DayTimeRanges": [
      {
        "Day": "ValueHere",
        "EndHour": IntValueHere,
        "EndMinute": "ValueHere",
        "StartHour": IntValueHere,
        "StartMinute": "ValueHere"
      }
    ],
    "EndDate": {
      "Day": IntValueHere,
      "Month": IntValueHere,
      "Year": IntValueHere
    },
    "StartDate": {
      "Day": IntValueHere,
      "Month": IntValueHere,
      "Year": IntValueHere
    },
    "UseSearcherTimeZone": "ValueHere"
  },
  "Status": "ValueHere",
  "Type": "LocationAdExtension",
  "Version": IntValueHere,
  "Address": {
    "CityName": "ValueHere",
    "CountryCode": "ValueHere",
    "PostalCode": "ValueHere",
    "ProvinceCode": "ValueHere",
    "ProvinceName": "ValueHere",
    "StreetAddress": "ValueHere",
    "StreetAddress2": "ValueHere"
  },
  "CompanyName": "ValueHere",
  "GeoCodeStatus": "ValueHere",
  "GeoPoint": {
    "LatitudeInMicroDegrees": IntValueHere,
    "LongitudeInMicroDegrees": IntValueHere
  },
  "PhoneNumber": "ValueHere"
}

Éléments

L’objet LocationAdExtension contient les éléments suivants : Address, CompanyName, GeoCodeStatus, GeoPoint, PhoneNumber.

Élément	Description	Type de données
Address	Adresse de l’entreprise. Les valeurs de code de pays prises en charge incluent AR, AT, AU, BR, CA, CH, CL, CO, DE, DK, ES, FI, FR, GB, HK, ID, IE, IN, IT, MX, MY, NL, NZ, NO, PE, PH, SE, SG, TH, TW, US, VE et VN. Ajouter: Obligatoire Mettre à jour: Obligatoire	Adresse
CompanyName	Nom de l’entreprise. Le nom peut contenir un maximum de 80 caractères. Ajouter: Obligatoire Mettre à jour: Obligatoire	chaîne
GeoCodeStatus	Valeur status qui indique si les coordonnées de latitude et de longitude métier ont été déterminées. Si vous fournissez les coordonnées, le status sera défini sur Terminé ; sinon, le status indiquera la progression de la détermination des coordonnées de l’adresse professionnelle spécifiée. Ajouter: Non autorisé Mettre à jour: Non autorisé	BusinessGeoCodeStatus
GeoPoint	Coordonnées de latitude et de longitude de l’élément Address spécifié. Les coordonnées sont utilisées pour marquer l’emplacement de l’entreprise sur Bing Cartes lorsque l’utilisateur clique sur l’adresse de l’annonce. Si les coordonnées spécifiées ne se trouvent pas dans la plage de valeurs valides, le service détermine les coordonnées en fonction de l’adresse. Si vous spécifiez les coordonnées connues, le service ne vérifie pas si les coordonnées spécifiées correspondent à l’adresse professionnelle spécifiée. Si vous ne fournissez pas les coordonnées, l’opération AddAdExtensions utilise l’adresse métier pour déterminer les coordonnées. Lors de l’ajout de plus de 10 extensions d’annonces d’emplacement, le service résout les coordonnées hors connexion et résout les coordonnées à l’avance lors de l’exécution de l’opération de service. L’emplacement n’est pas utilisé dans une annonce tant que les coordonnées ne sont pas déterminées, ce qui peut prendre de quelques secondes à quelques minutes en fonction du nombre d’extensions d’annonces d’emplacement ajoutées et de la demande actuelle. Pour déterminer si les coordonnées ont été résolues, appelez l’opération GetAdExtensionsByIds et accédez à l’élément GeoCodeStatus . Pour obtenir la liste des valeurs status possibles, consultez BusinessGeoCodeStatus. Ajouter: Optionnel Mettre à jour: Optionnel	GeoPoint
PhoneNumber	Numéro de téléphone professionnel à inclure dans l’annonce. Le numéro de téléphone peut être cliqué sur les appareils mobiles hi-fi. Le numéro de téléphone peut contenir un maximum de 35 caractères et doit être valide pour le pays ou la région spécifié. Si la campagne inclut également une extension d’appel, le numéro de téléphone dans le poste d’appel remplacera ce numéro de téléphone. Ajouter: Optionnel Mettre à jour: Optionnel. Si vous définissez cet élément null, le paramètre précédent est supprimé.	chaîne

L’objet LocationAdExtension contient des éléments hérités.

Éléments hérités

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

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

Élément	Description	Type de données
DevicePreference	Non pris en charge pour ce type d’extension d’annonce.	long
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. Il n’existe actuellement aucune modification de compatibilité avant pour l’objet AdExtension . Ajouter: En lecture seule Mettre à jour: En lecture seule	Tableau KeyValuePairOfstringstring
Id	Identificateur Microsoft Advertising unique de l’extension de publicité. Ajouter: En lecture seule Mettre à jour: Lecture seule et Obligatoire	long
Planification	Détermine le jour calendaire et les intervalles de temps où l’extension d’annonce peut être affichée dans des annonces. Ajouter: Optionnel Mettre à jour: Optionnel. Si vous définissez cet élément null, tout jeu de planification existant pour l’extension d’annonce reste inchangé. Si vous définissez ce paramètre sur n’importe quel objet Schedule non null, vous remplacez efficacement les paramètres de planification existants pour l’extension d’annonce. Pour supprimer toutes les planifications, définissez cet élément sur un objet Schedule vide.	Schedule
Statut	Status de l’extension d’annonce. La valeur sera toujours Active , car le service Campaign Management ne retourne pas d’extensions publicitaires supprimées. Ajouter: En lecture seule Mettre à jour: En lecture seule	AdExtensionStatus
Type	Type de l’extension d’annonce. Cette valeur est LocationAdExtension lorsque vous récupérez une extension d’annonce de localisation. Ajouter: En lecture seule Mettre à jour: En lecture seule Pour plus d’informations sur les types d’extensions publicitaires, consultez les remarques relatives aux objets de données d’extension d’annonce.	chaîne
Version	Effectue le suivi du nombre de mises à jour de l’extension d’annonce. La version est définie sur 1 lors de la création de l’extension d’annonce et incrémente d’un après chaque mise à jour. Ajouter: Non autorisé Mettre à jour: Non autorisé	int

Configuration requise

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

Partager via