Objet de données FilterLinkAdExtension - Gestion des campagnes

Article
12/21/2023

Filtrer Les extensions de lien associent un en-tête avec entre 3 et 10 valeurs de texte cliquables qui en disent plus aux clients sur votre entreprise.

Vous pouvez associer une extension de publicité de lien de filtre au compte ou à des campagnes et des groupes d’annonces dans le compte. Chaque entité (compte, campagne ou groupe d’annonces) peut être associée à jusqu’à 20 extensions d’annonce de lien de filtre. Une annonce de texte développée n’inclut qu’une seule extension de lien de filtre (un titre avec 3 à 10 valeurs cliquables) par impression.

Syntaxe

<xs:complexType name="FilterLinkAdExtension" xmlns:xs="http://www.w3.org/2001/XMLSchema">
  <xs:complexContent mixed="false">
    <xs:extension base="tns:AdExtension">
      <xs:sequence>
        <xs:element minOccurs="0" name="AdExtensionHeaderType" nillable="true" type="tns:AdExtensionHeaderType" />
        <xs:element xmlns:q58="http://schemas.microsoft.com/2003/10/Serialization/Arrays" minOccurs="0" name="FinalMobileUrls" nillable="true" type="q58:ArrayOfstring" />
        <xs:element minOccurs="0" name="FinalUrlSuffix" nillable="true" type="xs:string" />
        <xs:element xmlns:q59="http://schemas.microsoft.com/2003/10/Serialization/Arrays" minOccurs="0" name="FinalUrls" nillable="true" type="q59:ArrayOfstring" />
        <xs:element minOccurs="0" name="Language" nillable="true" type="xs:string" />
        <xs:element xmlns:q60="http://schemas.microsoft.com/2003/10/Serialization/Arrays" minOccurs="0" name="Texts" nillable="true" type="q60:ArrayOfstring" />
        <xs:element minOccurs="0" name="TrackingUrlTemplate" nillable="true" type="xs:string" />
        <xs:element minOccurs="0" name="UrlCustomParameters" nillable="true" type="tns:CustomParameters" />
      </xs:sequence>
    </xs:extension>
  </xs:complexContent>
</xs:complexType>

Éléments

L’objet FilterLinkAdExtension contient les éléments suivants : AdExtensionHeaderType, FinalMobileUrls, FinalUrls, FinalUrlSuffix, Language, Texts, TrackingUrlTemplate, UrlCustomParameters.

Élément	Description	Type de données
AdExtensionHeaderType	En-tête qui est ajouté avec un signe deux-points ( :) et précède les valeurs de lien de filtre dans l’annonce affichée. Les en-têtes de lien de filtre s’affichent dans la langue que vous spécifiez. Par exemple, si vous souhaitez l’en-tête Commodités en anglais, vous devez définir la langue sur Anglais et AdExtensionHeaderType sur Commodités. Si vous souhaitez en-tête Ausstattung (Commodités en allemand), vous devez définir la langue sur Allemand et l’AdExtensionHeaderType sur Commodités. Ajouter: Obligatoire Mettre à jour: Obligatoire	AdExtensionHeaderType
FinalMobileUrls	URL de la page d’accueil des appareils mobiles. Les règles de validation suivantes s’appliquent aux URL finales et aux URL mobiles finales. - La longueur de l’URL est limitée à 2 048 caractères. La chaîne de protocole HTTP ou HTTPS compte pour la limite de 2 048 caractères. - Vous pouvez spécifier jusqu’à 10 éléments de liste pour FinalUrls et FinalMobileUrls. Toutefois, seul le premier élément de chaque liste est utilisé pour la remise. Le service autorise jusqu’à 10 éléments de liste pour une compatibilité descendante potentielle. - L’utilisation de « { » et de « } » est autorisée uniquement pour délimiter les balises, par exemple {lpurl}. - Les URL finales doivent chacune être une URL bien formée commençant par http:// ou https://. - Si vous spécifiez FinalMobileUrls, vous devez également spécifier FinalUrls. 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 liste vide, le paramètre précédent est supprimé.	tableau de chaînes
FinalUrls	URL de la page d’accueil. Les règles de validation suivantes s’appliquent aux URL finales et aux URL mobiles finales. - La longueur de l’URL est limitée à 2 048 caractères. La chaîne de protocole HTTP ou HTTPS compte pour la limite de 2 048 caractères. - Vous pouvez spécifier jusqu’à 10 éléments de liste pour FinalUrls et FinalMobileUrls. Toutefois, seul le premier élément de chaque liste est utilisé pour la remise. Le service autorise jusqu’à 10 éléments de liste pour une compatibilité descendante potentielle. - L’utilisation de « { » et de « } » est autorisée uniquement pour délimiter les balises, par exemple {lpurl}. - Les URL finales doivent chacune être une URL bien formée commençant par http:// ou https://. - Si vous spécifiez FinalMobileUrls, vous devez également spécifier FinalUrls. Ajouter: Obligatoire Mettre à jour: Optionnel. Si aucune valeur n’est définie pour la mise à jour, ce paramètre n’est pas modifié.	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. Cette fonctionnalité n’est disponible que pour les clients dans le pilote Final URL Suffix Phase 3 (GetCustomerPilotFeatures renvoie 636). Si vous n’êtes pas dans le pilote, cette propriété sera ignorée et aucune erreur ne sera retournée. Ajouter: Optionnel Mettre à jour: Optionnel. Si aucune valeur n’est définie pour la mise à jour, ce paramètre n’est pas modifié.	chaîne
Langue	Langue que vous souhaitez utiliser pour les en-têtes de lien de filtre. Les en-têtes de lien de filtre s’affichent dans la langue que vous spécifiez. Par exemple, si vous souhaitez l’en-tête Commodités en anglais, vous devez définir la langue sur Anglais et AdExtensionHeaderType sur Commodités. Si vous souhaitez en-tête Ausstattung (Commodités en allemand), vous devez définir la langue sur Allemand et l’AdExtensionHeaderType sur Commodités. Ajouter: Obligatoire Mettre à jour: Obligatoire	chaîne
Textes	Valeurs de texte qui suivent après le composant AdExtensionHeaderType de l’annonce affichée. Chaque valeur de texte que vous choisissez peut avoir une longueur maximale de 25 caractères. Notez que pour les caractères chinois traditionnels, chaque valeur peut avoir une longueur maximale de 12 caractères. Ajouter: Obligatoire Mettre à jour: Obligatoire	tableau de chaînes
TrackingUrlTemplate	Modèle de suivi à utiliser comme valeur par défaut pour tous les FinalUrls et FinalMobileUrls. 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 celles définies 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 valide pas l’existence de 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} ne sont définis 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. 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é.	chaîne
UrlCustomParameters	Votre collection personnalisée de paramètres de clé et de valeur pour le suivi des URL. Microsoft Advertising accepte les 3 premiers objets CustomParameter que vous incluez dans l’objet CustomParameters , et tous les paramètres personnalisés supplémentaires sont ignorés. Chaque CustomParameter comprend des éléments Key et Value . Pour les clients dans le pilote d’augmentation de la limite des paramètres personnalisés phase 3 (GetCustomerPilotFeatures retourne 635), Microsoft Advertising accepte les 8 premières paires clé/valeur de paramètre personnalisé que vous incluez, et si vous incluez plus de 8 paramètres personnalisés, une erreur est retournée. 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 .	CustomParameters

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

Éléments hérités

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

L’objet FilterLinkAdExtension 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 à FilterLinkAdExtension 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 FilterLinkAdExtension lorsque vous récupérez une extension d’annonce de lien de filtre. 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