Contient les méthodes de définition et de création d’une annonce de texte développée. Pour plus d’informations sur les générateurs, voir Générateurs.
Remarque
-
Mettez à niveau vos annonces de texte étendu vers des annonces de recherche réactives d’après le 1er février 2023. Après cette date, vous ne pourrez plus créer ou modifier des annonces textuelles développées existantes. Pour plus d’informations, consultez À propos des annonces de recherche réactives.
- Les annonces textuelles développées existantes continueront de servir et vous pourrez afficher des rapports sur leurs performances.
- Vous pourrez toujours suspendre, activer ou supprimer vos annonces texte développées. Dans le cas contraire, les tentatives d’ajout ou de mise à jour d’annonces de texte développées se solderont par une
CampaignServiceAdTypeInvalid erreur.
-
En savoir plus sur cette modification.
Exemple d’utilisation :
var operation = adGroup.newAd().expandedTextAdBuilder()
.withHeadlinePart1('FIRST PART OF TITLE GOES HERE')
.withHeadlinePart2('SECOND PART OF TITLE GOES HERE')
.withDescription('AD TEXT GOES HERE')
.withFinalUrl('LANDING PAGE URL GOES HERE')
.build();
// See the Builders topic for performance considerations
// when using the operation object's methods.
if (!operation.isSuccessful()) {
for (var error of operation.getErrors()) {
Logger.log(`${error}\n`);
}
}
Méthodes
build
Crée l’annonce et renvoie un objet d’opération utilisé pour case activée si les scripts ont correctement ajouté l’annonce.
Pour connaître les limites du nombre d’annonces que vous pouvez ajouter à un groupe d’annonces, consultez Limites du hiérarchie d’entités.
Retourne
| Type |
Description |
|
AdOperation |
Objet d’opération utilisé pour case activée si Scripts a correctement ajouté l’annonce. |
withCustomParameters(Object customParameters)
Définit les paramètres personnalisés de l’annonce.
Les paramètres personnalisés sont utiles pour le partage d’informations dynamiques entre plusieurs URL. Pour plus d’informations sur son utilisation, voir Paramètres personnalisés.
Arguments
| Nom |
Type |
Description |
| customParameters |
Objet |
Carte allant jusqu’à des paramètres personnalisés à appliquer à l’URL finale de l’annonce. Par exemple, {key1: 'value1', key2: 'value2', key3: 'value3'}, où key est le nom du paramètre personnalisé et la valeur est la valeur du paramètre. Le nom peut contenir un maximum de 16 caractères de 8 octets et la valeur peut contenir un maximum de 200 caractères de 8 octets. |
Retourne
withDescription(string description)
Définit la première description de l’annonce. Cette méthode est déconseillée en faveur de withDescription1(string description1).
Arguments
| Nom |
Type |
Description |
| description |
string |
Première description de l’annonce. Pour plus d’informations sur les limites de copie et l’inclusion de chaînes de texte dynamiques, consultez API Bing Ads. |
Retourne
withDescription1(string description1)
Définit la première description de l’annonce. Cette méthode définit le même champ que withDescription(string description).
Arguments
| Nom |
Type |
Description |
| description 1 |
string |
Première description de l’annonce. Pour plus d’informations sur les limites de copie et l’inclusion de chaînes de texte dynamiques, consultez API Bing Ads. |
Retourne
withDescription2(string description2)
Définit la deuxième description de l’annonce.
Arguments
| Nom |
Type |
Description |
| Description2 |
string |
Deuxième description de l’annonce. Pour plus d’informations sur les limites de copie et l’inclusion de chaînes de texte dynamiques, consultez API Bing Ads. |
Retourne
withFinalUrl(string finalUrl)
Définit l’URL de la page de destination de l’annonce.
Arguments
| Nom |
Type |
Description |
| finalUrl |
string |
URL de la page de destination de l’annonce. Pour plus d’informations sur les limites d’URL, consultez API Bing Ads. |
Retourne
withHeadlinePart1(string headlinePart1)
Définit la première partie du titre de l’annonce.
Arguments
| Nom |
Type |
Description |
| headlinePartie 1 |
string |
Première partie du titre de l’annonce. Lorsque Microsoft génère le titre de l’annonce à l’aide des parties 1, 2 et 3 du titre, il concatène les parties à l’aide de « - ». Ne spécifiez pas le tiret dans les parties de titre. Chaque partie du titre doit contenir au moins un mot. Pour plus d’informations sur les limites de titres supplémentaires et l’inclusion de chaînes de texte dynamiques dans le titre, consultez API Microsoft Advertising Bing. |
Retourne
| Type |
Description |
|
ExpandedTextAdBuilder |
Générateur d’annonces avec la partie 1 du titre de l’annonce appliquée. |
withHeadlinePart2(string headlinePart2)
Définit la deuxième partie du titre de l’annonce.
Arguments
| Nom |
Type |
Description |
| headlinePartie 2 |
string |
Deuxième partie du titre de l’annonce. Lorsque Microsoft génère le titre de l’annonce à l’aide des parties 1, 2 et 3 du titre, il concatène les parties à l’aide de « - ». Ne spécifiez pas le tiret dans les parties de titre. Chaque partie du titre doit contenir au moins un mot. Pour plus d’informations sur les limites de titres supplémentaires et l’inclusion de chaînes de texte dynamiques dans le titre, consultez API Microsoft Advertising Bing. |
Retourne
| Type |
Description |
|
ExpandedTextAdBuilder |
Générateur d’annonces avec la partie 1 du titre de l’annonce appliquée. |
withHeadlinePart3(string headlinePart3)
Définit la troisième partie du titre de l’annonce.
Arguments
| Nom |
Type |
Description |
| headlinePartie 3 |
string |
Troisième partie du titre de l’annonce. Lorsque Microsoft génère le titre de l’annonce à l’aide des parties 1, 2 et 3 du titre, il concatène les parties à l’aide de « - ». Ne spécifiez pas le tiret dans les parties de titre. Chaque partie du titre doit contenir au moins un mot. Pour plus d’informations sur les limites de titres supplémentaires et l’inclusion de chaînes de texte dynamiques dans le titre, consultez API Microsoft Advertising Bing. |
Retourne
| Type |
Description |
|
ExpandedTextAdBuilder |
Générateur d’annonces avec la partie 1 du titre de l’annonce appliquée. |
withMobileFinalUrl(string mobileFinalUrl)
Définit l’URL finale de l’annonce pour les appareils mobiles.
L’URL finale identifie la page Web vers laquelle l’utilisateur est dirigé lorsqu’il clique sur l’annonce. Pour spécifier une URL finale pour les périphériques mobiles, spécifiez d’abord une URL finale pour les périphériques non mobiles (reportez-vous à la section withFinalUrl()).
Pour plus d’informations, consultez Quels paramètres de suivi ou d’URL puis-je utiliser ?
Arguments
| Nom |
Type |
Description |
| mobileFinalUrl |
string |
URL finale pour les appareils mobiles. |
Retourne
withPath1(string urlPath1)
Définit le premier chemin d’accès facultatif à ajouter à l’URL d’affichage de la publicité.
Arguments
| Nom |
Type |
Description |
| mobileFinalUrl |
string |
Premier chemin d’accès facultatif à ajouter à l’URL d’affichage de l’annonce. Microsoft utilise le domaine spécifié comme withFinalUrl URL d’affichage. Si le domaine de l’URL finale est contoso.com et que le chemin d’accès est chaussures, l’URL d’affichage de l’annonce est contoso.com/shoes. Pour l’utilisation et les limites, reportez-vous au chemin d’accès 1. |
Retourne
withPath2(string urlPath2)
Définit le deuxième chemin d’accès facultatif à ajouter à l’URL d’affichage de l’annonce.
Arguments
| Nom |
Type |
Description |
| mobileFinalUrl |
string |
Deuxième chemin d’accès facultatif à ajouter à l’URL d’affichage de la publicité. Pour spécifier le deuxième chemin d’accès, spécifiez d’abord le premier chemin d’accès (reportez-vous à la section withPath1). Microsoft utilise le domaine spécifié comme withFinalUrl URL d’affichage. Si le domaine de l’URL finale est contoso.com, le premier chemin est chaussures et le second chemin est femmes, l’URL d’affichage de l’annonce est contoso.com/shoes/ladies. Pour l’utilisation et les limites, reportez-vous au chemin d’accès 2. |
Retourne
withTrackingTemplate(string trackingTemplate)
Définit le modèle de suivi de l’annonce.
Les modèles de suivi sont utilisés avec l’URL finale du mot clé pour créer l’URL de destination utilisée par l’annonce. Pour plus d’informations, consultez Quels paramètres de suivi ou d’URL puis-je utiliser ?
Arguments
| Nom |
Type |
Description |
| trackingTemplate |
string |
Modèle de suivi à utiliser avec cette annonce. |
Retourne