Libellés

Les libellés vous permettent d'organiser les éléments de votre compte en groupes logiques. Vous pouvez ainsi filtrer rapidement les données qui vous intéressent le plus pour créer un rapport. Les scripts Google Ads acceptent les libellés au niveau du compte, de la campagne, du groupe d'annonces, des annonces et des mots clés.

Cas d'utilisation

Dans les comptes Google Ads, les libellés permettent d'associer des données arbitraires à des entités Google Ads. Dans les comptes administrateur, les libellés permettent de regrouper des comptes enfants similaires. Les étiquettes sont utiles pour de nombreux cas d'utilisation:

  • Traitez une liste de comptes.
    • Si vous êtes une agence, vous pouvez appliquer un libellé plumber_accounts à tous les comptes de plombiers. Ensuite, un script peut insérer des mots clés liés à ce sujet (par exemple, "réparation urgence sous douche") dans toutes les campagnes de ces comptes.
  • Traiter une liste d'entités
    • Si vous souhaitez activer un ensemble de mots clés uniquement le week-end, vous pouvez leur appliquer un libellé weekend_keywords. Un script peut ensuite activer tous les mots clés associés au paramètre weekend_keywords le vendredi soir et les mettre en veille le lundi matin.
  • Traiter des entités dans plusieurs exécutions
    • Si un grand nombre d'entités ne peuvent pas être traitées en moins de 30 minutes, vous pouvez créer un libellé processed dans votre script et l'appliquer aux entités déjà traitées. Planifiez l'exécution du script toutes les heures, puis traitez uniquement les entités auxquelles le libellé processed n'est pas appliqué.
  • Modifications en deux étapes
    • Plutôt que de demander au script d'appliquer une modification d'enchère à un grand nombre de mots clés, vous pouvez ajouter le libellé increase_bid_by_10% aux mots clés, vous connecter à l'interface utilisateur Google Ads, filtrer les mots clés correspondant à ce libellé, les examiner et, si le résultat vous convient, modifier leurs enchères en effectuant des modifications groupées.
  • Enchères flexibles
    • Un script peut utiliser des libellés pour conserver un historique des modifications d'enchères. Par exemple, lorsqu'un script augmente l'enchère d'un mot clé de 20%, il peut associer le compte au libellé increased_20%. Le lendemain, le script s'aperçoit qu'il a déjà augmenté l'enchère précédemment appliqué au libellé et ne pourra augmenter l'enchère que de 10%.
  • Suivi du niveau de qualité
    • Un script peut attribuer des libellés de niveau de qualité aux mots clés importants, puis vérifier régulièrement les mots clés dont le niveau de qualité ne correspond plus au libellé et générer des rapports les concernant.

Libellés au niveau du compte

Les scripts Google Ads vous permettent de créer des libellés dans les comptes administrateur et d'en appliquer aux comptes Google Ads associés:

const labelName = 'High spending accounts';
AdsManagerApp.createAccountLabel(labelName);

Vous pouvez appliquer le libellé aux comptes de votre choix à l'aide de la méthode applyLabel:

const accountIds = ['123-456-7890', '345-6789-2100'];
const labelName = 'High spending accounts';

const accounts = AdsManagerApp.accounts().withIds(accountIds).get();
for (const account of accounts) {
  account.applyLabel(labelName);
}

De même, vous pouvez supprimer le libellé d'un compte à l'aide de la méthode removeLabel:

const accountIds = ['123-456-7890', '345-6789-2100'];
const labelName = 'High spending accounts';

const accounts = AdsManagerApp.accounts().withIds(accountIds).get();
for (const account of accounts) {
  account.removeLabel(labelName);
}

Les libellés de compte sont le plus souvent utilisés pour traiter un groupe de comptes partageant le même libellé:

const labelName = 'High spending accounts';

const accounts = AdsManagerApp.accounts()
    .withCondition(`LabelNames CONTAINS "${labelName}"`)
    .get();

Consultez notre guide sur les scripts de compte administrateur pour en savoir plus sur le traitement de plusieurs comptes dans une seule exécution de script.

Libellés au sein d'un compte

Vous pouvez créer et appliquer des libellés à des campagnes, des groupes d'annonces, des annonces et des mots clés dans un compte. Pour appliquer un libellé à une campagne, procédez comme suit:

const campaign = AdsApp.campaigns()
    .withCondition('campaign.name = "My first campaign"').get().next();
campaign.applyLabel('High performing campaign');

De même, vous pouvez supprimer un libellé à l'aide de la méthode removeLabel:

const campaign = AdsApp.campaigns()
    .withCondition('campaign.name = "My first campaign"').get().next();
campaign.removeLabel('High performing campaign');

Les étiquettes sont le plus souvent utilisées pour traiter un ensemble d'entités similaires regroupées par étiquette. L'extrait de code suivant montre comment mettre en veille un groupe de campagnes partageant un même libellé:

const label = AdsApp.labels()
    .withCondition('label.name = "Christmas promotions"')
    .get().next();
var campaignIterator = label.campaigns().get();
for (const campaign of campaignIterator) {
  campaign.pause();
}

Rapports

Lorsque vous générez des rapports sur les performances pour des comptes Google Ads, vous pouvez utiliser les noms de ressources de libellés pour filtrer les entités. Les noms de ressources sont un concept propre à l'API Google Ads. Ils sont parfois utilisés lors de l'exécution de rapports avec GAQL. Le nom d'une ressource d'étiquette se présente toujours au format suivant:

customers/[customer id]/labels/[label id]

Vous pouvez récupérer le nom de ressource d'un libellé à l'aide de la méthode getResourceName.

L'extrait de code suivant montre comment générer un rapport sur les campagnes pour toutes les campagnes associées au libellé "Noël promotions" :

const label = AdsApp.labels()
    .withCondition("label.name = 'Christmas promotions'")
    .get().next();
const query = `SELECT campaign.name, metrics.clicks, metrics.impressions, metrics.cost ` +
    `FROM campaign WHERE campaign.labels CONTAINS ANY ` +
    `["${label.getResourceName()}"] AND segments.date DURING THIS_MONTH`;
const result = AdsApp.search(query);

N'oubliez pas que vous ne pouvez utiliser que les opérateurs CONTAINS_ALL, CONTAINS_ANY et CONTAINS_NONE pour filtrer par nom de ressource de libellé.