Z tego przewodnika dowiesz się, jak za pomocą Google Mobile Ads SDK wczytywać i wyświetlać reklamy z Moloco przy użyciu mediacji, w tym integracji z licytowaniem. Wyjaśniamy w nim, jak dodać Moloco do konfiguracji mediacji jednostki reklamowej oraz jak zintegrować pakiet SDK i adapter Moloco z aplikacją na iOS.
Obsługiwane integracje i formaty reklam
Adapter do zapośredniczenia w przypadku Moloco ma te funkcje:
| Integracja | |
|---|---|
| Określanie stawek | |
| Wodospad | |
| Formaty | |
| Otwarcie aplikacji | |
| Baner | |
| Pełnoekranowa | |
| Z nagrodą | |
| Reklama pełnoekranowa z nagrodą | |
| Natywna | |
Wymagania
iOS w wersji 12.0 lub nowszej
Adapter Moloco w wersji 3.9.1.0 lub nowszej
Nowości na kanale Google Mobile Ads SDK
Zapoznaj się z przewodnikiem dla początkujących dotyczącym zapośredniczenia.
Krok 1. Skonfiguruj ustawienia w interfejsie Moloco
Zaloguj się w portalu wydawców Moloco.
Otwórz kolejno Przegląd > kartę Aplikacje, a następnie kliknij przycisk Dodaj aplikację, aby utworzyć nową aplikację.
Wybierz system operacyjny i ustawienia prywatności aplikacji, wypełnij pozostałe pola formularza, a następnie kliknij Utwórz.
Po utworzeniu aplikacji wybierz ją na karcie Aplikacje, aby wyświetlić szczegóły, i zanotuj klucz aplikacji.
Otwórz kartę Przegląd > Jednostki reklamowe, wybierz aplikację z menu i kliknij Nowa jednostka reklamowa.
Wybierz Ustalanie stawek w aplikacji jako Metodę aukcji i wypełnij pozostałą część formularza. Następnie kliknij Utwórz.
Na karcie Jednostki reklamowe otwórz nowo utworzoną jednostkę reklamową, aby wyświetlić jej szczegóły. Zanotuj Identyfikator jednostki reklamowej.
Krok 2. Skonfiguruj popyt Moloco w interfejsie Ad Managera
Zaloguj się na konto Ad Managera.
Włącz udostępnianie bezpiecznych sygnałów
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.

Udostępnianie bezpiecznych sygnałów w pytaniach o stawkę
Kliknij kolejno Zasoby reklamowe i Bezpieczne sygnały. W sekcji Bezpieczne sygnały wyszukaj Moloco Ads SDK i włącz Włącz integrację z aplikacją.

Kliknij Zapisz.
Zezwalanie na udostępnianie bezpiecznych sygnałów na potrzeby określania stawek przez pakiet SDK
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.
Konfigurowanie określania stawek w Moloco
Kliknij kolejno Wyświetlanie > Licytujący i Otwórz Określanie stawek przez pakiet SDK.

Kliknij Nowy licytujący.

Jako dostawcę wybierz Moloco Ads.

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

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

Wybierz firmę, która udostępnia pakiet Moloco Ads SDK.

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 klucz aplikacji i identyfikator jednostki reklamowej uzyskane w poprzedniej sekcji.
Na koniec kliknij Zapisz.

Dodawanie Moloco Ads do listy partnerów reklamowych zachowujących zgodność z rozporządzeniami europejskimi i amerykańskimi przepisami stanowymi
Aby dodać Moloco Ads do listy partnerów reklamowych zachowujących zgodność z rozporządzeniami europejskimi i amerykańskimi przepisami stanowymi 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 Moloco
Korzystanie z CocoaPods (zalecane)
Dodaj do pliku Podfile projektu ten wiersz:
pod 'GoogleMobileAdsMediationMoloco'W wierszu poleceń uruchom:
pod install --repo-update
Krok 4. Wdróż ustawienia prywatności w pakiecie Moloco SDK
Zgoda użytkowników z UE i RODO
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 stosowanie 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.
Pakiet Moloco SDK zawiera flagę
hasUserConsent
do przekazywania informacji o zgodzie do pakietu Moloco SDK.
Poniższy przykładowy kod pokazuje, jak przekazywać informacje o uzyskanej zgodzie do pakietu SDK Moloco. Jeśli zdecydujesz się ustawić te flagi, zalecamy, aby zrobić to przed wysłaniem żądania reklam za pomocą Google Mobile Ads SDK.
Swift
import MolocoSDK
// ...
MolocoPrivacySettings.hasUserConsent = true;
Objective-C
#import <MolocoSDK/MolocoSDK-Swift.h>
// ...
[MolocoPrivacySettings setHasUserConsent:YES];
Więcej informacji znajdziesz w dokumentacji Moloco dotyczącej ochrony prywatności.
amerykańskie przepisy stanowe o ochronie prywatności,
Przepisy dotyczące prywatności w stanach USA wymagają, aby użytkownicy mieli prawo wycofać zgodę 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.
Pakiet SDK Moloco zawiera flagę isDoNotSell, która przekazuje informacje o zgodzie do pakietu SDK Moloco.
Poniższy przykładowy kod pokazuje, jak przekazywać informacje o uzyskanej zgodzie do pakietu SDK Moloco. Jeśli zdecydujesz się ustawić te flagi, zalecamy, aby zrobić to przed wysłaniem żądania reklam za pomocą Google Mobile Ads SDK.
Swift
import MolocoSDK
// ...
MolocoPrivacySettings.isDoNotSell = true;
Objective-C
#import <MolocoSDK/MolocoSDK-Swift.h>
// ...
[MolocoPrivacySettings setIsDoNotSell:YES];
Więcej informacji znajdziesz w dokumentacji Moloco dotyczącej ochrony prywatności.
Krok 5. Przetestuj implementację
Włączanie reklam testowych
Upewnij się, że zarejestrowano urządzenie testowe w Ad Managerze.
Weryfikowanie reklam testowych
Aby sprawdzić, czy otrzymujesz reklamy testowe z pakietu SDK Moloco Ads, włącz testowanie pojedynczego źródła reklam w inspektorze reklam, korzystając ze źródeł reklam Moloco (licytowanie).
Kody błędów
Jeśli adapter nie otrzyma reklamy od Moloco, możesz sprawdzić podstawowy błąd w odpowiedzi reklamy, korzystając z GADResponseInfo.adNetworkInfoArray w tych klasach:
MolocoSDK.MolocoError
GADMediationAdapterMoloco
Oto kody i komunikaty wyświetlane przez adapter Moloco, gdy nie uda się wczytać reklamy:
| Kod błędu | Domena | Przyczyna |
|---|---|---|
| 101 | com.google.ads.mediation.moloco | Pakiet Moloco SDK nie obsługuje wyświetlania reklam w systemie iOS 12 i starszych. |
| 102 | com.google.ads.mediation.moloco | Brakujący lub nieprawidłowy klucz aplikacji Moloco. |
| 103 | com.google.ads.mediation.moloco | Brakujący lub nieprawidłowy identyfikator jednostki reklamowej Moloco. |
| 104 | com.google.ads.mediation.moloco | Reklama nie jest gotowa do wyświetlania. |
| 105 | com.google.ads.mediation.moloco | Nie udało się wyświetlić reklamy. |
| 106 | com.google.ads.mediation.moloco | Brak danych renderowania, które umożliwiłyby wyświetlenie reklamy. |
| Od -1 do 5000 | Wysłane przez pakiet SDK Moloco | Pakiet Moloco SDK zwrócił błąd. Więcej informacji znajdziesz w dokumentacji Moloco. |
Weryfikacja po stronie serwera w przypadku reklam z nagrodą
Jeśli weryfikujesz wywołania zwrotne weryfikacji po stronie serwera (SSV), identyfikator źródła reklamy w przypadku Moloco to 8267622065755668722.
Dziennik zmian adaptera do zapośredniczenia Moloco na iOS
Wersja 4.1.2.0
- Sprawdzona zgodność z pakietem SDK Moloco w wersji 4.1.2.
Zaprojektowane i przetestowane z użyciem:
- Pakiet SDK do reklam mobilnych Google w wersji 12.14.0.
- Moloco SDK w wersji 4.1.2.
Wersja 4.1.0.0
- Sprawdzona zgodność z pakietem SDK Moloco w wersji 4.1.0.
Zaprojektowane i przetestowane z użyciem:
- Pakiet SDK do reklam mobilnych Google w wersji 12.14.0.
- Moloco SDK w wersji 4.1.0.
Wersja 3.13.0.0
- Obejmuje
Info.plistw ramach platform. - Zweryfikowana zgodność z pakietem Moloco SDK w wersji 3.13.0.
Zaprojektowane i przetestowane z użyciem:
- Pakiet SDK do reklam mobilnych Google w wersji 12.9.0.
- Moloco SDK w wersji 3.13.0.
Wersja 3.12.1.0
- Zweryfikowana zgodność z pakietem SDK Moloco w wersji 3.12.1.
Zaprojektowane i przetestowane z użyciem:
- Pakiet SDK do reklam mobilnych Google w wersji 12.8.0.
- Wersja pakietu Moloco SDK 3.12.1.
Wersja 3.12.0.0
- Zweryfikowana zgodność z pakietem SDK Moloco w wersji 3.12.0.
Zaprojektowane i przetestowane z użyciem:
- Pakiet SDK do reklam mobilnych Google w wersji 12.8.0.
- Wersja pakietu Moloco SDK 3.12.0.
Wersja 3.11.0.0
- Sprawdzona zgodność z pakietem Moloco SDK w wersji 3.11.0.
Zaprojektowane i przetestowane z użyciem:
- SDK do reklam mobilnych Google w wersji 12.6.0.
- Moloco SDK w wersji 3.11.0.
Wersja 3.10.1.0
- Zweryfikowana zgodność z pakietem SDK Moloco w wersji 3.10.1.
Zaprojektowane i przetestowane z użyciem:
- SDK do reklam mobilnych Google w wersji 12.6.0.
- Moloco SDK w wersji 3.10.1.
Wersja 3.10.0.0
- Zweryfikowana zgodność z pakietem SDK Moloco w wersji 3.10.0.
Zaprojektowane i przetestowane z użyciem:
- Pakiet SDK do reklam mobilnych Google w wersji 12.5.0.
- Moloco SDK w wersji 3.10.0.
Wersja 3.9.1.0
- Dodaliśmy obsługę znaków wodnych w przypadku formatów reklam z ustalaniem stawek.
- Rozwiązaliśmy problem z wczytywaniem banerów reklamowych MREC.
- Sprawdzona zgodność z pakietem Moloco SDK w wersji 3.9.1.
Zaprojektowane i przetestowane z użyciem:
- Pakiet SDK do reklam mobilnych Google w wersji 12.3.0.
- Moloco SDK w wersji 3.9.1.
Wersja 3.9.0.0
- Nazwa platformy zapośredniczenia jest teraz ustawiana podczas inicjowania pakietu SDK Moloco.
- Sprawdzona zgodność z pakietem SDK Moloco w wersji 3.9.0.
Zaprojektowane i przetestowane z użyciem:
- Pakiet SDK do reklam mobilnych Google w wersji 12.3.0.
- Wersja pakietu SDK Moloco 3.9.0.
Wersja 3.8.0.0
- Włącz flagi
-fobjc-arci-fstack-protector-all. - Rozwiązaliśmy problem z uzyskiwaniem oceny w gwiazdkach w przypadku reklam natywnych.
- Sprawdzona zgodność z pakietem Moloco SDK w wersji 3.8.0.
Zaprojektowane i przetestowane z użyciem:
- Pakiet SDK do reklam mobilnych Google w wersji 12.2.0.
- Wersja pakietu Moloco SDK 3.8.0.
Wersja 3.7.2.0
- Zweryfikowana zgodność z pakietem Moloco SDK w wersji 3.7.2.
- Dodaliśmy obsługę określania stawek w przypadku formatu reklam natywnych.
Zaprojektowane i przetestowane z użyciem:
- Pakiet SDK do reklam mobilnych Google w wersji 12.1.0.
- Moloco SDK w wersji 3.7.2.
Wersja 3.7.1.0
- Zweryfikowana zgodność z pakietem SDK Moloco w wersji 3.7.1.
Zaprojektowane i przetestowane z użyciem:
- Pakiet SDK do reklam mobilnych Google w wersji 12.1.0.
- Moloco SDK w wersji 3.7.1.
Wersja 3.7.0.0
- Zweryfikowana zgodność z pakietem Moloco SDK w wersji 3.7.0.
Zaprojektowane i przetestowane z użyciem:
- Pakiet SDK do reklam mobilnych Google w wersji 12.0.0.
- Wersja pakietu Moloco SDK 3.7.0.
Wersja 3.6.0.1
- Zaktualizowano adapter, aby pobierał wersję pakietu SDK Moloco z wątku głównego.
- Wymaga teraz pakietu SDK do reklam mobilnych Google w wersji 12.0.0 lub nowszej.
Zaprojektowane i przetestowane z użyciem:
- Pakiet SDK do reklam mobilnych Google w wersji 12.0.0.
- Moloco SDK w wersji 3.6.0.
Wersja 3.6.0.0
- Zweryfikowana zgodność z pakietem Moloco SDK w wersji 3.6.0.
Zaprojektowane i przetestowane z użyciem:
- Pakiet SDK do reklam mobilnych Google w wersji 11.13.0.
- Moloco SDK w wersji 3.6.0.
Wersja 3.5.0.0
- Pierwsza wersja.
- Dodaliśmy obsługę określania stawek w przypadku formatów banerów (w tym MREC), reklam pełnoekranowych i reklam z nagrodą.
- Sprawdzona zgodność z pakietem Moloco SDK w wersji 3.5.0.
Zaprojektowane i przetestowane z użyciem:
- Pakiet SDK do reklam mobilnych Google w wersji 11.13.0.
- Moloco SDK w wersji 3.5.0.