Protected Audience API açık artırma raporları

Protected Audience API açık artırma verilerini ve sonuçlarını ölçme

Bu makalede, Protected Audience API açık artırma verilerini sunucunuza bildirmek için kullanabileceğiniz çeşitli mekanizmalara ve şu anda alternatif çözümler hazır olana kadar taşıma sırasında kullanabileceğiniz geçiş mekanizmalarına dair genel bir bakış bulabilirsiniz.

Protected Audience API, bir reklam açık artırmasından topladığınız önemli metrikleri raporlamak için aşağıdakilerle çalışır:

• Özet raporları oluşturmak için açık artırma sinyallerini ve sonuçlarını toplayan Özel Toplama.
• Fenceed Çerçeveler ve iframe'ler için Ads Reporting API. Bu API, Protected Audience API iş akışlarıyla iletişim kurmak amacıyla çerçevelerin içinde bulunan bir kanaldır. API, etkinlik düzeyindeki verilerin açık artırma sinyalleriyle ilişkilendirilmesini sağlar. Ads Reporting API'nin etkinlik düzeyinde raporlaması, daha gizli bir bildirme mekanizması tasarlanana kadar bir geçiş mekanizmasıdır.
• Dönüşüm verilerini açık artırma sinyalleriyle ilişkilendirmenize olanak tanıyan İlişkilendirme Raporları.
• Kaynaklar arası depolama alanına açık artırma sinyalleri yazmanıza ve daha sonra Özel Toplama'yı kullanarak bu verileri raporlamanıza olanak tanıyan Paylaşılan Depolama.

Protected Audience API raporlarına genel bakış

Protected Audience API açık artırma akışındaki verilerin sunucunuza raporlanabileceği üç ana zaman aralığı vardır: açık artırma yayıncı sitesinden açık artırma zamanı, reklamın yayıncı sitesinde çitli bir çerçeve veya iframe'e oluşturulduğunda oluşturulma süresi ve kullanıcının başka bir sitede açık artırmayla ilişkilendirilebilecek bir işlem gerçekleştirdiği dönüşüm süresi.

Açık artırma sırasında, raporlama iş uygulamalarını kullanarak açık artırma verilerini bildirebilirsiniz. Oluşturma süresi boyunca, bir iFrame veya sınırları belirlenmiş bir karedeki etkileşim verilerini bildirebilirsiniz. Dönüşüm sırasında, Attribution Reporting API'yi kullanarak hedef sayfadaki ilişkilendirme verilerini raporlayabilirsiniz.

Raporlama konumları

Bir açık artırmada, alıcılar generateBid() ve reportWin() iş akışlarında bulunan sinyalleri, satıcılar ise scoreAd() ve reportResult()'teki mevcut sinyalleri bildirebilir. Açık artırma dışında, alıcılar ve satıcılar reklamı oluşturan bir çerçeveden ve dönüşümün yapıldığı siteden alınan verileri bildirebilir.

Dönem	Hedef	Konum	Veriler kullanılabilir	Reporting API'ler kullanılabilir
Açık artırma	Alım sorumlusu	generateBid()	Sinyaller, açık artırma sonuçları ve açık artırma performansı	Private Aggregation API
		reportWin()		Private Aggregation API Ads Reporting API
	Satıcı	scoreAd()		Private Aggregation API
		reportResult()		Private Aggregation API Ads Reporting API
Oluştur	Alıcı / Satıcı	Yayıncı sitesindeki çerçeve	Reklam çerçevesi içindeki etkinlik düzeyinde veriler	Private Aggregation API Ads Reporting API
Dönüşüm	Alıcı / Satıcı	Dönüşüm sitesi	Dönüşüm sitesinden elde edilen dönüşüm ve etkinlik düzeyindeki veriler	Attribution Reporting API Private Aggregation API Ads Reporting API

Listelenen her bir dönem boyunca, alıcılar ve satıcılar açık artırma sinyalleri, etkinlik düzeyindeki veriler ve dönüşüm verileri gibi verileri raporlamak için kullanılabilen çeşitli raporlama API'lerine erişebilir.

Protected Audience API açık artırmasında kullanılabilen veriler

Aşağıdaki veriler, açık artırma sırasında Protected Audience API iş akışından raporlanabilir.

Sinyaller

Sinyaller; bir iş kanalındaki alıcı ve satıcıların teklif oluşturmak, reklam puanlamak ve açık artırmanın sonuçlarını bildirmek için kullanabileceği açık artırma içerik verileri, kullanıcı verileri, gerçek zamanlı veriler ve tarayıcı verileridir.

Sinyal	Açıklama	Konum ayarla	Kullanıcı sayısı	Kullanılabilirlik
auctionSignals	Açık artırmanın gerçekleştiği bağlamla ilgili veriler. Bu veriler arasında sayfa içeriği bilgileri, birinci taraf kullanıcı verileri ve daha fazlası yer alabilir.	Açık artırma yapılandırmasında yayıncı sitesinden satıcı tarafından ayarlanır.	Buyer Seller	createTeklif puanıReklam raporuWin raporuSonuç
directFromSellerSignals	auctionSignals, perBuyerSignals ve sellerSignals için aynı veriler ancak sinyallerin belirtilen satıcıdan geleceği garanti edilir.	Satıcının HTTP yanıt başlıkları aracılığıyla ayarlandı	Buyer Seller	createTeklif puanıReklam raporuWin raporuSonuç
browserSignals	Tarayıcı tarafından sağlanan çeşitli veriler (topWindowHostname, interestGroupOwner, renderUrl, adComponents, biddingDurationMsec, IGJoinCount, IGRecency, modelingSignals).	Tarayıcı tarafından ayarlanır.	Buyer Seller	createTeklif puanıReklam raporuWin raporuSonuç
sellerSignals	Reklam puanlaması için satıcıya sağlanan sinyaller.	Açık artırma yapılandırmasında yayıncı sitesinden satıcı tarafından ayarlanır.	Satıcı	scoreAd reportWin reportResult
trustedScoringSignals	Reklam puanlaması için satıcıya sağlanan gerçek zamanlı sinyaller.	URL, açık artırma yapılandırmasında yayıncı sitesinden satıcı tarafından ayarlanır.	Satıcı	skorReklam raporuSonuç
perBuyerSignals	Belirli alıcılara sağlanan açık artırma içerik verileri. Satıcı, açık artırma başlamadan önce alıcıların değerlerini alabilir. Bu, alıcının reklam fırsatı hakkındaki bilgisidir.	Açık artırma yapılandırmasında yayıncı sitesinden satıcı tarafından ayarlanır.	Alım sorumlusu	createTeklif puanıReklam raporuWin raporuSonuç
trustedBiddingSignals	Reklam teklif verme için alıcılara sağlanan gerçek zamanlı sinyaller.	URL, ilgi alanı grubu ayarlandığında, reklamveren sitesindeki alıcı tarafından ayarlanır.	Alım sorumlusu	generateBid
userBiddingSignals	Alıcı tarafından sağlanan kullanıcı verileri.	İlgi alanı grubu ayarlandığında, reklamveren sitesinde alıcı tarafından belirlenir .	Alım sorumlusu	generateBid

Açık artırma yapılandırması nesnesi, iş akışlarında sinyal olarak kullanılabilir hale gelmesi için sağlanan birincil veri kaynağıdır. Yayıncı ve satıcı, açık artırma yapılandırmasında bağlamsal veriler ve birinci taraf verileri sağlayabilir. Bu sinyaller; alıcıdan gelen ilgi alanı grubu verileri, reklam oluşturma çerçevesinden etkinlik düzeyindeki veriler ve tıklama sayfasındaki ilişkilendirme verileriyle zenginleştirilebilir. Bildirilen veriler alıcı/satıcı raporlaması, faturalandırma, bütçe oluşturma, makine öğrenimi modeli eğitimi ve daha birçok amaçla kullanılabilir.

Diğer veriler

• Açık artırma kazanma ve kayıp verileriyle ilgili sonuç verileri (kazanan teklif fiyatı ve teklifin reddedilme nedeni gibi).
• Teklifli sistem iş akışını getirmenin ve yürütmenin ne kadar sürdüğü gibi gecikme bilgilerini içeren performans verileri.

Protected Audience API açık artırması dışında kullanılabilen veriler

Protected Audience API açık artırması dışında, verilerin raporlanabileceği iki dönem vardır.

Reklam oluşturma süresinde, reklam yayıncı sitesinde oluşturulduğunda iFrame veya sınırları belirlenmiş çerçevenin içindeki etkinlik düzeyinde veriler, Protected Audience API açık artırma verileriyle ilişkilendirilebilir ve sunucunuza raporlanabilir. Etkinlik düzeyindeki örnek veriler; reklam gösterimi, tıklama, fareyle üzerine gelme ve çerçeve içinde gerçekleşen diğer etkinlikleri içerir.

Dönüşüm süresi boyunca, bir kullanıcı açık artırmayla ilişkilendirilen tıklama sayfasında işlem yaptığında, dönüşüm sayfasındaki etkinlik düzeyindeki veriler Protected Audience API açık artırma verileriyle ilişkilendirilebilir ve sunucunuza raporlanabilir.

Etkinlik düzeyinde raporlama

Etkinlik düzeyindeki raporlar, bir veya daha fazla etkinliğe ait bilgileri ayrıntılı olarak gösterir. Bir etkinlik; açık artırma kazanma, reklam gösterimi veya dönüşüm olabilir. En az 2026'ya kadar etkinlik düzeyinde açık artırma kazanma raporları kullanımda kalacak, Protected Audience reklamı oluşturmak için korumalı çerçevelere gerek olmayacak ve etkinlik düzeyinde raporlama için sınırsız ağ erişimine sahip iframe kullanılabilecek. Ayrıca, açık artırma ve dönüşüm verilerini çerçevedeki etkinlik düzeyindeki verilerle ilişkilendirmeniz için Ads Reporting API sınırlanmış çerçevelerde ve iframe'lerde kullanılabilir. Bu tasarım, sisteminizi Protected Audience'a taşırken mevcut raporlama altyapınızı en az 2026'ya kadar kullanmaya devam edebileceğiniz için ekosistemin geçiş sürecini kolaylaştırmak amacıyla tasarlanmıştır.

sendReportTo() ile etkinlik düzeyinde açık artırma kazanma raporu

Protected Audience açık artırmasında etkinlik düzeyindeki verileri raporlamak için kullanılabilen bir mekanizma, açık artırmayı kazanan sendReportTo() function sistemidir. İşlev, alıcı ve satıcı raporlama iş akışlarında kullanılabilir ve reklam oluşturma işlemi başladığında tarayıcı, sağlanan URL dizesi için bir GET isteğinde bulunur. İş akışlarınızda bulunan tüm sinyalleri URL'nin sorgu parametreleri olarak kodlayabilirsiniz.

Örneğin, bir alıcı faturalandırma amacıyla reportWin() iş akışından kazanan teklif tutarını raporlayabilir:

// Buyer reporting worklet
function reportWin(auctionSignals, perBuyerSignals, sellerSignals, browserSignals, directFromSellerSignals) {
  sendReportTo(`https://buyer-reporting-server.example/reporting?bid=${browserSignals.bid}`);
}

sendReportTo() işlevi, reportResult() üzerinden çağrıldığında satıcı için bir kazanma raporu, reportWin() üzerinden çağrıldığında ise alıcı için bir kazanma raporu oluşturmak amacıyla kullanılabilir. sendReportTo() işlevi, en az 2026'ya kadar kullanılabilir.

Etkileşim raporu

Etkileşim raporu, reklamı oluşturan Protected Audience API açık artırmasının sinyalleriyle ilişkilendirilmiş gösterim veya tıklama verileri gibi reklam öğesinin etkinlik düzeyinde verilerini içerir. Reklam, açık artırma sona erdikten sonra oluşturulduğundan, reklamı oluşturan çerçevenin içinde açık artırma sinyalleri bulunmaz. Farklı dönemlere ait bu verileri ilişkilendirmek için etkileşim raporları oluşturabileceğiniz iki geçiş mekanizması sunarız.

Yukarıda açıklanan sendReportTo() işlevi, açık artırma verilerini bir iframe'den gelen etkinlik düzeyindeki verilerle ilişkilendirmek için kullanılabilir. Ancak yerleştirici ve sınırlanmış çerçeve arasındaki iletişim sınırlı olduğundan, yerleşik çerçeveden benzersiz bir kimlik geçirilemediğinden, sınırlanmış bir çerçevede çalışmaz. Açık artırma verilerini, sınırlı çerçeveli bir çerçeve reklamın etkinlik düzeyindeki verileriyle ilişkilendirmek için Ads Reporting API kullanılabilir.

Çitli çerçeveler ve iframe'ler için Ads Reporting API

Korumalı çerçeveler ve iframe'ler için Ads Reporting API, bir reklam çerçevesinden kullanıcı etkinlik düzeyindeki verileri Protected Audience açık artırmasındaki sinyallerle ilişkilendirmenizi sağlayan bir mekanizma sağlar.

Protected Audience API raporlama iş akışında, registerAdBeacon() işleviyle bir reklam işaretçisi kaydedebilir ve sorgu parametreleri olarak eklenen sinyallerle raporlama URL'nizi aktarabilirsiniz. Ayrıca, raporlama URL'si ile ilişkilendirmek istediğiniz özel etkinliği de belirtirsiniz. Daha sonra reklam çitli bir çerçevede oluşturulduğunda window.fence.reportEvent() işlevini çağırarak özel etkinliği tetikleyebilirsiniz. Sınırla çevrili çerçeve içinde bulunan veriler yük olarak eklenebilir.

registerAdBeacon() işlevi yalnızca raporlama işlevlerinde kullanılabilir ve alıcının teklif verme mantığında ve satıcının puanlama mantığında kullanılamaz.

Aşağıdaki örnekte, kampanya kimliği tıklama koordinatlarındaki etkinlik düzeyinde bir yükle ilişkilendirilir:

// Protected Audience API buyer win reporting worklet
function reportWin(auctionSignals) {
  const { campaignId } = auctionSignals

  registerAdBeacon({
    click: `https://buyer-server.example/report/click?campaignId=${campaignId}`
  })
}

// Protected Audience API seller reporting worklet
function reportResult(auctionConfig) {
  const { campaignId } = auctionConfig.auctionSignals;

  registerAdBeacon({
    click: `https://seller-server.example/report/click?campaignId=${campaignId}`
  })
}

// Ad frame
window.fence.reportEvent({
  eventType: 'click',
  eventData: JSON.stringify({'clickX': '123', 'clickY': '456'}),
  destination:['buyer', 'seller']
});

Fenced Frames Ads Reporting API, kazanma raporlarıyla aynı nedenlerle en az 2026'ya kadar kullanılabilecektir.

Daha ayrıntılı bilgi edinmek için açıklamayı inceleyin.

Sınırsız ağ erişimi

Sınırlanmış çerçeveler, ağ kaynaklarının, iFrame ile aynı şekilde yüklenmesine olanak tanır. Sunucunuza, sınırlanmış çerçevelerin içindeki etkinlik düzeyinde verileri gönderebilirsiniz. Daha sonra, sınırlanmış bir çerçevedeki etkinlik düzeyinde verileri, yukarıdaki açık artırma etkinliği düzeyinde raporlama mekanizması bölümünde açıklanan sendReportTo() ile gönderilen açık artırma verileriyle ilişkilendirerek sunucu tarafında etkinlik düzeyinde raporlar oluşturabilirsiniz.

Gelecekte ağ erişimi kısıtlanacaktır.

İlişkilendirme raporu

İlişkilendirme raporu, bir web sitesindeki dönüşümü Protected Audience API açık artırmasından seçilen bir reklamla ilişkilendirmenize olanak tanır. Örneğin, bir kullanıcı sunduğunuz bir ürün reklamını tıklayabilir, reklamverenin sitesine yönlendirilebilir, orada bir satın alma işlemi gerçekleştirebilir ve siz de satın almayı gösterilen reklamla ilişkilendirmek istiyorsunuz. Attribution Reporting API, yayıncı sitesinden alınan açık artırma verileri ile reklamveren sitesinden alınan dönüşüm verilerini birleştirmek için Protected Audience API ile entegre edilecektir.

Daha kalıcı bir çözüm tasarlıyor olsak da, Attribution Reporting ile etkinlik düzeyinde ve toplanabilir bir rapor oluşturmaya yönelik bir geçiş mekanizması olarak çitli çerçeveler için Ads Reporting API'yi kullanabilirsiniz. Bu raporların dönüşümleri ölçmeye yönelik olduğunu, açık artırmadan ve reklam çerçevesinden oluşturulan etkinlik düzeyinde ve toplu hale getirilebilir etkileşim raporlarından ayrı olduğunu unutmayın. Hazır olduğunda daha kalıcı bir çözüm için açıklayıcı bir açıklama yayınlayacağız.

Geçiş mekanizması

Bir reklam işaretçisini kaydederken, ilişkilendirme kaynağı olarak kaydedilmeye uygun hale gelmesi için işaretçinin Attribution-Reporting-Eligible başlığını otomatik olarak ekleyen reserved.top_navigation anahtar kelimesini kullanabilirsiniz.

registerAdBeacon({
 'reserved.top_navigation': 'https://adtech.example/click?buyer_event_id=123',
});

Kaydettiğiniz işaretçiye etkinlik düzeyinde veri eklemek için etkinlik yüküyle birlikte sınırlanmış çerçeveden setReportEventDataForAutomaticBeacons() öğesini çağırabilirsiniz.

window.fence.setReportEventDataForAutomaticBeacons({
  eventType: 'reserved.top_navigation',
  eventData: 'data from the frame',
  destination:['seller', 'buyer']
})

Daha fazla bilgi edinmek için Ads Reporting API açıklayıcısının İlişkilendirme Raporları bölümüne bakın.

Etkileşim ve dönüşüm raporlama örneği

Bu örnekte, açık artırma, reklam çerçevesi ve dönüşüm sitesindeki verileri ilişkilendirmek isteyen alıcı gözünden inceleyeceğiz.

Bu iş akışında alıcı, açık artırmaya benzersiz bir kimlik göndermek için satıcıyla koordineli çalışır. Açık artırma sırasında alıcı, açık artırma verileriyle birlikte bu benzersiz kimliği gönderir. Oluşturma ve dönüşüm süresi boyunca, sınırlanmış çerçeve veya iFrame'deki veriler de aynı benzersiz kimlikle gönderilir. Daha sonra, bu raporları birbiriyle ilişkilendirmek için benzersiz kimlik kullanılabilir.

İş akışı:

1. Açık artırma başlamadan önce alıcı, programatik gerçek zamanlı teklif verme ("GZT") teklif yanıtının bir parçası olarak satıcıya benzersiz bir kimlik gönderir. Kimlik, auctionId gibi bir değişken olarak ayarlanabilir. Kimlik, auctionConfig içinde perBuyerSignals olarak aktarılır ve alıcının iş akışlarında kullanılabilir.
2. Açık artırma sırasında alıcı, reklam oluşturma süresi ve dönüşüm süresi (registerAdBeacon()) sırasında tetiklenecek bir reklam işaretçisi kaydedebilir.
   1. Bir reklam çerçevesi etkinliği için açık artırma sinyallerini ilişkilendirmek için auctionId özelliğini, işaretçi URL'sinin sorgu parametresi olarak ayarlayın.
   2. Bir dönüşüm etkinliğinin açık artırma sinyallerini ilişkilendirmek için işaretçi URL'de auctionId özelliğini ayarlayın.
3. Reklam oluşturma süresinde, açık artırma sırasında kaydettiğiniz işaretçiler etkinlik düzeyindeki verilerle tetiklenebilir veya geliştirilebilir.
   1. Çerçeve etkinliğini reportEvent() ile tetikleyin ve etkinlik düzeyindeki verileri iletin.
   2. setReportEventDataForAutomaticBeacons() ile ilişkilendirme işaretçisine etkinlik düzeyinde yük ekleyin
   3. Reklam işaretçisi isteklerine Attribution-Reporting-Register-Source başlığıyla yanıt vererek reklamı Attribution Reporting API'ye kaydedin.
4. Dönüşüm sırasında, açık artırma sırasında kaydettiğiniz kaynağı tetikleyebilirsiniz.

Yukarıdaki işlemden sonra alıcı, birbiriyle ilişkilendirmek için kullanılabilecek tek bir benzersiz anahtarla birleştirilmiş bir açık artırma raporu, etkileşim raporu ve dönüşüm raporu alır.

Benzer iş akışı, ilişkilendirme verilerine erişmesi gereken satıcılar için geçerlidir. Satıcı ayrıca registerAdBeacon() ile gönderim yapmak için benzersiz bir kimlik kullanabilir. Çerçeveden reportEvent() çağrısı, raporu hem alıcıya hem de satıcıya göndermek için kullanılabilecek bir hedef mülk içerir. Tetikleyicinin kaynakla ilişkilendirilmesi için STP'nin açılış sayfasında da bulunması gerektiğini unutmayın.

Protected Audience verilerini toplama

Private Aggregation API, özet raporu oluşturmak üzere Protected Audience verilerini raporlamak için kullanılan mekanizmadır. Bu rapor, paketlerde toplanan verilerin gürültülü ve toplu bir raporudur. Paket, toplama anahtarıyla temsil edilir ve bazı bilgiler anahtara kodlanabilir.

Örneğin, bir reklam gösterimi etkinliği farklı gruplarda sayılabilir. Burada her grup farklı bir reklam kampanyasını temsil eder. Özet raporu, her bir etkinlikle ilgili bilgi sağlamaması açısından etkinlik düzeyindeki raporlardan farklıdır. Etkinlik düzeyinde bir rapor ile A, B ve C kullanıcılarının 123 kampanyasını gördüğünü belirleyebilirsiniz. Özet raporlar sayesinde, 123 numaralı kampanyayı gören ve kullanıcı gizliliğini korumak için gürültü eklenmiş kullanıcıların sayısını ölçebilirsiniz.

API hakkında daha fazla bilgi için Özel Toplama makalesine bakın.

Açık artırma sinyallerini toplama

Özel Toplama'yı kullanarak iş akışlarındaki mevcut sinyalleri sunucunuza toplayabilirsiniz. Sinyal toplama için alıcı teklif verme iş akışında, satıcı puanlama iş akışında ve alıcı/satıcı raporlama iş akışlarında bulunan privateAggregation.contributeToHistogram() yöntemini kullanabilirsiniz.

Bu örnekte, kazanan teklif ilgi alanı grubu sahibi grubunda toplanmıştır:

function convertBuyerToBucket(igOwner) {}
function convertWinningBidToValue(winningBid) {}

function reportResult(auctionConfig, browserSignals) {
  privateAggregation.contributeToHistogram({
    bucket: convertBuyerToBucket(browserSignals.interestGroupOwner),
    value: convertWinningBidToValue(browserSignals.bid)
  });
} 

Toplamak istediğiniz sinyaller etkinlik düzeyindeki verilerle ilişkili olmadığında ve açık artırma dışındaki bir etkinlik tarafından tetiklenmediğinde bu genel mekanizma kullanılır. Açık artırma sinyallerini raporlama hakkında daha fazla bilgi edinmek için açıklamaya bakın.

Açık artırma sinyallerini etkinlik verileriyle toplama

Açık artırma sinyallerini, bir reklam çerçevesinde gerçekleşen bir etkinlik hakkında sınırlı bilgiyle toplayabilirsiniz. Örneğin, bir kampanyadaki reklamın kaç tıklama aldığını, kampanyayı ve tıklama etkinliğini temsil eden bir paket oluşturarak toplu olarak ölçebilirsiniz. Hangi etkinliğin gerçekleştiğini reklam çerçevesinden belirtebileceğinizi ancak etkinlik düzeyinde bir yük ekleyemeyeceğinizi unutmayın.

Açık artırma sinyallerini etkinliklere göre toplamak için etkinlik türünü ve bu etkinlik tetiklendiğinde raporlanacak katkıyı belirten bir dize alan privateAggregation.contributeToHistogramOnEvent(eventType, contribution) kullanabilirsiniz. Yöntemi özel bir etkinlik türüyle çağırabilir ve ardından gönderilecek raporu tetiklemek için reklam çerçevesinden window.fence.reportEvent(eventType) yöntemini çağırabilirsiniz.

Bir kampanyadaki reklamın kaç tıklama aldığını ölçmek istediğinizi varsayalım.

// Protected Audience API worklet
function getClickReportBucketForCampaign(campaignId) {
  // return a bucket for the campaign ID and the click event
}

function generateBid(interestGroup) {
  privateAggregation.contributeToHistogramOnEvent('click', {
    bucket: getClickReportBucketForCampaign(interestGroup.ads.metadata.campaignId), 
    value: 1
  });
}

Teklif oluşturma işlevinde, kampanya kimliği ve tıklama etkinliğinin kombinasyonu olarak bir paket tanımlayabilir ve ardından etkinlik her tetiklendiğinde o grubun değerini 1 artırabilirsiniz.

// Ad frame
window.fence.reportEvent('click');

Daha sonra, daha sonra reklam çerçevesinden reportEvent(eventType) işlemini çağırarak rapor gönderimini tetikleyebilirsiniz:

Açıklayıcının bir karesinden Özel Toplama katkılarını tetikleme hakkında daha fazla bilgi edinin.

Açık artırma sonuçlarını ve performansı raporlama

Ayrıca, ayrılmış bir etkinlik türündeki anahtar kelimeleri (reserved.win, reserved.loss ve reserved.always) geçtiğinizde contributeToHistogramOnEvent(eventType, contribution) ile bir açık artırma kazanma veya kaybetme etkinliği ile tetiklenen açık artırma sonuçlarını birleştirebilirsiniz.

Özel Toplama, katkınızın grubunu ve değerini hesaplayabileceğiniz temel değerlerin listesini sunar. Açık artırma sonuçları için kullanılabilecek temel değerler kazanan reklamın teklif değeri, ikinci en yüksek olarak puanlanan teklif değeri ve bir teklifin açık artırmada reddedilme nedenidir.

Kazanan teklif tutarı gibi bir taban değer sağlandığında, bu değere ne kadar ekleme veya çıkarma yapacağınızı ayarlayabilir, ardından nihai değeri raporlayabilirsiniz. Örneğin, taban değer olarak 5 TL'lik kazanan teklif verilirse açık artırmanızı ne kadar kaybettiğinizin 3 TL'lik gerçek değerini hesaplamak için 2 TL'lik teklifinizi çıkarabilirsiniz.

Açık artırma sonuçları raporlaması

Açık artırmayı kaybettiğiniz ve teklifinizin, açık artırmadaki açık artırma fiyatından ne kadar uzakta olduğunu öğrenmek istediğiniz bir örneği inceleyelim.

Açık artırmayı ne kadar kaybettiğinizi öğrenmek için teklif fiyatınızı, kazanan teklif fiyatından çıkarabilirsiniz:

function generateBid() {
  const bid = calculateBidAmount();

  privateAggregation.contributeToHistogramOnEvent('reserved.loss', {
    bucket: getBucketForCampaign(interestGroup.ads.metadata.campaignId),
    value: {
      baseValue: 'winning-bid',
      scale: 1 // Scale the value to minimize noise-to-signal ratio 
      offset: -bid, // Numbers added to browser value after scaling 
    }
  });
}

Rapor gönderildiğinde, raporlanan gerçek değer offset değeri ile kaydırılan baseValue şeklinde ayarlanır. Daha fazla bilgi edinmek için açıklamaya göz atın.

Performans raporlaması

Alıcılar ve satıcılar, bir komut dosyasının çalışmasının ne kadar sürdüğünü ve güvenilir sinyalleri getirmesinin ne kadar sürdüğünü bildirebilir. Satıcılar, izniyle her alıcının teklif oluşturma zamanını ve güvenilir teklif sinyali zamanını toplayabilir.

Daha fazla bilgi edinmek için açıklayıcıya bakın.

Açık artırma sinyallerini Paylaşılan Depolama Alanı'nda depolama

Paylaşılan depolama, serbestçe yazabileceğiniz, bölümlendirilmemiş ve kaynaklar arası bir depolama alanıdır. Bununla birlikte, depolanan değerler okunurken ve işlenirken kapılarla korunur. Shared Storage API'nin kullanılabilen kapılarından biri Özel Birleştirme'dir. Paylaşılan depolama alanındaki değerleri yalnızca bir iş ortağının içinden okuyabilirsiniz. Bu değerleri, iş akışından Özel Toplama'yı kullanarak bildirebilirsiniz.

Ayrıca Protected Audience API teklif verme, puanlama ve raporlama iş akışlarından da paylaşılan depolama alanına yazabilirsiniz. Daha sonra, paylaşılan depolama alanındaki bu değerleri Özel Toplama 'yı kullanarak sunucunuza bildirebilirsiniz . URL Seçimi işlemi için depolanan değerleri de kullanabilirsiniz.

Bir Protected Audience API iş akışından tüm anahtarları ve değerleri paylaşılan depolama alanına yazabilirsiniz:

// Protected Audience API worklet
function generateBid() {
  sharedStorage.set('test-bucket', 123);
}

Daha sonra, bir paylaşılan depolama iş akışı yükleyerek bu değeri Özel Toplama ile birlikte okuyabilir ve gönderebilirsiniz:

// Shared Storage worklet
class SendReachReport{
  async run() {
    const testBucket = await this.sharedStorage.get('test-bucket');

    privateAggregation.contributeToHistogram({
      bucket: testBucket,
      value: 1
    });
  }
}

register('send-report', SendReachReport);

Paylaşılan depolama alanı hakkında daha fazla bilgi edinmek için Protected Audience API raporlaması geliştirici kılavuzunun paylaşılan depolama alanı bölümüne, açıklamaya, canlı demoya ve GitHub'daki demo koduna göz atın.

Sonraki adım

Herkesin yararlanabileceği bir API geliştirdiğimizden emin olmak için sizinle görüşmeler yapmak istiyoruz.

API'yi tartışın

Diğer Özel Korumalı Alan API'lerinde olduğu gibi bu API de belgelenmiş ve herkese açık olarak tartışılmıştır.

API ile deneme yapma

Protected Audience API hakkında denemeler yapabilir ve görüşmelere katılabilirsiniz.