Partager via


ExpandedTextAdBuilder

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

Nom de la méthode Type renvoyé Description
Construire AdOperation Crée l’annonce et retourne un objet d’opération utilisé pour case activée si Scripts a correctement ajouté la publicité.
withCustomParameters(Object customParameters) ExpandedTextAdBuilder Définit les paramètres personnalisés de la publicité.
withDescription(string description) ExpandedTextAdBuilder Définit la première description de la publicité. Cette méthode est déconseillée en faveur de withDescription1(string description1).
withDescription1(string description1) ExpandedTextAdBuilder Définit la première description de la publicité. Cette méthode définit le même champ que withDescription(string description).
withDescription2(string description2) ExpandedTextAdBuilder Définit la deuxième description de l’annonce.
withFinalUrl(string finalUrl) ExpandedTextAdBuilder Définit l’URL de la page d’accueil de l’annonce.
withHeadlinePart1(string headlinePart1) ExpandedTextAdBuilder Définit la première partie du titre de l’annonce.
withHeadlinePart2(string headlinePart2) ExpandedTextAdBuilder Définit la deuxième partie du titre de l’annonce.
withHeadlinePart3(string headlinePart3) ExpandedTextAdBuilder Définit la troisième partie du titre de l’annonce.
withMobileFinalUrl(string mobileFinalUrl) ExpandedTextAdBuilder Définit l’URL finale de l’annonce pour les appareils mobiles.
withPath1(string urlPath1) ExpandedTextAdBuilder Définit le premier chemin facultatif à ajouter à l’URL d’affichage de la publicité.
withPath2(string urlPath2) ExpandedTextAdBuilder Définit le deuxième chemin facultatif à ajouter à l’URL d’affichage de la publicité.
withTrackingTemplate(string trackingTemplate) ExpandedTextAdBuilder Définit le modèle de suivi de la publicité.

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

Type Description
ExpandedTextAdBuilder Générateur d’annonces avec la description appliquée.

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

Type Description
ExpandedTextAdBuilder Générateur d’annonces avec la description appliquée.

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

Type Description
ExpandedTextAdBuilder Générateur d’annonces avec la description appliquée.

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

Type Description
ExpandedTextAdBuilder Générateur d’annonces avec l’URL finale appliquée.

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

Type Description
ExpandedTextAdBuilder Générateur d’annonces avec l’URL finale mobile appliquée.

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

Type Description
ExpandedTextAdBuilder Générateur d’annonces avec le chemin d’accès appliqué.

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

Type Description
ExpandedTextAdBuilder Générateur d’annonces avec le chemin d’accès appliqué.

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

Type Description
ExpandedTextAdBuilder Générateur d’annonces avec le modèle de suivi appliqué.