In v25 (ab v25.2) können Sie die Methode SmartCampaignSettingService.GeneratePMaxDraftCampaign verwenden, um eine smarte Kampagne in eine Performance Max-Kampagne umzuwandeln. Diese Methode ist in v24 und früheren Versionen nicht verfügbar.
So funktioniert die Umstellung
Wenn Sie SmartCampaignSettingService.GeneratePMaxDraftCampaign aufrufen, wird in der API ein Entwurf für eine Performance Max-Kampagne auf Grundlage der Konfiguration einer Smart-Kampagne erstellt.
Der generierte Performance Max-Kampagnenentwurf wird mit status auf PAUSED initialisiert. Die Berechtigung für die Anzeigenauslieferung wird in primary_status angegeben. Wenn die Validierung aller Funktionskonverter für die smarte Kampagne fehlschlägt, schlägt die Anfrage mit dem Fehler SmartCampaignError.GENERATE_PMAX_CONVERTERS_FAIL fehl.
So können Sie die generierte Performance Max-Kampagne, das Budget, die Asset-Gruppe und die Assets prüfen, ändern und optimieren, bevor Sie die Kampagne aktivieren. Durch das Erstellen der Performance Max-Kampagne als Entwurf wird die ursprüngliche Smart-Kampagne nicht geändert oder pausiert. Sie bleibt aktiv, bis Sie sie manuell pausieren.
Anfrageparameter
Die Nachricht GeneratePMaxDraftCampaignRequest akzeptiert die folgenden Felder:
resource_name(Erforderlich): Der Ressourcenname desSmartCampaignSetting, der für die Smart-Kampagne, die Sie umwandeln möchten, neu generiert werden soll, im folgenden Format:customers/customer_id/smartCampaignSettings/campaign_idvalidate_only(Optional): Wenntrue, wird die Anfrage validiert, aber nicht ausgeführt. In der Antwort werden nur Validierungsfehler, Warnungen oder mögliche Conversion-Probleme im Feldvalidated_infozurückgegeben, ohne dass Entwurfseinheiten erstellt werden.gbp_enabled(Nicht unterstützt): Optional. Gibt an, ob der mit der Performance Max-Kampagne verknüpfte Standort des Unternehmensprofils umgewandelt werden soll. Lassen Sie dieses Feld leer oder legen Sie es auffalsefest. Die Einstellung auftrueist inv25nicht implementiert und gibt einenSmartCampaignError.GBP_ENABLED_GENERATE_PMAX_NOT_SUPPORTED-Fehler zurück.image_enabled(Nicht unterstützt): Optional. Gibt an, ob die erforderlichen Bilder für Performance Max-Kampagnen generiert werden sollen, z. B. horizontale, quadratische und Logo-Bilder. Lassen Sie dieses Feld leer oder legen Sie es auffalsefest. Die Einstellung auftrueist inv25nicht implementiert und gibt einenSmartCampaignError.IMAGE_ENABLED_GENERATE_PMAX_NOT_SUPPORTED-Fehler zurück.
Antwortdetails
Die Meldung GeneratePMaxDraftCampaignResponse gibt die Ressourcennamen des generierten Performance Max-Kampagnenentwurfs und der zugehörigen Entitäten zurück:
pmax_campaign: DerCampaign-Ressourcenname der generierten Performance Max-Kampagne.campaign_budget: Der RessourcennameCampaignBudget, der mit der generierten Performance Max-Kampagne verknüpft ist.asset_group: Der RessourcennameAssetGroup, der mit der generierten Performance Max-Kampagne verknüpft ist.assets: Eine Liste der Ressourcennamen vonAsset, die mit der generierten Performance Max-Kampagne verknüpft sind.validated_info: Validierungsinformationen oder mögliche Conversion-Probleme, die von der Conversion-Prüfung zurückgegeben werden (werden sowohl festgelegt, wennvalidate_onlyauftruegesetzt ist, als auch zusammen mit den generierten Ressourcennamen der Entität, wennvalidate_onlyfalseist).
Empfohlener Workflow
So wandeln Sie eine Smart-Kampagne um:
- Kampagnenentwurf erstellen: Rufen Sie
SmartCampaignSettingService.GeneratePMaxDraftCampaignmit nur den erforderlichenresource_nameauf (lassen Siegbp_enabledundimage_enablednicht festgelegt oder legen Sie sie auffalsefest). Speichern Sie die zurückgegebenen Ressourcennamenpmax_campaign,campaign_budget,asset_groupundassets. - Kampagne überprüfen und anpassen: Da die Performance Max-Kampagne im Entwurf mit
status = PAUSEDerstellt wird, sollten Sie das Budget, die Asset-Gruppe und die Assets prüfen und konfigurieren. - Kampagne aktivieren und ursprüngliche Kampagne pausieren: Wenn Sie Anzeigen schalten möchten, ändern Sie den
statusder Performance Max-Kampagne inENABLEDund denstatusder ursprünglichen Smart-Kampagne inPAUSED, um doppelte Auslieferungen zu vermeiden.