Akıllı kampanyaları Maksimum Performans kampanyalarına dönüştürme

v25 (v25.2 tarihinden itibaren) Akıllı kampanyaları Maksimum Performans kampanyalarına dönüştürmek için SmartCampaignSettingService.GeneratePMaxDraftCampaign yöntemini kullanabilirsiniz. Bu yöntem v24 ve önceki sürümlerde kullanılamaz.

Dönüşümün işleyiş şekli

SmartCampaignSettingService.GeneratePMaxDraftCampaign işlevini çağırdığınızda API, bir Akıllı Kampanya'nın yapılandırmasına dayalı bir Maksimum Performans kampanyası taslağı oluşturur.

Oluşturulan Maksimum Performans taslak kampanyası, status değeri PAUSED olarak ayarlanmış şekilde başlatılır (ve yayınlanmaya uygunluk durumu primary_status içinde yansıtılır). Tüm özellik dönüştürücüler Akıllı Kampanya için doğrulama işlemini geçemezse istek SmartCampaignError.GENERATE_PMAX_CONVERTERS_FAIL hatasıyla başarısız olur.

Bu sayede, kampanyanın reklam yayınlamasını etkinleştirmeden önce oluşturulan Maksimum Performans kampanyasını, bütçeyi, öğe grubunu ve öğeleri inceleyebilir, değiştirebilir ve geliştirebilirsiniz. Taslak Maksimum Performans kampanyası oluşturulduğunda orijinal Akıllı kampanya değiştirilmez veya duraklatılmaz. Orijinal Akıllı kampanya, siz manuel olarak duraklatana kadar etkin kalır.

İstek parametreleri

GeneratePMaxDraftCampaignRequest mesajı aşağıdaki alanları kabul eder:

• resource_name (Zorunlu): Dönüştürmek istediğiniz Akıllı kampanya için yeniden oluşturulacak SmartCampaignSetting öğesinin kaynak adı. Aşağıdaki biçimde olmalıdır:

  customers/customer_id/smartCampaignSettings/campaign_id
  

• validate_only (İsteğe bağlı): true ise istek doğrulanır ancak yürütülmez. Yanıtın validated_info alanında yalnızca doğrulama hataları, uyarılar veya olası dönüşüm sorunları döndürülür. Taslak öğeler oluşturulmaz.

• gbp_enabled (Desteklenmiyor): İsteğe bağlı. Maksimum Performans kampanyasına bağlı Google İşletme Profili (GİP) konumunun dönüştürülüp dönüştürülmeyeceği. Bu alanı ayarlanmadan bırakın veya false olarak ayarlayın. Bu alanı true olarak ayarlamak v25'de uygulanmaz ve SmartCampaignError.GBP_ENABLED_GENERATE_PMAX_NOT_SUPPORTED hatası döndürür.

• image_enabled (Desteklenmiyor): İsteğe bağlı. Gerekli Maksimum Performans kampanyası resimlerinin (ör. yatay, kare ve logo resim türleri) oluşturulup oluşturulmayacağı. Bu alanı ayarlanmadan bırakın veya false; true olarak ayarlamak v25'de uygulanmaz ve SmartCampaignError.IMAGE_ENABLED_GENERATE_PMAX_NOT_SUPPORTED hatası döndürür.

Yanıt ayrıntıları

GeneratePMaxDraftCampaignResponse mesajı, oluşturulan Maksimum Performans taslak kampanyasının ve ilişkili öğelerinin kaynak adlarını döndürür:

• pmax_campaign: Oluşturulan taslak Maksimum Performans kampanyasının Campaignkaynak adı.
• campaign_budget: Oluşturulan Maksimum Performans kampanyasına bağlı CampaignBudget kaynak adı.
• asset_group: Oluşturulan Maksimum Performans kampanyasına bağlı AssetGroup kaynak adı.
• assets: Oluşturulan Maksimum Performans kampanyasına bağlı Asset kaynak adlarının listesi.
• validated_info: Doğrulama bilgileri veya dönüşüm kontrolü tarafından döndürülen olası dönüşüm sorunları (hem validate_only, true olarak ayarlandığında hem de validate_only, false olduğunda oluşturulan öğe kaynak adlarıyla birlikte doldurulur).

Önerilen iş akışı

Bir Akıllı kampanyayı dönüştürmek için aşağıdaki iş akışını kullanın:

1. Taslak kampanyayı oluşturun: Yalnızca gerekli resource_name ayarlanmışken SmartCampaignSettingService.GeneratePMaxDraftCampaign çağrısı yapın (gbp_enabled ve image_enabled ayarlanmamış olarak bırakın veya false olarak ayarlayın). Döndürülen pmax_campaign, campaign_budget, asset_group ve assets kaynak adlarını kaydedin.
2. Kampanyayı inceleyin ve özelleştirin: Taslak Maksimum Performans kampanyası status = PAUSED ile oluşturulduğu için bütçesini, öğe grubunu ve öğelerini inceleyip yapılandırın.
3. Kampanyayı etkinleştirin ve orijinal kampanyayı duraklatın: Reklam yayınlamaya hazır olduğunuzda Maksimum Performans kampanyasının status ayarını ENABLED olarak güncelleyin, ardından orijinal Akıllı kampanyanın status ayarını PAUSED olarak güncelleyerek reklamların iki kez yayınlanmasını önleyin.