İstekleri Yapılandırın

Bu kılavuzda, Maksimum Performans kampanyaları oluşturan ve güncelleyen istekleri yapılandırmanın birçok ayrıntısı 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 ile birlikte kullanılabilir.

Maksimum Performans kampanyaları oluşturma

Google Ads API'de Maksimum Performans kampanyası öğeleri, birkaç benzersiz kaynağın birleşimi olarak gösterilir.

Standart Maksimum Performans kampanyaları

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

Markalama kurallarının etkin olduğu kampanyalarda Campaign oluşturma işlemleri ve gerekli CampaignAsset kaynakları tek bir isteğe dahil edilmelidir. Ayrıca 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 gerektiğini ve AssetGroupAsset kaynaklarının birleştirilerek tüm minimum öğe koşullarının ve spesifikasyonlarının karşılanması gerektiğini unutmayın. Bu durumun perakende kampanyalarında nasıl farklı olduğunu görün. 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 başlıklı makaleyi inceleyin.

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ğı 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 etkinleştirildiği kampanyalarda, Campaign ve gerekli CampaignAsset kaynakları tek bir istekte birlikte gönderilmelidir.)
  • Bu kaynakların tümünü tek bir değiştirme isteğine dahil edin.

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

Geçerli bir Maksimum Performans kampanyasının yayınlanması için minimum koşullar

resim

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

AssetGroupSignal kaynaklarını oluşturma işlemlerini, AssetGroup ve AssetGroupAsset kaynaklarını oluşturan isteğe dahil edebilirsiniz. Alternatif olarak, AssetGroup oluşturulduktan sonra ayrı bir istekte AssetGroupSignal 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ı bakımından benzersizdir:

  • Öğesiz öğe grupları
  • Gerekli 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 kümesi gerekir.

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

Campaign.shopping_settings alanının perakende kampanyalarında doldurulması gerektiğini unutmayın. Ayrıca, her final_urls listelenen AssetGroup, Campaign.shopping_settings içinde belirtilen Merchant Center hesap kimliğiyle ilişkili URL'lerle eşleşmelidir. Son olarak, her AssetGroup, bir veya daha fazla AssetGroupListingGroupFilter kaynağının yer aldığı, ilişkilendirilmiş 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 bir düğüm ağacı oluşturmanız gerekir.

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

Geçerli bir yayın Maksimum Performans perakende kampanyası için minimum koşullar

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çeneklerden yararlanabilir. AssetGroup kaynağını oluştururken AssetGroup öğesine öğe eklemeyi seçerseniz AssetGroup, minimum öğe koşullarına tabi olur. Başka bir deyişle, hiçbir öğeyi veya gerekli tüm öğeleri ekleyebilirsiniz.

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

resim

Geçersiz durum ve geçersiz istekler arasındaki fark

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

Geçersiz eyalet
Kampanya, yapılandırma şekli nedeniyle yayınlanmaya uygun değil. Örneğin, PERFORMANCE_MAX advertising_channel_type ile 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 kampanya yayınlanmaya uygun olmaz. İstekleriniz başarılı olmasına rağmen kampanyanız veya öğe gruplarınız yayınlanmıyorsa CampaignPrimaryStatus, CampaignPrimaryStatusReason, AssetGroupPrimaryStatus ve AssetGroupPrimaryStatusReason kullanarak nedeni belirleyebilirsiniz. Ayrıntılı bilgi için sorun giderme kılavuzuna bakın.
Geçersiz istek
Kampanyayı veya kaynağı geçersiz bir duruma getireceği için başarılı olamayacak bir istek. Örneğin, Google Ads API, gerekli minimum öğeleri eklemeden perakende dışı bir kampanya için AssetGroup oluşturmaya çalışırsanız hata verir. Bu nedenle, aynı isteğe bir AssetGroup ve AssetGroupAsset kaynaklarını eklemeniz gerekir. Bu aynı zamanda, tüm isteğin başarısız olmasını önlemek için tüm AssetGroupAsset kaynaklarınızın belirli bir field_type için doğru spesifikasyonları karşılaması gerektiği anlamına da gelir.

Değiştirme istekleriyle grup işlemleri

Maksimum Performans kampanyaları birden fazla kaynaktan oluşur ve bu ayrı kaynakları benzersiz isteklerle veya tek bir toplu mutasyon isteğiyle oluşturma seçeneğiniz vardır. Ancak, standart Maksimum Performans kampanyalarındaki AssetGroups ve AssetGroupAssets, daha önce belirtildiği gibi tek bir atomik istekte 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 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ş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ğa oluşturulmadan önce asla referans vermeyecek şekilde sıralamanız gerekir. Toplu değiştirme isteklerinde bu, işlemleri, referans verilen kaynakların kendilerine referans veren kaynaklardan önce listeleneceği şekilde sıralamak anlamına gelir.

Bir AssetGroup ve AssetGroupAsset kaynaklarını oluşturan toplu mutasyon isteğiyle aynı anda öğe kaynakları oluşturmayı seçerseniz diyagramda gösterildiği gibi tüm AssetOperations, tüm AssetGroupAssetOperations'den önce gelmelidir.

resim

Google Ads sunucusu, art arda gelen AssetGroupAssetOperations işlemlerini birlikte gruplandırır ve bir AssetGroup işleminin, bu gruptaki son işlemden sonra 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'dan sonra minimum öğe koşullarını değerlendirir ve isteğin geri kalan işlemlerine 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 kaynaklardan 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 istekleri gönderemezsiniz. Bu tür istekler hata verir. Örneğin, tek bir MARKETING_IMAGE ile AssetGroup oluşturursanız (minimum şart), bu MARKETING_IMAGE ile ilişkili AssetGroupAsset öğesinin kaldırılmasına yönelik tüm istekler hata döndürür.

Bu durum, özellikle perakende kampanyalarındaki ilişkili öğeler olmadan oluşturulan öğe grupları için önemlidir. AssetGroup öğesine AssetGroupAsset kaynakları oluşturarak öğe ekleme istekleri yalnızca istek tüm öğe koşullarını karşılıyorsa başarılı olur. Başka bir deyişle, bu öğe gruplarına öğeleri artımlı olarak ekleyemezsiniz.

Önceki
Kampanya Ölçütü Raporları
Sonraki
Toplu işleme