İstekleri Yapılandırın

Bu kılavuzda, Maksimum Performans kampanyaları oluşturan ve güncelleyen isteklerin yapılandırılmasının birçok inceliği ayrıntılı olarak açıklanmaktadır. Entegrasyonunuzu tasarlarken faydalı bir kaynak olabilir. Bu kılavuzda, Maksimum Performans kampanyalarını değiştiren isteklerin nasıl işlendiği açıklanmaktadır. Bu kılavuz, Maksimum Performans ile ilgili sorun giderme kılavuzu ve Maksimum Performans toplu işleme kılavuzu'na eşlik eden bir kaynak olabilir.

Maksimum Performans kampanyaları oluşturma

Google Ads API'de Maksimum Performans kampanyası varlıkları, birkaç benzersiz kaynağın birleşimi olarak temsil edilir.

Standart Maksimum Performans kampanyaları

Standart Maksimum Performans kampanyalarının yayınlanması için minimum bir kaynak grubu gerekir.

Marka yönergelerinin etkin olduğu kampanyalarda, Campaign oluşturma işlemleri ve gerekli CampaignAssetkaynakları tek bir isteğe dahil edilmeli, CampaignAssetkaynakları ise minimum öğe koşullarını ve özelliklerini karşılamalıdır.

AssetGroup ve AssetGroupAsset öğelerini oluşturma işlemlerinin tek bir istekle birlikte dahil edilmesi ve AssetGroupAsset kaynaklarının tüm minimum öğe şartlarını ve özelliklerini karşılamak için birleştirilmesi gerektiğini unutmayın. Bunun perakende kampanyaları için nasıl farklı olduğunu öğrenin. Gerekli tüm AssetGroupAsset öğeleri olmadan AssetGroup oluşturma istekleri hatayla sonuçlanır. Daha fazla bilgi için Geçersiz durum ve geçersiz istekler bölümüne bakın.

Maksimum Performans kampanyaları oluşturan istekleri yapılandırma konusunda farklı seçenekler vardır. İşlemlerin nasıl gruplandırılacağı ve isteklerin nasıl yapılandırılacağı konusundaki karar büyük ölçüde hedeflerinize ve altyapınıza bağlıdır.

  • AssetGroup ve AssetGroupAsset kaynaklarını oluşturmadan önce CampaignBudget, Campaign, Asset ve CampaignAsset kaynaklarını ayrı isteklerde oluşturun. (Marka kurallarının etkin olduğu kampanyalarda Campaign ve gerekli CampaignAsset kaynakları tek bir isteğe birlikte dahil edilmelidir.)
  • Bu kaynakların tümünü tek bir değiştirme isteğine dahil edin.

CampaignBudget, Campaign, Asset ve CampaignAsset kaynaklarını ayrı öncelikli isteklerde başarıyla oluşturabilirsiniz ancak Maksimum Performans kampanyası, AssetGroup ve AssetGroupAsset kaynakları da oluşturulana kadar yayınlanmaya uygun olmaz.

Geçerli bir Maksimum Performans kampanyası yayınlamak için minimum şartlar

resim

Şemada gösterildiği gibi ek kaynaklar oluşturarak Maksimum Performans kampanyalarınızı daha da özelleştirebilirsiniz.

AssetGroup ve AssetGroupAsset kaynaklarını oluşturan aynı istekte AssetGroupSignal kaynakları oluşturma işlemleri ekleyebilirsiniz. Alternatif olarak, AssetGroup oluşturulduktan sonra ayrı bir istekte AssetGroupSignal öğeleri oluşturabilirsiniz.

Ek seçenekler içeren Maksimum Performans kampanyası

resim

Perakende için Maksimum Performans kampanyaları

Perakende kampanyaları, geçerli bir yayın kampanyasıyla sonuçlanan öğe grupları oluşturmanın iki ayrı yolu olması açısından benzersizdir:

  • Öğe içermeyen öğe grupları
  • GEREKLİ TÜM öğeleri içeren öğe grupları (tercih edilir)

Öğeleri öğe gruplarından hariç tutmayı seçtiğinizde Google, reklam oluşturmak için bağlı Merchant Center hesabınızda sağlanan öğeleri otomatik olarak kullanır. Ancak tüm envantere ulaşmak için öğeler sağlamanızı öneririz. Perakende için Maksimum Performans kampanyalarının yayınlanabilmesi için aşağıdaki minimum kaynak grubu gerekir.

  • CampaignBudget
  • Campaign (ShoppingSettings doldurulmuştur)
  • AssetGroup
  • AssetGroupListingGroupFilter

Perakende kampanyalarında Campaign.shopping_settings alanının doldurulması gerektiğini unutmayın. Ayrıca, her AssetGroup içinde listelenen final_urls, Campaign.shopping_settings içinde belirtilen Merchant Center hesap kimliğiyle ilişkili URL'lerle eşleşmelidir. Son olarak, her AssetGroup için bir veya daha fazla AssetGroupListingGroupFilter kaynağından oluşan ilişkilendirilmiş, geçerli bir ürün listeleme grubu ağacı olmalıdır. Belirttiğiniz Merchant Center feed'indeki tüm ürünleri hesaba katmak için en azından tek bir düğüm ağacı oluşturmanız gerekir.

Bu kaynakların her biri ayrı ayrı veya tek bir istekle oluşturulabilir. Ancak bu kaynakların tümü doğru şekilde oluşturulana kadar kampanya yayınlanmaya uygun olmaz.

Geçerli bir Perakende Maksimum Performans kampanyası yayınlamak için minimum şartlar

resim

Perakende kampanyaları, öğe grubu sinyalleri oluşturma, kampanya dönüşüm hedefleri ve kampanya ölçütleri dahil olmak üzere standart Maksimum Performans kampanyalarında kullanılabilen tüm seçenekleri kullanabilir. AssetGroup kaynağını oluştururken bir AssetGroup'e öğe eklemeyi seçerseniz AssetGroup'ünüz minimum öğe koşullarına tabi olur. Başka bir deyişle, hiçbir öğe veya gerekli tüm öğeleri ekleyebilirsiniz.

Ek seçenekler içeren Perakende Maksimum Performans kampanyası

resim

Geçersiz durum ve geçersiz istekler

Google Ads API'de Maksimum Performans kampanyalarıyla çalışırken geçersiz durumlar ile geçersiz istekler arasında önemli bir fark vardır.

Geçersiz eyalet
Kampanya, yapılandırması nedeniyle yayınlanmaya uygun değil. Örneğin, PERFORMANCE_MAX advertising_channel_type değerine sahip bağımsız bir Campaign kaynağı oluşturabilirsiniz. Kampanya oluşturma isteği başarılı olsa da kampanyaya en az bir AssetGroup ekleyene kadar yayınlanmaya uygun olmaz. İstemleriniz başarılı olsa da kampanyanız veya öğe gruplarınız yayınlanmıyorsa CampaignPrimaryStatus, CampaignPrimaryStatusReason, AssetGroupPrimaryStatus ve AssetGroupPrimaryStatusReason'ı kullanarak nedeni belirleyebilirsiniz. Ayrıntılar için sorun giderme kılavuzunu inceleyin.
Geçersiz istek
Kampanyayı veya kaynağı geçersiz bir duruma sokacağı için başarılı olmayacak bir istek. Örneğin, gerekli minimum öğeleri eklemeden perakende dışı bir kampanya için AssetGroup oluşturmaya çalışırsanız Google Ads API hata verir. Bu nedenle, aynı isteğe bir AssetGroup ve AssetGroupAsset kaynaklarını eklemeniz gerekir. Bu, isteğin tamamının başarısız olmasını önlemek için tüm AssetGroupAsset kaynaklarınızın belirli bir field_type için doğru özellikleri karşılaması gerektiği anlamına da gelir.

Grup işlemleri ve değiştirme istekleri

Maksimum Performans kampanyaları birden fazla kaynaktan oluşur ve bu ayrı kaynakları benzersiz isteklerde veya tek bir toplu değiştirme isteğinde oluşturabilirsiniz. Ancak standart Maksimum Performans kampanyalarındaki AssetGroups ve ilişkili AssetGroupAssets, daha önce belirtildiği gibi tek bir atomik istekle oluşturulmalıdır.

Bu kılavuzda belirtilen tüm gerekli kaynakları başarıyla oluşturana kadar kampanyanız yayınlanmaya uygun olmaz. Ayrı istekler gönderirken, sonraki isteklerde referans verilen kaynakların gerçek kaynak adlarını kullanın. Birden fazla işlem içeren toplu değiştirme istekleri gönderirken geçici kimlikler kullanılarak oluşturulan kaynak adlarını kullanın.

İşlem sırası

Maksimum Performans kampanyası oluşturmak için toplu değiştirme isteği kullanıp kullanmadığınızdan bağımsız olarak, isteklerinizi ve işlemlerinizi, bir kaynağı hiçbir zaman oluşturulmadan önce referans vermeyecek şekilde sıralamanız gerekir. Toplu değiştirme isteklerinde bu, işlemlerin, referans verilen kaynakların, kendilerine referans veren kaynaklardan önce listeleneceği şekilde sıralanmasını ifade eder.

Bir AssetGroup ve AssetGroupAsset kaynaklarını oluşturan aynı toplu değiştirme isteğinde öğe kaynakları oluşturmayı seçerseniz AssetOperations öğelerinin tümü, şemada gösterildiği gibi AssetGroupAssetOperations öğelerinin tümünden önce gelmelidir.

resim

Google Ads sunucusu, art arda gelen AssetGroupAssetOperations öğelerini gruplandırır ve bir AssetGroup öğesinin, ilgili gruptaki son işlemden sonra minimum öğe koşullarını karşılayıp karşılamadığını değerlendirir. İsteğinizde AssetOperations ve AssetGroupAssetOperations arasında geçiş yaparsanız API sunucusu, ilk AssetGroupAssetOperation'den sonra minimum öğe şartlarını değerlendirir ve istekteki diğer işlemlere devam etmeden hata döndürür. Sonuç olarak, istekteki öğelerin hiçbiri Google Ads hesabınıza eklenmez. Ayrıca, AssetGroup veya ilişkili AssetGroupAsset kaynaklarından hiçbiri oluşturulmaz.

Öğe gruplarını güncelleme

Geçerli bir AssetGroup oluşturduktan sonra, minimum öğe koşullarının artık karşılanmadığı geçersiz bir duruma neden olacak sonraki istekler gönderemezsiniz. Bu tür istekler hata verir. Örneğin, tek bir MARKETING_IMAGE içeren bir AssetGroup oluşturursanız (minimum şart) bu MARKETING_IMAGE ile ilişkili AssetGroupAsset'yi kaldırma isteklerine hata mesajı döndürülür.

Bu, özellikle ilişkili öğe olmadan oluşturulan perakende kampanyalarındaki öğe grupları için önemlidir. AssetGroupAsset kaynakları oluşturarak AssetGroup'e öğe eklemeyle ilgili sonraki istekler yalnızca istek tüm öğe şartlarını karşılıyorsa başarılı olur. Diğer bir deyişle, bu öğe gruplarına kademeli olarak öğe ekleyemezsiniz.