Convertir des campagnes intelligentes en campagnes PMax

Dans v25 (à partir du v25.2), vous pouvez utiliser la méthode SmartCampaignSettingService.GeneratePMaxDraftCampaign pour convertir une campagne intelligente en campagne Performance Max. Cette méthode n'est pas disponible dans v24 ni les versions antérieures.

Fonctionnement des conversions

Lorsque vous appelez SmartCampaignSettingService.GeneratePMaxDraftCampaign, l'API génère une campagne Performance Max brouillon en fonction de la configuration d'une campagne intelligente.

La campagne Performance Max brouillon générée est initialisée avec son status défini sur PAUSED (et son éligibilité à la diffusion reflétée dans primary_status). Si tous les convertisseurs de composants échouent à la validation pour la campagne intelligente, la requête échoue avec une erreur SmartCampaignError.GENERATE_PMAX_CONVERTERS_FAIL.

Vous pouvez ainsi inspecter, modifier et améliorer la campagne Performance Max, le budget, le groupe de composants et les composants générés avant d'activer la campagne pour diffuser des annonces. La génération de la campagne Performance Max brouillon ne modifie ni ne met en veille la campagne intelligente d'origine, qui reste active jusqu'à ce que vous la mettiez en veille manuellement.

Paramètres de requête

Le message GeneratePMaxDraftCampaignRequest accepte les champs suivants :

• resource_name (obligatoire) : nom de ressource de l'SmartCampaignSetting à régénérer pour la campagne intelligente que vous souhaitez convertir, au format suivant :

  customers/customer_id/smartCampaignSettings/campaign_id
  

• validate_only (facultatif) : si la valeur est true, la requête est validée, mais pas exécutée. Seules les erreurs ou avertissements de validation, ou les problèmes de conversion potentiels sont renvoyés dans le champ validated_info de la réponse, sans créer d'entités brouillon.

• gbp_enabled (Non pris en charge) : facultatif. Indique si l'emplacement de la fiche d'établissement Google (FEG) associée à la campagne Performance Max doit être converti. Laissez ce champ non défini ou sur false. Le définir sur true n'est pas implémenté dans v25 et renvoie une erreur SmartCampaignError.GBP_ENABLED_GENERATE_PMAX_NOT_SUPPORTED.

• image_enabled (Non compatible) : facultatif. Indique si les images requises pour la campagne Performance Max doivent être générées (par exemple, les types d'images horizontales, carrées et de logo). Laissez ce champ non défini ou false. Si vous le définissez sur true, une erreur SmartCampaignError.IMAGE_ENABLED_GENERATE_PMAX_NOT_SUPPORTED est renvoyée, car cette valeur n'est pas implémentée dans v25.

Détails de la réponse

Le message GeneratePMaxDraftCampaignResponse renvoie les noms de ressources de la campagne Performance Max brouillon générée et de ses entités associées :

• pmax_campaign : nom de ressource Campaign de la campagne Performance Max brouillon générée.
• campaign_budget : nom de ressource CampaignBudget associé à la campagne Performance Max générée.
• asset_group : nom de ressource AssetGroup associé à la campagne Performance Max générée.
• assets : liste des noms de ressources Asset associés à la campagne Performance Max générée.
• validated_info : informations de validation ou problèmes de conversion potentiels renvoyés par la vérification de la conversion (renseignés lorsque validate_only est défini sur true et à côté des noms de ressources d'entité générés lorsque validate_only est défini sur false).

Workflow recommandé

Pour convertir une campagne intelligente, suivez la procédure ci-dessous :

1. Générez la campagne brouillon : appelez SmartCampaignSettingService.GeneratePMaxDraftCampaign avec uniquement l'ensemble resource_name requis (laissez gbp_enabled et image_enabled non définis ou définissez-les sur false). Enregistrez les noms de ressources pmax_campaign, campaign_budget, asset_group et assets renvoyés.
2. Vérifiez et personnalisez la campagne : comme la campagne Performance Max provisoire est créée avec status = PAUSED, vérifiez et configurez son budget, son groupe de composants et ses composants.
3. Activez la campagne et mettez en veille l'originale : lorsque vous êtes prêt à diffuser des annonces, définissez l'état status de la campagne Performance Max sur ENABLED, puis définissez l'état status de la campagne intelligente d'origine sur PAUSED pour éviter la diffusion en double.