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 raporlamanız için kullanabileceğiniz çeşitli mekanizmaların yanı sıra alternatif çözümler hazır olana kadar geçiş sırasında kullanabileceğiniz geçiş mekanizmalarının üst düzey bir genel bakışını bulacaksınız.

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

• Özet raporlar oluşturmak için açık artırma sinyallerini ve sonuçlarını toplayan Private Aggregation.
• Fenced Frame'ler ve iframe'ler için Ads Reporting API: Bu API, Protected Audience API iş parçacıklarıyla iletişim kurmak için çerçeveler içinde kullanılan bir kanaldır. API, etkinlik düzeyindeki verilerin açık artırma sinyalleriyle ilişkilendirilmesine olanak tanır. Ads Reporting API'nin etkinlik düzeyinde raporlaması, daha gizli bir raporlama mekanizması tasarlanana kadar geçiş mekanizması olarak kullanılacaktır.
• Dönüşüm verilerini açık artırma sinyalleriyle ilişkilendirmenize olanak tanıyan ilişkilendirme raporları.
• Shared Storage, açık artırma sinyallerini kaynaklar arası depolama alanına yazmanıza ve daha sonra Private Aggregation kullanarak bu verileri raporlamanıza olanak tanır.

Protected Audience API raporlamasına genel bakış

Protected Audience API açık artırma akışından elde edilen verilerin sunucunuza raporlanabileceği üç ana dönem vardır: açık artırmanın yayıncı sitesinden yürütüldüğü açık artırma zamanı, reklamın yayıncı sitesindeki bir fenced frame veya iframe'e yerleştirildiği oluşturma zamanı ve kullanıcının açık artırmayla ilişkilendirilebilecek başka bir sitede işlem yaptığı dönüşüm zamanı.

Açık artırma sırasında, raporlama işlevlerini kullanarak açık artırma verilerini bildirebilirsiniz. Oluşturma sırasında, bir iFrame veya sınırlı çerçeveden etkileşim verilerini bildirebilirsiniz. Dönüşüm sırasında, Attribution Reporting API'yi kullanarak hedef sayfadaki ilişkilendirme verilerini bildirebilirsiniz.

Raporlama konumları

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

Listelenen her dönemde alıcılar ve satıcılar, açık artırma sinyalleri, etkinlik düzeyinde 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 bir Protected Audience API işletiğinden raporlanabilir.

Sinyaller

Sinyaller, bir teklif oluşturmak, bir reklama puan vermek ve açık artırma sonuçlarını bildirmek için bir işlevlet içindeki alıcılar ve satıcılar tarafından kullanılabilen açık artırma bağlamsal verileri, kullanıcı verileri, gerçek zamanlı veriler ve tarayıcı verileridir.

auction config nesnesi, işlevlerde sinyal olarak kullanılmak üzere sağlanan verilerin birincil kaynağıdır. Yayıncı ve satıcı, açık artırma yapılandırmasında içeriğe dayalı veriler ve birinci taraf verileri sağlayabilir. Bu sinyaller, alıcının ilgi alanı grubu verileri, reklam oluşturma çerçevesindeki etkinlik düzeyinde veriler ve tıklama sonrası sayfadaki ilişkilendirme verileriyle zenginleştirilebilir. Raporlanan veriler; alıcı/satıcı raporlaması, faturalandırma, bütçelendirme, makine öğrenimi modeli eğitimi ve daha birçok amaç için kullanılabilir.

Diğer kullanılabilir veriler

• Kazanılan teklif fiyatı ve teklifin reddedilme nedeni gibi açık artırma kazanma ve kaybetme verileriyle ilgili sonuç verileri.
• Teklif işlevinin getirilmesi ve yürütülmesinin 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.

Oluşturma sırasında, reklam yayıncı sitesinde oluşturulduğunda iFrame veya sınırlı çerçeve içindeki etkinlik düzeyindeki veriler Protected Audience API açık artırma verileriyle ilişkilendirilebilir ve sunucunuza bildirilebilir. Örnek etkinlik düzeyindeki veriler arasında reklam gösterimi, tıklama, fareyle üzerine gelme ve çerçeve içinde gerçekleşen diğer etkinlikler yer alır.

Dönüşüm sırasında, bir kullanıcı açık artırmayla ilişkilendirilen tıklama sonrası sayfasında bir işlem gerçekleştirdiğinde dönüşüm sayfasındaki etkinlik düzeyinde 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. Etkinlik; açık artırma kazanma, reklam gösterimi veya dönüşüm olabilir. Etkinlik düzeyinde açık artırma kazanma raporlaması en az 2026'ya kadar devam edecek, Protected Audience reklamı oluşturmak için sınırlı çerçeveler gerekmeyecek ve etkinlik düzeyinde raporlama için sınırsız ağ erişimine sahip bir iFrame kullanılabilecek. Ayrıca, açık artırma ve dönüşüm verilerini çerçevedeki etkinlik düzeyinde verilerle ilişkilendirmeniz için Ads Reporting API, sınırlı çerçevelerde ve iFrame'lerde kullanılabilir. Bu özellik, sisteminizi Protected Audience'a taşırken en az 2026'ya kadar mevcut raporlama altyapınızı kullanmaya devam edebileceğiniz için ekosistemin geçiş sürecini kolaylaştırmak üzere tasarlanmıştır.

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

Protected Audience açık artırmasındaki etkinlik düzeyinde verileri raporlamak için kullanılabilen bir mekanizma, açık artırma kazanıldığında sendReportTo() function'dır. Bu işlev, alıcı ve satıcı raporlama işlevletlerinde kullanılabilir. Tarayıcı, reklam oluşturma işlemi başladığında sağlanan URL dizesine GET isteği gönderir. İş öğelerinizde bulunan tüm sinyalleri URL'nin sorgu parametreleri olarak kodlayabilirsiniz.

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

// 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 üzere kullanılabilir. sendReportTo() işlevi en az 2026'ya kadar kullanılabilir.

Etkileşim raporu

Etkileşim raporu, reklamı oluşturmuş olan Protected Audience API açık artırmasının sinyalleriyle ilişkili gösterim veya tıklama verileri gibi bir reklam öğesinden alınan etkinlik düzeyinde verileri içerir. Reklam, açık artırma sona erdikten sonra oluşturulduğu için açık artırma sinyalleri, reklamı oluşturan çerçevede kullanılamaz. Farklı dönemlere ait bu verileri ilişkilendirmek için etkileşim raporları oluşturmanıza yardımcı olacak iki geçiş mekanizması sunuyoruz.

Yukarıda açıklanan sendReportTo() işlevi, açık artırma verilerini bir iFrame'deki etkinlik düzeyindeki verilerle ilişkilendirmek için kullanılabilir ancak yerleştirici ile sınırlı çerçeve arasındaki iletişim sınırlı olduğundan yerleştiriciden benzersiz bir kimlik geçirilemediği için sınırlı çerçevelerde çalışmaz. Açık artırma verilerini, sınırlı çerçeve reklamından gelen etkinlik düzeyindeki verilerle ilişkilendirmek için Ads Reporting API kullanılabilir.

Sınırlı çerçeveler ve iframe'ler için Ads Reporting API

Fenced frame'ler ve iframe'ler için Ads Reporting API, bir reklam çerçevesindeki kullanıcı etkinliği düzeyindeki verileri Protected Audience açık artırmasındaki sinyallerle ilişkilendirmenize olanak tanıyan bir mekanizma sağlar.

Protected Audience API raporlama işletiğinde registerAdBeacon() işleviyle bir reklam işaretçisi kaydedebilir ve raporlama URL'nizi sorgu parametreleri olarak eklenen sinyallerle birlikte iletebilirsiniz. Ayrıca, raporlama URL'siyle ilişkilendirmek istediğiniz özel etkinliği de belirtirsiniz. Daha sonra, reklam sınırlı çerçevede oluşturulduğunda window.fence.reportEvent() işlevini çağırarak özel etkinliği tetikleyebilirsiniz. Sınırlı ç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, bir kampanya kimliği, tıklama koordinatlarını içeren etkinlik düzeyinde bir yükle ilişkilendirilmiştir:

// 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 de kazanma raporlamasıyla aynı nedenlerden dolayı en az 2026'ya kadar kullanılabilecek.

Daha ayrıntılı bilgi için açıklayıcı metne bakın.

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

Sınırlı kapsamlı çerçeveler, ağ kaynaklarının bir iFrame ile aynı şekilde yüklenmesine olanak tanır ve sınırlı kapsamlı çerçeveler içindeki etkinlik düzeyinde verileri sunucunuza gönderebilirsiniz. Yukarıdaki açık artırma etkinliği düzeyinde raporlama mekanizması bölümünde ele alınan sendReportTo() ile gönderilen açık artırma verileriyle, sınırlı alandaki etkinlik düzeyinde verileri ilişkilendirerek daha sonra sunucu tarafında etkinlik düzeyinde raporlar oluşturabilirsiniz.

Ağ erişimi gelecekte 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ı yayınladığınız bir ürün reklamını tıklayabilir, reklamverenin sitesine yönlendirilebilir, burada bir satın alma işlemi gerçekleştirebilir ve siz de satın alma işlemini gösterilen reklamla ilişkilendirmek isteyebilirsiniz. Attribution Reporting API, yayıncı sitesindeki açık artırma verileri ile reklamveren sitesindeki dönüşüm verilerini birleştirmek için Protected Audience API ile entegre edilecek.

Daha kalıcı bir çözüm tasarlarken, çitlenmiş çerçeveler için Ads Reporting API'yi, ilişkilendirme raporlaması ile etkinlik düzeyinde ve toplanabilir bir rapor oluşturmaya yönelik geçiş mekanizması olarak kullanabilirsiniz. Bu raporların dönüşümü ölçmek için kullanıldığını ve açık artırmadan ve reklam çerçevesinden oluşturulan etkinlik düzeyinde ve toplanabilir 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 makale yayınlayacağız.

Geçiş mekanizması

Bir reklam işaretçisini kaydederken reserved.top_navigation anahtar kelimesini kullanabilirsiniz. Bu anahtar kelime, işaretçinin bir ilişkilendirme kaynağı olarak kaydedilmeye uygun olması için Attribution-Reporting-Eligible üstbilgisini otomatik olarak ekler.

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

Etkinlik düzeyindeki verileri kaydettiğiniz işaretçiye eklemek için etkinlik yüküyle birlikte sınırlı çerçeveden setReportEventDataForAutomaticBeacons() işlevini ç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 Attribution Reporting bölümünü inceleyin.

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

Bu örnekte, verileri açık artırma, reklam çerçevesi ve dönüşüm sitesinden ilişkilendirmek isteyen alıcı perspektifinden bakacağız.

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

İş akışı:

1. Müzayede 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 iletilir ve alıcının işlevletlerinde kullanılabilir.
2. Açık artırma sırasında alıcı, reklam oluşturma süresi ve dönüşüm süresi boyunca tetiklenecek bir reklam işaretçisi kaydedebilir (registerAdBeacon()).
   1. Bir reklam çerçevesi etkinliği için açık artırma sinyallerini ilişkilendirmek üzere auctionId değerini işaretçi URL'sinin sorgu parametresi olarak ayarlayın.
   2. Bir dönüşüm etkinliği için açık artırma sinyallerini ilişkilendirmek üzere işaretçi URL'sinde auctionId değerini ayarlayın.
3. Reklam oluşturma süresi boyunca, açık artırma sırasında kaydettiğiniz işaretçiler tetiklenebilir veya etkinlik düzeyindeki verilerle geliştirilebilir.
   1. reportEvent() ile çerçeve etkinliğini tetikleyin ve etkinlik düzeyindeki verileri iletin.
   2. setReportEventDataForAutomaticBeacons() ile ilişkilendirme işaretçisine etkinlik düzeyinde yük ekleme
   3. Attribution-Reporting-Register-Source üstbilgisiyle reklam işaretçisi isteklerine 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ı, açık artırma raporu, etkileşim raporu ve dönüşüm raporuna sahip olur. Bu raporların tümü, birbirleriyle ilişkilendirmek için kullanılabilecek tek bir benzersiz anahtarla bağlanır.

Benzer iş akışı, ilişkilendirme verilerine erişmesi gereken bir satıcı için de geçerlidir. Satıcı, registerAdBeacon() ile göndermek için benzersiz bir kimlik de kullanabilir. Çerçeveden gelen 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 kaynağa atfedilmesi için SSP'nin açılış sayfasında da bulunması gerektiğini unutmayın.

Protected Audience verilerini toplama

Private Aggregation API, Protected Audience verilerini raporlamak için kullanılan mekanizmadır. Bu mekanizma, gruplar halinde toplanan verilerin gürültülü ve toplu bir raporu olan özet raporu oluşturur. Bucket, bir toplama anahtarıyla temsil edilir ve anahtara bazı bilgiler kodlanabilir.

Örneğin, bir reklam gösterimi etkinliği farklı gruplara dahil edilebilir. Bu grupların her biri farklı bir reklam kampanyasını temsil eder. Özet rapor, her bir etkinlikle ilgili bilgileri göstermemesi nedeniyle etkinlik düzeyindeki rapordan farklıdır. Etkinlik düzeyindeki bir raporla A, B ve C kullanıcılarının 123 kampanyasını gördüğünü belirleyebilirsiniz. Özet raporlarla 123 kampanyasını gören kullanıcı sayısını ölçebilirsiniz. Kullanıcı gizliliğini korumak için gürültü eklenir.

API hakkında daha fazla bilgi için Private Aggregation makalesine bakın.

Açık artırma sinyallerini toplama

Private Aggregation'ı kullanarak iş parçacıklarında bulunan sinyalleri sunucunuzda toplayabilirsiniz. Sinyal toplama için alıcı teklifi işlevinde, satıcı puanlama işlevinde ve alıcı/satıcı raporlama işlevlerinde bulunan privateAggregation.contributeToHistogram() yöntemini kullanabilirsiniz.

Bu örnekte, kazanan teklif ilgi grubu sahibi paketinde toplanı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şkilendirilmediğinde ve açık artırma dışındaki bir etkinlik tarafından tetiklenmediğinde kullanılması gereken genel mekanizmadır. Açık artırma sinyallerini raporlama hakkında daha fazla bilgi edinmek için açıklayıcı bölümüne bakın.

Açık artırma sinyallerini etkinlik verileriyle toplama

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

Açık artırma sinyallerini etkinliklere göre toplamak için privateAggregation.contributeToHistogramOnEvent(eventType, contribution) işlevini kullanabilirsiniz. Bu işlev, etkinlik türünü ve etkinlik tetiklendiğinde raporlanacak katkıyı belirten bir dize alır. Yöntemi özel bir etkinlik türüyle çağırabilir, ardından raporun gönderilmesini tetiklemek için reklam çerçevesinden window.fence.reportEvent(eventType) çağrısı yapabilirsiniz.

Bir kampanyanın reklamını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, bir grubu kampanya kimliği ve tıklama etkinliğinin kombinasyonu olarak tanımlayabilir, ardından etkinlik her tetiklendiğinde bu grubun değerini 1 artırabilirsiniz.

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

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

Bir çerçeveden Private Aggregation katkılarının tetiklenmesi hakkında daha fazla bilgiyi açıklayıcı belgede bulabilirsiniz.

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

Ayrıca, ayrılmış bir etkinlik türü anahtar kelimeleri (reserved.win, reserved.loss ve reserved.always) ilettiğinizde bir açık artırma kazanma veya kaybetme etkinliği tarafından tetiklenen açık artırma sonuçlarını contributeToHistogramOnEvent(eventType, contribution) ile toplu hale getirebilirsiniz.

Özel toplama, katkınızın aralığını ve değerini hesaplayabileceğiniz bir temel değerler listesi sağlar. Açık artırma sonuçları için kullanılabilen temel değerler, kazanan reklamın teklif değeri, en yüksek ikinci puanı alan teklifin değeri ve bir teklifin açık artırmadan reddedilme nedenidir.

Kazanan teklif tutarı gibi bir temel değer sağlandığında bu değere ne kadar ekleme veya çıkarma yapacağınızı belirleyebilir, ardından nihai değeri raporlayabilirsiniz. Örneğin, 5 ABD doları tutarındaki kazanan teklif temel değer olarak sağlanıyorsa açık artırmayı ne kadar kaybettiğinizin gerçek değeri olan 3 ABD dolarını hesaplamak için 2 ABD doları tutarındaki teklifinizi çıkarabilirsiniz.

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

Bir açık artırmayı kaybettiğiniz ve teklifinizin açık artırma kapanış fiyatından ne kadar uzak olduğunu öğrenmek istediğiniz bir örneğe bakalım.

Açık artırmayı ne kadar farkla 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, bildirilen gerçek değer, baseValue değeriyle offset değeri kadar kaydırılmış ölçeklendirilmiş değer olur. Daha fazla bilgi edinmek için açıklayıcıya bakın.

Performans raporlaması

Alıcılar ve satıcılar, bir komut dosyasının yürütülmesinin ve güvenilir sinyallerin getirilmesinin ne kadar sürdüğünü bildirebilir. Satıcılar, her alıcının teklif oluşturma süresini ve güvenilir teklif sinyali süresini izniyle toplayabilir.

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

Açık artırma sinyallerini Shared Storage'da depolama

Paylaşılan depolama alanı, serbestçe yazabileceğiniz ancak depolanan değerleri okurken ve işlerken kapılarla korunan, bölümlenmemiş ve kaynaklar arası bir depolama alanıdır. Shared Storage API için kullanılabilen geçitlerden biri Private Aggregation'dır. Paylaşılan depolamadaki değerleri yalnızca bir işlevletin içinden okuyabilir ve bu değerleri işlevletten Özel Toplama'yı kullanarak raporlayabilirsiniz.

Ayrıca Protected Audience API teklif verme, puanlama ve raporlama iş parçacıklarından ortak depolama alanına yazabilirsiniz. Daha sonra, Private Aggregation'ı kullanarak bu değerleri paylaşılan depolama alanında sunucunuza bildirebilirsiniz . URL Seçimi işlemi için depolanan değerleri de kullanabilirsiniz.

Protected Audience API işletiğinden, paylaşılan depolama alanına herhangi bir anahtar ve değer yazabilirsiniz:

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

Daha sonra, bu değeri okumak ve Private Aggregation ile göndermek için paylaşılan depolama işleti yükleyebilirsiniz:

// 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);

Shared Storage hakkında daha fazla bilgi edinmek için Protected Audience API raporlama geliştirici kılavuzunun Shared Storage bölümüne, açıklayıcı, canlı demo ve GitHub'daki demo koduna bakı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.