ProductCustomLabel
Contient les méthodes de gestion d’un groupe de produits d’étiquette personnalisée. Cet objet dérive de ProductGroup.
Utilisé par le moteur de livraison pour déterminer si un produit du catalogue de l’annonceur est servi. Le moteur peut servir le produit si l’étiquette personnalisée du produit correspond exactement à l’étiquette retournée pargetType.
Exemple d’utilisation :
var shoppingCampaign = AdsApp.shoppingCampaigns().withIds(["123456789"]).get().next();
var productGroups = shoppingCampaign.productGroups().get();
while (productGroups.hasNext()) {
var group = productGroups.next();
switch (group.getDimension()) {
case "CUSTOM_LABEL": {
// It's only necessary to cast the product group to a ProductCustomLabel product
// group if you need to get the label's name by calling getType(). Otherwise,
// you can simply use ProductGroup if you want to get the label's value by
// calling getValue().
var customLabel = productGroup.asCustomLabel();
var labelName = customLabel.getType();
var labelValue = customLabel.getValue();
break;
}
// Other cases
}
}
Méthodes
| Nom de la méthode | Type renvoyé | Description |
|---|---|---|
| children | ProductGroupSelector | Obtient un sélecteur utilisé pour filtrer la liste des groupes de produits enfants de ce groupe de produits. |
| getAdGroup | AdGroup | Obtient le groupe d’annonces auquel appartient ce groupe de produits. |
| getCampaign | Campagne | Obtient la campagne à laquelle ce groupe de produits appartient. |
| getDimension | string | Obtient la dimension de ce groupe de produits. |
| getEntityType | string | Obtient le type de cette entité. |
| getId | string | Obtient l’ID qui identifie de façon unique ce groupe de produits. |
| getMaxCpc | double | Obtient le montant maximal de l’enchère coût par clic pour ce groupe de produits. |
| getStats | Stats | Obtient les données de performances pour ce groupe de produits. |
| Gettype | string | Obtient le type d’étiquette personnalisée du produit. |
| Getvalue | string | Obtient la valeur de l’étiquette personnalisée. |
| isExcluded | Valeur booléenne | Obtient une valeur booléenne qui détermine si ce groupe de produits est exclu. |
| isOtherCase | Valeur booléenne | Obtient une valeur booléenne qui détermine si ce groupe de produits représente tous les autres cas non représentés par son groupe de produits frère. |
| parent | ProductGroup | Obtient le groupe de produits parent de ce groupe de produits. |
| setMaxCpc(double cpc) | void | Définit le montant maximal de l’enchère coût par clic à utiliser pour ce groupe de produits. |
children
Obtient un sélecteur utilisé pour filtrer la liste des groupes de produits enfants de ce groupe de produits.
Retourne
| Type | Description |
|---|---|
| ProductGroupSelector | Sélecteur utilisé pour filtrer la liste des enfants de ce groupe de produits. |
getAdGroup
Obtient le groupe d’annonces auquel appartient ce groupe de produits.
Retourne
| Type | Description |
|---|---|
| AdGroup | Groupe d’annonces auquel appartient ce groupe de produits. |
getCampaign
Obtient la campagne à laquelle ce groupe de produits appartient.
Retourne
| Type | Description |
|---|---|
| Campagne | Campagne à laquelle appartient ce groupe de produits. |
getDimension
Obtient la dimension de ce groupe de produits.
Retourne
| Type | Description |
|---|---|
| Chaîne | Dimension de ce groupe de produits, qui est définie sur CUSTOM_LABEL. |
getEntityType
Obtient le type de cette entité.
Retourne
| Type | Description |
|---|---|
| string | Le type de cette entité, qui est ProductCustomLabel. |
getId
Obtient l’ID qui identifie de façon unique ce groupe de produits.
Retourne
| Type | Description |
|---|---|
| string | ID qui identifie de façon unique ce groupe de produits. |
getMaxCpc
Obtient le montant maximal du coût par clic de ce groupe de produits.
Retourne
| Type | Description |
|---|---|
| double | Montant de l’offre. Retourne null s’il n’est pas défini ou s’il s’agit d’un groupe de produits négatif (isExluded a la valeur true). |
getStats
Obtient les données de performances pour ce groupe de produits.
Pour appeler cette méthode, vous devez inclure l’une des forDateRange méthodes dans la chaîne du sélecteur de groupe de produits .
Renvoie :
| Type | Description |
|---|---|
| Stats | Données de performances pour ce groupe de produits. |
Gettype
Obtient le type d’étiquette personnalisée du produit.
Retourne
| Type | Description |
|---|---|
| Chaîne | Type d’étiquette personnalisée du produit. Par exemple, CustomLabel0 à CustomLabel4. |
Getvalue
Obtient la valeur de l’étiquette personnalisée.
Renvoie :
| Type | Description |
|---|---|
| string | Valeur de l’étiquette personnalisée. |
isExcluded
Obtient une valeur booléenne qui détermine si ce groupe de produits est un groupe de produits négatif.
Renvoie :
| Type | Description |
|---|---|
| Boolean | A la valeur true si ce groupe de produits est un groupe négatif ; sinon, false. Par exemple, au lieu d’inclure tous les skis alpins, vous les excluez. |
isOtherCase
Obtient une valeur booléenne qui détermine si ce groupe de produits représente tout le reste qui n’est pas représenté par son groupe de produits frère (c’est-à-dire, l’autre cas).
Renvoie :
| Type | Description |
|---|---|
| Boolean | A la valeur true si ce groupe de produits représente l'« autre » cas ; sinon, false. Par exemple, si vous divisez Tous les produits (le nœud racine) par Articles de sport, le service crée un groupe de produits frère qui représente les produits non dans Articles de sport et définit ce champ sur true. L’ID parent de ce groupe de produits et le groupe de produits Articles de sport pointent vers le nœud racine. |
parent
Obtient le parent de ce groupe de produits.
Renvoie :
| Type | Description |
|---|---|
| ProductGroup | Parent de ce groupe de produits. |
setMaxCpc(double cpc)
Définit le montant maximal du coût par clic pour ce groupe de produits.
Arguments
| Nom | Type | Description |
|---|---|---|
| Cpc | double | Montant de l’offre. Le montant de l’enchère est dans la devise du compte, ce qui détermine les valeurs d’enchère minimale et maximale que vous pouvez spécifier. Ne définissez pas l’enchère si ce groupe de produits est subdivisé (a des enfants) ou s’il s’agit d’un groupe de produits négatif (isExcluded a la valeur true). |
Retourne
| Type | Description |
|---|---|
| void | Renvoie la valeur nothing. |