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.

Google, mümkünse nesneleri bir OpenRTB isteğinde otomatik olarak oluşturur.

SupplyChain nesnesinin işleyiş şekli

schain olarak da bilinen SupplyChain nesnesi, OpenRTB teklif isteğinin bir parçasıdır ve "düğümlerden" oluşur. schain 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.

İpucu: Google'ın eksiksiz bir SupplyChain nesnesi oluşturabilmesi için ÇMY Envanteri Yönetme yetkisine sahip ana yayıncıların, alt yayıncılarının satıcı kimliğini (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) 

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

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 aracını kullanan yayıncılar

Çoklu Müşteri Yönetimi (ÇMY) ana yayıncıların alt yayıncılara ait envanterden Hesabı Yönet yetki türüyle tek tek veya Envanteri Yönet yetki türüyle geniş ölçekli olarak para kazanmasını sağlar.

Hesabı Yönet yetki türü olan iş ortakları için

Hesabı Yönet yetki türünü kullanan ana ve alt yayıncılar söz konusu olduğunda schain nesnesi, alt yayıncının satıcı kimliğiyle bir düğüme sahip olur ve zincir "tamamlandı" olarak işaretlenir. Hesabı Yönet yetki türüne sahip yayıncılar 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. Ana yayıncının bilgileri schain nesnesine dahil edilmez.

Envanteri Yönet yetki türü olan iş ortakları için

SupplyChain Nesnesi artık ÇMY Envanteri Yönet yetkisine sahip yayıncılar için tamamlandı olarak işaretlenir. ÇMY alt yayıncıları için 1 düğüm, ÇMY ana yayıncıları için 1 düğüm vardır ve zincir "tamamlandı" olarak işaretlenir.

Bu güncelleme, ÇMY Envanteri Yönet yetki türüne sahip ana yayıncıların Ad Manager ön ucu veya API'si aracılığıyla alt yayıncılarının Satıcı Kimliği'ni (SID) paylaşmasını gerektirir. 

Eksiksiz SupplyChain Nesnesi örneği

Bu örnekte, exchange olarak Google ile birlikte ÇMY alt yayıncısı ve ana yayıncısı için "tamamlandı" olarak işaretlenen SupplyChain nesnesi gösterilmektedir.

"schain" : {
    "ver": "1.0",
    "complete" : 1,
    "nodes" : [

// ÇMY alt yayıncısı için düğüm
        {
            "asi":"mcm-parent-example.com",  // Bu bir örnektir. Ana yayıncının gerçek alanını girdiğinizden emin olun. 
            "sid":"52e41fac28963d1e058a106f", // Ana yayıncının seller.json dosyasındaki alt yayıncı satıcı kimliği
            "hp":1,
        },

// ÇMY Envanteri Yönet yetki türü olan ana yayıncı
        {
            "asi":"google.com",
            "sid":"pub-1234567891234567", // Google'ın seller.json dosyasındaki ÇMY ana yayıncı kimliği
            "hp":1,
        }
    ]
}

SSS

ÇMY ana yayıncılarının neden bir sellers.json dosyası oluşturması gerekiyor?

İş ortaklarının bilgilerini sellers.json dosyasında listelenmesine izin vererek herkese açık hâle getirmek, reklam alıcılarının envanterlerini doğrulamasına yardımcı olmak için uygulanması gereken önemli bir adımdır. 

IAB sellers.json spesifikasyonu hakkında daha fazla bilgi

Tüm alt yayıncılarımın geçerli bir ads.txt dosyasına sahip olması gerekir mi?

Evet. ÇMY alt davet işleminin bir parçası olarak alt yayıncılar, sahip oldukları ve işlettikleri her sitenin site sahipliğini doğrulamak için bir ads.txt dosyası oluşturur. 

Alt yayıncının ads.txt dosyası, ÇMY Ana Yayıncısını DIRECT olarak listeleyen bir satır içermiyorsa (ör. MCM-parent-example.com, ÇMY alt yayıncısı için Satıcı Kimliği, DIRECT) ancak ana yayıncının kimliğiyle Google satırını listeliyorsa (ör. google.com, ÇMY ana yayıncısı için PUB kimliği, RESELLER, f08c47fec0942fa0) bunun gelir üzerinde olumsuz bir etkisi olur mu? Tedarik zinciri "tamamlandı" olarak işaretlenir mi?

Tedarik zinciri tamamlandı olarak işaretlenir ancak SupplyChain'de sitenin ads.txt dosyasında yetkili satıcı olarak listelenmediği bir düğüm olduğundan alıcılar trafiği "yetkisiz" olarak kabul edebilir. ads.txt dosyasını, ÇMY Ana Yayıncısını DIRECT (ör. MCM-parent-example.com, ÇMY alt yayıncısı için Satıcı Kimliği, DIRECT) olarak içerek şekilde güncellemek, bu hataları önlemek için uygulanması gereken bir adımdır.