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

v25 ve sonraki sürümlerde, 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 yöntemini çağırdığınızda API, istekte sağlanan Akıllı kampanyanın yapılandırmasına göre taslak bir Maksimum Performans kampanyası, bütçe, öğe grubu ve öğeler oluşturur. Oluşturulduktan sonra, kampanyanın reklam yayınlamasını etkinleştirmeden önce yeni kaynakları incelemeli, değiştirmeli ve geliştirmelisiniz.

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

  • status, PAUSED olarak ayarlandı.
  • Yayınlanma uygunluğu primary_status bölümünde gösterilir.
  • contains_eu_political_advertising, varsayılan olarak DOES_NOT_CONTAIN_EU_POLITICAL_ADVERTISING olarak ayarlanır (Akıllı kampanyada daha önce belirtilmemişse). Kampanyanızda AB siyasi reklamcılığı varsa bu alanı doğrulayıp güncelleyin.

Bu sayede, kampanyayı reklam yayınlayacak şekilde etkinleştirmeden önce oluşturulan Maksimum Performans kampanyasını, bütçeyi, öğe grubunu ve öğeleri inceleyebilir, değiştirebilir ve iyileştirebilirsiniz.

Taslak öğeler

Yeni kampanyada, yeni kampanya etkinleştirilmeden önce değiştirilmesi gereken bir grup yer tutucu görsel bulunur. image_enabled alanı desteklendiğinde ve istekte true olarak ayarlandığında API, yer tutucu resimler kullanmak yerine otomatik olarak resim oluşturur. Yanıtın assets alanındaki yeni öğeleri inceleyebilir ve aşağıdaki adımları uygulayarak bunları değiştirebilirsiniz:

  1. Öğe koşulları kılavuzunu inceleyin.
  2. Resim öğesi yükleme örneğini uygulayarak yeni resimler yükleyin.
  3. Yeni öğeleri taslak kampanyanın öğe grubuna bağlayın ve ardından öğe gruplarını öğelere bağlama kılavuzunu uygulayarak yer tutucu resimlerin AssetGroupAsset bağlantılarını kaldırın (aynı atomik değişiklik isteğinde veya yeni öğeleri bağladıktan sonra, minimum öğe koşulları karşılanmaya devam edecek şekilde).

İ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ı. Ş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ıttaki 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ıyla bağlantılı Google İşletme Profili (GİP) konumunun dönüştürülüp dönüştürülmeyeceği. Bu alanı ayarlanmamış olarak bırakın veya false olarak ayarlayın. true olarak ayarlamak desteklenmez 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 olarak ayarlayın. true olarak ayarlanması desteklenmez ve SmartCampaignError.IMAGE_ENABLED_GENERATE_PMAX_NOT_SUPPORTED hatası döndürülü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).

Akıllı kampanyaları 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ış olarak SmartCampaignSettingService.GeneratePMaxDraftCampaign yöntemini ç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ğundan 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 değerini ENABLED olarak güncelleyin, ardından yinelenen yayınları önlemek için orijinal Akıllı kampanyanın status değerini PAUSED olarak güncelleyin.
Önceki
Genel bakış
Sonraki
Öneri al