AdGroupBuilder

Contient les méthodes utilisées pour définir et ajouter un groupe d’annonces. Pour plus d’informations sur les générateurs, consultez Générateurs.

Exemple d’utilisation :

    // Get a campaign to add the ad group to.
    var iterator = AdsApp.campaigns()
        .withIds(['CAMPAIGN ID GOES HERE'])
        .get();

    while (iterator.hasNext()) {
        var campaign = iterator.next();

        // Get the campaign's ad group builder and add an ad group.
        var operation = campaign.newAdGroupBuilder()
            .withName("AD GROUP NAME GOES HERE")
            .withStatus("ENABLED")
            .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

build

Crée le groupe d’annonces et retourne un objet d’opération utilisé pour case activée si le groupe d’annonces a été correctement ajouté.

Retourne

withBiddingStrategy(string biddingStrategy)

Définit la stratégie d’enchères du groupe d’annonces.

Arguments

Retourne

withCpc(double cpc)

Définit l’enchère CPC du groupe d’annonces.

Spécifie le montant de l’enchère à utiliser lorsque le mot clé correspond au terme de recherche de l’utilisateur et que la stratégie d’enchère du groupe d’annonces est MANUAL_CPC. Cette enchère est utilisée si une entité de niveau inférieur comme mot clé ne la remplace pas.

Arguments

Retourne

withCpm(double cpm)

Définit l’enchère CPM du groupe d’annonces.

Spécifie le montant de l’enchère à utiliser pour 1 000 impressions consultées et quand la stratégie d’enchère du groupe d’annonces est MANUAL_CPM.

Arguments

Retourne

withCpv(double cpv)

Définit l’enchère CPV du groupe d’annonces.

Spécifie le montant de l’enchère à utiliser par affichage ou par clic sur une publicité vidéo, et lorsque la stratégie d’enchère du groupe d’annonces est MANUAL_CPV.

Arguments

Retourne

withCustomParameters(Object customParameters)

Définit les paramètres personnalisés du groupe d’annonces à utiliser dans les URL finales ou les modèles de suivi.

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

Retourne

withEndDate(string endDate)

Définit la date à laquelle les annonces du groupe d’annonces cessent de servir. Appelez cette méthode uniquement si vous souhaitez que les annonces du groupe cessent de servir à une date spécifique.

Arguments

Retourne

withEndDate(Object endDate)

Définit la date à laquelle les annonces du groupe d’annonces cessent de servir. Appelez cette méthode uniquement si vous souhaitez que les annonces du groupe cessent de servir à une date spécifique.

Arguments

Retourne

withLanguage(string language)

Définit la langue utilisée par les publicités dans ce groupe d’annonces.

Par défaut, le groupe d’annonces hérite de la langue de sa campagne parente. Spécifiez une langue au niveau du groupe d’annonces pour remplacer la langue spécifiée au niveau de la campagne ou si la campagne ne spécifie pas de langue (la langue doit être spécifiée au niveau de la campagne et/ou du groupe d’annonces).

Arguments

Retourne

withName(string name)

Définit le nom du groupe d’annonces.

Arguments

Retourne

withStartDate(string startDate)

Définit la date à laquelle les annonces du groupe d’annonces commencent à être diffusées. Appelez cette méthode uniquement si vous souhaitez que les annonces du groupe commencent à être diffusées à une date spécifique . sinon, les annonces commencent à servir immédiatement.

Arguments

Retourne

withStartDate(Object startDate)

Définit la date à laquelle les annonces du groupe d’annonces commencent à être diffusées. Appelez cette méthode uniquement si vous souhaitez que les annonces du groupe commencent à être diffusées à une date spécifique . sinon, les annonces commencent à servir immédiatement.

Arguments

Retourne

withStatus(string status)

Définit la status du groupe d’annonces.

Arguments

Retourne

withTrackingTemplate(string trackingTemplate)

Définit le modèle de suivi du groupe d’annonces.

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

Retourne

Voir aussi

Campaign.newAdGroupBuilder()