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ı incelemeniz, değiştirmeniz ve iyileştirmeniz gerekir.

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 değerine 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

Dikkat: gbp_enabled ve image_enabled parametreleri desteklenmez ve bir istekte true olarak ayarlanırsa hatalara neden olur. Her iki alanı da boş bırakın veya false olarak ayarlayın.

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. Taslak öğeler oluşturulmadan 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 (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ı ayarlanmadan bırakın veya false olarak ayarlayın. true olarak ayarlanması desteklenmez ve SmartCampaignError.GBP_ENABLED_GENERATE_PMAX_NOT_SUPPORTED hatası döndürülü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 varlıklarının 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: Dönüşüm kontrolü tarafından döndürülen doğrulama bilgileri veya olası dönüşüm sorunları (validate_only, true olarak ayarlandığında ve validate_only, false olduğunda oluşturulan varlık kaynak adlarıyla birlikte doldurulur).

Önerilen iş akışı

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: Maksimum Performans kampanyası taslağı 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.

Not: gbp_enabled ve image_enabled gelecekteki bir sürümde etkinleştirildiğinde GİP konumlarını ve resim öğelerini de otomatik olarak taşıyabileceksiniz.