Aby omawiać nasze usługi i przekazywać opinie na ich temat, dołącz do oficjalnego kanału Discord usługi Ad Manager na serwerze społeczności Google Ads i pomiarów.

Ta strona została przetłumaczona przez Cloud Translation API.

Integracja Pangle z określaniem stawek

Z tego przewodnika dowiesz się, jak za pomocą pakietu SDK do reklam mobilnych Google wczytywać i wyświetlać reklamy z Pangle przy użyciu mediacji. Obejmuje on zarówno integrację kaskadową, jak i integrację z licytowaniem. Wyjaśnia, jak dodać Pangle do konfiguracji mediacji jednostki reklamowej oraz jak zintegrować pakiet SDK i adapter Pangle z aplikacją na iOS.

Obsługiwane integracje i formaty reklam

Adapter do mediacji w przypadku sieci Pangle ma te możliwości:

Integracja
Określanie stawek
Wodospad
Formaty
Reklama przy otwarciu aplikacji
Baner
Pełnoekranowa
Z nagrodą
Reklama pełnoekranowa z nagrodą
Natywna

Wymagania

iOS w wersji 10.0 lub nowszej
[W przypadku określania stawek]: aby zintegrować wszystkie obsługiwane formaty reklam w określaniu stawek, użyj adaptera Pangle w wersji 5.4.1.1.0 lub nowszej (zalecana jest najnowsza wersja).

Najnowszy pakiet SDK do reklam mobilnych Google
Zapoznaj się z przewodnikiem dla początkujących dotyczącym zapośredniczenia.

Krok 1. Skonfiguruj ustawienia w interfejsie Pangle

Zarejestruj się lub zaloguj na konto Pangle.

Dodawanie nowej aplikacji

Otwórz kartę Aplikacje i kliknij przycisk Dodaj aplikację.

Wybierz system operacyjny, dla którego chcesz utworzyć aplikację, i wypełnij pozostałą część formularza. Następnie kliknij Prześlij.

Zanotuj identyfikator aplikacji.

Tworzenie miejsca docelowego reklamy

Po utworzeniu aplikacji kliknij przycisk Dodaj, aby utworzyć miejsce docelowe reklamy.

Określanie stawek

Wybierz Format reklamy i Nazwę miejsca docelowego reklamy, a jako Typ ceny wybierz Określanie stawek w aplikacji. Wypełnij pozostałe pola formularza i kliknij Prześlij.

Po utworzeniu miejsca docelowego reklamy zanotuj identyfikator miejsca docelowego reklamy.

Wodospad

Wybierz Format reklamy i Nazwę miejsca docelowego reklamy oraz Globalny CPM jako Typ ceny. Wypełnij pozostałe pola formularza i kliknij Prześlij.

Po utworzeniu miejsca docelowego reklamy zanotuj identyfikator miejsca docelowego reklamy.

Aktualizowanie pliku app-ads.txt

Authorized Sellers for Apps (plik app-ads.txt) to projekt IAB Tech Lab, który ma zagwarantować, że Twoje zasoby reklamowe w aplikacjach będą sprzedawane tylko w tych kanałach, na które wyrażasz zgodę. Aby zapobiec utracie przychodów z reklam, musisz wdrożyć plik app-ads.txt. Jeśli jeszcze tego nie zrobiono, utwórz plik app-ads.txt dla usługi Ad Manager.

Aby zaimplementować app-ads.txt w przypadku Pangle, zapoznaj się z tym artykułem: Jak dodać Pangle do pliku app-ads.txt.

Włączanie trybu testowego

Aby włączyć reklamy testowe Pangle, postępuj zgodnie z instrukcjami w przewodniku Pangle How to add a Test Ad (Jak dodać reklamę testową).

Krok 2. Skonfiguruj popyt Pangle w interfejsie Ad Managera

Zaloguj się na konto Ad Managera.

Dodawanie Pangle w sekcji Firmy

Określanie stawek

Ten krok nie jest wymagany w przypadku integracji z określaniem stawek.

Wodospad

Kliknij kolejno Administracja > Firmy, a potem na karcie Wszystkie firmy kliknij przycisk Nowa firma. Kliknij Sieć reklamowa.

Wybierz Pangle jako Sieć reklamową, wpisz unikalną Nazwę i włącz Zapośredniczanie.

Nie musisz wpisywać nazwy użytkownika ani hasła. Gdy skończysz, kliknij Zapisz.

Włącz udostępnianie bezpiecznych sygnałów

Określanie stawek

Otwórz Administracja > Ustawienia globalne. Otwórz kartę Ustawienia konta Ad Exchange, a następnie przejrzyj i włącz opcję Udostępnianie bezpiecznych sygnałów. Kliknij Zapisz.

Wodospad

Ten krok nie jest wymagany w przypadku integracji kaskadowych.

Udostępnianie bezpiecznych sygnałów w pytaniach o stawkę

Określanie stawek

Kliknij Zasoby reklamowe > Bezpieczne sygnały. W sekcji Bezpieczne sygnały wyszukaj platformę Pangle DSP i włącz opcję Włącz integrację aplikacji.

Kliknij Zapisz.

Wodospad

Ten krok nie jest wymagany w przypadku integracji kaskadowych.

Zezwalanie na udostępnianie bezpiecznych sygnałów na potrzeby określania stawek przez pakiet SDK

Określanie stawek

Kliknij kolejno Wyświetlanie i Ustawienia na potrzeby kanałów popytu. Na karcie Ustawienia domyślne włącz opcję Zezwalaj na udostępnianie bezpiecznych sygnałów w przypadku licytowania w SDK.

Kliknij Zapisz.

Wodospad

Ten krok nie jest wymagany w przypadku integracji kaskadowych.

Konfigurowanie ustalania stawek w Pangle

Określanie stawek

Kliknij kolejno Wyświetlanie > Licytujący i Otwórz Określanie stawek przez pakiet SDK.

Kliknij Nowy licytujący.

Wybierz licytującego Pangle.

Kliknij Dalej, aby włączyć określanie stawek przez pakiet SDK w przypadku tego licytującego.

Kliknij Gotowe.

Wodospad

Ten krok nie jest wymagany w przypadku integracji kaskadowych.

Konfigurowanie mapowania jednostki reklamowej

Określanie stawek

Kliknij kolejno Wyświetlanie > Licytujący i Otwórz Określanie stawek przez pakiet SDK.

Wybierz firmę, która będzie korzystać z Pangle.

Otwórz kartę Mapowanie jednostek reklamowych i kliknij Nowe mapowanie jednostek reklamowych.

Wybierz Konkretna jednostka reklamowa. Wybierz jednostkę reklamową i format, Aplikacja mobilna jako Typ zasobów reklamowych oraz Aplikacja mobilna. Następnie wpisz Identyfikator aplikacji i Identyfikator miejsca docelowego reklamy uzyskane w poprzedniej sekcji. Na koniec kliknij Zapisz.

Wodospad

Kliknij kolejno Wyświetlanie > Grupy zysku i kliknij przycisk Nowa grupa zysku. Wybierz aplikację mobilną.

Przewiń w dół i kliknij Dodaj partnera zysku.

Wybierz firmę utworzoną w poprzedniej sekcji na potrzeby Pangle. Wybierz Zapośredniczenie mobilne SDK jako Rodzaj integracji, iOS jako Platformę i Aktywny jako Stan.

Wpisz identyfikator aplikacji i identyfikator miejsca docelowego reklamy uzyskane w poprzedniej sekcji oraz wartość domyślnego CPM. Kliknij Zapisz.

Dodawanie platformy DSP Pangle do listy partnerów reklamowych w przypadku RODO i przepisów stanowych USA

Aby dodać platformę DSP Pangle do listy partnerów reklamowych wymaganych przez rozporządzenia europejskie i amerykańskie przepisy stanowe w interfejsie Ad Managera, wykonaj czynności opisane w sekcjach Ustawienia dotyczące rozporządzeń europejskich i Ustawienia dotyczące amerykańskich przepisów stanowych.

Krok 3. Zaimportuj pakiet SDK i adapter Pangle

CocoaPods (zalecane)

Dodaj do pliku Podfile projektu ten wiersz:
```
pod 'GoogleMobileAdsMediationPangle'
```
W wierszu poleceń uruchom:
```
pod install --repo-update
```

Integracja ręczna

Pobierz najnowszą wersję pakietu SDK Pangle na iOS i połącz wszystkie pliki i pakiety .framework w projekcie.
Pobierz najnowszą wersję adaptera Pangle, korzystając z linku w dzienniku zmian, i połącz go z projektem.PangleAdapter.xcframework

Krok 4. Wdróż ustawienia prywatności w pakiecie Pangle SDK

Aby zachować zgodność z polityką Google w zakresie zgody użytkownika z UE, musisz przekazywać użytkownikom z Europejskiego Obszaru Gospodarczego (EOG), Wielkiej Brytanii i Szwajcarii określone informacje oraz uzyskiwać ich zgodę na używanie plików cookie lub innych środków do lokalnego przechowywania danych, jeśli jest to wymagane przez prawo, a także na zbieranie, udostępnianie i wykorzystywanie danych osobowych na potrzeby personalizacji reklam. Polityka ta odzwierciedla wymagania UE zawarte w dyrektywie o prywatności i łączności elektronicznej oraz w Ogólnym rozporządzeniu o ochronie danych (RODO). Odpowiadasz za sprawdzenie, czy zgoda jest przekazywana do każdego źródła reklam w łańcuchu mediacji. Google nie może automatycznie przekazywać do takich sieci wyboru użytkownika dotyczącego zgody.

Adapter Pangle udostępnia metodę +setGDPRConsent: , która przekazuje informacje o zgodzie użytkownika do adaptera Pangle, a następnie do pakietu SDK Pangle. Poniższy przykładowy kod pokazuje, jak przekazywać informacje o uzyskanej zgodzie do pakietu Pangle SDK. Ustaw informacje o uzyskaniu zgody użytkowników, zanim zainicjujesz pakiet SDK do reklam mobilnych Google, aby mieć pewność, że zostaną one prawidłowo przekazane do pakietu SDK Pangle.

Swift

import PAGAdSDK
import PangleAdapter
// ...

GADMediationAdapterPangle.setGDPRConsent(PAGGDPRConsentType.consent.rawValue)

Objective-C

#import <PAGAdSDK/PAGSdk.h>
#import <PangleAdapter/PangleAdapter.h>
// ...

[GADMediationAdapterPangle setGDPRConsent:PAGGDPRConsentTypeConsent];

Więcej informacji i wartości, które można podać w poszczególnych metodach, znajdziesz w przewodniku po integracji z iOS Pangle.

amerykańskie przepisy stanowe o ochronie prywatności,

Przepisy dotyczące prywatności w stanach USA wymagają, aby użytkownicy mieli możliwość wycofania zgody na „sprzedaż” „danych osobowych” (w znaczeniu określonym w ustawie). Wycofanie zgody musi być możliwe za pomocą dobrze widocznego linku „Do Not Sell My Personal Information” („Nie sprzedawaj moich danych osobowych”) na stronie głównej podmiotu „sprzedającego”. Przewodnik po zgodności z przepisami stanowymi USA o ochronie prywatności umożliwia włączenie ograniczonego przetwarzania danych na potrzeby wyświetlania reklam Google, ale Google nie może zastosować tego ustawienia do każdej sieci reklamowej w Twoim łańcuchu mediacji. Dlatego musisz wskazać każdą sieć reklamową w łańcuchu zapośredniczenia, która może uczestniczyć w sprzedaży danych osobowych, i postępować zgodnie z wytycznymi każdej z tych sieci, aby zapewnić zgodność z przepisami.

Adapter Pangle udostępnia metodę +setPAConsent: , która przekazuje informacje o zgodzie użytkownika do adaptera Pangle, a następnie do pakietu SDK Pangle. Poniższy przykładowy kod pokazuje, jak przekazywać informacje o uzyskanej zgodzie do pakietu Pangle SDK. Ustaw informacje o uzyskaniu zgody użytkowników, zanim zainicjujesz pakiet SDK do reklam mobilnych Google, aby mieć pewność, że zostaną one prawidłowo przekazane do pakietu SDK Pangle.

Swift

import PAGAdSDK
import PangleAdapter
// ...

GADMediationAdapterPangle.setPAConsent(PAGPAConsentType.consent.rawValue)

Objective-C

#import <PAGAdSDK/PAGSdk.h>
#import <PangleAdapter/PangleAdapter.h>
// ...

[GADMediationAdapterPangle setPAConsent:PAGPAConsentTypeConsent];

Więcej informacji i wartości, które można podać w poszczególnych metodach, znajdziesz w przewodniku po integracji z iOS Pangle.

Krok 5. Dodaj wymagany kod

Integracja SKAdNetwork

Postępuj zgodnie z dokumentacją Pangle, aby dodać identyfikatory SKAdNetwork do pliku Info.plist w projekcie.

Krok 6. Przetestuj implementację

Włączanie reklam testowych

Upewnij się, że zarejestrowano urządzenie testowe w Ad Managerze i włączono tryb testowy w interfejsie Pangle.

Weryfikowanie reklam testowych

Aby sprawdzić, czy otrzymujesz reklamy testowe z Pangle, włącz testowanie pojedynczego źródła reklam w inspektorze reklam, korzystając ze źródeł reklam Pangle (określanie stawek) i Pangle (kaskadowe).

Kroki opcjonalne

Reklamy natywne

Renderowanie reklam

Adapter Pangle zwraca reklamy natywne jako obiekty GADNativeAd. Wypełnia te pola w przypadku GADNativeAd:

Pole	Zasoby zawsze uwzględniane przez adapter Pangle
Nagłówek
Obraz	1
Treść
Ikona
Wezwanie do działania
Ocena w gwiazdkach
Sklep
Cena
Reklamodawca

^1. Adapter Pangle nie zapewnia bezpośredniego dostępu do głównego zasobu graficznego w przypadku reklam natywnych. Zamiast tego adapter wypełnia element GADMediaView filmem lub obrazem.

Kody błędów

Jeśli adapter nie otrzyma reklamy z Pangle, możesz sprawdzić podstawowy błąd w odpowiedzi na reklamę, korzystając z GADResponseInfo.adNetworkInfoArray w tych klasach:

GADMediationAdapterPangle

Oto kody i komunikaty, które adapter Pangle zwraca, gdy nie uda się wczytać reklamy:

Kod błędu	Domena	Przyczyna
101	com.google.ads.mediation.pangle	Nieprawidłowe parametry serwera (np. brak identyfikatora aplikacji lub identyfikatora miejsca docelowego).
102	com.google.ads.mediation.pangle	Żądany rozmiar reklamy nie pasuje do rozmiaru banera obsługiwanego przez Pangle.
-1-60000	Wysłane przez pakiet SDK Pangle	Pakiet SDK Pangle zwrócił błąd. Więcej informacji znajdziesz w dokumentacji Pangle.