In v25 und höher können Sie mit der
SmartCampaignSettingService.GeneratePMaxDraftCampaign
Methode eine smarte Kampagne in eine Performance Max-Kampagne umwandeln. Diese Methode ist in v24 und niedriger nicht verfügbar.
So funktioniert die Umstellung
Wenn Sie
SmartCampaignSettingService.GeneratePMaxDraftCampaign aufrufen, generiert die
API eine Performance Max-Kampagne im Entwurfsmodus, ein Budget, eine Asset-Gruppe und Assets
basierend auf der Konfiguration der smarten Kampagne, die in der Anfrage angegeben ist. Nach der Generierung sollten Sie die neuen Ressourcen prüfen, ändern und optimieren, bevor Sie die Kampagne aktivieren, damit Anzeigen ausgeliefert werden können.
Die generierte Performance Max-Kampagne im Entwurfsmodus wird mit den folgenden Statuswerten initialisiert:
statusist aufPAUSEDgesetzt.- Die Berechtigung zur Anzeigenauslieferung wird in
primary_statusangegeben. contains_eu_political_advertisingist standardmäßig aufDOES_NOT_CONTAIN_EU_POLITICAL_ADVERTISINGgesetzt (sofern nicht bereits in der smarten Kampagne angegeben). Prüfen und aktualisieren Sie dieses Feld, wenn Ihre Kampagne politische Werbung in der EU enthält.
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, damit Anzeigen ausgeliefert werden können.
Asset-Entwürfe
Die neue Kampagne enthält eine Gruppe von Platzhalterbildern, die ersetzt werden müssen, bevor die neue Kampagne aktiviert wird. Wenn das Feld image_enabled unterstützt wird und in der Anfrage auf true gesetzt ist, generiert die API automatisch Bilder, anstatt Platzhalterbilder zu verwenden. Sie können die neuen Assets im Feld assets der Antwort prüfen und sie so ersetzen:
- Lesen Sie den Leitfaden zu den Asset-Anforderungen.
- Laden Sie neue Bilder hoch. Folgen Sie dazu dem Beispiel zum Hochladen von Bild-Assets .
- Verknüpfen Sie die neuen Assets mit der Asset-Gruppe des Kampagnenentwurfs und entfernen Sie dann die
AssetGroupAssetVerknüpfungen für die Platzhalterbilder. Das kann entweder in derselben atomaren Mutationsanfrage oder nach dem Verknüpfen der neuen Assets erfolgen, damit die Mindestanforderungen an Assets erfüllt bleiben. Folgen Sie dazu dem Leitfaden zum Verknüpfen von Asset-Gruppen mit Assets.
Anfrageparameter
Die GeneratePMaxDraftCampaignRequest Nachricht akzeptiert
die folgenden Felder:
resource_name(Erforderlich): Der Ressourcenname derSmartCampaignSetting, die für die smarte 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 Probleme bei der Umstellung 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 im Unternehmensprofil umgewandelt werden soll. Lassen Sie dieses Feld nicht festgelegt oderfalsesetzen Sie es auftruewird der FehlerSmartCampaignError.GBP_ENABLED_GENERATE_PMAX_NOT_SUPPORTEDzurückgegeben.image_enabled(Nicht unterstützt): Optional. Gibt an, ob die erforderlichen Bilder für die Performance Max-Kampagne generiert werden sollen (z. B. horizontale, quadratische und Logo-Bilder). Lassen Sie dieses Feld nicht festgelegt oderfalse. Wenn Sie es auftruesetzen, wird der FehlerSmartCampaignError.IMAGE_ENABLED_GENERATE_PMAX_NOT_SUPPORTEDzurückgegeben.
Antwortdetails
Die GeneratePMaxDraftCampaignResponse Nachricht
gibt die Ressourcennamen der generierten Performance Max-Kampagne im Entwurfsmodus und
der zugehörigen Einheiten zurück:
pmax_campaign: DerCampaignRessourcenname der generierten Performance Max-Kampagne im Entwurfsmodus.campaign_budget: DerCampaignBudget-Ressourcenname, der mit der generierten Performance Max-Kampagne verknüpft ist.asset_group: DerAssetGroupRessourcenname, der mit der generierten Performance Max-Kampagne verknüpft ist.assets: Eine Liste derAsset-Ressourcennamen, die mit der generierten Performance Max-Kampagne verknüpft sind.validated_info: Validierungsinformationen oder mögliche Probleme bei der Umstellung, die von der Umstellungsprüfung zurückgegeben werden. Dieses Feld wird sowohl festgelegt, wennvalidate_onlyauftruegesetzt ist, als auch zusammen mit den Ressourcennamen der generierten Einheit, wennvalidate_onlyauffalsegesetzt ist.
Empfohlener Workflow
So wandeln Sie eine smarte Kampagne um:
- Kampagne im Entwurfsmodus generieren: Rufen Sie
SmartCampaignSettingService.GeneratePMaxDraftCampaignauf und legen Sie nur das erforderliche Feldresource_namefest. Lassen Siegbp_enabledundimage_enablednicht festgelegt oder setzen Sie sie auffalse. Speichern Sie die zurückgegebenen Ressourcennamenpmax_campaign,campaign_budget,asset_groupundassets. - Kampagne prüfen und anpassen: Da die Performance Max
Kampagne im Entwurfsmodus mit
status = PAUSEDundcreation_status = INCOMPLETEerstellt wird, müssen Sie das Budget, die Asset Gruppe und die Assets prüfen und konfigurieren. - Kampagne aktivieren und ursprüngliche Kampagne pausieren: Wenn Sie bereit sind, Anzeigen auszuliefern, setzen Sie `status` der Performance Max-Kampagne auf `ENABLED` und dann `status` der ursprünglichen smarten Kampagne auf `PAUSED`, um doppelte Auslieferungen zu vermeiden.
statusstatusENABLEDPAUSED