Google używa technologii AI do tłumaczenia treści na Twój preferowany język. Tłumaczenia wygenerowane przez AI mogą zawierać błędy.

Integracja Moloco z zapośredniczeniem

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 AdMob, co obejmuje integrację 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:

Integracja
Określanie stawek
Kaskada
Formaty
Otwarcie aplikacji
Baner
Pełnoekranowa
Z nagrodą
Reklama pełnoekranowa z nagrodą
Rodzimy użytkownik

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

Krok 1. Skonfiguruj ustawienia w interfejsie Moloco

Zaloguj się w portalu wydawców Moloco.

Kliknij 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łą 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. Zapisz identyfikator jednostki reklamowej.

Krok 2. Skonfiguruj oferty reklamowe Moloco w interfejsie AdMob

Konfigurowanie ustawień zapośredniczenia dla jednostki reklamowej

Musisz dodać pakiet SDK Moloco Ads do konfiguracji zapośredniczenia dla jednostki reklamowej.

Najpierw zaloguj się na konto AdMob. Następnie otwórz kartę Zapośredniczenie. Jeśli masz już grupę zapośredniczenia, którą chcesz zmodyfikować, kliknij jej nazwę, aby ją edytować, i przejdź do sekcji Dodawanie pakietu SDK Moloco Ads jako źródła reklam.

Aby utworzyć nową grupę zapośredniczenia, kliknij Utwórz grupę zapośredniczenia.

Wpisz format reklamy i platformę, a potem kliknij Dalej.

Nadaj nazwę grupie zapośredniczenia i wybierz lokalizacje, na które chcesz kierować reklamy. Następnie ustaw stan grupy zapośredniczenia na Włączona i kliknij Dodaj jednostki reklamowe.

Powiąż tę grupę zapośredniczenia z co najmniej jedną z istniejących jednostek reklamowych AdMob. Następnie kliknij Gotowe.

Na karcie jednostek reklamowych powinny być teraz widoczne wybrane przez Ciebie jednostki reklamowe:

Dodawanie pakietu SDK Moloco Ads jako źródła reklam

W sekcji Źródła reklam znajdź kartę Określanie stawek i kliknij Dodaj źródło reklam. Następnie wybierz Moloco Ads SDK.

Kliknij Jak podpisać umowę partnerską i skonfiguruj partnerstwo dotyczące określania stawek z Moloco Ads SDK.

Kliknij Potwierdź i wyraź zgodę, a następnie Dalej.

Jeśli masz już mapowanie dla pakietu SDK do wyświetlania reklam Moloco Ads, możesz je wybrać. W przeciwnym razie kliknij Dodaj mapowanie.

Następnie wpisz klucz aplikacji i identyfikator jednostki reklamowej uzyskane w poprzedniej sekcji. Następnie kliknij Gotowe.

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

Krok 3. Zaimportuj pakiet SDK i adapter Moloco

Zalecane: użyj Swift Package Managera

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

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

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

W wyświetlonym oknie wyszukaj ten adres URL pakietu:

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

W sekcji Reguła zależności wybierz Gałąź.
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 przekazać określone informacje użytkownikom z Europejskiego Obszaru Gospodarczego (EOG), Wielkiej Brytanii i Szwajcarii oraz uzyskać ich zgodę na wykorzystywanie plików cookie lub innych lokalnych metod przechowywania danych, jeśli jest to wymagane przez prawo, a także na gromadzenie, udostępnianie i wykorzystywanie danych osobowych do 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 zapośredniczenia.

Adapter pakietu SDK Moloco Ads na iOS 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 (TCF), do pakietu SDK Moloco Ads. Więcej informacji znajdziesz w artykule Ciąg tekstowy dotyczący zgody zgodny z zasadami TCF.

amerykańskie przepisy stanowe o ochronie prywatności

Amerykańskie przepisy stanowe o ochronie prywatności wymagają, aby użytkownicy mieli prawo do rezygnacji ze „sprzedaży” ich „danych osobowych” (w znaczeniu określonym w ustawie). Opcja ta musi być dostępna za pomocą dobrze widocznego linku „Nie sprzedawaj moich danych osobowych” na stronie głównej podmiotu „sprzedającego”. Przewodnik po zgodności z amerykańskimi przepisami stanowymi 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 ł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 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 prywatności.

Krok 5. Przetestuj implementację

Włączanie reklam testowych

Pamiętaj, aby zarejestrować urządzenie testowe w AdMob.

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 reklamę, korzystając z metody 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:

Kod błędu	Domena	Przyczyna
101	com.google.ads.mediation.moloco	Pakiet SDK Moloco nie obsługuje wyświetlania reklam na urządzeniach z systemem iOS 12 lub starszym.
102	com.google.ads.mediation.moloco	Brak klucza aplikacji Moloco lub jest on nieprawidłowy.
103	com.google.ads.mediation.moloco	Brak identyfikatora jednostki reklamowej Moloco lub jest on nieprawidłowy.
104	com.google.ads.mediation.moloco	Reklama nie jest gotowa do wyświetlenia.
105	com.google.ads.mediation.moloco	Nie udało się wyświetlić reklamy.
106	com.google.ads.mediation.moloco	Dane renderowania są niedostępne, aby wyrenderować reklamę.
Od –1 do 5000	Wysłane przez pakiet Moloco SDK	Pakiet Moloco SDK zwrócił błąd. Więcej informacji znajdziesz w dokumentacji Moloco.