İstekleri Yapılandırın

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 bir kaynak grubu 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 eklenmesi 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ı için 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.

• 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ş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.

• Öğe grubu sinyalleri
• Kampanya dönüşüm hedefleri
• Kampanya Ölçütleri

AssetGroup ve AssetGroupAsset kaynaklarını oluşturan istekle aynı istekte AssetGroupSignal kaynaklarını oluşturma işlemlerini de ekleyebilirsiniz. Alternatif olarak, AssetGroup oluşturulduktan sonra AssetGroupSignal öğelerini ayrı bir istekte 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:

• Öğe içermeyen öğe grupları
• TÜM gerekli öğ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. Perakende için Maksimum Performans kampanyalarının yayınlanabilmesi için aşağıdaki minimum kaynak grubunun sağlanması gerekir.

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

Campaign.shopping_settings alanının perakende kampanyalarında doldurulması gerektiğini unutmayın. Ayrıca, her AssetGroup içinde final_urlslistelenenler, Campaign.shopping_settings içinde belirtilen Merchant Center hesabı kimliğiyle ilişkili URL'lerle 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 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.

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

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 öğe eklemeyi tercih ederseniz AssetGroup, minimum öğe koşullarına tabi olur. Diğer bir deyişle, öğe eklemeyebilir veya gerekli tüm öğeleri ekleyebilirsiniz.

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

Geçersiz durum ve geçersiz istekler

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_type değeri 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 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 sorun giderme kılavuzunda ayrıntılı olarak açıklandığı şekilde CampaignPrimaryStatus, CampaignPrimaryStatusReason, AssetGroupPrimaryStatus ve AssetGroupPrimaryStatusReason kullanarak 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 kampanyası dışı bir kampanya için AssetGroup oluşturmaya çalışırsanız Google Ads API bir hata verir. Bu nedenle, aynı istekte 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ş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 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 ID'ler 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şlemleri, bir kaynağa oluşturulmadan önce asla 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 toplu değişiklik isteğinde öğe kaynakları oluşturmayı seçerseniz diyagramda gösterildiği gibi tüm AssetOperations, tüm AssetGroupAssetOperations'den önce gelmelidir.

Google Ads sunucusu, art arda gelen AssetGroupAssetOperations işlemlerini birlikte gruplandırır ve bir AssetGroup işleminin, söz konusu 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 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, 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 (minimum şart) içeren bir AssetGroup oluşturursanız bu MARKETING_IMAGE ile ilişkili AssetGroupAsset öğesini kaldırma istekleri hata döndürür.

Bu, özellikle perakende kampanyalarında ilişkili öğe olmadan oluşturulan öğe grupları için önemlidir. AssetGroup kaynakları oluşturarak AssetGroupAsset öğesine öğe eklemeye yönelik sonraki istekler, 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 kademeli olarak öğe ekleyemezsiniz.