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

Ciblage de la campagne

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

Calendriers de diffusion des annonces

Les calendriers de diffusion des annonces vous permettent de contrôler les périodes de diffusion de vos annonces.

Récupérer

Vous pouvez récupérer les calendriers 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. Par conséquent, aucun calendrier de diffusion des annonces ne peut être récupéré si vous n'avez pas défini de calendrier personnalisé pour votre campagne.

Mettre à jour

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

adSchedule.setBidModifier(1.1);

Créer

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

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

Consultez notre documentation pour en savoir plus sur les valeurs autorisées de chaque paramètre, ainsi que sur les restrictions supplémentaires à prendre en compte lors de la création de calendriers de diffusion des annonces.

Supprimer

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

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

Emplacements

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. Vous pouvez récupérer les zones géographiques exclues à l'aide de la méthode excludedLocations. L'extrait de code suivant sélectionne toutes les zones ciblées 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, la liste des zones géographiques que vous obtenez est vide.

Mettre à jour

Une fois que vous avez récupéré un établissement, vous pouvez modifier ses propriétés directement. Par exemple, vous pouvez mettre à jour le modificateur d'enchères d'une zone géographique en procédant 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 géographique à l'aide de la méthode excludeLocation. L'extrait de code suivant cible une campagne aux É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 un ciblage géographique, consultez 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 dans la ressource Rapport location_view.

Supprimer

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

Zones de proximité

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

Récupérer

Vous pouvez récupérer la liste des zones de proximité ciblées à l'aide de la méthode targetedProximities sur les cibles de la campagne. L'extrait de code suivant sélectionne toutes les zones de proximité ciblées qui ont reçu 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 zone de proximité ciblée 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 la même zone de proximité ciblée 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"
  }
});

Gardez à l'esprit qu'aucune vérification ne permet de vérifier que l'adresse appartient réellement à la latitude et à la longitude données. L'adresse sert uniquement à modifier ce qui s'affiche dans l'interface de gestion des campagnes.

Supprimer

Vous pouvez supprimer une zone de proximité ciblée à l'aide de la 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. Généralement, ce critère de ciblage est utilisé pour 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 leurs valeurs sont prédéfinies, comme spécifié dans l'annexe des plates-formes de l'API Google Ads. Ces ID peuvent être utiles lors de l'analyse des rapports. Lorsque vous sélectionnez directement les critères, vous pouvez utiliser les méthodes d'assistance fournies par PlatformSelector.