Gösterim bildirimleri alma

Google, verilerinizin segmentlerinin gerçek zamanlı teklif açık artırmasında kazanan bir teklifte kullanıldığını ve gösterimle sonuçlandığını her tespit ettiğinde gösterim bildirimleri alabilirsiniz. Google, veri segmentlerinizin nasıl kullanıldığı hakkında daha fazla bilgi edinmek için gösterim bildirimleriyle entegrasyon yapmanızı önerir. Gösterim bildirimlerini etkinleştirmek için hesap yöneticinizle iletişime geçin.

Gösterim bildirimi uç noktanızı yapılandırma

Gösterim bildirimleri almak için bir HTTP uç noktası oluşturup URL'sini Google ile paylaşmanız gerekir. Gösterim bildirimlerinin gönderileceği URL'yi aşağıdaki seçeneklerden biriyle ayarlayabilirsiniz:

  1. Her bir anlık içerik seçimi çağrısı için gösterim bildirimi uç nokta URL'sini ayarlayın.
    • SegmentResponse.burl alanını doldurarak aldığınız her Gerçek Zamanlı Seçim açıklama metni için gösterim bildirimlerinde kullanılan URL'yi dinamik olarak ayarlayabilirsiniz.
    • Belirli bir anlık içerik seçimi çağrısı için, bu çağrıya ilişkin bir gösterim bildirimi almak üzere SegmentResponse.burl alanını ayarlamanız gerekir. SegmentResponse.burl alanı doldurulmamışsa önceki açıklama metinlerinde SegmentResponse.burl alanı ayarlanmış olsa bile bu açıklama metni için bildirim gönderilmez.
  2. Hesap düzeyinde gösterim bildirimi uç noktası URL'si ayarlayın.
    • Hesap yöneticinizle iletişime geçerek hesabınız için hesap düzeyinde bir gösterim bildirimi uç nokta URL'si ayarlayabilirsiniz. Bu yöntem, uç nokta URL'niz nadiren değişiyorsa idealdir.
    • Tüm Anlık Seçim açıklama metinleri, tek bir Anlık Seçim açıklama metni için SegmentResponse.burl alanını ayarlayarak hesap düzeyindeki URL'yi geçersiz kılmadığınız sürece hesabınız için yapılandırdığınız hesap düzeyindeki gösterim bildirimi URL'sini kullanır.

Gösterim bildirimini ayrıştırma

Gösterim bildiriminde gönderilen bilgiler, gösterim bildirimi uç noktası URL'nizin yapılandırmasına bağlıdır. Uç nokta URL'niz sorgu parametreleri içerebilir ve verilerinizin nasıl kullanıldığı hakkında ek bağlam eklemek için makrolar kullanabilir. segmentler, bir gösterimle sonuçlanan kazanan teklif tarafından kullanıldı.

Makroların nasıl genişletildiğini anlama

Uç nokta URL'nizi makro olarak ayarlanan bir veya daha fazla sorgu parametresi içerecek şekilde yapılandırırsanız uç noktanıza gönderilen gösterim bildirimleri bu makroları genişleterek makroları karşılık gelen değerleriyle değiştirir.

Örneğin, aşağıdaki gibi bir gösterim bildirimi uç nokta URL'si yapılandırabilirsiniz:

https://testendpoint.com/impressions?segmentReqId=${SR_ID}&segmentIds=${SEGMENT_IDS}

Bir gösterim bildirimi alındığında makrolar değiştirilerek URL'nin aşağıdaki gibi görünmesine neden olur:

https://testendpoint.com/impressions?segmentReqId=8Mbl39sMOX5yg1NZgS35ET&segmentIds=test-ds-1|test-ds-2

Desteklenen makrolar hakkında bilgi

Aşağıda, gösterim bildirimi uç nokta URL'sinin sorgu parametrelerine ekleyebileceğiniz makrolar verilmiştir. Bu makroların yerini, veri segmentlerinizden bir veya daha fazlasının katkıda bulunduğu kazanan teklifle ilgili değerler alır.

Makro Açıklama
${SR_ID} İlgili anlık seçme açıklama metni için SegmentRequest.segment_request_id alanına eşdeğer benzersiz bir dize kimliği. Bu, kazanan teklife katkıda bulunan bir veya daha fazla veri segmenti kimliğiyle yanıtladığınız segment isteğini ifade eder.
${SEGMENT_IDS} Kazanan teklife katkıda bulunan dize veri segmenti kimliklerinin listesi. Listedeki her öğe "|" karakteriyle ayrılır. Örneğin, bu liste aşağıdaki gibi bir değer listesiyle genişletilebilir: "segmentId1|segmentId2|segmentId3" Listeyi dolduran her veri segmenti kimliği, Marketplace API'deki ilgili curators.dataSegments kaynağının kaynak kimliğini ifade eder.
${AUCTION_PRICE} Açık artırmanın kazanan fiyatını temsil eden bir dize. Fiyat, mikro ABD doları cinsinden ifade edilen tek bir gösterimin maliyetidir (BGB). Örneğin, 5 ABD doları BGBM tutarındaki bir gerçek zamanlı teklif, Gerçek Zamanlı Seçim gösterim bildiriminde ${AUCTION_PRICE} makrosunun 5.000 mikro ABD doları YBM'ye genişlemesine neden olur.
${DEAL_ID} Açık artırmayı kazanan anlaşmanın veya paketin kimliği. Bu, ${SEGMENT_IDS} makrosuyla tanımlanabilen, veri segmenti kimliklerinizden birini veya daha fazlasını hedefleyen bir fırsat ya da pakettir.
${BUYER_SEAT_ID} Kazanan teklifte teklif veren tarafından belirtildiği şekilde, gösterimi kazanan alıcı lisansının kimliği. Örneğin, alıcı koltukları ajanslar veya reklamverenler olabilir.

Sonraki adımlar