Partager via


ResponsiveSearchAdBuilder

Contient les méthodes permettant de définir et de créer une annonce de recherche réactive. Pour plus d’informations sur les générateurs, consultez 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 à l’aide de cette méthode ou de la méthode addDescription().
addHeadline(string headline, string pinning) ResponsiveSearchAdBuilder Ajoute le titre fourni à la liste actuelle des titres. Au moins 3 titres doivent être spécifiés à l’aide de la méthode this ou addHeadline().
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) ResponsiveSearchAdBuilder Définit les paramètres personnalisés de la publicité.
withDescriptions(object[] descriptions) ResponsiveSearchAdBuilder Définit les descriptions de l’annonce.
withFinalUrl(string finalUrl) ResponsiveSearchAdBuilder Définit l’URL de la page d’accueil de l’annonce.
withFinalUrlSuffix(string finalUrlSuffix) ResponsiveSearchAdBuilder Définit le suffixe d’URL final de la publicité.
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 facultatif à ajouter à l’URL d’affichage de la publicité.
withPath2(string urlPath2) ResponsiveSearchAdBuilder Définit le deuxième chemin facultatif à ajouter à l’URL d’affichage de la publicité.
withTrackingTemplate(string trackingTemplate) ResponsiveSearchAdBuilder Définit le modèle de suivi de la publicité.

addDescription(string description, string pinning)

Ajoute la description fournie à la liste actuelle des descriptions. Au moins 2 descriptions doivent être spécifiées à l’aide de cette méthode ou de 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 Bing Ads.
Épinglage string Emplacement épinglé facultatif.

Les valeurs possibles pour les descriptions sont : 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(string headline, string pinning)

Ajoute le titre fourni à la liste actuelle des titres. Au moins 3 titres doivent être spécifiés à l’aide de la méthode this ou addHeadline().

Arguments

Nom Type Description
Titre string Titre de l’annonce à ajouter. Pour plus d’informations sur les limites et l’inclusion de chaînes de texte dynamiques, consultez API Bing Ads.
Épinglage chaîne 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 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
ResponsiveSearchAdBuilder Générateur d’annonces avec les paramètres personnalisés appliqués.

withDescriptions(object[] descriptions)

Définit les descriptions de l’annonce.

Arguments

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

Retourne

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

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
ResponsiveSearchAdBuilder Générateur d’annonces avec l’URL finale appliquée.

withFinalUrlSuffix(string finalUrlSuffix)

Définit le suffixe d’URL final de la publicité.

Arguments

Nom Type Description
finalUrl chaîne 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[] Les titres de l’annonce. Pour plus d’informations sur les limites et l’inclusion de chaînes de texte dynamiques, consultez API Bing Ads.

Retourne

Type Description
ResponsiveSearchAdBuilder Générateur d’annonces avec les titres de la publicité 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 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
ResponsiveSearchAdBuilder 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
ResponsiveSearchAdBuilder 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 string 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
ResponsiveSearchAdBuilder 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
ResponsiveSearchAdBuilder Générateur d’annonces avec le modèle de suivi appliqué.