Contient les méthodes permettant de définir et de créer une annonce de texte développée. Pour plus d’informations sur les générateurs, consultez Générateurs.
Remarque
-
Mettez à niveau vos annonces textuelles développées en annonces de recherche réactives d’après le 1er février 2023. Après cette date, vous ne serez plus en mesure de créer ou de modifier des annonces textuelles développées existantes. Pour plus d’informations, consultez À propos des annonces de recherche réactive.
- Les annonces textuelles développées existantes continueront à être diffusées et vous serez en mesure d’afficher des rapports sur leurs performances.
- Vous pourrez toujours suspendre, activer ou supprimer vos annonces textuelles développées. Dans le cas contraire, les tentatives d’ajout ou de mise à jour d’annonces textuelles développées entraînent 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 retourne un objet d’opération utilisé pour case activée si Scripts a correctement ajouté la publicité.
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 la publicité.
Les paramètres personnalisés sont utiles pour le partage d’informations dynamiques entre plusieurs URL. Pour plus d’informations sur son utilisation, consultez Paramètres personnalisés.
Arguments
| Nom |
Type |
Description |
| customParameters |
Objet |
Mappage des paramètres personnalisés à appliquer à l’URL finale de la publicité. 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
| Type |
Description |
|
ExpandedTextAdBuilder |
Générateur d’annonces avec les paramètres personnalisés appliqués. |
withDescription(string description)
Définit la première description de la publicité. 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 la publicité. Cette méthode définit le même champ que withDescription(string description).
Arguments
| Nom |
Type |
Description |
| description1 |
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 d’accueil de l’annonce.
Arguments
| Nom |
Type |
Description |
| finalUrl |
string |
URL de la page d’accueil 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 |
| headlinePart1 |
string |
Première partie du titre de l’annonce. Lorsque Microsoft génère le titre de la publicité à 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 titre supplémentaires et l’inclusion de chaînes de texte dynamiques dans le titre, consultez API Bing Ads. |
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 |
| headlinePart2 |
string |
Deuxième partie du titre de l’annonce. Lorsque Microsoft génère le titre de la publicité à 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 titre supplémentaires et l’inclusion de chaînes de texte dynamiques dans le titre, consultez API Bing Ads. |
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 |
| headlinePart3 |
string |
Troisième partie du titre de l’annonce. Lorsque Microsoft génère le titre de la publicité à 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 titre supplémentaires et l’inclusion de chaînes de texte dynamiques dans le titre, consultez API Bing Ads. |
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 redirigé lorsqu’il clique sur la publicité. Pour spécifier une URL finale pour les appareils mobiles, spécifiez d’abord une URL finale pour les appareils non mobiles (voir 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 facultatif à ajouter à l’URL d’affichage de la publicité.
Arguments
| Nom |
Type |
Description |
| mobileFinalUrl |
string |
Premier chemin facultatif à ajouter à l’URL d’affichage de la publicité. Microsoft utilise le domaine spécifié dans comme withFinalUrl URL d’affichage. Si le domaine de l’URL finale est contoso.com et que le chemin est des chaussures, l’URL d’affichage de l’annonce est contoso.com/shoes. Pour plus d’informations sur l’utilisation et les limites, consultez Path1. |
Retourne
withPath2(string urlPath2)
Définit le deuxième chemin facultatif à ajouter à l’URL d’affichage de la publicité.
Arguments
| Nom |
Type |
Description |
| mobileFinalUrl |
chaîne |
Deuxième chemin facultatif à ajouter à l’URL d’affichage de la publicité. Pour spécifier le deuxième chemin, commencez par spécifier le premier chemin (voir withPath1). Microsoft utilise le domaine spécifié dans comme withFinalUrl URL d’affichage. Si le domaine de l’URL finale est contoso.com, le premier chemin est chaussures et le deuxième chemin est dames, l’URL d’affichage de l’annonce est contoso.com/shoes/ladies. Pour plus d’informations sur l’utilisation et les limites, consultez Path2. |
Retourne
withTrackingTemplate(string trackingTemplate)
Définit le modèle de suivi de la publicité.
Les modèles de suivi sont utilisés avec le FinalUrl de l’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 publicité. |
Retourne