Convertir des campagnes intelligentes en campagnes PMax

Dans la version v25 et les versions ultérieures, 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 et les versions antérieures.

Fonctionnement de la conversion

Lorsque vous appelez SmartCampaignSettingService.GeneratePMaxDraftCampaign, l'API génère un brouillon de campagne Performance Max, un budget, un groupe de composants et des composants, en fonction de la configuration de la campagne intelligente fournie dans la requête. Une fois générées, vous devez inspecter, modifier et améliorer les nouvelles ressources avant d'activer la campagne pour diffuser des annonces.

La campagne brouillon Performance Max générée est initialisée avec les valeurs d'état suivantes :

• status est défini sur PAUSED.
• Son éligibilité à la diffusion est indiquée dans primary_status.
• contains_eu_political_advertising est défini sur DOES_NOT_CONTAIN_EU_POLITICAL_ADVERTISING par défaut (s'il n'est pas déjà spécifié dans la campagne intelligente). Vérifiez et mettez à jour ce champ si votre campagne contient de la publicité à caractère politique dans l'UE.

Cela vous permet d'inspecter, de modifier et d'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.

Composants brouillons

La nouvelle campagne est accompagnée d'un groupe d'images de substitution qui doivent être remplacées avant l'activation de la nouvelle campagne. Lorsque le champ image_enabled est accepté et défini sur true dans la requête, l'API génère automatiquement des images au lieu d'utiliser des images de substitution. Vous pouvez inspecter les nouveaux éléments dans le champ assets de la réponse et les remplacer en procédant comme suit :

1. Consultez le guide des exigences concernant les assets.
2. Importez de nouvelles images en suivant l'exemple Importer un composant Image.
3. Associez les nouveaux composants au groupe de composants de la campagne brouillon, puis supprimez les liens AssetGroupAsset des images de substitution (soit dans la même requête de modification atomique, soit après avoir associé les nouveaux composants afin de continuer à respecter les exigences minimales concernant les composants) en suivant le guide sur l'association des groupes de composants aux composants.

Paramètres de requête

Attention : Les paramètres gbp_enabled et image_enabled ne sont pas acceptés et provoquent des erreurs s'ils sont définis sur true dans une requête. Laissez les deux champs non définis ou définis sur false.

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. Seuls les erreurs de validation, les avertissements ou les éventuels problèmes de conversion sont renvoyés dans le champ validated_info de la réponse, sans créer d'entités brouillons.

• gbp_enabled (non compatible) : facultatif. Indique si l'établissement de la fiche d'établissement Google (GBP) associé à la campagne Performance Max doit être converti. Laissez ce champ non défini ou false. Le définir sur true n'est pas accepté et renvoie une erreur SmartCampaignError.GBP_ENABLED_GENERATE_PMAX_NOT_SUPPORTED.

• image_enabled (non compatible) : facultatif. Indique si vous souhaitez générer les images requises pour les campagnes Performance Max (par exemple, les types d'images horizontales, carrées et de logo). Laissez ce champ non défini ou false. Le définir sur true n'est pas possible et renvoie une erreur SmartCampaignError.IMAGE_ENABLED_GENERATE_PMAX_NOT_SUPPORTED.

Détails de la réponse

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

• pmax_campaign : nom de ressource Campaign de la campagne Performance Max générée en tant que brouillon.
• campaign_budget : nom de la ressource CampaignBudget associée à la campagne Performance Max générée.
• asset_group : nom de la ressource AssetGroup associée à la campagne Performance Max générée.
• assets : liste de 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 à la fois 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 le workflow ci-dessous :

1. Générez le brouillon de campagne : appelez SmartCampaignSettingService.GeneratePMaxDraftCampaign en définissant uniquement le champ obligatoire resource_name (laissez gbp_enabled et image_enabled non définis ou définis sur false). Enregistrez les noms de ressources pmax_campaign, campaign_budget, asset_group et assets renvoyés.
2. Examiner et personnaliser la campagne : étant donné que le brouillon de la campagne Performance Max est créé avec status = PAUSED et creation_status = INCOMPLETE, examinez et configurez son budget, son groupe de composants et ses composants.
3. Activer la campagne et mettre en veille la campagne d'origine : lorsque vous êtes prêt à diffuser des annonces, remplacez l'état (status) de la campagne Performance Max par ENABLED, puis remplacez l'état (status) de la campagne intelligente d'origine par PAUSED pour éviter les diffusions en double.

Remarque : Une fois que gbp_enabled et image_enabled seront activés dans une prochaine version, vous pourrez également migrer automatiquement les établissements et les composants Image de la fiche d'établissement Google.