Libellés

Les libellés vous permettent d'organiser les éléments de votre compte en groupes logiques afin de filtrer rapidement les données qui vous intéressent le plus pour créer un rapport. Les scripts Google Ads sont compatibles avec les libellés au niveau du compte, de la campagne, du groupe d'annonces, de l'annonce et du mot clé.

Cas d'utilisation

Dans les comptes Google Ads, les libellés peuvent être utilisés pour associer des données arbitraires à des entités Google Ads. Dans les comptes administrateur, les libellés peuvent être utilisés pour regrouper des comptes enfants similaires. Les libellés sont utiles dans plusieurs cas d'utilisation :

• Traiter une liste de comptes
  • Si vous êtes une agence, vous pouvez appliquer un libellé plumber_accounts à tous les comptes de plombiers. Un script peut ensuite insérer des mots clés liés à la plomberie (par exemple, "réparation de douche en urgence") dans toutes les campagnes de ces comptes.
• Traiter une liste d'entités
  • Si vous disposez d'un ensemble de mots clés que vous souhaitez activer uniquement le week-end, vous pouvez leur appliquer un libellé weekend_keywords. Un script pourrait ensuite activer tous les mots clés avec weekend_keywords le vendredi soir et les mettre en veille le lundi matin.
• Traiter les entités sur plusieurs exécutions
  • Si vous avez un grand nombre d'entités qui 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 qui ont déjà été traitées. Programmez l'exécution du script toutes les heures, puis ne traitez que les entités auxquelles le libellé processed n'est pas appliqué.
• Modifications en deux étapes
  • Au lieu de faire exécuter par le script une modification d'enchère pour un grand nombre de mots clés, vous pouvez les étiqueter avec increase_bid_by_10%, vous connecter à l'UI Google Ads, filtrer les mots clés correspondant à l'étiquette, les examiner et, si vous êtes satisfait du résultat, modifier leurs enchères à l'aide des modifications groupées.
• Enchères flexibles
  • Un script peut utiliser des libellés pour conserver l'historique des modifications d'enchères. Par exemple, lorsqu'un script augmente l'enchère d'un mot clé de 20 %, il peut marquer le compte avec un libellé, increased_20%. Le lendemain, lorsque le script s'exécute sur le libellé et se rend compte qu'il avait déjà augmenté l'enchère précédemment, il ne peut l'augmenter que de 10 %.
• Suivi du niveau de qualité
  • Un script peut attribuer un libellé aux mots clés importants en fonction de leur niveau de qualité, puis vérifier régulièrement les mots clés dont le niveau de qualité ne correspond plus au libellé et générer un rapport à leur sujet.

Libellés au niveau du compte

Les scripts Google Ads vous permettent de créer des libellés dans les comptes administrateur, mais aussi de les 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 un 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);
}

L'utilisation la plus courante des libellés de compte consiste à traiter un groupe de comptes partageant le même libellé de compte :

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 lors d'une même exécution de script.

Libellés dans un compte

Vous pouvez créer et appliquer des libellés aux campagnes, aux groupes d'annonces, aux annonces et aux mots clés d'un compte. Voici comment appliquer un libellé à une campagne :

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 libellés sont le plus souvent utilisés pour traiter un ensemble d'entités similaires regroupées par un libellé. L'extrait de code suivant montre comment mettre en veille un groupe de campagnes partageant un libellé commun :

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

Rapports

Vous pouvez utiliser les noms de ressources de libellé pour filtrer les entités lorsque vous générez des rapports sur les performances pour les comptes Google Ads. Les noms de ressources sont un concept de l'API Google Ads. Ils sont parfois utilisés lors de l'exécution de rapports avec GAQL. Le nom d'une ressource de libellé est 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 sa méthode getResourceName.

L'extrait de code suivant montre comment exécuter un rapport sur les campagnes pour toutes les campagnes portant le libellé "Promotions de Noël" :

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é.