Objet de données CallAdExtension - Gestion des campagnes

Article
07/19/2024

Définit un objet qui spécifie un numéro de téléphone click-to-call à inclure dans une annonce texte.

Vous pouvez associer une extension d’annonce d’appel à des campagnes dans le compte. Chaque entité (campagne) peut être associée à une extension d’annonce d’appel.

Syntaxe

<xs:complexType name="CallAdExtension" xmlns:xs="http://www.w3.org/2001/XMLSchema">
  <xs:complexContent mixed="false">
    <xs:extension base="tns:AdExtension">
      <xs:sequence>
        <xs:element minOccurs="0" name="CountryCode" nillable="true" type="xs:string" />
        <xs:element minOccurs="0" name="IsCallOnly" nillable="true" type="xs:boolean" />
        <xs:element minOccurs="0" name="IsCallTrackingEnabled" nillable="true" type="xs:boolean" />
        <xs:element minOccurs="0" name="PhoneNumber" nillable="true" type="xs:string" />
        <xs:element minOccurs="0" name="RequireTollFreeTrackingNumber" nillable="true" type="xs:boolean" />
      </xs:sequence>
    </xs:extension>
  </xs:complexContent>
</xs:complexType>

Éléments

L’objet CallAdExtension contient les éléments suivants : CountryCode, IsCallOnly, IsCallTrackingEnabled, PhoneNumber, RequireTollFreeTrackingNumber.

Élément	Description	Type de données
CountryCode	Code du pays où le numéro de téléphone est enregistré. Le code de pays doit contenir un code de pays à 2 caractères. 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	chaîne
IsCallOnly	L’option permettant d’afficher votre numéro de téléphone et votre site web, ou simplement votre numéro de téléphone, aux personnes qui voient vos annonces sur un smartphone. Vous souhaiterez peut-être afficher uniquement votre numéro de téléphone si votre entreprise exige que vous parlez à chaque client. Définissez cette propriété sur true si vous souhaitez que l’extension d’annonce affiche uniquement le numéro de téléphone sans lien vers votre site web. Sinon, si vous souhaitez que l’extension de publicité inclue un lien vers votre site web en plus du numéro de téléphone, définissez-la sur false. Ajouter: Optionnel. Si vous ne spécifiez pas cet élément ou laissez-le vide, la valeur par défaut false est définie et l’extension publicitaire inclut un lien vers votre site web en plus du numéro de téléphone. Mettre à jour: Optionnel	boolean
IsCallTrackingEnabled	Détermine si le suivi des appels est activé pour l’extension d’annonce d’appel. Le suivi des appels n’est pris en charge que dans les États-Unis et au Royaume-Uni. Définissez cette propriété sur true pour activer le suivi des appels et définissez-la sur false. Ajouter: Optionnel. Si vous ne spécifiez pas cet élément ou si vous le laissez vide, la valeur par défaut false est définie. Mettre à jour: Optionnel	boolean
PhoneNumber	Numéro de téléphone cliquable à inclure dans l’annonce. 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 des extensions d’appel et d’annonce de localisation, ce numéro de téléphone remplace le numéro de téléphone spécifié dans les extensions d’annonce de localisation. Notez que le numéro de téléphone peut être reformaté. Par exemple, si vous définissez le numéro de téléphone sur 4255551212, il est reformaté en (425) 555-1212. Ajouter: Obligatoire Mettre à jour: Obligatoire	chaîne
RequireTollFreeTrackingNumber	Vous pouvez utiliser votre propre numéro de téléphone ou un numéro de téléphone de transfert Microsoft Advertising. Un numéro de téléphone de transfert Microsoft Advertising est un numéro de téléphone unique qui est acheminé vers votre numéro de téléphone professionnel. Avec un numéro de transfert Microsoft Advertising, vous pouvez suivre tous les appels de votre annonce afin d’analyser les performances de la publicité. Cet élément détermine si un numéro de téléphone gratuit de transfert Microsoft Advertising doit être créé pour le suivi des appels. Cet élément ne peut être défini que si IsCallTrackingEnabled a également la valeur true. Avant août 2017, les clients pouvaient définir cette propriété sur true si un numéro de téléphone de transfert Microsoft Advertising devait être créé pour le suivi des appels. Depuis août 2017, les clients ne peuvent plus créer de numéro de téléphone de transfert gratuit Microsoft Advertising. Si vous définissez cette valeur true , l’opération réussit ; Toutefois, un numéro gratuit n’est pas créé et lorsque vous récupérez l’extension d’annonce d’appel, cette propriété est définie sur false. Si un numéro de transfert gratuit a été provisionné avant août 2017, cette propriété sera true si le numéro est toujours actif lorsque vous récupérez l’extension d’annonce d’appel. Ajouter: Optionnel. Si vous ne spécifiez pas cet élément ou si vous le laissez vide, la valeur par défaut false est définie. Mettre à jour: Optionnel	boolean

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

Éléments hérités

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

L’objet CallAdExtension 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 à CallAdExtension 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 CallAdExtension lorsque vous récupérez une extension d’annonce d’appel. 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
Noms: https://bingads.microsoft.com/CampaignManagement/v13

Partager via