4.4 Gestion des campagnes
Introduction
Il est important de permettre aux marchands de modifier leur campagne une fois celle-ci créée. Les aspects les plus critiques qu'ils devraient pouvoir modifier sont les suivants:
- Budget
- État (mise en veille, activation, suppression)
- Ciblage géographique (recommandé, mais facultatif)
- Tout autre champ que vous avez inclus dans l'interface de création de campagne
Conseils sur l'expérience utilisateur
Afficher la liste des campagnes sur la page Vue d'ensemble et sur une page distincte dans le rapport sur les performances des campagnes Autorisez les utilisateurs à mettre en veille, supprimer et modifier des campagnes.
La modification d'une campagne doit permettre au marchand de modifier les mêmes champs que ceux qu'il a fournis lors de la création de la campagne. Voici un exemple:
Conseils techniques
Une fois que vous avez créé une campagne Performance Max pour le commerce, vous pouvez modifier les paramètres suivants:
- Nom de la campagne
- Budget de la campagne
- Campaign status
- Critères de ciblage de la campagne
Vous trouverez une présentation détaillée de la méthode de mutation des ressources dans le guide du développeur. Vous pouvez modifier une ressource spécifique à l'aide du point de terminaison du service exposé pour modifier cette ressource (par exemple, CampaignService.MutateCampaigns) ou effectuer une mutation sur plusieurs ressources différentes à l'aide de la fonctionnalité de mutation en masse disponible à l'aide du point de terminaison GoogleAdsService.Mutate.
Dans la mesure du possible, nous vous recommandons d'effectuer des modifications groupées afin de réduire le nombre d'opérations requises pour mettre à jour une campagne. Dans cette optique, vous devez concevoir votre architecture sur l'utilisation du point de terminaison GoogleAdsService.Mutate plutôt que sur des points de terminaison de ressources individuelles. Cela permet également d'étendre plus facilement les fonctionnalités à l'avenir.
Les exemples suivants supposent que les identifiants pertinents sont déjà stockés dans votre base de données locale.
Nom de la campagne
Pour mettre à jour le nom d'une campagne, vous devez modifier le champ Campaign.name.
Il ne doit pas contenir de caractères nuls (point de code 0x0), de saut de ligne NL (point de code 0xA) ni de retour chariot (point de code 0xD).
Budget de la campagne
Il est recommandé de mettre à jour un budget existant au lieu de le remplacer par un nouveau. Vous vous assurez ainsi que les dépenses de votre campagne sont conformes à vos attentes et n'entraînent pas de surdiffusion.
Vous ne devez mettre à jour que la valeur du budget et ne modifier aucun autre champ, ce qui augmente la valeur des dépenses quotidiennes.
Python
budget_resource_name = client.get_service(
"CampaignBudgetService"
).campaign_budget_path(customer_id, budget_id)
mutate_operation = client.get_type("MutateOperation")
campaign_budget = mutate_operation.campaign_budget_operation.update
campaign_budget.resource_name = budget_resource_name
# update the budget amount to the new value
campaign_budget.amount_micros = 50000000
client.copy_from(
mutate_operation.campaign_budget_operation.update_mask,
protobuf_helpers.field_mask(None, campaign_budget._pb),
)
return mutate_operation
Campaign status
Pour mettre à jour l'état (activer/mettre en veille/supprimer) d'une campagne, vous devez modifier le champ Campaign.status et attribuer l'état approprié à partir de l'énumération CampaignStatus.
Vous trouverez un exemple de modification de l'état d'une campagne dans l'exemple de code de la section Mettre à jour une campagne.
Critères de la campagne
Lors de la mise à jour des critères de la campagne, il vous suffit de fournir la possibilité de mettre à jour les critères exposés à l'utilisateur. Il s'agit au minimum du ciblage géographique et potentiellement linguistique. Vous trouverez un exemple de mise à jour d'un critère de campagne dans l'exemple de code pour mettre à jour le modificateur d'enchères du critère de campagne.
Pour mettre à jour les critères de ciblage géographique, remplacez CampaignCriterion.location par la valeur de la nouvelle constante de la cible géographique.
Python
criterion_rname = client.get_service(
"CampaignCriterionService"
).campaign_criterion_path(
customer_id, campaign_id, criterion_id
)
mutate_operation = client.get_type("MutateOperation")
campaign_criterion = mutate_operation.campaign_criterion_operation.update
campaign_criterion.resource_name = criterion_rname
# Set the geo to the update geo targeting
campaign_criterion.location.geo_target_constant = (
geo_target_constant_service.geo_target_constant_path("1022762")
) # Brooklyn
client.copy_from(
mutate_operation.campaign_criterion_operation.update_mask,
protobuf_helpers.field_mask(None, campaign_criterion._pb),
)
return mutate_operation
Pour mettre à jour les critères de ciblage linguistique, vous devez mettre à jour la valeur de CampaignCriterion.language avec la nouvelle constante de langue.
Python
campaign_criterion_service = client.get_service("CampaignCriterionService")
criterion_rname = campaign_criterion_service.campaign_criterion_path(
customer_id, campaign_id, criterion_id
)
mutate_operation = client.get_type("MutateOperation")
campaign_criterion = mutate_operation.campaign_criterion_operation.update
campaign_criterion.resource_name = criterion_rname
# Set the language to the updated language
# For a list of all language codes, see:
# https://developers.google.com/google-ads/api/data/codes-formats#languages
campaign_criterion.language.language_constant = (
googleads_service.language_constant_path("1000")
) # English
client.copy_from(
mutate_operation.campaign_criterion_operation.update_mask,
protobuf_helpers.field_mask(None, campaign_criterion._pb),
)
return mutate_operation