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, voir 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

Nom de la méthode Type renvoyé Description
build AdGroupOperation Crée le groupe d’annonces et renvoie un objet d’opération utilisé pour case activée si le groupe d’annonces a été correctement ajouté.
withBiddingStrategy(string biddingStrategy) AdGroupBuilder Définit la stratégie d’enchères du groupe d’annonces.
withCpc(double cpc) AdGroupBuilder Définit l’enchère au CPC maximale du groupe d’annonces.
withCpm(double cpm) AdGroupBuilder Définit l’enchère CPM maximale du groupe d’annonces.
withCpv(double cpv) AdGroupBuilder Définit l’enchère CPV maximale du groupe d’annonces.
withCustomParameters(Object customParameters) AdGroupBuilder Définit les paramètres personnalisés du groupe d’annonces.
withEndDate(string endDate) AdGroupBuilder Définit la date à laquelle les annonces du groupe d’annonces cessent de servir.
withEndDate(Object endDate) AdGroupBuilder Définit la date à laquelle les annonces du groupe d’annonces cessent de servir.
withLanguage(string language) AdGroupBuilder Définit la langue utilisée par ce groupe d’annonces.
withName(string name) AdGroupBuilder Définit le nom du groupe d’annonces.
withStartDate(string startDate) AdGroupBuilder Définit la date à laquelle les annonces du groupe d’annonces commencent à être diffusées.
withStartDate(Object startDate) AdGroupBuilder Définit la date à laquelle les annonces du groupe d’annonces commencent à être diffusées.
withStatus(string status) AdGroupBuilder Définit le statut du groupe d’annonces.
withTrackingTemplate(string trackingTemplate) AdGroupBuilder Définit le modèle de suivi du groupe d’annonces.

build

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

Retourne

Type Description
AdGroupOperation Objet d’opération utilisé pour case activée si le groupe d’annonces a été correctement ajouté.

withBiddingStrategy(string biddingStrategy)

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

Arguments

Nom Type Description
stratégie d’enchère string Stratégie d’enchères à appliquer au groupe d’annonces. Voici les valeurs possibles respectant la casse.
  • MANUAL_CPC
  • MANUAL_CPM
  • MANUAL_CPV
Pour plus d’informations sur ces stratégies, consultez Types de stratégie d’enchère.

Retourne

Type Description
AdGroupBuilder Générateur de groupe d’annonces avec la stratégie d’enchères appliquée.

withCpc(double cpc)

Définit l’enchère au 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 offre est utilisée si une entité de niveau inférieur telle qu’un mot clé ne la remplace pas.

Arguments

Nom Type Description
Coût par correspondance double Enchère au CPC maximale du groupe d’annonces. 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
AdGroupBuilder Générateur de groupe d’annonces avec l’enchère au CPC appliquée.

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 lorsque la stratégie d’enchère du groupe d’annonces est MANUAL_CPM.

Arguments

Nom Type Description
CPM double Enchère CPM maximale du groupe d’annonces. 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
AdGroupBuilder Générateur de groupe d’annonces avec l’enchère CPM appliquée.

withCpv(double cpv)

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

Indique le montant de l’enchère à utiliser par vue ou par clic sur une annonce vidéo et lorsque la stratégie d’enchère du groupe d’annonces est MANUAL_CPV.

Arguments

Nom Type Description
Le CPV double Enchère CPV maximale du groupe d’annonces. 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
AdGroupBuilder Générateur de groupe d’annonces avec l’enchère CPV appliquée.

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, voir Paramètres personnalisés.

Arguments

Nom Type Description
customParameters Objet Carte contenant jusqu’à trois paramètres personnalisés à appliquer au groupe d’annonces. 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
AdGroupBuilder Générateur de groupe d’annonces avec les paramètres personnalisés appliqués.

withEndDate(string endDate)

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

Arguments

Nom Type Description
endDate string Date à laquelle les annonces ne sont plus diffusées. Spécifiez la date au format AAAAMMJJ.

Retourne

Type Description
AdGroupBuilder Générateur de groupe d’annonces avec la date de fin appliquée.

withEndDate(Object endDate)

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

Arguments

Nom Type Description
endDate Objet Date à laquelle les annonces ne sont plus diffusées. Spécifiez la date à l’aide d’un objet avec les champs suivants :
  • year
  • month
  • jour

Par exemple : var date = {year: 2018, month: 5, day: 13};

Le mois est basé sur une base, où 1 correspond à janvier et 12 à décembre.

Retourne

Type Description
AdGroupBuilder Générateur de groupe d’annonces avec la date de fin appliquée.

withLanguage(string language)

Définit la langue utilisée par les annonces de 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

Nom Type Description
language string Langue utilisée par les annonces du groupe d’annonces. Par exemple, l'anglais. La chaîne n’est pas sensible à la casse. N’utilisez pas de code de langue à deux caractères. Pour obtenir la liste des langues prises en charge, voir Langues d’annonce.

Retourne

Type Description
AdGroupBuilder Générateur de groupe d’annonces avec la langue appliquée.

withName(string name)

Définit le nom du groupe d’annonces.

Arguments

Nom Type Description
name string Nom du groupe d’annonces. Le nom est obligatoire. Le nom ne peut pas contenir plus de 256 caractères et doit être unique parmi tous les groupes d’annonces actifs dans la campagne.

Retourne

Type Description
AdGroupBuilder Générateur de groupes d’annonces avec le nom appliqué.

withStartDate(string startDate)

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

Arguments

Nom Type Description
endDate string Date de début de diffusion des annonces. Spécifiez la date au format AAAAMMJJ.

Retourne

Type Description
AdGroupBuilder Générateur de groupe d’annonces avec la date de début appliquée.

withStartDate(Object startDate)

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

Arguments

Nom Type Description
endDate Objet Date de début de diffusion des annonces. Spécifiez la date à l’aide d’un objet avec les champs suivants :
  • year
  • month
  • jour

Par exemple : var date = {year: 2018, month: 5, day: 13};

Le mois est basé sur une base, où 1 correspond à janvier et 12 à décembre.

Retourne

Type Description
AdGroupBuilder Générateur de groupe d’annonces avec la date de début appliquée.

withStatus(string status)

Définit le statut du groupe d’annonces.

Arguments

Nom Type Description
statut String Status du groupe d’annonces. Voici les valeurs possibles respectant la casse.
  • ACTIVÉ
  • PAUSE
  • SUPPRIMÉ
La valeur par défaut est SUSPENDUE.

Retourne

Type Description
AdGroupBuilder Générateur de groupe d’annonces avec le status appliqué.

withTrackingTemplate(string trackingTemplate)

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

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 le groupe d’annonces.

Retourne

Type Description
AdGroupBuilder Générateur de groupe d’annonces avec le modèle de suivi appliqué.

Voir aussi

Campaign.newAdGroupBuilder()

  • Last updated on