Integracja Moloco z określaniem stawek

Z tego przewodnika dowiesz się, jak wczytywać i wyświetlać reklamy z platformy Moloco za pomocą Google Mobile Ads SDK (Legacy) przy użyciu zapośredniczenia, w tym integracji z licytowaniem. Dowiesz się z niego, jak dodać Moloco do konfiguracji zapośredniczenia jednostki reklamowej oraz jak zintegrować pakiet SDK i adapter Moloco z aplikacją na Androida.

Obsługiwane integracje i formaty reklam

Adapter zapośredniczenia Moloco ma te funkcje:

Wymagania wstępne

Zanim przejdziesz dalej, sprawdź te kwestie:

• Android API na poziomie 24 lub wyższym.

• Adapter Moloco w wersji 3.8.0.0 lub nowszej.

• Najnowsza wersja Google Mobile Ads SDK (Legacy).

• Skonfiguruj mediację.

Krok 1. Skonfiguruj ustawienia w interfejsie Moloco

Zaloguj się w portalu Moloco Portal wydawców.

Kliknij kolejno Przegląd > kartę Aplikacje, a następnie przycisk Dodaj aplikację, aby utworzyć nową aplikację.

Wybierz system operacyjny i ustawienia prywatności aplikacji, wypełnij pozostałą część 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 kolejno karty Przegląd > Jednostki reklamowe, wybierz aplikację z menu i kliknij Nowa jednostka reklamowa.

Wybierz Określanie stawek w aplikacji jako Metodę aukcji i wypełnij pozostałą część formularza. Następnie kliknij Utwórz.

Aby wyświetlić szczegóły nowo utworzonej jednostki reklamowej, otwórz ją na karcie Jednostki reklamowe. Zapisz identyfikator jednostki reklamowej.

Krok 2. Skonfiguruj żądania Moloco w interfejsie Ad Managera

Zaloguj się na konto Ad Managera.

Włączanie udostępniania bezpiecznych sygnałów

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

Udostępnianie bezpiecznego sygnału w pytaniach o stawkę

Kliknij kolejno Zasoby reklamowe i Bezpieczne sygnały. W sekcji Bezpieczne sygnały wyszukaj Moloco pakiet SDK do wyświetlania reklam i włącz opcję Włącz integrację aplikacji.

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 określania stawek przez pakiet SDK.

Kliknij Zapisz.

Konfigurowanie określania stawek Moloco

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

Kliknij Nowy licytujący.

Jako dostawcę usług licytujących 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 zgodnych z rozporządzeniami europejskimi i amerykańskimi przepisami stanowymi

Wykonaj czynności opisane w artykułach Ustawienia dotyczące rozporządzeń europejskich i Ustawienia dotyczące przepisów stanowych w USA, aby dodać Moloco Ads do listy partnerów reklamowych zgodnych z rozporządzeniami europejskimi i przepisami stanowymi w USA w interfejsie Ad Managera.

Krok 3. Zaimportuj pakiet SDK i adapter Moloco

Integracja z Android Studio (zalecana)

W pliku build.gradle.kts na poziomie aplikacji dodaj te zależności i konfiguracje implementacji. Używaj najnowszych wersji pakietu SDK i adaptera Moloco:

dependencies {
    implementation("com.google.android.gms:play-services-ads:25.5.0")
    implementation("com.google.ads.mediation:moloco:4.13.0.0")
}

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 udzielać odpowiednich informacji użytkownikom z Europejskiego Obszaru Gospodarczego (EOG), Wielkiej Brytanii i Szwajcarii oraz uzyskać ich zgodę na stosowanie plików cookie lub innych środków do lokalnego przechowywania danych, jeśli jest to wymagane prawnie. Musisz też uzyskać ich zgodę na zbieranie, udostępnianie i wykorzystywanie danych osobowych do personalizowania 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 zapośredniczenia.

Adapter Moloco Ads SDK na Androida w wersji 3.5.0.0 i nowszych obsługuje przekazywanie sygnałów zgody na wykorzystanie danych zgodnie z RODO z platform do zarządzania zgodą użytkowników, które są zintegrowane z Zasadami IAB dotyczącymi przejrzystości i uzyskiwania zgody na przetwarzanie danych, do pakietu Moloco Ads SDK. Więcej informacji znajdziesz w dokumentacji MolocoPrivacy.

amerykańskie przepisy stanowe o ochronie prywatności

Amerykańskie przepisy stanowe o ochronie prywatności wymagają, aby użytkownicy mieli prawo wycofać zgodę na „sprzedaż” „danych osobowych” (w znaczeniu określonym w ustawie). W tym celu na stronie głównej podmiotu „sprzedającego” musi być umieszczony dobrze widoczny link „Nie sprzedawaj moich danych osobowych”. Przewodnik po zgodności z przepisami stanowymi USA dotyczącymi ochrony 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 zapośredniczenia. Dlatego musisz zidentyfikować każdą sieć reklamową w łańcuchu zapośredniczenia, która może uczestniczyć w sprzedaży danych osobowych, i postępować zgodnie ze wskazówkami każdej z tych sieci, aby zapewnić zgodność z przepisami.

Pakiet Moloco SDK zawiera flagę isDoNotSell, która przekazuje informacje o zgodzie do pakietu Moloco SDK.

Poniższy przykładowy kod pokazuje, jak przekazać informacje o 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 (Legacy).

val privacySettings = PrivacySettings(isDoNotSell = true)
MolocoPrivacy.setPrivacy(privacySettings)
MolocoMediationSnippets.kt

PrivacySettings privacySettings =
    new PrivacySettings(
        /* isUserConsent= */ false, /* isAgeRestrictedUser= */ false, /* isDoNotSell= */ true);
MolocoPrivacy.setPrivacy(privacySettings);
MolocoMediationSnippets.java

Więcej informacji znajdziesz w dokumentacji pakietu Moloco SDK na Androida.

Krok 5. Przetestuj implementację

Włączanie reklam testowych

Upewnij się, że urządzenie testowe jest zarejestrowane w usłudze Ad Manager.

Sprawdzanie reklam testowych

Aby sprawdzić, czy otrzymujesz reklamy testowe z pakietu SDK do wyświetlania reklam Moloco Ads, włącz w inspektorze reklam testowanie pojedynczego źródła reklam, korzystając ze źródeł reklam Moloco (określanie stawek).

Kody błędów

Jeśli adapter nie otrzyma reklamy z Moloco, możesz sprawdzić błąd w odpowiedzi na żądanie reklamy, korzystając z metody ResponseInfo.getAdapterResponses() w tych klasach:

com.moloco.sdk
com.google.ads.mediation.moloco.MolocoMediationAdapter

Oto kody i powiązane z nimi komunikaty, które adapter Moloco wyświetla, gdy nie uda się wczytać reklamy:

Lista zmian dotyczących adaptera zapośredniczenia Moloco na Androida

Wersja 4.13.0.0

• Zweryfikowano zgodność z pakietem SDK Moloco w wersji 4.13.0.

Zbudowano i przetestowano z:

• Pakiet SDK do reklam mobilnych Google w wersji 25.5.0.
• Pakiet SDK do wyświetlania reklam mobilnych Google nowej generacji w wersji 1.5.0.
• Moloco SDK w wersji 4.13.0.

Wersja 4.12.0.1

• Przypnij zależność adaptera od Kotlina do wersji 1.9.0 (minimalnej wersji Kotlina obsługiwanej przez pakiet GMA NextGen SDK).

Zbudowano i przetestowano z:

• Pakiet SDK do reklam mobilnych Google w wersji 25.4.0.
• Pakiet SDK do wyświetlania reklam mobilnych Google nowej generacji w wersji 1.4.0.
• Pakiet SDK Moloco w wersji 4.12.0.

Wersja 4.12.0.0

• Zweryfikowano zgodność z pakietem SDK Moloco w wersji 4.12.0.

Zaprojektowano i przetestowano z użyciem:

• Pakiet SDK do reklam mobilnych Google w wersji 25.4.0.
• Pakiet SDK do wyświetlania reklam mobilnych Google nowej generacji w wersji 1.4.0.
• Moloco SDK w wersji 4.12.0.

Wersja 4.11.1.0

• Zaktualizowano, aby raportować wyświetlenie reklamy, gdy wyświetlana jest reklama natywna.
• Naprawiliśmy błąd, który powodował, że po kliknięciu banera reklamowego wywoływane było wywołanie zwrotne onAdOpened, zamiast wyświetlenia reklamy.
• Zweryfikowana zgodność z pakietem Moloco SDK w wersji 4.11.1.

Zaprojektowano i przetestowano z użyciem:

• Pakiet SDK do reklam mobilnych Google w wersji 25.4.0.
• Pakiet SDK do wyświetlania reklam mobilnych Google nowej generacji w wersji 1.3.1.
• Pakiet SDK Moloco w wersji 4.11.1.

Wersja 4.11.0.0

• Dodaje obsługę banerów adaptacyjnych do adaptera mediacji Moloco.
• Potwierdzona zgodność z pakietem SDK Moloco w wersji 4.11.0.

Zaprojektowano i przetestowano z użyciem:

• Pakiet SDK do reklam mobilnych Google w wersji 25.4.0.
• Pakiet SDK do wyświetlania reklam mobilnych Google nowej generacji w wersji 1.3.1.
• Moloco SDK w wersji 4.11.0.

Wersja 4.10.1.0

• Zweryfikowano zgodność z pakietem SDK Moloco w wersji 4.10.1.

Zbudowano i przetestowano z:

• Pakiet SDK do reklam mobilnych Google w wersji 25.4.0.
• Pakiet SDK do wyświetlania reklam mobilnych Google nowej generacji w wersji 1.2.1.
• Moloco SDK w wersji 4.10.1.

Wersja 4.10.0.0

• Mapuje AgeRestrictedTreatment na ustawienia Moloco dotyczące ograniczeń wiekowych.
• Sprawdzona zgodność z pakietem SDK Moloco w wersji 4.10.0.

Zbudowano i przetestowano z:

• Pakiet SDK do reklam mobilnych Google w wersji 25.4.0.
• Pakiet SDK do wyświetlania reklam mobilnych Google nowej generacji w wersji 1.2.1.
• Pakiet SDK Moloco w wersji 4.10.0.

Wersja 4.9.0.0

• Zweryfikowano zgodność z pakietem SDK Moloco w wersji 4.9.0.

Zaprojektowano i przetestowano z użyciem:

• Pakiet SDK do reklam mobilnych Google w wersji 25.3.0.
• Pakiet SDK do wyświetlania reklam mobilnych Google nowej generacji w wersji 1.1.1.
• Pakiet SDK Moloco w wersji 4.9.0.

Wersja 4.9.0.0 (w toku)

Wersja 4.8.1.0

• Zweryfikowana zgodność z pakietem Moloco SDK w wersji 4.8.1.

Zaprojektowano i przetestowano z użyciem:

• Pakiet SDK do reklam mobilnych Google w wersji 25.2.0.
• Pakiet SDK do wyświetlania reklam mobilnych Google nowej generacji w wersji 1.0.1.
• Moloco SDK w wersji 4.8.1.

Wersja 4.8.0.0

• Zaktualizowano, aby przekazywać kontekst aplikacji do Moloco.initialize() zamiast kontekstu aktywności, co pozwala uniknąć wycieku pamięci.
• Potwierdzona zgodność z pakietem SDK Moloco w wersji 4.8.0.

Zbudowano i przetestowano z:

• Pakiet SDK do reklam mobilnych Google w wersji 25.2.0.
• Pakiet SDK do wyświetlania reklam mobilnych Google nowej generacji w wersji 0.25.0-beta01.
• Moloco SDK w wersji 4.8.0.

Wersja 4.7.0.0

• Dodano właściwość umożliwiającą tworzenie adaptera z zależnością pakietu SDK nowej generacji do reklam mobilnych Google.
• Zweryfikowana zgodność z pakietem Moloco SDK w wersji 4.7.0.

Zbudowano i przetestowano z:

• Pakiet SDK do reklam mobilnych Google w wersji 25.1.0.
• Pakiet SDK do wyświetlania reklam mobilnych Google nowej generacji w wersji 0.25.0-beta01.
• Moloco SDK w wersji 4.7.0.

Wersja 4.6.0.0

• Zweryfikowana zgodność z pakietem Moloco SDK w wersji 4.6.0.

Zbudowano i przetestowano z:

• Pakiet SDK do reklam mobilnych Google w wersji 24.9.0.
• Pakiet SDK Moloco w wersji 4.6.0.

Wersja 4.5.0.0

• Potwierdzona zgodność z pakietem SDK Moloco w wersji 4.5.0.

Zbudowano i przetestowano z:

• Pakiet SDK do reklam mobilnych Google w wersji 24.9.0.
• Pakiet SDK Moloco w wersji 4.5.0.

Wersja 4.4.0.0

• Sprawdzona zgodność z pakietem Moloco SDK w wersji 4.4.0.

Zbudowano i przetestowano z:

• Pakiet SDK do reklam mobilnych Google w wersji 24.9.0.
• Moloco SDK w wersji 4.4.0.

Wersja 4.3.1.0

• Sprawdzona zgodność z pakietem Moloco SDK w wersji 4.3.1.

Zaprojektowano i przetestowano z użyciem:

• Pakiet SDK do reklam mobilnych Google w wersji 24.8.0.
• Pakiet SDK Moloco w wersji 4.3.1.

Wersja 4.2.1.0

• Potwierdzona zgodność z pakietem SDK Moloco w wersji 4.2.1.

Zaprojektowano i przetestowano z użyciem:

• Pakiet SDK do reklam mobilnych Google w wersji 24.7.0.
• Pakiet SDK Moloco w wersji 4.2.1.

Wersja 4.2.0.0

• Zweryfikowano zgodność z pakietem Moloco SDK w wersji 4.2.0.

Zbudowano i przetestowano z:

• Pakiet SDK do reklam mobilnych Google w wersji 24.7.0.
• Moloco SDK w wersji 4.2.0.

Wersja 4.1.1.0

• Zweryfikowana zgodność z pakietem Moloco SDK w wersji 4.1.1.

Zbudowano i przetestowano z:

• Pakiet SDK do reklam mobilnych Google w wersji 24.7.0.
• Pakiet SDK Moloco w wersji 4.1.1.

Wersja 4.1.0.0

• Sprawdzona zgodność z pakietem Moloco SDK w wersji 4.1.0.

Zaprojektowano i przetestowano z użyciem:

• Pakiet SDK do reklam mobilnych Google w wersji 24.6.0.
• Moloco SDK w wersji 4.1.0.

Wersja 4.0.0.0

• Sprawdzona zgodność z pakietem Moloco SDK w wersji 4.0.0.

Zbudowano i przetestowano z:

• Pakiet SDK do reklam mobilnych Google w wersji 24.5.0.
• Moloco SDK w wersji 4.0.0.

Wersja 3.12.1.0

• Zweryfikowana zgodność z pakietem Moloco SDK w wersji 3.12.1.

Zbudowano i przetestowano z:

• Pakiet SDK do reklam mobilnych Google w wersji 24.5.0.
• Pakiet SDK Moloco w wersji 3.12.1.

Wersja 3.12.0.0

• Zweryfikowano zgodność z pakietem SDK Moloco w wersji 3.12.0.

Zbudowano i przetestowano z:

• Pakiet SDK do reklam mobilnych Google w wersji 24.4.0.
• Pakiet SDK Moloco w wersji 3.12.0.

Wersja 3.11.0.0

• Zweryfikowano zgodność z pakietem SDK Moloco w wersji 3.11.0.

Zaprojektowano i przetestowano z użyciem:

• Pakiet SDK do reklam mobilnych Google w wersji 24.4.0.
• Wersja pakietu Moloco SDK 3.11.0.

Wersja 3.10.0.0

• Sprawdzona zgodność z pakietem Moloco SDK w wersji 3.10.0.

Zbudowano i przetestowano z:

• Pakiet SDK do reklam mobilnych Google w wersji 24.3.0.
• Moloco SDK w wersji 3.10.0.

Wersja 3.9.0.0

• Zweryfikowano zgodność z pakietem SDK Moloco w wersji 3.9.0.

Zbudowano i przetestowano z:

• Pakiet SDK do reklam mobilnych Google w wersji 24.2.0.
• Pakiet SDK Moloco w wersji 3.9.0.

Wersja 3.8.0.1

• Dodaliśmy obsługę rozmiaru banera reklamowego typu średni prostokąt.

Zbudowano i przetestowano z:

• Pakiet SDK do reklam mobilnych Google w wersji 24.1.0.
• Pakiet SDK Moloco w wersji 3.8.0.

Wersja 3.8.0.0

• Dodaliśmy obsługę określania stawek w przypadku formatu reklamy natywnej.
• Zweryfikowano zgodność z pakietem SDK Moloco w wersji 3.8.0.

Zaprojektowano i przetestowano z użyciem:

• Pakiet SDK do reklam mobilnych Google w wersji 24.1.0.
• Pakiet SDK Moloco w wersji 3.8.0.

Wersja 3.7.2.0

• Zweryfikowano zgodność z pakietem SDK Moloco w wersji 3.7.2.

Zbudowano i przetestowano z:

• Pakiet SDK do reklam mobilnych Google w wersji 24.0.0.
• Pakiet SDK Moloco w wersji 3.7.2.

Wersja 3.7.1.0

• Zaktualizowano minimalny wymagany poziom interfejsu Android API do 23.
• Zaktualizowaliśmy minimalną wymaganą wersję pakietu SDK do reklam mobilnych Google do 24.0.0.
• Zweryfikowana zgodność z pakietem SDK Moloco w wersji 3.7.1.

Zbudowano i przetestowano z:

• Pakiet SDK do reklam mobilnych Google w wersji 24.0.0.
• Pakiet SDK Moloco w wersji 3.7.1.

Wersja 3.7.0.0

• Zweryfikowana zgodność z pakietem Moloco SDK w wersji 3.7.0.

Zbudowano i przetestowano z:

• SDK do reklam mobilnych Google w wersji 23.6.0.
• Moloco SDK w wersji 3.7.0.

Wersja 3.6.1.0

• Zweryfikowano zgodność z pakietem SDK Moloco w wersji 3.6.1.

Zbudowano i przetestowano z:

• SDK do reklam mobilnych Google w wersji 23.6.0.
• Pakiet SDK Moloco w wersji 3.6.1.

Wersja 3.6.0.0

• Sprawdzona zgodność z pakietem Moloco SDK w wersji 3.6.0.

Zaprojektowano i przetestowano z użyciem:

• Pakiet SDK do reklam mobilnych Google w wersji 23.6.0.
• Pakiet SDK Moloco w wersji 3.6.0.

Wersja 3.5.0.0

• Pierwsza wersja.
• Dodano obsługę określania stawek w przypadku formatów reklam: banerów, reklam pełnoekranowych i reklam z nagrodą.
• Zweryfikowano zgodność z pakietem SDK Moloco w wersji 3.5.0.

Zaprojektowano i przetestowano z użyciem:

• Pakiet SDK do reklam mobilnych Google w wersji 23.6.0.
• Moloco SDK w wersji 3.5.0.