ResponsiveSearchAdBuilder

Contient les méthodes de définition et de création d’une annonce de recherche réactive. Pour plus d’informations sur les générateurs, voir Générateurs.

Exemple d’utilisation :

    var operation = adGroup.newAd().responsiveSearchAdBuilder()
        .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
addDescription(string description, string pinning)	ResponsiveSearchAdBuilder	Ajoute la description fournie à la liste actuelle des descriptions. Au moins 2 descriptions doivent être spécifiées en utilisant cette méthode ou la méthode addDescription().
addHeadline(titre de chaîne, épinglage de chaîne)	ResponsiveSearchAdBuilder	Ajoute le titre fourni à la liste actuelle des titres. Au moins 3 titres doivent être spécifiés en utilisant cette méthode ou la méthode addHeadline().
build	AdOperation	Crée l’annonce et renvoie un objet d’opération utilisé pour case activée si les scripts ont correctement ajouté l’annonce.
withCustomParameters(Object customParameters)	ResponsiveSearchAdBuilder	Définit les paramètres personnalisés de l’annonce.
withDescriptions(object[] descriptions)	ResponsiveSearchAdBuilder	Définit les descriptions de l’annonce.
withFinalUrl(string finalUrl)	ResponsiveSearchAdBuilder	Définit l’URL de la page de destination de l’annonce.
withFinalUrlSuffix(string finalUrlSuffix)	ResponsiveSearchAdBuilder	Définit le suffixe d’URL finale de l’annonce.
withHeadlines(object[] headlines)	ResponsiveSearchAdBuilder	Définit les titres de l’annonce.
withMobileFinalUrl(string mobileFinalUrl)	ResponsiveSearchAdBuilder	Définit l’URL finale de l’annonce pour les appareils mobiles.
withPath1(string urlPath1)	ResponsiveSearchAdBuilder	Définit le premier chemin d’accès facultatif à ajouter à l’URL d’affichage de la publicité.
withPath2(string urlPath2)	ResponsiveSearchAdBuilder	Définit le deuxième chemin d’accès facultatif à ajouter à l’URL d’affichage de l’annonce.
withTrackingTemplate(string trackingTemplate)	ResponsiveSearchAdBuilder	Définit le modèle de suivi de l’annonce.

addDescription(string description, string pinning)

Ajoute la description fournie à la liste actuelle des descriptions. Au moins 2 descriptions doivent être spécifiées en utilisant cette méthode ou la méthode addDescription().

Arguments

Nom	Type	Description
description	string	Description de l’annonce à ajouter. Pour plus d’informations sur les limites et l’inclusion de chaînes de texte dynamiques, consultez API Microsoft Advertising Bing.
épinglage	string	Emplacement épinglé facultatif. Les valeurs possibles pour les descriptions sont les suivantes : DESCRIPTION_1, DESCRIPTION_2
text	string	Texte de cette ressource.

Retourne

Type	Description
ResponsiveSearchAdBuilder	générateur d’annonces avec la description appliquée.

addHeadline(titre de chaîne, épinglage de chaîne)

Ajoute le titre fourni à la liste actuelle des titres. Au moins 3 titres doivent être spécifiés en utilisant cette méthode ou la méthode addHeadline().

Arguments

Nom	Type	Description
titre	string	Titre d’annonce à ajouter. Pour plus d’informations sur les limites et l’inclusion de chaînes de texte dynamiques, consultez API Microsoft Advertising Bing.
épinglage	string	Emplacement épinglé facultatif. Les valeurs possibles pour les titres sont : HEADLINE_1, HEADLINE_2 HEADLINE_3

Retourne

Type	Description
ResponsiveSearchAdBuilder	Générateur d’annonces avec le titre appliqué.

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

Type	Description
ResponsiveSearchAdBuilder	avec les paramètres personnalisés appliqués.

withDescriptions(object[] descriptions)

Définit les descriptions de l’annonce.

Arguments

Nom	Type	Description
les descriptions	AdTextAsset[]	Descriptions de l’annonce. Pour plus d’informations sur les limites et l’inclusion de chaînes de texte dynamiques, consultez API Microsoft Advertising Bing.

Retourne

Type	Description
ResponsiveSearchAdBuilder	générateur d’annonces avec les descriptions appliquées.

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

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

withFinalUrlSuffix(string finalUrlSuffix)

Définit le suffixe d’URL finale de l’annonce.

Arguments

Nom	Type	Description
finalUrl	string	Suffixe d’URL final de l’annonce. Pour plus d’informations sur les limites d’URL, consultez API Bing Ads.

Retourne

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

withHeadlines(object[] headlines

Définit les titres de l’annonce.

Arguments

Nom	Type	Description
Titres	AdTextAsset[]	Titres de l’annonce. Pour plus d’informations sur les limites et l’inclusion de chaînes de texte dynamiques, consultez API Microsoft Advertising Bing.

Retourne

Type	Description
ResponsiveSearchAdBuilder	Générateur d’annonces avec les titres de l’annonce appliqués.

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

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

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

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

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

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

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

Type	Description
ResponsiveSearchAdBuilder	avec le modèle de suivi appliqué.