SupplyChain nesnesi, alıcı ve aracıların reklam envanteri satan veya yeniden satan tüm tarafları görmesine olanak tanır. Nesne, reklam ekosisteminde şeffaflık sağlamak için ads.txt/ads.txt ve ads.txt ile birlikte çalışır.
- Yayıncı bir teklif isteği gönderir.
- Alıcı, teklif isteğini ve verileri SupplyChain nesnesinden alır.
- Alıcı, envanteri yeniden satan tüm aracıların kimliklerine bakar.
- Alıcı, envanter satma yetkisi olan tedarikçileri tarayıp doğrular.
Google, mümkünse nesneleri bir OpenRTB isteğinde otomatik olarak oluşturur.
SupplyChain nesnesinin işleyiş şekli
schainschain nesnesindeki her düğüm, teklif isteğine katılan belirli bir tüzel kişiyi gösterir. Teklif isteği, envanter ile ilgili doğrudan ödeme akışına dahil olan tüm varlıkları içerir.
sid) Ad Manager üzerinden veya API'yi kullanarak paylaşması gerekir.
// Example object
"schain": {
"complete": 1,
"nodes": [{
"asi":"google.com",
"sid":"pub-1234567891234567", // Same seller_id for the publisher in sellers.json
"hp":1
}],
"ver":"1.0"
}
Daha fazla ayrıntı için OpenRTB’nin geliştirici belgelerine ve IAB'nin belgelerine bakın.
SupplyChain nesnesi, alıcılarla çalışma biçiminize bağlı olarak farklı görünür.
Doğrudan Google ile satış yapan yayıncılar
Doğrudan Ad Manager, AdMob veya AdSense aracılığıyla satış yapan yayıncılar için schain nesnesi, sellers.json'dan bulunan seller_id ile "google.com" için yalnızca bir düğüm içerir.
Open Bidding özelliğini kullanan yayıncılar
Üçüncü taraf exchange'ler ile çalışmak için Open Bidding'i kullanan yayıncıların schain nesnesinde iki düğümü vardır: sellers.json'da bulunan seller_id ile google.com için bir düğüm ve exchange getiri iş ortağı için bir düğüm.
Google'ın teklif isteğini göndermeden önce google.com düğümünü oluşturması gibi, üçüncü taraf exchange de isteği iletmeden önce düğümünü eklemekten sorumludur.
Tüm ödeme dışı aracılar
Ödeme işlemiyle uğraşmayan alıcılar SupplyChain nesnesine dahil edilmez. Buna istemci taraflı başlıktan teklif alma (header bidding), ödeme işlemi içermeyecek şekilde başlıktan teklif alma (header bidding), envanter paylaşımı ve diğer uyumlulaştırma özellikleri dahildir.
İstek öncesinde ödeme aracıları kullanan yayıncılar (Beta)
Beta sürümündeki özellikler ağınızda kullanılamayabilir. Bu özelliğin ne zaman genel kullanıma sunulacağını öğrenmek için sürüm notlarını takip edin.
Google Ad Manager'a istek göndermeden önce ödeme aracılarından yararlanan yayıncıların, IAB yönergeleri uyarınca SupplyChain nesnesini iletmesi gerekir. SupplyChain nesnesi yalnızca envanter ödeme akışıyla doğrudan ilgili aracıları içermelidir. Bu tür aracılar, yayıncı tarafından kullanılan üçüncü taraf reklam sunucusu teknolojisini içerebilir. SupplyChain nesnesi, schain parametresi kullanılarak reklam isteğine gönderilebilir.
Açıklama
Tedarik zinciri (schain) parametresi, serileştirilmiş SupplyChain nesnesi olması gereken değişken değerini kabul eder. Bu parametre dahil edildiğinde Google, alıcılara göndermeden önce alınan tüm schain nesnelerine bir düğüm ekler.
SupplyChain bilgilerini OpenRTB yerine bir etiket aracılığıyla iletmek için IAB belgelerinin tamamını inceleyin.
Schain nesnelerinin doğru şekilde ayrıştırılmasıyla ilgili koşulları inceleyin.
IAB dokümanlarına göre SupplyChain nesnesi için serileştirme aşağıdaki şekilde tanımlanır:
{SupplyChainObject}!{SupplyChainNode array}. SupplyChainObjectveSupplyChainNodeözellikleri, isteğe bağlı alanların atlanabileceği ve virgül ayırıcıların isteğe bağlı olarak hariç tutulabileceği şekilde virgül ile ayrılır.- Her
SupplyChainNodeöğesi bir "!" ile ayrılır. - Herhangi bir mülkün değeri URL kodlaması gerektiren karakterler (ör. "
," veya "!") içeriyorsa değer, serileştirmeden önce URL olarak kodlanmalıdır.
Serileştirme sırası
SupplyChainObject özellikleri şu sırayla serileştirilir:
ver,complete
SupplyChainNode özellikleri şu sırayla serileştirilir:
asi,sid,hp,rid,name,domain,ext
ext öğesinin içeriği exchange'e özeldir. Google Ad Manager bu özelliği ayrıştırmaz.SupplyChain nesnesinin nasıl serileştirileceğine dair örnekler
Aşağıda, yukarıdaki SupplyChain nesnesini serileştirmenin iki yolu gösterilmektedir:
1.0,1!exchange1,12345,1,bid-request-1,publisher1,publisher1.com!google.com,pub-12345678910,1,,,,
1.0,1!exchange1,12345,1,bid-request-1,publisher1,publisher1.com!google.com,pub-12345678910,1
Kullanım örnekleri
schain=1.0,1!exchange1,12345,1,bid-request-1,publisher1,publisher1.com!google.com,pub-12345678910,1,,,,
asi değeri exchange,1 olsaydı kaçış karakterleriyle serileştirme şöyle olurdu:
1.0,1!exchange%2C1,12345,1,bid-request-1,publisher1,publisher1.com!google.com,pub-12345678910,1
Koşullar ve öneriler
Bu parametre, belirli bir uygulamaya veya işlem türüne reklam yayınlamak için gerekli olmasa da Google Ad Manager'a istek göndermeden önce ödeme aracılarından yararlanan yayıncılar için gereklidir. Üçüncü taraf reklam sunucusu teknolojisini kullanan yayıncılar da buna dahildir.
SupplyChain nesnesine eklenen ek düğümler de yayıncının ads.txt/app-ads.txt dosyasında temsil edilmelidir. Aksi takdirde alıcılar, trafiği yetkisiz olarak kabul edebilir.Çoklu Müşteri Yönetimi yayıncıları
Çoklu Müşteri Yönetimi (ÇMY) aracı yayıncıların, müşterilerinin AdMob hesaplarını kendilerinin sahip olduğu görünürlük ve kontrol düzeyinde yönetmesine olanak tanır.
AdMob ÇMY'yi kullanan ana ve alt yayıncılar için schain nesnesi alt yayıncının satıcı kimliğiyle bir düğüme, ana yayıncı için bir düğüme sahip olur ve zincir "tamamlandı" olarak işaretlenir. AdMob ÇMY için para kazanma süreci, alt yayıncının hesabında gerçekleşir. Alt yayıncı, son yayıncı olarak kabul edilir.