SupplyChain nesnesiyle teklif şeffaflığı

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.

1. Yayıncı bir teklif isteği gönderir.
2. Alıcı, teklif isteğini ve verileri SupplyChain nesnesinden alır.
3. Alıcı, envanteri yeniden satan tüm aracıların kimliklerine bakar.
4. Alıcı, envanter satma yetkisi olan tedarikçileri tarayıp doğrular.

Ad Manager, mümkünse nesneleri bir OpenRTB isteğinde veya Google GZT protokolünde otomatik olarak oluşturur.

SupplyChain nesnesinin işleyiş şekli

schain olarak da bilinen SupplyChain nesnesi, OpenRTB teklif isteğinin parçasıdır ve "düğümlerden" oluşur. schain nesnesindeki her bir düğüm, teklif isteğine katılan belirli bir tüzel kişiyi temsil eder. Teklif isteği, envanter ile ilgili doğrudan ödeme akışına dahil olan tüm varlıkları içerir.

// Örnek nesne
"schain": {
    "complete": 1,
    "nodes": [{
         "asi":"google.com",
         "sid":"pub-1234567891234567", // sellers.json'da yayıncı için aynı seller_id
         "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 tarafı başlıktan teklif alma (header bidding), ödeme dışı başlıktan teklif alma (header bidding), envanter paylaşımı ve diğer uyumlulaştırmalar dahildir.

İstek öncesinde ödeme aracıları kullanan yayıncılar ^(Beta) 

Bu özellik Beta sürümündedir
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 için ödeme akışıyla doğrudan ilgili olan 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.

schain parametresi hakkında daha fazla bilgi

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}. SupplyChainObject ve SupplyChainNode ö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

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

Boş isteğe bağlı alanlar için virgülle serileştirme

1.0,1!exchange1,12345,1,bid-request-1,publisher1,publisher1.com!google.com,pub-12345678910,1,,,,

Boş isteğe bağlı alanlar için virgül olmadan serileştirme

1.0,1!exchange1,12345,1,bid-request-1,publisher1,publisher1.com!google.com,pub-12345678910,1

SupplyChain nesnesi hakkında daha fazla bilgi

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.

 

Not: 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.