İstekleri Yapılandırın

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 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 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

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 ekleyebilirsiniz. Alternatif olarak, AssetGroup oluşturulduktan sonra ayrı bir istekte AssetGroupSignal varlıklarını oluşturabilirsiniz.

Ek seçenekler içeren Maksimum Performans kampanyası

resim

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

resim

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ı

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ırılma biçimi nedeniyle yayınlanmaya uygun değil. Örneğin, advertising_channel_type adet PERFORMANCE_MAX olan bağımsız bir Campaign kaynağı oluşturabilirsiniz. Kampanya oluşturma isteği başarılı olsa da, kampanyaya en az bir AssetGroup 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ığı şekilde CampaignPrimaryStatus, CampaignPrimaryStatusReason, AssetGroupPrimaryStatus ve AssetGroupPrimaryStatusReason 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 bir AssetGroup ve AssetGroupAsset kaynaklarını 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 ç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.

resim

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.