AdGroup

Contient les méthodes utilisées pour gérer un groupe d’annonces.

Méthodes

Nom de la méthode Type renvoyé Description
addLocation(int locationId) TargetedLocationOperation Crée une cible d’emplacement dans ce groupe d’annonces à partir d’un ID d’emplacement.
addLocation(int locationId, double bidModifier) TargetedLocationOperation Crée une cible d’emplacement dans ce groupe d’annonces à partir d’un ID d’emplacement et d’un modificateur d’enchère.
publicités AdSelector Obtient un sélecteur utilisé pour filtrer la liste des annonces de ce groupe d’annonces.
applyLabel(string name) void Applique l’étiquette à ce groupe d’annonces.
enchère AdGroupBidding Obtient les méthodes utilisées pour gérer le montant de l’enchère de ce groupe d’annonces.
Activer void Active ce groupe d’annonces.
excludeLocation(int locationId) ExcludedLocationOperation Crée une exclusion d’emplacement dans ce groupe d’annonces à partir d’un ID d’emplacement.
getCampaign Campagne Obtient la campagne à laquelle ce groupe d’annonces appartient.
getEndDate BingAdsDate Obtient la date à laquelle les annonces de ce groupe d’annonces cessent de servir.
getEntityType string Récupère le type de cette entité.
getId string Obtient l’ID qui identifie de manière unique ce groupe d’annonces.
getName string Récupère le nom de ce groupe d’annonces.
getStartDate BingAdsDate Obtenir la date à laquelle les annonces de ce groupe d’annonces commencent à être diffusées.
getStats Statistiques Obtient les données de performances pour ce groupe d’annonces.
isEnabled Booléen Obtient une valeur booléenne qui indique si ce groupe d’annonces est activé.
isPaused Booléen Obtient une valeur booléenne qui indique si ce groupe d’annonces est suspendu.
isRemoved Booléen Obtient une valeur booléenne qui indique si ce groupe d’annonces est supprimé.
Mots clés KeywordSelector Obtient un sélecteur utilisé pour filtrer la liste des mots clés de ce groupe d’annonces.
Étiquettes Sélecteur d’étiquette Obtient un sélecteur utilisé pour filtrer la liste des étiquettes associées à ce groupe d’annonces.
newAd Espace AdBuilderSpace Obtient un objet qui contient des méthodes pour obtenir des générateurs de publicités.
newKeywordBuilder KeywordBuilder Obtient un générateur utilisé pour ajouter un mot clé à ce groupe d’annonces.
mettre en pause void Suspend ce groupe de publicitaires.
productGroups ProductGroupSelector Obtient un sélecteur utilisé pour filtrer la liste des groupes de produits de ce groupe de publicitaires.
removeLabel(string name) void Supprime l’étiquette de ce groupe d’annonces.
rootProductGroup Groupe de produits Obtient le groupe de produits racine pour ce groupe d’annonces.
setEndDate(string endDate) void Définit la date à laquelle les annonces de ce groupe d’annonces cessent de servir.
setEndDate(Object endDate) void Définit la date à laquelle les annonces de ce groupe d’annonces cessent de servir.
setName(String name) void Définit le nom du groupe d’annonces.
setStartDate(string startDate) void Définit la date à laquelle les annonces de ce groupe d’annonces commencent à être diffusées.
setStartDate(Object startDate) void Définit la date à laquelle les annonces de ce groupe d’annonces commencent à être diffusées.
Ciblage AdGroupTargeting Fournit l’accès aux critères de ciblage au niveau du groupe d’annonces : ciblage d’emplacement.
les URL AdGroupUrls Contient les méthodes utilisées pour gérer les URL finales, le modèle de suivi et les paramètres personnalisés de ce groupe d’annonces.

addLocation(int locationId)

Crée une cible d’emplacement dans ce groupe d’annonces à partir d’un ID d’emplacement.

Retourne

Type Description
TargetedLocationOperation Objet d’opération utilisé pour case activée si l’emplacement ciblé a été correctement ajouté.

addLocation(int locationId, double bidModifier)

Crée une cible d’emplacement dans ce groupe d’annonces à partir d’un ID d’emplacement et d’un modificateur d’enchère.

Retourne

Type Description
TargetedLocationOperation Objet d’opération utilisé pour case activée si l’emplacement ciblé a été correctement ajouté.

publicités

Obtient un sélecteur utilisé pour filtrer la liste des annonces de ce groupe d’annonces.

Retourne

Type Description
AdSelector Sélecteur utilisé pour filtrer la liste des annonces de ce groupe d’annonces.

applyLabel(string name)

Applique l’étiquette au groupe d’annonces.

Vous pouvez appliquer un maximum de 50 étiquettes à un groupe d’annonces. Pour obtenir un exemple qui ajoute une étiquette à une entité, consultez Utilisation d’étiquettes.

Arguments

Nom Type Description
name string Nom de l’étiquette qui respecte la casse. Pour obtenir la liste des étiquettes de ce compte que vous pouvez appliquer, consultez AdsApp.labels.

Retourne

Type Description
void Renvoie la valeur nothing.

enchère

Obtient les méthodes utilisées pour gérer le montant de l’enchère de ce groupe d’annonces.

Renvoie :

Type Description
AdGroupBidding Contient les méthodes de gestion du montant de l’enchère de ce groupe d’annonces.

Activer

Active ce groupe d’annonces.

Retourne

Type Description
void Renvoie la valeur nothing.

excludeLocation(int locationId)

Crée une exclusion d’emplacement dans ce groupe d’annonces à partir d’un ID d’emplacement.

Retourne

Type Description
ExcludedLocationOperation Objet d’opération utilisé pour case activée si l’emplacement exclu a été correctement ajouté.

getCampaign

Obtient la campagne à laquelle ce groupe d’annonces appartient.

Retourne

Type Description
Campagne La campagne à laquelle ce groupe d’annonces appartient.

getEndDate

Obtient la date à laquelle les annonces de ce groupe d’annonces cessent de servir.

Retourne

Type Description
BingAdsDate Date à laquelle les annonces de ce groupe d’annonces cessent de servir.

getEntityType

Récupère le type de cette entité.

Retourne

Type Description
string Type de cette entité, qui est AdGroup.

getId

Obtient l’ID qui identifie de manière unique ce groupe d’annonces.

Retourne

Type Description
string ID qui identifie de manière unique ce groupe d’annonces.

getName

Récupère le nom de ce groupe d’annonces.

Retourne

Type Description
string Nom de ce groupe d’annonces.

getStartDate

Obtient la date à laquelle les annonces de ce groupe d’annonces commencent à être diffusées.

Retourne

Type Description
BingAdsDate Date à laquelle les annonces de ce groupe d’annonces commencent à être diffusées.

getStats

Obtient les données de performances pour ce groupe d’annonces.

Pour appeler cette méthode, vous devez inclure l’une des méthodes dans la chaîne du sélecteur de groupe d’annoncesforDateRange.

Renvoie :

Type Description
Statistiques Données de performances pour ce groupe d’annonces.

isEnabled

Obtient une valeur booléenne qui indique si ce groupe d’annonces est activé.

Renvoie :

Type Description
Booléen Est vrai si ce groupe d’annonces est activé ; sinon, false.

isPaused

Obtient une valeur booléenne qui indique si ce groupe d’annonces est suspendu.

Renvoie :

Type Description
Booléen est vrai si ce groupe d’annonces est suspendu ; sinon, false.

isRemoved

Obtient une valeur booléenne qui indique si ce groupe d’annonces est supprimé (supprimé).

Retourne

Type Description
Booléen est vrai si ce groupe d’annonces est supprimé ; sinon, false.

keywords

Obtient un sélecteur utilisé pour filtrer la liste des mots clés de ce groupe d’annonces.

Retourne

Type Description
KeywordSelector Sélecteur utilisé pour filtrer la liste des mots clés de ce groupe d’annonces.

Étiquettes

Obtient un sélecteur utilisé pour filtrer la liste des étiquettes associées à ce groupe d’annonces.

Retourne

Type Description
Sélecteur d’étiquette Sélecteur utilisé pour filtrer la liste des étiquettes associées à ce groupe d’annonces.

newAd

Obtient un objet qui contient des méthodes pour obtenir des générateurs de publicités.

Retourne

Type Description
Espace AdBuilderSpace Objet qui contient des méthodes pour obtenir des générateurs de publicités. Par exemple, pour créer une annonce de texte développée, appelez la méthode de l’objet expandedTextAdBuilder pour obtenir l’objet ExpandedTextAdBuilder .

newKeywordBuilder

Obtient un générateur utilisé pour ajouter un mot clé à ce groupe d’annonces.

Retourne

Type Description
KeywordBuilder Le constructeur utilisé pour ajouter un mot clé à ce groupe d’annonces.

mettre en pause

Suspend ce groupe de publicitaires.

Retourne

Type Description
void Renvoie la valeur nothing.

productGroups

Obtient un sélecteur utilisé pour filtrer la liste des groupes de produits de ce groupe de publicitaires.

Retourne

Type Description
ProductGroupSelector Sélecteur utilisé pour filtrer la liste des groupes de produits de ce groupe d’annonces.

removeLabel(string name)

Supprime l’étiquette du groupe d’annonces.

Arguments

Nom Type Description
name string Nom de l’étiquette qui respecte la casse. Pour obtenir la liste des étiquettes associées à ce groupe d’annonces, voir Étiquettes.

Retourne

Type Description
void Renvoie la valeur nothing.

rootProductGroup

Obtient le groupe de produits racine dans ce groupe d’annonces.

Retourne

Type Description
Groupe de produits Groupe de produits racine dans ce groupe d’annonces. Renvoie la valeur nulle si le groupe d’annonces ne contient pas de groupes de produits.

setEndDate(string endDate)

Définit la date à laquelle les annonces de ce groupe d’annonces cessent de servir. Définissez une date de fin uniquement 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 du groupe d’annonces cessent de servir. Spécifiez la date au format AAAAMMJJ.

Retourne

Type Description
void Renvoie la valeur nothing.

setEndDate(Object endDate)

Définit la date à laquelle les annonces de ce groupe d’annonces cessent de servir. Définissez une date de fin uniquement 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 de ce groupe d’annonces cessent de servir. 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
void Renvoie la valeur nothing.

setName(string name)

Définit le nom de ce groupe d’annonces.

Arguments

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

Retourne

Type Description
void Renvoie la valeur nothing.

setStartDate(string startDate)

Définit la date à laquelle les annonces de ce groupe d’annonces commencent à être diffusées. Définir une date de début uniquement si vous souhaitez que les annonces du groupe commencent à être diffusées à une date spécifique ; sinon, ils commencent à servir immédiatement.

Arguments

Nom Type Description
endDate string Date à laquelle les annonces de ce groupe d’annonces commencent à être diffusées. Spécifiez la date au format AAAAMMJJ.

Retourne

Type Description
void Renvoie la valeur nothing.

setStartDate(Object startDate)

Définit la date à laquelle les annonces de ce groupe d’annonces commencent à être diffusées. Définir une date de début uniquement si vous souhaitez que les annonces du groupe commencent à être diffusées à une date spécifique ; sinon, ils commencent à servir immédiatement.

Arguments

Nom Type Description
endDate Objet Date à laquelle les annonces de ce groupe d’annonces commencent à être 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
void Renvoie la valeur nothing.

Ciblage

Fournit l’accès aux critères de ciblage au niveau du groupe d’annonces : ciblage d’emplacement.

Retourne

Type Description
AdGroupTargeting Accès aux critères de ciblage géographique dans ce groupe d’annonces.

urls

Contient les méthodes utilisées pour gérer les URL finales, le modèle de suivi et les paramètres personnalisés de ce groupe d’annonces.

Retourne

Type Description
AdGroupUrls Objet utilisé pour gérer les URL finales, le modèle de suivi et les paramètres personnalisés de ce groupe d’annonces.

Voir aussi