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

v25_2 sürümünden itibaren Google Ads API, Akıllı kampanyaları Maksimum Performans kampanyalarına dönüştürmenize yardımcı olmak için SmartCampaignSettingService.GeneratePMaxDraftCampaign yöntemini kullanıma sunuyor.

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

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

Oluşturulan Maksimum Performans taslak kampanyası aşağıdaki durum değerleriyle başlatılır:

  • status, PAUSED olarak ayarlanır.
  • creation_status, INCOMPLETE olarak ayarlanır.

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.

İstek parametreleri

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

  • resource_name (Zorunlu): Dönüştürmek istediğiniz mevcut Akıllı kampanya ile ilişkili SmartCampaignSetting kaynağının adı. Şu 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.

  • gbp_enabled (Şu anda desteklenmemektedir): Akıllı kampanya ile ilişkili Google İşletme Profili (GİP) konumunun, oluşturulan Maksimum Performans kampanyasına dönüştürülüp bağlanacağı. Bu alanı true olarak ayarlama şu anda uygulanmamaktadır ve GBP_ENABLED_GENERATE_PMAX_NOT_SUPPORTED hatası döndürür.

  • image_enabled (Şu anda desteklenmemektedir): Maksimum Performans kampanyası için gerekli resimlerin (ör. yatay, kare ve logo resim öğeleri) otomatik olarak oluşturulup oluşturulmayacağı. Bu alanı true olarak ayarlama şu anda uygulanmamaktadır ve IMAGE_ENABLED_GENERATE_PMAX_NOT_SUPPORTED hatası döndürür.

Yanıt ayrıntıları

GeneratePMaxDraftCampaignResponse mesajı, yeni 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 Campaign kaynak 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: validate_only, true olarak ayarlandığında ek doğrulama bilgileri veya olası dönüşüm sorunları döndürülür.

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 işlevini çağırı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 ve creation_status = INCOMPLETE ile oluşturulduğu için bütçesini, öğe grubunu ve öğelerini inceleyip yapılandırın.
  3. Kampanyayı etkinleştirin: Reklam yayınlamaya hazır olduğunuzda kampanyanın status ayarını ENABLED, creation_status ayarını ise COMPLETE olarak güncelleyin.