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

bookmark_border Koleksiyonlar ile düzeninizi koruyun İçeriği tercihlerinize göre kaydedin ve kategorilere ayırın.

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 alternatif çözümler hazır olana kadar taşıma sırasında kullanabileceğiniz geçiş mekanizmalarına genel bir bakış sunulmaktadır.

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.
• Çitli çerçeveler 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çindeki bir kanaldır. API, etkinlik düzeyindeki verileri açık artırma sinyalleriyle ilişkilendirmenize olanak tanır. Daha gizli bir raporlama mekanizması tasarlanana kadar Ads Reporting API'nin etkinlik düzeyinde raporlaması geçiş mekanizması olarak kullanılacaktır.
• Dönüşüm verilerini açık artırma sinyalleriyle ilişkilendirmenize olanak tanıyan İlişkilendirme Raporları.
• Açık artırma sinyallerini kaynaktan bağımsız bir depolama alanına 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ırmanın yayıncı sitesinden yürütüldüğü açık artırma zamanı, reklamın yayıncı sitesinde çitle çevrili bir çerçeveye veya iFrame'e oluşturulduğu oluşturma zamanı 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 zamanı.

Açık artırma sırasında, raporlama iş parçacıklarını kullanarak açık artırma verilerini raporlayabilirsiniz. Oluşturma sırasında, bir iframe'den veya çitle çevrili çerçeveden etkileşim verilerini bildirebilirsiniz. Dönüşüm süresi boyunca, Attribution Reporting API'yi kullanarak hedef sayfadaki ilişkilendirme verilerini bildirebilirsiniz.

Bildirilen konumlar

Açık artırmalarda alıcılar generateBid() ve reportWin() iş parçacıklarında bulunan sinyalleri, satıcılar ise scoreAd() ve reportResult() iş parçacıklarında bulunan 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 veri bildirebilir.

Listelenen her dönemde 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 ç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ş parçasından raporlanabilir.

Sinyaller

Sinyaller, teklif oluşturmak, reklam puanlamak ve açık artırma sonuçlarını bildirmek için alıcı ve satıcıların bir iş parçasında kullanabileceği açık artırma bağlamsal verileri, kullanıcı verileri, gerçek zamanlı veriler ve tarayıcı verileridir.

auction config nesnesi, iş parçacıklarında sinyal olarak kullanılacak birincil veri 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ıdan gelen ilgi alanı grubu verileri, reklam oluşturma çerçevesinden gelen etkinlik düzeyindeki veriler ve tıklama sayfasından gelen ilişkilendirme verileriyle zenginleştirilebilir. Bildirilen veriler alıcı/satıcı raporları, faturalandırma, bütçe, makine öğrenimi modeli eğitimi ve daha fazlası için kullanılabilir.

Diğer kullanılabilir veriler

• Açık artırma kazanma ve kaybetme verileriyle (ör. kazanan teklif fiyatı ve teklifin reddedilme nedeni) ilgili sonuç verileri.
• Teklifli sistem iş parçacığının getirilmesi ve yürütülmesi için geçen süre gibi gecikme bilgilerini içeren performans verileri.

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

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

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

Dönüşüm süresi sırasında, bir kullanıcı tıklama sayfasında açık artırmaya atfedilen bir 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 etkinlikten alınan ayrıntılı bilgileri içerir. Etkinlik; açık artırma kazanması, reklam gösterimi veya dönüşüm olabilir. En az 2026'ya kadar etkinlik düzeyinde açık artırma kazancı raporlaması geçerli olmaya devam edecek, korumalı kitle reklamı oluşturmak için çitle çevrili çerçeveler gerekmeyecek ve etkinlik düzeyinde raporlama için sınırsız ağ erişimi olan bir iFrame kullanılabilir. Ayrıca, açık artırma ve dönüşüm verilerini çerçevedeki etkinlik düzeyindeki verilerle ilişkilendirmek için Ads Reporting API, çitle çevrili çerçevelerde ve iFrame'lerde kullanılabilir. Bu, 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ş için daha kolay bir yol izlemesini sağlamak üzere tasarlanmıştır.

sendReportTo() ile etkinlik düzeyinde açık artırma kazancı raporlaması

Protected Audience açık artırması içindeki etkinlik düzeyindeki verileri raporlamak için kullanılabilecek bir mekanizma, açık artırma kazanışındaki sendReportTo() function'tır. İşlev, alıcı ve satıcı raporlama iş parçacıklarında kullanılabilir. Reklam oluşturma işlemi başladığında tarayıcı, sağlanan URL dizesine bir GET isteği gönderir. Çalışma parçalarınızda bulunan tüm sinyalleri URL'nin sorgu parametreleri olarak kodlayabilirsiniz.

Örneğin, bir alıcı faturalandırma amacıyla reportWin() iş parçasından 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() çağrısı alındığında satıcı için bir kazanç raporu, reportWin() çağrısı alındığında ise alıcı için bir kazanç raporu oluşturmak amacıyla kullanılabilir. sendReportTo() işlevi en az 2026'ya kadar kullanılabilir.

Etkileşim raporu

Etkileşim raporu, reklam öğesinden alınan etkinlik düzeyindeki verileri (ör. reklamı oluşturan Protected Audience API açık artırmasının sinyalleri ile ilişkili gösterim veya tıklama verileri) içerir. Reklam, açık artırma sona erdikten sonra oluşturulduğundan 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 olanak tanıyan 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 çitle çevrili çerçeve arasındaki iletişim sınırlı olduğundan yerleştirici tarafından benzersiz bir kimlik iletilemediği için çitle çevrili çerçeve için çalışmaz. Açık artırma verilerini, çevrili çerçeve reklamdaki etkinlik düzeyindeki verilerle ilişkilendirmek için Ads Reporting API kullanılabilir.

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

Çitli çerçeveler ve iFrame'ler için Ads Reporting API, bir reklam çerçevesindeki kullanıcı etkinlik 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ş parçasında, registerAdBeacon() işleviyle bir reklam işaretçisi kaydedebilir ve raporlama URL'nizi, sorgu parametreleri olarak eklenen sinyallerle iletebilirsiniz. Ayrıca, raporlama URL'siyle ilişkilendirmek istediğiniz özel etkinliği de belirtirsiniz. Daha sonra, reklamın çevrili bir çerçevede oluşturulduğu daha sonraki bir zamanda window.fence.reportEvent() işlevini çağırarak özel etkinliği tetikleyebilirsiniz. Çitlenen çerçevede bulunan veriler yük olarak eklenebilir.

registerAdBeacon() işlevi yalnızca raporlama işlevlerinde kullanılabilir ve alıcının teklif verme mantığı ile 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ük ile 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']
});

Çitli çerçeve reklam raporlama API'si de kazanç raporlamayla aynı nedenlerden dolayı en az 2026'ya kadar kullanılabilir.

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

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

Çitli çerçeveler, ağ kaynaklarının bir iFrame'de olduğu gibi yüklenmesine olanak tanır. Çitli çerçeveler içindeki etkinlik düzeyindeki verileri sunucunuza gönderebilirsiniz. Daha sonra, çitle çevrili bir çerçevedeki etkinlik düzeyindeki verileri, yukarıdaki açık artırma etkinlik 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.

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 ve burada satın alma işlemi gerçekleştirebilir. Bu durumda, satın alma işlemini gösterilen reklamla ilişkilendirmek istersiniz. Attribution Reporting API, yayıncı sitesindeki açık artırma verilerini ve reklamveren sitesindeki dönüşüm verilerini birleştirmek için Protected Audience API ile entegre edilecek.

Daha kalıcı bir çözüm tasarlarken, ilişkilendirme raporlamasıyla etkinlik düzeyinde ve toplanabilir bir rapor oluşturmak için geçiş mekanizması olarak çitle çevrili çerçeveler için Ads Reporting API'yi kullanabilirsiniz. Bu raporların dönüşümü ölçmek için kullanıldığını ve açık artırma ile reklam çerçevesinden oluşturulan etkinlik düzeyindeki ve toplanabilir etkileşim raporlarından ayrı olduğunu unutmayın. Hazır olduğunda daha kalıcı bir çözümle ilgili bir açıklama yayınlayacağız.

Geçiş mekanizması

Reklam işaretçisi kaydederken reserved.top_navigation anahtar kelimesini kullanabilirsiniz. Bu anahtar kelime, işaretçinin ilişkilendirme kaynağı olarak kaydedilmeye uygun olması için Attribution-Reporting-Eligible başlığını otomatik olarak ekler.

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

Kayıt ettiğiniz işaretçiye etkinlik düzeyinde veri eklemek için çitle çevrili çerçeveden etkinlik yükü ile setReportEventDataForAutomaticBeacons()'ü ç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çıklamalı kılavuzunun İlişkilendirme Raporlaması bölümüne göz atın.

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

Bu örnekte, açık artırma, reklam çerçevesi ve dönüşüm sitesinden gelen verileri bir araya getirmek isteyen bir alıcının bakış açısından konuya bakacağız.

Bu iş akışında alıcı, açık artırmaya benzersiz bir kimlik göndermek için satıcıyla koordinasyon sağlar. 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ırasında, çitle çevrili çerçeve veya iframe'deki veriler de aynı benzersiz kimlikle gönderilir. Benzersiz kimlik daha sonra bu raporları birbirine ilişkilendirmek için kullanılabilir.

İş akışı:

1. Alıcı, açık artırma başlamadan önce programatik gerçek zamanlı teklif verme ("GZT") teklif yanıtı kapsamında 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 worklet'lerinde kullanılabilir hale gelir.
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 üzere auctionId'yi 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 sırasında, açık artırma süresi boyunca kaydettiğiniz işaretçiler tetiklenebilir veya etkinlik düzeyindeki verilerle 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ü ekleme
   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ı, açık artırma raporu, etkileşim raporu ve dönüşüm raporu alır. Bu raporların tümü, birbirleriyle ilişkilendirmek için kullanılabilecek tek bir benzersiz anahtarla birbirine bağlanır.

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

Protected Audience verilerini toplama

Private Aggregation API, korumalı kitle 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. Paket, bir toplama anahtarıyla temsil edilir ve bazı bilgiler anahtara kodlanabilir.

Örneğin, bir reklam gösterimi etkinliği farklı gruplara ayrılabilir. Her grup farklı bir reklam kampanyasını temsil eder. Özet rapor, her bir etkinlikle ilgili bilgi göstermemesi bakımından etkinlik düzeyindeki rapordan farklıdır. Etkinlik düzeyinde 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 Özel Toplama makalesine bakın.

Açık artırma sinyallerini toplama

Özel toplama özelliğini kullanarak iş parçacıklarında bulunan sinyalleri sunucunuzda 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ışında bulunan privateAggregation.contributeToHistogram() yöntemini kullanabilirsiniz.

Bu örnekte, kazanan teklif ilgi alanı grubu sahibi grubuna 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şkili değilse ve açık artırmanın dışındaki bir etkinlik tarafından tetiklenmiyorsa kullanılacak genel mekanizma budur. Açık artırma sinyallerini raporlama hakkında daha fazla bilgi edinmek için açıklamayı inceleyin.

Açık artırma sinyallerini etkinlik verileriyle toplama

Açık artırma sinyallerini, reklam çerçevesinde gerçekleşen bir etkinlikle ilgili sınırlı bilgilerle toplayabilirsiniz. Örneğin, bir kampanyanın reklamının aldığı tıklama sayısını toplu olarak ölçmek için söz konusu kampanyayı ve tıklama etkinliğini temsil eden bir grup oluşturabilirsiniz. Reklam çerçevesinde hangi etkinliğin gerçekleştiğini belirtebileceğinizi ancak etkinlik düzeyinde bir yükü ekleyemediğ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) işlevini kullanabilirsiniz. Özel etkinlik türüyle yöntemi çağırabilir, ardından raporun gönderilmesini tetiklemek için reklam çerçevesinden window.fence.reportEvent(eventType)'ü çağırabilirsiniz.

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

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

Ardından, daha sonra reklam çerçevesinden reportEvent(eventType) işlevini çağırarak rapor göndermeyi tetikleyebilirsiniz:

Özel toplama katkılarını bir kareden tetikleme hakkında daha fazla bilgiyi açıklayıcı makalede bulabilirsiniz.

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

Ayrıca, ayrılmış etkinlik türü anahtar kelimelerini (reserved.win, reserved.loss ve reserved.always) ilettiğinizde açık artırma kazanması veya kaybetmesi etkinliği tarafından tetiklendiğinde açık artırma sonuçlarını contributeToHistogramOnEvent(eventType, contribution) ile toplayabilirsiniz.

Özel toplama, katkınızın grubunu 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, ikinci en yüksek puan alan teklif 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 ekleneceğini veya bu değerden ne kadar çıkarılacağını ayarlayabilir ve ardından nihai değeri bildirebilirsiniz. Örneğin, taban değer olarak 5 ABD doları olan kazanan teklif sağlanırsa açık artırmayı kaç saniyeyle kaybettiğinizi hesaplamak için 2 ABD doları olan teklifinizi çıkararak 3 ABD doları olan gerçek değeri hesaplayabilirsiniz.

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

Bir açık artırmayı kaybettiğinizi ve teklifinizin açık artırma fiyatı ile ne kadar farklı olduğunu öğrenmek istediğinizi varsayalı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, raporlanan gerçek değer, offset değeriyle kaydırılmış ölçeklendirilmiş baseValue olur. Daha fazla bilgi için açıklamayı inceleyin.

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 zamanını ve güvenilir teklif sinyal zamanını izinleri doğrultusunda toplayabilir.

Daha fazla bilgi edinmek için açıklamayı inceleyin.

Açık artırma sinyallerini Paylaşılan Depolama'da saklama

Paylaşılan depolama alanı, bölümlere ayrılmamış ve kaynak ötesi bir depolama alanıdır. Bu alana özgürce yazabilirsiniz ancak depolanan değerleri okurken ve işlerken kapılarla korunur. Paylaşılan Depolama API'si için kullanılabilen kapılardan biri Özel Toplama'dır. Paylaşılan depolama alanındaki değerleri yalnızca bir iş parçasının içinden okuyabilir ve bu değerleri iş parçasından Özel Toplama'yı kullanarak raporlayabilirsiniz.

Protected Audience API teklif verme, puanlama ve raporlama iş parçacıklarından da ortak 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.

Protected Audience API iş parçacığında, paylaşılan depolama alanına istediğiniz anahtarları ve değerleri yazabilirsiniz:

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

Daha sonra, bu değeri Özel Toplama ile okuyup göndermek için paylaşılan depolama alanı iş parçacığı 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);

Paylaşılan depolama alanı hakkında daha fazla bilgi edinmek için Protected Audience API raporlama geliştirici kılavuzunun paylaşılan depolama alanı bölümüne, açıklayıcı sayfaya, canlı demo'ya 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.