Cette page a été traduite par l'API Cloud Translation.

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. La compatibilité est disponible pour les calendriers d'annonces, les zones géographiques ciblées et exclues, les proximités ciblées et les plates-formes. Ce guide explique comment utiliser les cibles de campagne.

Calendriers de diffusion des annonces

Les calendriers 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 calendriers de diffusion des annonces 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 d'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 ne recevrez donc aucun calendrier de diffusion si vous n'avez pas défini de calendrier de diffusion personnalisé 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 modifier le modificateur d'enchère d'un calendrier de diffusion d'annonces comme suit:

adSchedule.setBidModifier(1.1);

Créer

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

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 calendriers d'annonces, consultez notre documentation.

Supprimer

Vous pouvez supprimer un calendrier de diffusion des annonces à l'aide de la méthode remove. Pour réinitialiser le calendrier de diffusion des annonces personnalisées d'une campagne, vous pouvez supprimer tous ses calendriers de diffusion des annonces personnalisées 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 emplacements ciblés à l'aide de la méthode targetedLocations des cibles de la campagne. Les zones géographiques exclues peuvent être récupérées à l'aide de la méthode excludedLocations. L'extrait de code suivant sélectionne tous les emplacements ciblés ayant 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 défini votre campagne pour qu'elle soit diffusée dans tous les pays et régions, vous obtiendrez une liste vide d'emplacements.

Mettre à jour

Une fois que vous avez récupéré un emplacement, vous pouvez modifier directement ses propriétés. Par exemple, vous pouvez modifier le modificateur d'enchère 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 la 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ère 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 un ciblage géographique, consultez la documentation sur le ciblage géographique de l'API Google Ads. Pour suivre les performances de vos zones géographiques cibles, vous pouvez effectuer une recherche dans la ressource location_view Rapport.

Supprimer

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

Proximités

Vous pouvez cibler une campagne dans 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 ayant enregistré 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 la méthode addProximity. L'extrait de code suivant cible une campagne dans 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 le même ciblage de proximité avec un modificateur d'enchère 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 n'est effectuée pour vérifier que l'adresse appartient bien à la latitude et à la longitude indiquées. L'adresse n'a aucune utilité, si ce n'est 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.