Otrzymywanie powiadomień o wyświetleniach

Możesz otrzymywać powiadomienia o wyświetleniach, gdy Google wykryje, że Twoje segmenty danych zostały użyte w wygrywającej ofercie w aukcji z określaniem stawek w czasie rzeczywistym i spowodowały wyświetlenie. Aby dowiedzieć się więcej o tym, jak są używane Twoje segmenty danych, Google zaleca integrację z powiadomieniami o wyświetleniach. Aby włączyć powiadomienia o wyświetleniach, skontaktuj się z menedżerem konta.

Konfigurowanie punktu końcowego powiadomienia o wyświetleniu

Aby otrzymywać powiadomienia o wyświetleniach, musisz utworzyć punkt końcowy HTTP i udostępnić jego adres URL Google. Adres URL, na który mają być wysyłane powiadomienia o wyświetleniach, możesz ustawić za pomocą jednej z tych opcji:

  1. Ustaw adres URL punktu końcowego powiadomienia o wyświetleniu dla każdego wywołania funkcji Real-time Curation.
    • Możesz dynamicznie ustawiać adres URL używany w powiadomieniach o wyświetleniach w przypadku każdego wywołania funkcji Real-time Curation, wypełniając pole SegmentResponse.burl.
    • W przypadku danego wywołania funkcji Real-time Curation musisz ustawić pole SegmentResponse.burl, aby otrzymywać powiadomienie o wyświetleniu w przypadku tego wywołania. Jeśli pole SegmentResponse.burl nie jest wypełnione, nie zostanie wysłane powiadomienie o tym wywołaniu, nawet jeśli pole SegmentResponse.burl było ustawione we wcześniejszych wywołaniach.
  2. Ustaw adres URL punktu końcowego powiadomień o wyświetleniach na poziomie konta.
    • Aby ustawić URL punktu końcowego powiadomień o wyświetleniach na poziomie konta, skontaktuj się z menedżerem konta. Jest to idealne rozwiązanie, jeśli adres URL punktu końcowego zmienia się rzadko.
    • Wszystkie wywołania funkcji Real-time Curation będą korzystać z adresu URL powiadomienia o wyświetleniu na poziomie konta, który skonfigurujesz na swoim koncie, chyba że zastąpisz adres URL na poziomie konta, ustawiając pole SegmentResponse.burl dla poszczególnych wywołań funkcji Real-time Curation.

Analizowanie powiadomienia o wyświetleniu

Informacje wysyłane w powiadomieniu o wyświetleniu zależą od konfiguracji adresu URL punktu końcowego powiadomienia o wyświetleniu. Adres URL punktu końcowego może zawierać parametry zapytania i używać makr do uwzględniania dodatkowego kontekstu dotyczącego tego, jak segmenty danych były używane przez zwycięską stawkę, która spowodowała wyświetlenie.

Jak rozwijane są makra

Jeśli skonfigurujesz adres URL punktu końcowego tak, aby zawierał co najmniej 1 parametr zapytania ustawiony na makro, powiadomienia o wyświetleniach wysyłane do punktu końcowego będą rozwijać te makra, zastępując je odpowiednimi wartościami.

Możesz na przykład skonfigurować adres URL punktu końcowego powiadomień o wyświetleniach w ten sposób:

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

Po otrzymaniu powiadomienia o wyświetleniu makra zostaną zastąpione, a adres URL będzie wyglądać tak:

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

Dowiedz się więcej o obsługiwanych makrach

Poniżej znajdziesz makra, które możesz umieścić w parametrach zapytania adresu URL punktu końcowego powiadomienia o wyświetleniu. Te makra są zastępowane wartościami związanymi z wygraną stawką, do której przyczynił się co najmniej 1 segment danych.

Makro Opis
${SR_ID} Unikalny identyfikator w postaci ciągu znaków, który jest odpowiednikiem pola SegmentRequest.segment_request_id w przypadku odpowiedniego wywołania adnotacji do kuracji w czasie rzeczywistym. Odnosi się to do żądania segmentu, na które odpowiedziałeś(-aś) co najmniej 1 identyfikatorem segmentu danych, który przyczynił się do wygranej stawki.
${SEGMENT_IDS} Lista identyfikatorów segmentów danych tekstowych, które przyczyniły się do wygranej stawki. Poszczególne elementy listy są rozdzielone znakiem „|”. Można ją na przykład rozwinąć do listy wartości, takich jak:"segmentId1|segmentId2|segmentId3" Każdy identyfikator segmentu danych na liście odnosi się do identyfikatora zasobu odpowiedniego zasobu curators.dataSegments w interfejsie Marketplace API.
${AUCTION_PRICE} Ciąg znaków reprezentujący zwycięską cenę aukcji. Cena to koszt pojedynczego wyświetlenia (CPI) wyrażony w mikrodolarach amerykańskich. Na przykład stawka w ramach określania stawek w czasie rzeczywistym w wysokości 5 USD CPM spowoduje, że makro ${AUCTION_PRICE} w powiadomieniu o wyświetleniu w ramach selekcji w czasie rzeczywistym zostanie rozwinięte do wartości 5000 mikro-USD CPI.
${DEAL_ID} Identyfikator umowy lub pakietu, który wygrał aukcję. Jest to oferta lub pakiet kierowany na co najmniej 1 identyfikator segmentu danych, który można rozpoznać za pomocą makra ${SEGMENT_IDS}.
${BUYER_SEAT_ID} Identyfikator miejsca kupującego, które wygrało wyświetlenie, podany przez licytującego w zwycięskiej stawce. Na przykład miejscami kupujących mogą być agencje lub reklamodawcy.

Dalsze kroki