Ciblage de la campagne

Les scripts Google Ads vous permettent de travailler avec les paramètres de ciblage au niveau de la campagne dans vos comptes. L'assistance est disponible pour les programmations d'annonces, les zones géographiques ciblées et exclues, les proximités ciblées et les plates-formes. Ce guide vous explique comment utiliser les cibles de campagne.

Calendriers de diffusion des annonces

Les programmes de diffusion des annonces vous permettent de contrôler quand vos annonces doivent être diffusées.

Récupérer

Vous pouvez récupérer les plannings de diffusion d'une campagne à l'aide de la méthode adSchedules des cibles de la campagne. L'extrait de code suivant montre comment récupérer la liste de tous les critères AdSchedule pour une campagne :

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

const adSchedules = campaign.targeting().adSchedules().get();
for (const adSchedule of adSchedules) {
  // Process your ad schedule.
  ...
}

Par défaut, une campagne est diffusée en permanence. Vous n'obtiendrez donc aucun calendrier de diffusion des annonces si vous n'en avez pas défini un pour votre campagne.

Mettre à jour

Une fois que vous avez récupéré un calendrier de diffusion d'annonces, vous pouvez modifier directement ses propriétés. Par exemple, vous pouvez mettre à jour le modificateur d'enchères d'un calendrier de diffusion d'annonces comme suit :

adSchedule.setBidModifier(1.1);

Créer

Pour créer une programmation d'annonces, vous pouvez utiliser la méthode addAdSchedule de Campaign. L'extrait de code suivant crée un calendrier publicitaire personnalisé pour la campagne de 7h à 11h, tous les samedis, avec un modificateur d'enchères de 1,1, dans le fuseau horaire du compte.

campaign.addAdSchedule({
   dayOfWeek: "SATURDAY",
   startHour: 7,
   startMinute: 0,
   endHour: 11,
   endMinute: 0,
   bidModifier: 1.1
});

Pour en savoir plus sur les valeurs autorisées pour chaque paramètre, ainsi que sur les restrictions supplémentaires à prendre en compte lors de la création de programmations d'annonces, consultez notre documentation.

Supprimer

Vous pouvez supprimer un calendrier de diffusion des annonces à l'aide de sa méthode remove. Pour réinitialiser le calendrier de diffusion personnalisé d'une campagne, vous pouvez supprimer tous ses calendriers de diffusion personnalisés comme suit :

const adSchedules = campaign.adSchedules().get();
for (const adSchedule of adSchedules) {
  adSchedule.remove();
}

Zones

Vous pouvez également cibler ou exclure des zones géographiques pour votre campagne à l'aide de scripts Google Ads.

Récupérer

Vous pouvez récupérer la liste des zones géographiques ciblées à l'aide de la méthode targetedLocations des cibles de la campagne. Les zones exclues peuvent être récupérées à l'aide de la méthode excludedLocations. L'extrait de code suivant sélectionne tous les lieux ciblés qui ont enregistré plus de 100 impressions le mois dernier.

const locations = AdsApp.targeting()
  .targetedLocations()
  .withCondition("metrics.impressions > 100")
  .forDateRange("LAST_MONTH")
  .orderBy("metrics.clicks DESC")
  .get();

for (const location of locations) {
 // Process the campaign target here.
 ...
}

Si vous avez configuré votre campagne pour qu'elle soit diffusée dans tous les pays et régions, vous obtiendrez une liste vide de zones géographiques.

Mettre à jour

Une fois que vous avez récupéré un lieu, vous pouvez modifier directement ses propriétés. Par exemple, vous pouvez modifier le modificateur d'enchères d'un établissement comme suit :

location.setBidModifier(1.1);

Créer

Vous pouvez créer des cibles géographiques dans une campagne à l'aide de sa méthode addLocation. De même, vous pouvez exclure une zone à l'aide de la méthode excludeLocation. L'extrait de code suivant cible une campagne pour les États-Unis avec un modificateur d'enchères de 1,15, tout en excluant New York.

campaign.addLocation(2840, 1.15);     // United States
campaign.excludeLocation(1023191);    // New York city

Pour obtenir la liste des ID à utiliser lorsque vous ajoutez le ciblage géographique, vous pouvez consulter la documentation sur le ciblage géographique de l'API Google Ads. Pour suivre les performances de vos cibles géographiques, vous pouvez effectuer une recherche sur la ressource location_viewReport.

Supprimer

Vous pouvez supprimer une cible géographique à l'aide de la méthode remove.

Proximités

Vous pouvez cibler une campagne sur un rayon (proximité) autour d'un lieu à l'aide de scripts Google Ads.

Récupérer

Vous pouvez récupérer la liste des proximités ciblées à l'aide de la méthode targetedProximities sur les cibles de la campagne. L'extrait de code suivant sélectionne toutes les proximités ciblées qui ont généré plus de 100 impressions le mois dernier.

const proximities = AdsApp.targeting()
    .targetedProximities()
    .withCondition("metrics.impressions > 100")
    .forDateRange("LAST_MONTH")
    .orderBy("metrics.clicks DESC")
    .get();

for (const proximity of proximities) {
  ...
}

Créer

Vous pouvez créer une cible de proximité pour une campagne à l'aide de sa méthode addProximity. L'extrait de code suivant cible une campagne sur un rayon de 20 kilomètres autour des coordonnées (37.423021, -122.083739).

campaign.addProximity(37.423021, -122.083739, 20, "KILOMETERS");

Vous pouvez également utiliser cette méthode pour créer la même cible de proximité avec un modificateur d'enchères et une adresse :

campaign.addProximity(37.423021, -122.083739, 20, "KILOMETERS", {
  bidModifier: 1.15,
  address: {
    streetAddress: "1600 Amphitheatre Parkway",
    cityName: "Mountain View",
    provinceName: "California",
    provinceCode: "CA",
    postalCode: "94043",
    countryCode: "US"
  }
});

N'oubliez pas qu'aucune validation ne permet de vérifier que l'adresse appartient réellement à la latitude et à la longitude indiquées. L'adresse n'a d'autre but que de modifier ce qui s'affiche dans l'interface de gestion des campagnes.

Supprimer

Vous pouvez supprimer une cible de proximité à l'aide de sa méthode remove.

Plates-formes

Vous pouvez récupérer la liste des plates-formes ciblées par une campagne à l'aide de la méthode platforms des cibles de la campagne. Étant donné que les campagnes Google Ads ciblent toutes les plates-formes (ordinateur, mobile et tablette), vous ne pouvez pas ajouter ni supprimer de critère Platform. L'utilisation la plus courante de ce critère de ciblage consiste à définir l'ajustement des enchères en fonction de l'appareil de votre campagne :

campaign.targeting()
    .platforms()
    .mobile()
    .get()
    .next().
    setBidModifier(1.2);

Les ID de plate-forme sont partagés entre les campagnes et ont des valeurs prédéfinies, comme indiqué dans l'annexe sur les plates-formes de l'API Google Ads. Ces ID peuvent être utiles lors de l'analyse des rapports. Lorsque vous sélectionnez des critères directement, vous pouvez utiliser les méthodes d'assistance fournies par PlatformSelector.