Remarque
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de vous connecter ou de modifier des répertoires.
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de modifier des répertoires.
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é. |