Bu kılavuzda, Maksimum Performans kampanyaları oluşturan ve güncelleyen istekleri yapılandırmanın incelikleri 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 sorun giderme kılavuzu ve Maksimum Performans toplu işleme kılavuzu için yardımcı 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ınlanabilmesi için minimum sayıda kaynak gerekir.
- Kampanya bütçesi
- Kampanya
- Kampanya öğeleri (yalnızca marka kuralları etkinleştirilmiş kampanyalar için)
- Öğe grupları
- Öğe grubu öğeleri
- Assets
Marka kurallarının etkin olduğu kampanyalarda, Campaign ve gerekli CampaignAsset kaynaklarını oluşturma işlemleri tek bir isteğe dahil edilmeli ve CampaignAsset kaynakları minimum öğe koşullarını ve spesifikasyonlarını karşılamalıdır.
AssetGroup ve AssetGroupAsset öğelerini oluşturma işlemlerinin tek bir isteğe birlikte dahil edilmesi ve AssetGroupAsset kaynaklarının tüm minimum öğe koşullarını ve spesifikasyonlarını karşılayacak şekilde birleştirilmesi gerektiğini unutmayın. Perakende kampanyalarında bu durumun nasıl farklı olduğunu inceleyin.
Gerekli tüm AssetGroupAsset varlıkları 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ırmak için farklı seçenekler vardır. İşlemlerin nasıl gruplandırılacağı ve isteklerin nasıl yapılandırılacağı büyük ölçüde hedeflerinize ve altyapınıza bağlıdır.
AssetGroupveAssetGroupAssetkaynaklarını oluşturmadan önceCampaignBudget,Campaign,AssetveCampaignAssetkaynaklarını ayrı isteklerde oluşturun. (Marka kurallarının etkinleştirildiği kampanyalardaCampaignve gerekliCampaignAssetkaynakları tek bir istekte birlikte eklenmelidir)- Bu kaynakların tümünü tek bir değişiklik isteğine dahil edin.
CampaignBudget, Campaign, Asset ve CampaignAsset kaynaklarını ayrı ayrı önceki isteklerde başarıyla oluşturabilseniz de Maksimum Performans kampanyası, AssetGroup ve AssetGroupAsset kaynakları da oluşturulana kadar yayınlanmaya uygun olmaz.
Geçerli bir yayın yapan Maksimum Performans kampanyası için minimum koşullar
Diyagramda 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şlemlerini 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 farklı yolu olması açısından benzersizdir:
- Özel öğe içermeyen (veya yalnızca HTML5
MEDIA_BUNDLEöğeleri içeren) öğe grupları - Gerekli tüm öğeleri içeren öğe grupları (tercih edilen)
Öğ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 öğe sağlamanızı öneririz. Maksimum Performans perakende kampanyalarının yayınlanabilmesi için aşağıdaki minimum kaynak grubunun sağlanması gerekir:
CampaignBudgetCampaign(ShoppingSettingdoldurulmuş)AssetGroupAssetGroupListingGroupFilter
Perakende kampanyalarında Campaign.shopping_setting alanı doldurulmalıdır. Ayrıca, AssetGroup içinde listelenen tüm final_urls, Campaign.shopping_setting içinde belirtilen Merchant Center hesap kimliğiyle ilişkili web sitesi alanıyla eşleşmelidir. Son olarak, her AssetGroup bir veya daha fazla AssetGroupListingGroupFilter kaynağından oluşan ilişkili ve geçerli bir ürün listeleme grubu ağacına sahip olmalıdır. Belirtilen Merchant Center feed'inizdeki tüm ürünleri hesaba katmak için en azından tek düğümlü bir ağaç oluşturmanız gerekir.
Bu kaynakların her biri ayrı ayrı veya tek bir istekte oluşturulabilir. Ancak kampanya, bu kaynakların tümü doğru şekilde oluşturulana kadar yayınlanmaya uygun olmaz.
Geçerli bir yayın yapan Maksimum Performans perakende kampanyası için minimum koşullar
Maksimum Performans perakende kampanyaları, standart Maksimum Performans kampanyalarında kullanılabilen tüm seçeneklerden yararlanabilir. Öğe grubu sinyalleri, kampanya dönüşüm hedefleri ve kampanya ölçütleri oluşturma bu seçenekler arasındadır. AssetGroup kaynağını oluştururken AssetGroup öğesine özel öğeler (HTML5 MEDIA_BUNDLE öğeleri dışında) eklemeyi seçerseniz isteğinizin tüm minimum öğe koşullarını (marka kuralları etkinse kampanya düzeyindeki marka varlıkları dahil) karşılaması gerekir. Başka bir deyişle, özel öğe eklemeyin veya gerekli tüm öğeleri ekleyin.
Ek seçenekler içeren Maksimum Performans perakende kampanyası
Geçersiz durum ile geçersiz istekler arasındaki fark
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ırılma şekli nedeniyle yayınlanmaya uygun değil. Örneğin,
advertising_channel_typedeğeriPERFORMANCE_MAXolan bağımsız birCampaignkaynağı oluşturabilirsiniz. Kampanya oluşturma isteği başarılı olsa da kampanyaya en az birAssetGroupekleyene kadar kampanya yayınlanmaya uygun olmaz. İstekleriniz başarılı olmasına rağmen kampanyanız veya öğe gruplarınız yayınlanmıyorsa sorun giderme kılavuzunda ayrıntılı olarak açıklandığı şekildeCampaignPrimaryStatus,CampaignPrimaryStatusReason,AssetGroupPrimaryStatusveAssetGroupPrimaryStatusReasonkullanarak nedenini belirleyebilirsiniz. - 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 (Yerel Hizmetler Maksimum Performans kampanyaları hariç) için
AssetGroupoluşturmaya çalışırsanız Google Ads API bir hata verir. Bu nedenle, aynı istekte birAssetGroupveAssetGroupAssetkaynaklarını eklemeniz gerekir. Bu aynı zamanda, isteğin tamamının başarısız olmasını önlemek için tümAssetGroupAssetkaynaklarınızın belirli birfield_typeiçin doğru spesifikasyonları karşılaması gerektiği anlamına gelir.
Değişiklik istekleriyle işlemleri gruplandırma
Maksimum Performans kampanyaları birden fazla kaynaktan oluşur. Bu ayrı kaynakları benzersiz isteklerde veya tek bir toplu değişiklik isteğinde oluşturabilirsiniz. Ancak standart Maksimum Performans kampanyalarındaki AssetGroups ve ilişkili AssetGroupAssets, daha önce belirtildiği gibi tek bir atomik istekte oluşturulmalıdır.
Bu kılavuzda belirtilen tüm gerekli kaynakları başarıyla oluşturana kadar kampanyanız yayınlanmaya uygun değildir. 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şiklik 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şiklik isteği kullanıp kullanmadığınıza bakılmaksızın, isteklerinizi ve işlemlerinizi hiçbir zaman oluşturulmadan önce bir kaynağa referans vermeyecek şekilde sıralamanız gerekir. Toplu değişiklik isteklerinde bu, işlemlerin, referans verilen kaynakların kendilerine referans veren kaynaklardan önce listeleneceği şekilde sıralanması anlamına gelir.
AssetGroup ve AssetGroupAsset kaynaklarını oluşturan aynı toplu değişiklik isteğinde öğe kaynakları oluşturmayı seçerseniz diyagramda gösterildiği gibi tüm AssetOperations, tüm AssetGroupAssetOperations kaynaklarından önce gelmelidir.
Google Ads sunucusu, ardışık AssetGroupAssetOperations işlemlerini gruplandırır ve bu gruptaki son işlemden sonra AssetGroup öğesinin minimum öğe şartlarını karşılayıp karşılamadığını değerlendirir. İsteğinizde AssetOperations ve AssetGroupAssetOperations arasında geçiş yaparsanız API sunucusu, ilk AssetGroupAssetOperation işleminden sonra minimum öğe şartlarını değerlendirir ve istekteki diğer işlemlere devam etmeden hata döndürür. Bu nedenle, istekteki öğelerin hiçbiri Google Ads hesabınıza eklenmez. Ayrıca, AssetGroup ve ilişkili AssetGroupAsset kaynaklarından hiçbiri oluşturulmaz.
Öğe gruplarını güncelleme
Geçerli bir AssetGroup oluşturduktan sonra, bir öğe grubunu minimum öğe koşullarının altına düşürecek başka istekler gönderemezsiniz. Bu tür istekler hata verir. Örneğin, tek bir MARKETING_IMAGE (minimum koşul) içeren bir AssetGroup oluşturursanız yalnızca bu MARKETING_IMAGE
AssetGroupAsset öğesini kaldırma isteği hata döndürür. Ancak Maksimum Performans perakende kampanyalarında, tek bir istekte tüm özel AssetGroupAsset bağlantılarını kaldırarak Google Merchant Center'ın otomatik olarak üretilmiş öğelerini kullanmaya devam edebilirsiniz.AssetGroup
İlişkili özel öğeler olmadan oluşturulan Maksimum Performans perakende kampanyalarındaki öğe grupları için, özel öğeleri (HTML5 MEDIA_BUNDLE öğeleri hariç) bağlamaya yönelik sonraki isteklerde AssetGroup üzerinde en az bir final_urls ayarlandığından emin olunmalıdır (başlangıçta atlandıysa önce doldurulur) ve tüm minimum gerekli öğeler (marka kuralları etkinse kampanya düzeyindeki marka öğeleri dahil) tek bir atomik istekte sağlanmalıdır. YOUTUBE_VIDEO gibi isteğe bağlı öğeleri tek başına bağlamayın veya ayrı istekler üzerinden kademeli olarak öğe eklemeyin. Yalnızca isteğe bağlı özel öğelerin bağlanması, öğe grubunu desteklenmeyen bir durumda bırakır ve Google Ads kullanıcı arayüzünde düzenleme yapılmasını engeller. Ayrıntılar için Maksimum Performans perakende kampanyalarında öğe gruplarını öğelere bağlama başlıklı makaleyi inceleyin.