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`);
}
}
}
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.