Partager via

AdGroupBuilder

  • Article

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

Nom de la méthode Type renvoyé Description
Construire AdGroupOperation 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é.
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 AUT 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 la status 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 retourne 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
biddingStrategy string Stratégie d’enchère à 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égies d’enchères.

Retourne

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

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

Nom Type Description
Cpc double L’offre DET du groupe d’annonces maximale. 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
AdGroupBuilder Générateur de groupes d’annonces avec l’enchère 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 quand 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, consultez Devises des enchères et du budget.

Retourne

Type Description
AdGroupBuilder Générateur de groupes d’annonces avec l’enchère CPM appliquée.

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

Nom Type Description
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, consultez Devises des enchères et du budget.

Retourne

Type Description
AdGroupBuilder Générateur de groupes 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, consultez Paramètres personnalisés.

Arguments

Nom Type Description
customParameters Objet Carte de 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 groupes 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. Appelez cette méthode uniquement si vous souhaitez que les annonces du groupe cessent de servir à une date spécifique.

Arguments

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

Retourne

Type Description
AdGroupBuilder Générateur de groupes 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. Appelez cette méthode uniquement si vous souhaitez que les annonces du groupe cessent de servir à une date spécifique.

Arguments

Nom Type Description
endDate Objet Date d’arrêt de la 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 un, où 1 est janvier et 12 décembre.

Retourne

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

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

Nom Type Description
language string Langue utilisée par les publicités dans le groupe d’annonces. Par exemple, l'anglais. La chaîne ne respecte pas la casse. N’utilisez pas de code de langage à deux caractères. Pour obtenir la liste des langues prises en charge, consultez Langues publicitaires.

Retourne

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

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 peut contenir un maximum 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. 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

Nom Type Description
endDate string Date à laquelle commencer à diffuser des annonces. Spécifiez la date au format AAAAMMJJ.

Retourne

Type Description
AdGroupBuilder Générateur de groupes 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. 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

Nom Type Description
endDate Objet Date à laquelle commencer à diffuser 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 un, où 1 est janvier et 12 décembre.

Retourne

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

withStatus(string status)

Définit la status du groupe d’annonces.

Arguments

Nom Type Description
statut Chaîne La status du groupe d’annonces. Voici les valeurs possibles respectant la casse.
  • ACTIVÉ
  • PAUSE
  • ENLEVÉ
La valeur par défaut est PAUSED.

Retourne

Type Description
AdGroupBuilder Générateur de groupes 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 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 le groupe d’annonces.

Retourne

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

Voir aussi

Campaign.newAdGroupBuilder()