KeywordBuilder
Contient les méthodes permettant de définir et de créer un mot clé. Pour plus d’informations sur les générateurs, consultez Générateurs.
Remarque
Tous les mots clés de modificateur de correspondance large pour les annonces de recherche servent désormais de mots clés de correspondance large au lieu de correspondance d’expression. En savoir plus sur les types de correspondance mot clé.
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 |
|---|---|---|
| Construire | KeywordOperation | Crée l’mot clé et retourne un objet d’opération utilisé pour case activée si le mot clé a été correctement ajouté. |
| withCpc(double cpc) | KeywordBuilder | Définit l’enchère maximale du mot clé AUT. |
| 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 l’mot clé et retourne un objet d’opération utilisé pour case activée si le mot clé a été correctement ajouté.
Retourne
| Type | Description |
|---|---|
| KeywordOperation | Objet d’opération utilisé pour case activée si le mot clé a été correctement ajouté. |
withCpc(double cpc)
Définit l’enchère maximale du mot clé AUT.
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ère 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 des enchères, consultez Bid and BiddingScheme.
Arguments
| Nom | Type | Description |
|---|---|---|
| Cpc | double | Soumission maximale de la CPP à appliquer à l’mot clé. La devise du compte détermine les valeurs d’enchère minimale et maximale. Pour plus d’informations, consultez Devises des enchères et du budget. |
Retourne
| Type | Description |
|---|---|
| KeywordBuilder | Générateur de mots clés avec l’enchère DETD 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, consultez Paramètres personnalisés.
Arguments
| Nom | Type | Description |
|---|---|---|
| customParameters | Objet | Mappage des paramètres personnalisés à appliquer à l’URL finale de l’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 redirigé lorsqu’il clique sur la publicité. Si elle n’est pas spécifiée, l’entité hérite de l’URL finale de son entité parente. Par exemple, l’entité mot clé hérite de l’URL finale de la publicité. 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 redirigé lorsqu’il clique sur la publicité. |
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 redirigé lorsqu’il clique sur la publicité. Si elle n’est pas spécifiée, l’entité hérite de l’URL finale de son entité parente. Par exemple, l’entité mot clé hérite de l’URL finale de la publicité. 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 appareils mobiles, spécifiez d’abord une URL finale pour les appareils non mobiles (voir 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, n’utilisez aucune syntaxe de type de correspondance (par exemple,
keywordBuilder.withText("books")). - Pour le modificateur de correspondance large, ajoutez au texte un signe plus (+) (par exemple,
keywordBuilder.withText("+books")). Remarque : Si vous essayez de créer des mots clés BMM (Broad Match Modificateur), ils sont enregistrés et servis en tant que mots clés de correspondance d’expression. Vos mots clés BMM existants continueront à servir sous le comportement de correspondance d’expression. En savoir plus sur les types de correspondance mot clé. - Pour la correspondance d’expression, placez des guillemets autour du texte (par exemple,
keywordBuilder.withText("\"books\"")). - Pour obtenir une 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 peut contenir un maximum 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 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 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 mot clé. |
Retourne
| Type | Description |
|---|---|
| KeywordBuilder | Générateur de mots clés avec le modèle de suivi appliqué. |