İstekleri Yapılandırın

Bu kılavuzda, Maksimum Performans kampanyaları oluşturan ve güncelleyen istekleri yapılandırmanın birçok inceliği ayrıntılı olarak açıklanmaktadır. Bu, 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 ve Maksimum Performans sorun giderme kılavuzunu tamamlayıcı bir kaynak olabilir.

Maksimum Performans kampanyaları oluşturun

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

Standart Maksimum Performans kampanyaları

Standart Maksimum Performans kampanyalarının yayınlanması için minimum sayıda kaynak gerekir.

AssetGroup ve AssetGroupAsset varlıklarını oluşturma işlemlerinin tek bir istekte birlikte dahil edilmesi ve AssetGroupAsset kaynaklarının tüm minimum öğe gereksinimleri ve spesifikasyonlarını karşılamak için birleştirilmesi gerektiğini unutmayın. Bunun Perakende kampanyaları için nasıl farklılık gösterdiğini öğrenin. Gerekli tüm AssetGroupAsset varlıkları olmadan bir 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ğı 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 ve Asset kaynaklarını ayrı isteklerde oluşturun.
  • Bu kaynakların tümünü tek bir değişiklik isteğine dahil edin.

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 olmayacaktır.

Yayınlanan geçerli bir Maksimum Performans kampanyası için minimum koşullar

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ı isteğe AssetGroupSignal kaynakları oluşturma işlemleri dahil edebilirsiniz. Alternatif olarak, AssetGroup oluşturulduktan sonra ayrı bir istekte AssetGroupSignal varlıkları oluşturabilirsiniz.

Ek seçenekler sunan 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 farklı 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, bağlı Merchant Center hesabınızda sağlanan öğeleri reklam oluşturmak için otomatik olarak kullanır. Ancak tüm envanterde ulaşmak için öğe sağlamanızı öneririz. Perakende için Maksimum Performans kampanyalarının yayınlanması için aşağıdaki minimum kaynak grubunun bulunması gerekir.

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

Perakende kampanyalarında Campaign.shopping_settings alanının doldurulması gerektiğini unutmayın. Ayrıca, her bir AssetGroup için listelenen 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şkilendirilmiş, geçerli bir ürün listeleme grubu ağacına sahip olmalıdır. En azından, belirttiğiniz Merchant Center feed'indeki tüm ürünleri hesaba katacak şekilde tek bir düğüm ağacı oluşturmanız gerekir.

Bu kaynakların her biri ayrı olarak 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 yayınlanan Perakende Maksimum Performans kampanyası için minimum koşullar

resim

Perakende kampanyaları; öğe grubu sinyalleri, kampanya dönüşüm hedefleri ve kampanya ölçütleri oluşturma dahil olmak üzere standart Maksimum Performans kampanyalarında sunulan tüm seçeneklerden yararlanabilir. AssetGroup kaynağını oluştururken bir AssetGroup öğesine öğe eklemeyi seçerseniz AssetGroup minimum öğe gereksinimlerine tabi olur. Başka bir deyişle, hiç öğe eklemeyebilir veya gerekli tüm öğeleri dahil edebilirsiniz.

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

resim

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ırması nedeniyle yayınlanmaya uygun değil. Örneğin, advertising_channel_type değeri PERFORMANCE_MAX ile bağımsız bir Campaign kaynağı oluşturabilirsiniz. Kampanya oluşturma isteği başarılı olsa da kampanyaya en az bir AssetGroup eklemediğiniz sürece kampanya yayınlanmaya uygun olmaz. İstekleriniz başarılı olmasına rağmen kampanyanız veya öğe gruplarınız yayınlanmıyorsa nedenini belirlemek için sorun giderme kılavuzunda ayrıntılı olarak açıklandığı şekilde CampaignPrimaryStatus, CampaignPrimaryStatusReason, AssetGroupPrimaryStatus ve AssetGroupPrimaryStatusReason araçlarını kullanabilirsiniz.
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 bir AssetGroup oluşturmaya çalışırsanız Google Ads API hata verir. Bu nedenle, bir AssetGroup ve onun AssetGroupAsset kaynaklarını aynı isteğe eklemeniz gerekir. Bu aynı zamanda, isteğin tamamının başarısız olmasını önlemek amacıyla tüm AssetGroupAsset kaynaklarınızın belirli bir field_type için doğru spesifikasyonları karşılaması gerektiği anlamına gelir.

Değişim istekleriyle grup işlemleri

Maksimum Performans kampanyaları birden fazla kaynaktan oluşur. Dilerseniz 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, belirtildiği gibi tek bir atomik istekte oluşturulmalıdır.

Bu kılavuzda belirtilen gerekli tüm kaynakları başarıyla oluşturana kadar kampanyanız yayınlanmaya uygun olmaz. Ayrı istekler yayınlarken sonraki isteklerde referans verilen kaynakların gerçek kaynak adlarını kullanın. Birden çok işlem içeren toplu değiştirme istekleri yayınlarken, geçici kimliklerle oluşturulmuş kaynak adları kullanılır.

İş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ğı oluşturulmadan önce hiçbir zaman referans vermeyecek şekilde sıralamanız gerekir. Toplu değiştirme istekleri söz konusu olduğunda bu, işlemleri başvuruda bulunulan kaynakların onlara başvuran kaynaklardan önce listeleneceği şekilde sıralamak anlamına gelir.

Öğe kaynaklarını, bir AssetGroup ve onun AssetGroupAsset kaynaklarını oluşturan aynı toplu değiştirme isteğinde oluşturmayı tercih ederseniz şemada gösterildiği gibi AssetOperations öğesinin tamamı, tüm AssetGroupAssetOperations öğelerinden önce gelmelidir.

resim

Google Ads sunucusu, art arda AssetGroupAssetOperations öğesini toplu olarak işler ve bu gruptaki son işlemin ardından bir 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 öğesinden sonra minimum öğe gereksinimlerini değerlendirir ve istekteki diğer işlemlere devam etmeden bir hata döndürür. Sonuç olarak, istekteki öğelerin hiçbiri Google Ads hesabınıza eklenmez. Ayrıca AssetGroup ve ilişkili AssetGroupAsset kaynakları 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 neden olacak sonraki istekleri gönderemezsiniz. Bu tür istekler hataya neden olur. Örneğin, tek bir MARKETING_IMAGE ile bir AssetGroup oluşturursanız (minimum gereksinim) bu MARKETING_IMAGE ile ilişkilendirilmiş AssetGroupAsset öğesini kaldırma istekleri hata döndürür.

Bu, özellikle ilişkili herhangi bir öğe olmadan oluşturulan perakende kampanyalarındaki öğe grupları için önemlidir. AssetGroupAsset kaynakları oluşturarak AssetGroup öğesine öğe eklemeye yönelik sonraki istekler, yalnızca istek tüm öğe şartlarını karşılıyorsa başarılı olur. Yani bu öğe gruplarına aşamalı olarak öğe ekleyemezsiniz.