Ładowanie kodu kreacji za pomocą żądania bez tagów

Zamiast tagu reklamy można użyć żądania bez tagów, aby wysłać żądanie nieprzetworzonego kodu kreacji trafikowanego w usłudze Ad Manager. Żądania bez tagów są zwykle używane, gdy potrzebne jest niestandardowe analizowanie i wyświetlanie, jak w przypadku dekoderów lub innych środowisk bez obsługi tagowania Google ani pakietu SDK.

Gdy wywołujesz żądanie bez tagów, Ad Manager zwraca nieprzetworzony kod kreacji zgodnie z kryteriami trafikingu, bez realizacji i wyświetlania reklamy. W razie braku reklamy zwracany jest kod stanu 200/OK i pusta odpowiedź.

Twoja aplikacja, odtwarzacz lub witryna musi wykonać kod wyświetlający reklamę i włączyć śledzenie wyświetleń.

Żądania bez tagów nie należy używać do wyświetlania reklam w e-mailach. Zobacz wszystkie nieobsługiwane funkcje.

Ręczne tworzenie żądania bez tagów

Aby utworzyć żądanie bez tagów, rozpocznij od podstawowego adresu URL, dołącz wszystkie wymagane parametry i wszelkie dodatkowe opcjonalne parametry. Te parametry określają m.in. jednostkę reklamową, rozmiar kreacji, pary klucz-wartość i inne informacje dotyczące żądania.

Żądanie bez tagów musi być zabezpieczone protokołem SSL (https://).

Rozpoczęcie od podstawowego adresu URL

Użyj tego podstawowego adresu URL: https://securepubads.g.doubleclick.net/gampad/adx?

Określanie parametrów żądania reklamy

Parametry wymagane

Parametr	Opis
iu	Kod jednostki reklamowej Google Ad Managera, w tym kod sieci Google Ad Managera. Aby uwzględnić wiele poziomów, użyj znaku ukośnika (/) jako separatora. Przykład iu=/123/homepage iu=/456/sports/baseball Jeśli w przypadku żądań bez tagów używasz Zarządzania wieloma klientami (MCM), na potrzeby kodu sieci użyj struktury parent,child. Przykład (MCM) iu=/123,456/homepage
sz	Rozmiar kreacji. Aby uwzględnić wiele rozmiarów, użyj kreski pionowej (|) jako separatora między nimi. Przykład sz=320x50 dla jednego rozmiaru sz=320x50|300x50 dla wielu rozmiarów W żądaniach bez tagów zalecamy kodowanie kreski pionowej (|) jako %7c. Przykład &sz=216x36|300x50|320x50 zmieni się w &sz=216x36%7c300x50%7c320x50.
url	Adres URL domeny hostującej wstępne żądanie reklamy. Wymagany tylko w przypadku żądań MCM. Przykład url=www.example.com
c	Wartość korelatora (lub wartość zapobiegająca buforowaniu). Musi to być losowa liczba (litery nie są dozwolone) wygenerowana przez wydawcę, która powoduje, że do serwera reklam jest wysyłane nowe wywołanie przy każdym załadowaniu strony. Pozwala to uniknąć rozbieżności w zliczaniu wyświetleń. Przykład c=8362527364
tile	Pozycja tagu na stronie. Wartość powinna być unikalną liczbą całkowitą. Dla ułatwienia implementacji zalecamy stosowanie wartości rosnących. Ten parametr jest wymagany tylko wtedy, gdy tagi reklam używają tych samych wartości kodu jednostki (iu=) i korelatora (c=) na tej samej stronie. Przykład https://securepubads.g.doubleclick.net/gampad/adx?iu=/1234/homepage&sz=320x50&c=54631&tile=1 https://securepubads.g.doubleclick.net/gampad/adx?iu=/1234/homepage&sz=320x50&c=54631&tile=2

Parametry opcjonalne

Parametr	Opis
d_imp	Przełącznik opóźnionego wyświetlenia. Jeśli jest uwzględniony, zliczanie wyświetleń po otrzymaniu żądania jest wyłączone. Rejestrowanie wyświetleń odbywa się albo za pomocą makra widocznego wyświetlenia w zwróconej kreacji, albo na podstawie informacji z parametru d_imp_hdr. Przykład d_imp=1 d_imp=0 (domyślna wartość do zliczania wyświetleń Google Ad Managera)
d_imp_hdr	Przełącznik informacji w nagłówku opóźnionego wyświetlenia. Jeśli jest uwzględniony, URL wyświetlenia używany do zliczania wyświetleń jest zwracany w nagłówku HTTP. Te informacje nie są domyślnie określone. Aby zliczyć wyświetlenie, wydawca musi ręcznie sprawdzić URL wyświetlenia poleceniem ping. Dowiedz się więcej o zliczaniu wyświetleń i żądaniach bez tagów. Nagłówek Google-Delayed-Impression zawiera URL wyświetlenia Google Ad Managera. Nagłówek Google-3rdParty-Delayed-Impression zawiera URL wyświetlenia firmy zewnętrznej (jeśli znajduje się w kreacji). Przykład d_imp_hdr=1 d_imp_hdr=0 (wyraźnie wyłącza informacje w nagłówku opóźnionego wyświetlenia)
t	Pary klucz-wartość na poziomie boksu. Klucz i wartość są rozdzielone znakiem równości (=), a poszczególne pary – znakiem &. Każdy klucz i wartość powinny być indywidualnie zakodowane na potrzeby adresu URL, a następnie cały ciąg powinien być zakodowany na potrzeby tego adresu. Każdy klucz w zestawie par klucz-wartość musi być unikalny. W razie podania tego samego klucza więcej niż raz zostanie uwzględniona tylko jedna z powiązanych wartości. Przykład W parametrze t=genre%3Daction%26movie%3DMr+%2526+Mrs+Smith klucz „genre” jest przypisany do wartości „action”, a klucz „movie” do „Mr & Mrs Smith”. Pamiętaj, że znak „&” między przypisaniami pary klucz-wartość jest kodowany pojedynczo jako (%26), a podwójnie jako (%2526), jeśli pojawia się wewnątrz wartości. W przypadku wykluczeń konkurencji użyj klucza specjalnego excl_cat. Przykład t=excl_cat%3Dairlines t=interest%3Dsports%2Cnews%26excl_cat%3Dairlines W kluczach i wartościach nie wolno używać tych znaków: " ' ! + # * ~ ; ^ ( ) < > [ ] = . Spacje są dozwolone w wartościach (ze zmianą znaczenia w postaci %20 lub +), ale nie w kluczach. Przykład Ustawienie dla klucza „a” wartości „b+c” w postaci t=a%3Db%252Bc nie będzie działało.
m	Wartość typu MIME w nagłówku HTTP. Przykład m=text/wml
mob	Wskaźnik żądania reklamy mobilnej. Przykład mob=js (to jedyna dopuszczalna wartość)
ppid	Identyfikator podawany przez wydawcę (ang. publisher provided identifier, PPID) umożliwia przesyłanie do Google Ad Managera identyfikatora wykorzystywanego na potrzeby ograniczenia liczby wyświetleń, podziału odbiorców na segmenty, kierowania na odbiorców, sekwencyjnej rotacji reklam i innych funkcji sterujących wyświetlaniem reklam w zależności od odbiorców na różnych urządzeniach. Przykład ppid=12JD92JD8078S8J29SDOAKC0EF230337
u_w	Szerokość ekranu urządzenia mobilnego, która zastępuje wynik automatycznego wykrywania przez serwer reklam. Przykład u_w=1024
u_h	Wysokość ekranu urządzenia mobilnego, która zastępuje wynik automatycznego wykrywania przez serwer reklam. Przykład u_h=768
submodel	Informacje o urządzeniu mobilnym, które zastępują wynik automatycznego wykrywania przez serwer reklam. Przykład submodel=iPhone4%2C1 (kodowany jest przecinek, który oddziela wartość modelu podrzędnego) Wartości parametru submodel: iPhone (pierwszej generacji): iphone1,1 iPhone 3G: iphone1,2 iPhone 3GS: iphone2,1 iPhone 4 (GSM): iphone3,1 iPhone 4 (GSM): iphone3,2 iPhone 4 (CDMA): iphone3,3 iPhone 4S: iPhone4,1 iPhone 5 (GSM i LTE): iPhone5,1 iPhone 5 (CDMA i LTE): iPhone5,2 iPhone 5c: (GSM i CDMA): iPhone5,3 iPhone 5c (GSM i CDMA): iPhone5,4 iPhone 5s (GSM i CDMA): iPhone6,1 iPhone 5s (GSM i CDMA): iPhone6,2 iPhone 6: iPhone7,2 iPhone 6 Plus: iPhone7,1 iPhone 6s: iPhone8,1 iPhone 6s Plus: iPhone8,2 iPhone SE: iPhone8,4 iPhone 7: iPhone9,1 iPhone 7 Plus: iPhone9,2  iPod pierwszej generacji: iPod1,1 iPod drugiej generacji: iPod2,1 iPod trzeciej generacji: iPod3,1 iPod czwartej generacji: iPod4,1 iPod piątej generacji: iPod5,1 iPad pierwszej generacji (Wi-Fi): iPad1,1 iPad pierwszej generacji (AT&T): iPad1,2 iPad drugiej generacji (Wi-Fi): iPad2,1 iPad drugiej generacji (AT&T): iPad2,2 iPad drugiej generacji (Verizon): iPad2,3 iPad drugiej generacji (Wi-Fi): iPad2,4 iPad trzeciej generacji (Wi-Fi): iPad3,1 iPad trzeciej generacji (Verizon): iPad3,2 iPad trzeciej generacji (AT&T): iPad3,3 iPad czwartej generacji (Wi-Fi): iPad3,4 iPad czwartej generacji (AT&T): iPad3,5 iPad czwartej generacji (Verizon): iPad3,6 iPad Mini (Wi-Fi): iPad2,5 iPad Mini (AT&T-US; GSM i LTE 4, 17): iPad2,6 iPad Mini (Verizon-World; GSM, DMA i LTE 1,3,5,13,25): iPad2,7 iPad Mini Retina (Wi-Fi): iPad4,4 iPad Mini Retina (LTE): iPad4,5 iPad Air (Wi-Fi): iPad4,1 iPad Air (LTE): iPad4,2

 

Na potrzeby ograniczenia liczby wyświetleń i kierowania na odbiorców możesz użyć możliwego do zresetowania identyfikatora urządzenia (RDID). Dowiedz się więcej o konfigurowaniu RDID na potrzeby żądań bez tagów.

Aktywowanie śledzenia wyświetleń

Ad Manager może śledzić pobrane wyświetlenia (nazywane też „opóźnionymi”) na potrzeby żądań bez tagów. Użyj jednej z opcji wymienionych poniżej, ale nie wszystkich naraz. Jeśli skorzystasz ze wszystkich tych sposobów jednocześnie, wyświetlenia mogą być zliczane podwójnie (lub nawet potrójnie).

Zalecamy opcję 1, ale żeby móc z niej skorzystać, musisz mieć dostęp do nagłówków odpowiedzi HTTP oraz możliwość zaimplementowania protokołu opartego na nagłówku.

Opcja 1. Odczytywanie nagłówka odpowiedzi HTTP w celu kontrolowania zliczania wyświetleń

Dodaj parametry d_imp=1 i d_imp_hdr=1 do żądań bez tagów, by Google Ad Manager nie rejestrował wyświetlenia lub pobranego wyświetlenia, dopóki ręcznie nie wywołasz pingu wyświetlenia za pomocą adresu URL nagłówka HTTP Google-Delayed-Impression. Po wywołaniu tego pingu Google Ad Manager rejestruje „Wyświetlenie z serwera reklam” i „Wyświetlenie pobrane z serwera reklam”.

Aby uniknąć dwukrotnego zliczania wyświetleń, nie uwzględniaj w kreacjach zwróconych przez żądania bez tagów makra widocznego wyświetlenia.

Opcja 2. Wykorzystanie makra widocznego wyświetlenia

Jeśli nie masz dostępu do nagłówków odpowiedzi HTTP, musisz podzielić swoje zasoby reklamowe na segmenty i dodać do fragmentu kodu każdej kreacji zwracanej przez prosty tag URL marko widocznego wyświetlenia. To makro rozwija się do adresu URL, który ma być wysyłany przez kreację podczas renderowania.

Tworzenie żądania bez tagu w celu pobrania kodu kreacji

Treści internetowe

Żądania bez tagów są zwykle używane w środowiskach, które nie obsługują tagowania Google ani pakietu SDK. Jeśli tworzysz żądanie bez tagów w internecie, musisz wczytać go do elementu <iframe>, by mógł wykonać zwrócony nieprzetworzony kod.

Niestandardowe środowiska bez pakietu SDK Google

Aby pobrać nieprzetworzony kod kreacji w środowiskach, które nie obsługują tagowania Google ani pakietu SDK (np. dekodera innego niż Google), postępuj zgodnie z tymi wytycznymi:

• Ustaw odpowiedniego klienta użytkownika w nagłówku żądania User-Agent, by mieć pewność, że kierowanie będzie przebiegać prawidłowo.
• Upewnij się, że w używanym środowisku działają elementy Rich Media, w tym kod JavaScript i rozszerzenia kreacji.
• Wyślij żądanie HTTPS do Google Ad Managera.
• Sprawdź stan podany w odpowiedzi. Jeśli zawiera „HTTP 200/OK”, żądanie jest prawidłowe.

Nieobsługiwane funkcje w przypadku żądań bez tagów

• Widok aktywny
• Ad Exchange
• Identyfikatory plików cookie lub aplikacji mobilnych używane do śledzenia
• Kody towarzyszące kreacji
• Alokacja dynamiczna AdSense, Ad Exchange i AdMob
• Natywne zasoby reklamowe
• Umowy preferencyjne
• Podglądy kreacji

Żądania bez tagów, które używają parametru gampad/ad w tagach HTML obrazu (<img>), nie obsługują kodu śledzenia JavaScript, a metodologia zliczania pobranych wyświetleń nie obsługuje takich żądań.

Aby wygenerować raport obejmujący te reklamy, skorzystaj z kategorii danych „Łączna liczba wyświetleń kodu” w usłudze Ad Manager.