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.
- Kampanya bütçesi
- Kampanya
- Kampanya öğeleri (yalnızca marka kurallarının etkin olduğu kampanyalar için)
- Öğe grupları
- Öğe grubu öğeleri
- Assets
Marka yönergelerinin etkin olduğu kampanyalarda, Campaign
oluşturma işlemleri ve gerekli CampaignAsset
kaynakları tek bir isteğe dahil edilmeli, CampaignAsset
kaynakları 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
veAssetGroupAsset
kaynaklarını oluşturmadan önceCampaignBudget
,Campaign
,Asset
veCampaignAsset
kaynaklarını ayrı isteklerde oluşturun. (Marka kurallarının etkin olduğu kampanyalardaCampaign
ve gerekliCampaignAsset
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
Ş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ı
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
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ı
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 birCampaign
kaynağı oluşturabilirsiniz. Kampanya oluşturma isteği başarılı olsa da kampanyaya en az birAssetGroup
ekleyene kadar yayınlanmaya uygun olmaz. İstemleriniz başarılı olsa da kampanyanız veya öğe gruplarınız yayınlanmıyorsaCampaignPrimaryStatus
,CampaignPrimaryStatusReason
,AssetGroupPrimaryStatus
veAssetGroupPrimaryStatusReason
'ı 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 birAssetGroup
veAssetGroupAsset
kaynaklarını eklemeniz gerekir. Bu, isteğin tamamının başarısız olmasını önlemek için tümAssetGroupAsset
kaynaklarınızın belirli birfield_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.
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.