Integracja Moloco z określaniem stawek

Z tego przewodnika dowiesz się, jak używać pakietu Google Mobile Ads SDK do wczytywania i wyświetlania reklam displayowych z Moloco za pomocą zapośredniczenia, które obejmuje integracje z określaniem stawek. Dowiesz się z niego, jak dodać Moloco do konfiguracji zapośredniczenia jednostki reklamowej oraz jak zintegrować pakiet SDK i adapter Moloco z aplikacją na iOS.

Obsługiwane integracje i formaty reklam

Adapter zapośredniczenia Moloco ma te funkcje:

Wymagania wstępne

Zanim przejdziesz dalej, sprawdź te kwestie:

• iOS w wersji 13.0 lub nowszej.

• Adapter Moloco w wersji 3.9.1.0 lub nowszej.

• Najnowsza wersja Google Mobile Ads SDK.

• Skonfiguruj zapośredniczenie.

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 Apps (Aplikacje), aby wyświetlić szczegóły, i zanotuj App Key (Klucz aplikacji).

Otwórz kartę 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. Zanotuj Identyfikator jednostki reklamowej.

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

Zaloguj się na konto Ad Managera.

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

Kliknij Administracja > Ustawienia globalne. Otwórz kartę Ustawienia konta Ad Exchange, sprawdź 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 pakiet SDK do wyświetlania reklam i włącz opcję Włącz integrację aplikacyjną.

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 SDK do reklam Moloco.

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

Aby dodać Moloco Ads do listy partnerów reklamowych wymaganych przez rozporządzenia europejskie i przepisy stanowe w USA w interfejsie Ad Managera, wykonaj czynności opisane w sekcjach Ustawienia dotyczące rozporządzeń europejskich i Ustawienia dotyczące przepisów stanowych w USA.

Krok 3. Zaimportuj pakiet SDK i adapter Moloco

Korzystanie z Swift Package Manager

Zanim przejdziesz dalej, musisz mieć minimalną obsługiwaną wersję adaptera 4.1.0.0.

Aby dodać zależność pakietu do projektu, wykonaj te czynności:

1. W Xcode kliknij File (Plik) > Add Package Dependencies… (Dodaj zależności pakietów…).

2. W wyświetlonym oknie wyszukaj ten adres URL pakietu:

   https://github.com/googleads/googleads-mobile-ios-mediation-moloco.git
   

3. W sekcji Reguła zależności wybierz Gałąź.

4. W polu tekstowym wpisz main.

Używanie CocoaPods

• 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 SDK Moloco

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.

Wersja 3.5.0.0 i nowsze adaptera pakietu Moloco Ads SDK na iOS obsługują przekazywanie sygnałów zgody wymaganych przez RODO z platform do zarządzania zgodą, które są zintegrowane z opracowanymi przez IAB zasadami dotyczącymi przejrzystości i uzyskiwania zgody na przetwarzanie danych (TCF), do pakietu Moloco Ads SDK. Więcej informacji znajdziesz w sekcji Ciąg tekstowy zgody użytkownika w ramach TCF.

Amerykańskie przepisy stanowe o ochronie prywatności

Amerykańskie przepisy stanowe dotyczące prywatności wymagają, aby użytkownicy mieli prawo do rezygnacji ze „sprzedaży” ich „danych osobowych” (w znaczeniu określonym w ustawie). Opcja rezygnacji musi być dostępna za pomocą dobrze widocznego linku „Nie sprzedawaj moich danych osobowych” na stronie głównej „sprzedającego”. Przewodnik po amerykańskich przepisach stanowych o ochronie danych osobowych 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 ł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 SDK Moloco zawiera flagę isDoNotSell, która umożliwia przekazywanie informacji o zgodzie do pakietu SDK Moloco.

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 reklamy za pomocą Google Mobile Ads SDK.

import MolocoSDK
// ...

MolocoPrivacySettings.isDoNotSell = true;

#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.

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 od Moloco, możesz sprawdzić podstawowy błąd w odpowiedzi na reklamę, korzystając z GADResponseInfo.adNetworkInfoArray w tych klasach:

MolocoSDK.MolocoError
GADMediationAdapterMoloco

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

Lista zmian dotyczących zgodnego z iOS adaptera zapośredniczenia Moloco

Wersja 4.11.1.0

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

Zbudowano i przetestowano z:

• Pakiet SDK do reklam mobilnych Google w wersji 13.11.0.
• Pakiet SDK Moloco w wersji 4.11.1.

Wersja 4.11.0.0

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

Zbudowano i przetestowano z:

• Pakiet SDK do reklam mobilnych Google w wersji 13.11.0.
• Pakiet SDK Moloco w wersji 4.11.0.

Wersja 4.10.0.0

• Zweryfikowano zgodność z pakietem SDK Moloco w wersji 4.10.0.
• Zaktualizowano, aby wskazać, że pakiet SDK Moloco może śledzić wyświetlenia reklam natywnych.

Zaprojektowano i przetestowano z użyciem:

• Pakiet SDK do reklam mobilnych Google w wersji 13.9.0.
• Wersja pakietu Moloco SDK 4.10.0.

Wersja 4.9.1.0

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

Zbudowano i przetestowano z:

• Pakiet SDK do reklam mobilnych Google w wersji 13.8.0.
• Pakiet SDK Moloco w wersji 4.9.1.

Wersja 4.9.0.0

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

Zaprojektowano i przetestowano z użyciem:

• Pakiet SDK do reklam mobilnych Google w wersji 13.7.0.
• Pakiet SDK Moloco w wersji 4.9.0.

Wersja 4.8.1.1

• Dodano obsługę rozmiarów banerów adaptacyjnych.

Zbudowano i przetestowano z:

• SDK do reklam mobilnych Google w wersji 13.6.0.
• Pakiet SDK Moloco w wersji 4.8.1.

Wersja 4.8.1.0

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

Zbudowano i przetestowano z:

• SDK do reklam mobilnych Google w wersji 13.6.0.
• Moloco SDK w wersji 4.8.1.

Wersja 4.8.0.0

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

Zbudowano i przetestowano z:

• Pakiet SDK do reklam mobilnych Google w wersji 13.6.0.
• Pakiet SDK Moloco w wersji 4.8.0.

Wersja 4.7.0.0

• Sprawdzona zgodność z pakietem SDK Moloco w wersji 4.7.0.
• Zaktualizuj minimalną wersję iOS, aby zmniejszyć zależność od pakietu SDK do reklam mobilnych Google i umożliwić korzystanie z wersji podrzędnych.

Zbudowano i przetestowano z:

• Pakiet SDK do reklam mobilnych Google w wersji 13.5.0.
• Pakiet SDK Moloco w wersji 4.7.0.

Wersja 4.6.1.1

• Adapter przekazuje teraz flagę pakietu SDK do reklam mobilnych Google ageRestrictedTreatment do interfejsu COPPA API pakietu SDK Moloco.

Zaprojektowano i przetestowano z użyciem:

• Pakiet SDK do reklam mobilnych Google w wersji 13.3.0.
• Pakiet SDK Moloco w wersji 4.6.1.

Wersja 4.6.1.0

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

Zbudowano i przetestowano z:

• Pakiet SDK do reklam mobilnych Google w wersji 13.3.0.
• Pakiet SDK Moloco w wersji 4.6.1.

Wersja 4.6.0.0

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

Zbudowano i przetestowano z:

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

Wersja 4.5.1.0

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

Zbudowano i przetestowano z:

• Pakiet SDK do reklam mobilnych Google w wersji 13.2.0.
• Pakiet SDK Moloco w wersji 4.5.1.

Wersja 4.5.0.0

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

Zbudowano i przetestowano z:

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

Wersja 4.4.1.0

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

Zbudowano i przetestowano z:

• Pakiet SDK do reklam mobilnych Google w wersji 13.1.0.
• Wersja pakietu Moloco SDK 4.4.1.

Wersja 4.4.0.0

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

Zaprojektowano i przetestowano z użyciem:

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

Wersja 4.3.0.2

• Zaktualizowano zależność pakietu SDK do reklam mobilnych Google do wersji 13.0.0.

Zbudowano i przetestowano z:

• Pakiet SDK do reklam mobilnych Google w wersji 13.0.0.
• Pakiet SDK Moloco w wersji 4.3.0.

Wersja 4.3.0.1

• Zaktualizowano minimalną wersję iOS w CocoaPods do 13.0.

Zbudowano i przetestowano z:

• Pakiet SDK do reklam mobilnych Google w wersji 13.0.0.
• Moloco SDK w wersji 4.3.0.

Wersja 4.3.0.0

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

Zbudowano i przetestowano z:

• Pakiet SDK do reklam mobilnych Google w wersji 12.14.0.
• Moloco SDK w wersji 4.3.0.

Wersja 4.2.0.0

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

Zbudowano i przetestowano z:

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

Wersja 4.1.2.0

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

Zbudowano i przetestowano z:

• Pakiet SDK do reklam mobilnych Google w wersji 12.14.0.
• Pakiet SDK Moloco w wersji 4.1.2.

Wersja 4.1.0.0

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

Zbudowano i przetestowano z:

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

Wersja 3.13.0.0

• Obejmuje Info.plist w ramach platform.
• Zweryfikowana zgodność z pakietem SDK Moloco w wersji 3.13.0.

Zbudowano i przetestowano z:

• Pakiet SDK do reklam mobilnych Google w wersji 12.9.0.
• Wersja pakietu SDK Moloco 3.13.0.

Wersja 3.12.1.0

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

Zaprojektowano i przetestowano z użyciem:

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

Wersja 3.12.0.0

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

Zbudowano i przetestowano z:

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

Wersja 3.11.0.0

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

Zaprojektowano i przetestowano z użyciem:

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

Wersja 3.10.1.0

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

Zaprojektowano i przetestowano z użyciem:

• SDK do reklam mobilnych Google w wersji 12.6.0.
• Pakiet SDK Moloco w wersji 3.10.1.

Wersja 3.10.0.0

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

Zbudowano i przetestowano z:

• Pakiet SDK do reklam mobilnych Google w wersji 12.5.0.
• Pakiet SDK Moloco 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.

Zbudowano i przetestowano z:

• Pakiet SDK do reklam mobilnych Google w wersji 12.3.0.
• Pakiet SDK Moloco 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 Moloco SDK w wersji 3.9.0.

Zbudowano i przetestowano z:

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

Wersja 3.8.0.0

• Włączono flagi -fobjc-arc i -fstack-protector-all.
• Wyeliminowaliśmy problem z uzyskiwaniem oceny w postaci gwiazdek w przypadku reklam natywnych.
• 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 12.2.0.
• Pakiet SDK Moloco w wersji 3.8.0.

Wersja 3.7.2.0

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

Zaprojektowano i przetestowano z użyciem:

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

Wersja 3.7.1.0

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

Zaprojektowano i przetestowano z użyciem:

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

Wersja 3.7.0.0

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

Zaprojektowano i przetestowano z użyciem:

• Pakiet SDK do reklam mobilnych Google w wersji 12.0.0.
• Pakiet SDK Moloco w wersji 3.7.0.

Wersja 3.6.0.1

• Zaktualizowano adapter, aby pobierał wersję pakietu Moloco SDK z wątku głównego.
• Teraz wymagany jest pakiet SDK do reklam mobilnych Google w wersji 12.0.0 lub nowszej.

Zbudowano i przetestowano z:

• 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.

Zbudowano i przetestowano z:

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

Wersja 3.5.0.0

• Pierwsza wersja.
• Dodaliśmy obsługę określania stawek w przypadku formatów reklam banerowych (w tym MREC), pełnoekranowych i z nagrodą.
• Zweryfikowana zgodność z pakietem SDK Moloco w wersji 3.5.0.

Zaprojektowano i przetestowano z użyciem:

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