Libellés

Les libellés vous permettent d'organiser les éléments de votre compte en groupes logiques afin de filtrer facilement et 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, 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, vous pouvez utiliser des libellés pour regrouper des comptes enfants similaires. Les libellés sont utiles dans un certain nombre de cas d'utilisation :

• Traiter une liste de comptes
  • Si vous êtes une agence, vous pouvez appliquer un libellé plumber_accounts les comptes des plombiers, puis un script peut transmettre (par exemple, "réparation douche d'urgence") dans toutes les campagnes de ces comptes.
• Traiter une liste d'entités <ph type="x-smartling-placeholder">
  </ph>
  • Si vous avez un ensemble de mots clés que vous ne souhaitez activer que le week-end, vous pouvez leur appliquer un libellé weekend_keywords. Un script peut ensuite activer tous les mots clés avec weekend_keywords le vendredi soir et les mettre en veille le lundi matin.
• Traiter des entités pour plusieurs exécutions <ph type="x-smartling-placeholder">
  </ph>
  • Si vous avez un grand nombre d'entités qui ne peuvent pas être traitées dans après 30 minutes, vous pourrez créer un libellé processed dans votre et l'appliquer aux entités qui ont déjà été traitées. Planifiez 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 <ph type="x-smartling-placeholder">
  </ph>
  • Au lieu de demander au script d'exécuter une modification d'enchères pour 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 au libellé, 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 un historique des modifications des enchères. Pour Lorsqu'un script augmente l'enchère d'un mot clé de 20%, il peut marquer compte avec un libellé, increased_20%. Le lendemain de l'exécution du script et constate que l'enchère a déjà été augmentée auparavant, elle pouvait augmenter l'enchère de seulement 10%.
• Suivi du niveau de qualité <ph type="x-smartling-placeholder">
  </ph>
  • Un script peut libeller les mots clés importants en indiquant leur niveau de qualité, puis vérifier régulièrement les mots clés dont le niveau de qualité n'est plus correspond à l'étiquette.

Libellés au niveau du compte

Les scripts Google Ads vous permettent de créer des libellés dans les comptes administrateur et d'appliquer aux comptes Google Ads rattachés à ce compte administrateur:

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

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

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 removeLabel méthode:

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 généralement utilisés pour gérer le partage entre des comptes le même libellé de compte:

const labelName = 'High spending accounts';

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

Remarque : LabelNames est une méthode pratique qui nécessite un appel d'API supplémentaire en coulisses pour rechercher le nom de la ressource du libellé. Si vous disposez déjà d'un objet de libellé, utilisez plutôt un filtre customer_client.applied_labels CONTAINS ALL (${label.getResourceName()}). Pour en savoir plus sur les noms de ressources, consultez la section sur les rapports ci-dessous.

Pour en savoir plus sur le traitement de plusieurs comptes dans une seule exécution de script, consultez notre guide des scripts de compte administrateur.

Libellés d'un compte

Vous pouvez créer des libellés et les appliquer aux campagnes, groupes d'annonces, ads (annonces) et mots clés (mots clés). Pour 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 étiquettes sont le plus souvent utilisées pour traiter un ensemble d'entités similaires regroupées réunis par une étiquette. 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 des noms de ressources d'étiquettes pour filtrer les entités lors de l'exécution les rapports sur les performances des comptes Google Ads. Les noms de ressources sont un concept de l'API Google Ads et sont parfois utilisés lors de l'exécution de rapports avec GAQL. Une ressource d'étiquette 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 associées au 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é.