KeywordBuilder

Contient les méthodes de définition et de création d’un mot clé. Pour plus d’informations sur les générateurs, voir Générateurs.

Remarque

Tous les mots clés modificateurs en requête large pour les annonces de recherche servent désormais de mots clés en requête large au lieu d’expression idéale. En savoir plus sur les types de correspondance de mots clés.

Exemple d’utilisation :

    var operation = adGroup.newKeywordBuilder()
        .withText("KEYWORD TEXT GOES HERE")
        .withCpc(0.5)
        .withFinalUrl("http://www.contoso.com")
        .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
build KeywordOperation Crée le mot clé et renvoie un objet d’opération utilisé pour case activée si le mot clé a été ajouté avec succès.
withCpc(double cpc) KeywordBuilder Définit l’enchère CPC maximale du mot clé.
withCustomParameters(Object customParameters) KeywordBuilder Définit les paramètres personnalisés du mot clé.
withFinalUrl(string finalUrl) KeywordBuilder Définit l’URL finale du mot clé.
withMobileFinalUrl(string mobileFinalUrl) KeywordBuilder Définit l’URL finale du mot clé pour les appareils mobiles.
withText(string text) KeywordBuilder Définit le texte du mot clé.
withTrackingTemplate(string trackingTemplate) KeywordBuilder Définit le modèle de suivi du mot clé.

build

Crée le mot clé et renvoie un objet d’opération utilisé pour case activée si le mot clé a été ajouté avec succès.

Retourne

Type Description
KeywordOperation Objet d’opération utilisé pour case activée si l’mot clé a été correctement ajouté.

withCpc(double cpc)

Définit l’enchère CPC maximale du mot clé.

Spécifie le montant de l’enchère à utiliser lorsque le mot clé correspond au terme de recherche de l’utilisateur. S’applique uniquement si la stratégie d’enchères du groupe d’annonces est définie sur MANUAL_CPC.

Pour utiliser le montant d’enchère spécifié au niveau du groupe d’annonces, n’appelez pas cette méthode.

Pour plus d’informations sur les montants d’enchère, voir Enchère et système d’enchères.

Arguments

Nom Type Description
Coût par correspondance double Enchère CPC maximale à appliquer au mot clé. La devise du compte détermine les valeurs d’enchère minimale et maximale. Pour plus d’informations, voir Devises d’enchère et de budget.

Retourne

Type Description
KeywordBuilder Générateur de mots clés avec l’enchère CPC appliquée.

withCustomParameters(Object customParameters)

Définit les paramètres personnalisés du mot clé.

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 de jusqu’à paramètres personnalisés à appliquer à l’URL finale du mot clé. 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
KeywordBuilder Générateur de mots clés avec les paramètres personnalisés appliqués.

withFinalUrl(string finalUrl)

Définit l’URL finale du mot clé.

L’URL finale identifie la page Web vers laquelle l’utilisateur est dirigé lorsqu’il clique sur l’annonce. Si cela n’est pas spécifié, l’entité hérite de l’URL finale de son entité parente. Par exemple, l’entité de mot clé hérite de l’URL finale de l’annonce. Spécifiez l’URL finale du mot clé pour remplacer l’URL finale de l’annonce.

Pour plus d’informations, consultez Quels paramètres de suivi ou d’URL puis-je utiliser ?

Arguments

Nom Type Description
finalUrl string URL finale qui identifie la page Web vers laquelle l’utilisateur est dirigé lorsqu’il clique sur l’annonce.

Retourne

Type Description
KeywordBuilder Générateur de mots clés avec l’URL finale appliquée.

withMobileFinalUrl(string mobileFinalUrl)

Définit l’URL finale du mot clé pour les appareils mobiles.

L’URL finale identifie la page Web vers laquelle l’utilisateur est dirigé lorsqu’il clique sur l’annonce. Si cela n’est pas spécifié, l’entité hérite de l’URL finale de son entité parente. Par exemple, l’entité de mot clé hérite de l’URL finale de l’annonce. Spécifiez l’URL finale du mot clé si vous souhaitez remplacer l’URL finale de l’annonce.

Pour plus d’informations, consultez Quels paramètres de suivi ou d’URL puis-je utiliser ?

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()).

Arguments

Nom Type Description
mobileFinalUrl string URL finale pour les appareils mobiles.

Retourne

Type Description
KeywordBuilder Générateur de mots clés avec l’URL finale mobile appliquée.

withText(string text)

Définit le texte du mot clé.

Pour spécifier le type de correspondance du mot clé, utilisez la syntaxe suivante :

  • Pour une correspondance large, utilisez la syntaxe de type aucun type de correspondance (par exemple, keywordBuilder.withText("books")).
  • Pour le modificateur de correspondance large, faites précéder le texte d’un signe plus (+) (par exemple, keywordBuilder.withText("+books")). Remarque : si vous essayez de créer des mots clés BMM (Broad Match Modifier), ils seront enregistrés et servis en tant que mots clés de correspondance d’expression. Vos mots clés BMM existants continueront à être utilisés dans le cadre de la correspondance d’expression. En savoir plus sur les types de correspondance de mots clés.
  • Pour la correspondance d’expression, placez des guillemets autour du texte (par exemple, keywordBuilder.withText("\"books\"")).
  • Pour la correspondance exacte, placez des crochets autour du texte (par exemple, keywordBuilder.withText("[hardcover books]")).

Arguments

Nom Type Description
text string Texte du mot clé. Le texte du mot clé est obligatoire. Le texte ne peut pas contenir plus de 100 caractères. Spécifiez le texte dans les paramètres régionaux de la valeur de langue du groupe d’annonces.

Retourne

Type Description
KeywordBuilder Générateur de mots clés avec le texte du mot clé appliqué.

withTrackingTemplate(string trackingTemplate)

Définit le modèle de suivi du mot clé.

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 ce mot clé.

Retourne

Type Description
KeywordBuilder Générateur de mots clés avec le modèle de suivi appliqué.
  • Last updated on