Bu kılavuzda, Maksimum Performans kampanyalarını oluşturan ve güncelleyen istekleri yapılandırmanın birçok karmaşık adımı ayrıntılı bir şekilde açıklanmaktadır. Bu, entegrasyonunuzu tasarlarken yararlı bir kaynak olabilir. Bu kılavuzda, Maksimum Performans kampanyalarını değiştiren isteklerin nasıl işlendiği açıklanmaktadır. Bu istekler, Maksimum Performans sorun giderme kılavuzu ve Maksimum Performans toplu işleme rehberinin tamamlayıcı bir kaynağı olabilir.
Maksimum Performans kampanyaları oluşturun
Google Ads API'de Maksimum Performans kampanyası varlıkları, birkaç benzersiz kaynağın kombinasyonu olarak gösterilir.
Standart Maksimum Performans kampanyaları
Standart Maksimum Performans kampanyalarının yayınlanması için minimum bir kaynak grubu gerekir.
AssetGroup
ve AssetGroupAsset
varlıklarını oluşturmaya yönelik işlemlerin tek bir istekte birlikte eklenmesi ve AssetGroupAsset
kaynaklarının tüm minimum öğe gereksinimlerini ve spesifikasyonlarını karşılayacak şekilde birleştirilmesi gerektiğini unutmayın. Perakende kampanyaları için bunun nasıl farklı olduğunu öğrenin. 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ünü inceleyin.
Maksimum Performans kampanyası 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ğına dair karar, büyük ölçüde hedeflerinize ve altyapınıza bağlıdır.
AssetGroup
veAssetGroupAsset
kaynaklarını oluşturmadan önceCampaignBudget
,Campaign
veAsset
kaynaklarını ayrı isteklerde oluşturun.- Bu kaynakların tümünü tek bir değişiklik isteğine ekleyin.
CampaignBudget
, Campaign
ve Asset
kaynaklarını önceki ayrı isteklerde başarıyla oluşturabilirsiniz ancak AssetGroup
ve AssetGroupAsset
kaynakları da oluşturulana kadar Maksimum Performans kampanyası yayınlanmaya uygun olmaz.
Yayınlanacak geçerli bir Maksimum Performans kampanyası için minimum koşullar
Ş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ı isteğe AssetGroupSignal
kaynakları oluşturma işlemleri ekleyebilirsiniz.
Alternatif olarak, AssetGroup
oluşturulduktan sonra ayrı bir istekte AssetGroupSignal
varlıklarını oluşturabilirsiniz.
Ek seçenekler içeren Maksimum Performans kampanyası
Perakende için Maksimum Performans kampanyaları
Perakende kampanyaları, geçerli bir yayınlama kampanyasıyla sonuçlanan öğe grupları oluşturmanın iki ayrı yolu olması açısından benzersizdir:
- Öğe içermeyen öğ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 envanterin tamamında erişecek öğeler sağlamanızı öneririz. Perakende için Maksimum Performans kampanyalarının yayınlanması için aşağıdaki minimum kaynak grubunun kullanılması gerekir.
CampaignBudget
Campaign
(ShoppingSettings
alanı doldurulur)AssetGroup
AssetGroupListingGroupFilter
Perakende kampanyalarında Campaign.shopping_settings
alanının doldurulması gerektiğini unutmayın. Ayrıca her bir AssetGroup
için belirtilen final_urls
, Campaign.shopping_settings
özelliğinde belirtilen Merchant Center hesap kimliğiyle ilişkili URL'lerle eşleşmelidir. Son olarak, her AssetGroup
bir veya daha fazla AssetGroupListingGroupFilter
kaynaktan oluşan ilişkili, geçerli bir ürün listeleme grubu ağacına sahip olmalıdır. En azından, belirtilen Merchant Center feed'inizdeki tüm ürünleri hesaba katmak için tek bir düğüm ağacı 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.
Yayınlanan geçerli bir Perakende Maksimum Performans kampanyası için minimum koşullar
Perakende kampanyaları; öğe grubu sinyalleri, kampanya dönüşüm hedefleri ve kampanya ölçütleri oluşturma dahil, standart Maksimum Performans kampanyalarında kullanılabilen tüm seçeneklerden yararlanabilir. AssetGroup
kaynağını oluştururken bir AssetGroup
öğesine öğe eklemeyi tercih ederseniz AssetGroup
öğeniz minimum öğe gereksinimlerine tabi olur. Diğer bir deyişle, hiç öğe ekleyebilir veya tüm gerekli öğeleri ekleyebilirsiniz.
Ek seçenekler içeren perakende Maksimum Performans kampanyası
Geçersiz durum ve geçersiz istekler karşılaştırması
Google Ads API'deki Maksimum Performans kampanyalarıyla çalışırken geçersiz durumlar ile geçersiz istekler arasında önemli bir fark vardır.
- Geçersiz durum
- Kampanya, yapılandırılma biçimi nedeniyle yayınlanmaya uygun değil. Örneğin,
advertising_channel_type
adetPERFORMANCE_MAX
olan bağımsız birCampaign
kaynağı oluşturabilirsiniz. Kampanya oluşturma isteği başarılı olsa da, kampanyaya en az birAssetGroup
eklenene kadar yayınlanmaya uygun olmaz. İstekleriniz başarılı olduğu halde kampanyanız veya öğe gruplarınız yayınlanmıyorsa nedenini belirlemek için sorun giderme kılavuzunda açıklandığı şekildeCampaignPrimaryStatus
,CampaignPrimaryStatusReason
,AssetGroupPrimaryStatus
veAssetGroupPrimaryStatusReason
kullanabilirsiniz. - Geçersiz istek
- Kampanyayı veya kaynağı geçersiz bir duruma getireceği için başarılı olamayacak bir istek. Örneğin, gerekli minimum öğe sayısını dahil etmeden perakende olmayan 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 aynı zamanda, isteğin tamamının başarısız olmasını önlemek amacıyla, tümAssetGroupAsset
kaynaklarınızın belirli birfield_type
için doğru spesifikasyonları karşılaması gerektiği anlamına gelir.
Değişim istekleriyle grup işlemleri
Maksimum Performans kampanyaları birden çok 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 atom isteğinde oluşturulmalıdır.
Bu kılavuzda belirtilen gerekli kaynakların tümünü 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şiklik istekleri gönderirken geçici kimliklerin kullanımıyla oluşturulan kaynak adlarını kullanın.
İşlem sırası
Maksimum Performans kampanyası oluşturmak için toplu değişiklik isteği kullanıyor olsanız da olmasanız da isteklerinizi ve işlemlerinizi, hiçbir zaman bir kaynak oluşturulmadan önce referans vermeyecek şekilde sıralamanız gerekir. Toplu değişiklik isteklerinde bu, işlemlerin, referans verilen kaynakların, referans verilen kaynaklardan önce listelendiği şekilde sıralanması anlamına gelir.
Öğe kaynaklarını, AssetGroup
ve AssetGroupAsset
kaynaklarını oluşturan aynı toplu değişiklik isteğinde oluşturmayı seçerseniz AssetOperations
öğelerinin tamamı, diyagramda gösterildiği gibi AssetGroupAssetOperations
değerlerinin tamamından önce gelmelidir.
Google Ads sunucusu art arda AssetGroupAssetOperations
öğesini birlikte toplu olarak işler ve ilgili gruptaki son işlemin ardından AssetGroup
öğesinin minimum öğe gereksinimlerini karşılayıp karşılamadığını değerlendirir. İsteğinizde AssetOperations
ile AssetGroupAssetOperations
arasında geçiş yaparsanız API sunucusu ilk AssetGroupAssetOperation
sonrasında minimum öğe gereksinimlerini değerlendirir ve istekteki diğer işlemlere devam etmeden bir hata döndürür. Bu nedenle, 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üncelle
Geçerli bir AssetGroup
oluşturduktan sonra, minimum öğe koşullarının artık karşılanmadığı geçersiz bir duruma yol açacak yeni istekler gönderemezsiniz. Bu tür istekler hata verir. Örneğin, tek bir MARKETING_IMAGE
ile AssetGroup
oluşturursanız (minimum koşul) bu MARKETING_IMAGE
ile ilişkili AssetGroupAsset
kaldırma istekleri hata döndürür.
Bu, özellikle ilişkili herhangi bir öğe olmadan oluşturulan perakende kampanyalarındaki öğe grupları söz konusu olduğunda önemlidir. AssetGroupAsset
kaynakları oluşturarak AssetGroup
için daha sonra yapılan öğe ekleme istekleri, yalnızca istek tüm öğe gerekliliklerini karşıladığında başarılı olur. Yani öğeleri bu öğe gruplarına aşamalı olarak ekleyemezsiniz.