Integracja nend z zapośredniczeniem

Z tego przewodnika dowiesz się, jak używać pakietu SDK do reklam mobilnych Google do wczytywania i wyświetlania reklam z aplikacji za pomocą zapośredniczenia w zakresie integracji kaskady. Opisano w nim, jak dodać komponent nend do konfiguracji zapośredniczenia jednostki reklamowej oraz jak zintegrować pakiet SDK i adapter nend z aplikacjąiOS .

Interfejs panelu nend w etykietach, przyciskach i opisach zawiera tekst w języku japońskim, a widoczne poniżej zrzuty ekranu nie zostały przetłumaczone. W tym przewodniku etykiety i przyciski są odwoływane do ich angielskich odpowiedników. np. „URL カーム”, to „Schemat URL” i tak dalej.

Obsługiwane integracje i formaty reklam

Adapter zapośredniczenia AdMob dla nend ma te możliwości:

Wymagania

• Wartość docelowa wdrożenia iOS w wersji 12.0 lub nowszej

• Najnowszy pakiet SDK do reklam mobilnych Google

• Skorzystaj z zapośredniczenia Wprowadzenie

Krok 1. Skonfiguruj konfiguracje w interfejsie użytkownika Nend

Zarejestruj się lub zaloguj na konto Nend.

Aby dodać aplikację do panelu nend, najpierw kliknij kartę Zarządzanie miejscami docelowymi, a następnie wybierz Witryna/aplikacja. Kliknij przycisk Dodaj aplikację, by dodać aplikację do oferty.

Tworzenie aplikacji

Wpisz nazwę swojej aplikacji i jako typ aplikacji wybierz platformę, na której jest ona dostępna. Wpisz URL i sprawdź, czy Twoja aplikacja jest dostępna w odpowiednim sklepie z aplikacjami.

(jeśli Twoja aplikacja nie została jeszcze opublikowana, zapoznaj się z najczęstszymi pytaniami na temat nieopublikowanych aplikacji). Wybierz kategorię dla swojej aplikacji i kliknij Utwórz.

Po utworzeniu aplikacja zostanie wyświetlona w panelu.

Tworzenie miejsca docelowego

Po zarejestrowaniu aplikacji możesz przejść do tworzenia miejsca docelowego. Aby utworzyć miejsce docelowe na potrzeby banerów reklamowych, otwórz kartę Zarządzanie miejscami docelowymi i kliknij Miejsce docelowe. Następnie kliknij przycisk Utwórz nowe miejsce docelowe.

Wybierz aplikację w menu. Następnie postępuj zgodnie z instrukcjami odpowiednimi dla Twojego preferowanego formatu reklamy.

Aby skonfigurować AdMob jednostkę reklamową w kolejnej sekcji, będziesz potrzebować apiKey i spotID dla każdego miejsca docelowego. Aby je znaleźć, otwórz kartę Zarządzanie miejscami docelowymi i kliknij przycisk SDK pod nazwą aplikacji.

Zwróć uwagę na apiKey i spotID.

Potrzebny będzie też klucz interfejsu API do interfejsu API do raportowania nend, który wywołuje klucz interfejsu API do wydobywania danych. Znajdziesz go na karcie Narzędzia.

Krok 2. Skonfiguruj zapotrzebowanie AdMob w interfejsie

Konfigurowanie ustawień zapośredniczenia dla jednostki reklamowej

Musisz dodać nend do konfiguracji zapośredniczenia jednostki reklamowej.

Najpierw zaloguj się na swoje konto AdMob. Następnie otwórz kartę Zapośredniczenie. Jeśli masz istniejącą grupę zapośredniczenia, którą chcesz zmodyfikować, kliknij jej nazwę, aby ją edytować, i przejdź od razu do sekcji Dodawanie nend jako źródła reklam.

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

Podaj format reklamy i platformę, a następnie kliknij Dalej.

Nazwij grupę 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ą istniejącą jednostką reklamowąAdMob . Następnie kliknij Gotowe.

Na karcie jednostek reklamowych powinny się pojawić wybrane przez Ciebie jednostki reklamowe:

Dodaj nend jako źródło reklam

Na karcie Kaskada w sekcji Źródła reklam kliknij Dodaj źródło reklamy. Następnie kliknij nend.

Jeśli masz już mapowanie nend, możesz je wybrać. W przeciwnym razie kliknij Dodaj mapowanie.

Następnie wpisz dane Slot ID and API Keyotrzymane w poprzedniej sekcji. Następnie kliknij Gotowe.

Krok 3. Zaimportuj pakiet SDK i adapter nend

Używanie CocoaPods (zalecane)

• Dodaj ten wiersz do pliku Podfile projektu:

  pod 'GoogleMobileAdsMediationNend'
  

• W wierszu poleceń:

  pod install --repo-update
  

Integracja ręczna

Pobierz najnowszą wersję pakietu SDK Nend na iOS i połącz z nim nendSDK.framework w swoim projekcie. Pobierz najnowszy adapter nend adapter z linku do pobierania w historii zmian i połącz NendAdapter.framework w swoim projekcie.

Dodaj do projektu te platformy:

• AdSupport.framework
• Security.framework
• ImageIO.framework
• AVFoundation.framework
• CoreMedia.framework
• SystemConfiguration.framework
• WebKit.framework

Dodatkowo dzięki dodaniu poniższych schematów możesz korzystać ze szczegółowych informacji według wyświetlania reklam.

• CoreLocation.framework
• CoreMotion.framework
• CoreTelephony.framework

Krok 5. Dodaj wymagany kod

Integracja z bazą danych nie wymaga dodatkowego kodu.

Integracja SKAdNetwork

Wykonaj dokumentację dostępną w dokumentacji, aby dodać identyfikatory SKAdNetwork do pliku Info.plist projektu.

Ustawienia projektu

Dodaj flagę -ObjC do sekcji Inne flagi tagu łączącego w sekcji Cel aplikacji > Ustawienia kompilacji.

Krok 6. Przetestuj implementację

Włącz reklamy testowe

Zarejestruj urządzenie testowe na potrzeby AdMob. Aby uzyskać reklamy testowe dla banerów, reklam pełnoekranowych i reklam z nagrodą, zalecamy użycie kluczy interfejsu API i identyfikatorów Spotów podanych na stronie dołącz do testowych jednostek reklamowych . Podczas testowania można je wpisać jako klucze interfejsu API i identyfikatory Spota jednostek reklamowych AdMob podczas testowania, a następnie zastąpić je rzeczywistym kluczem interfejsu API i identyfikatorem Spota, gdy aplikacja będzie gotowa do produkcji.

Weryfikacja reklam testowych

Aby sprawdzić, czy otrzymujesz reklamy testowe z witrynynend, włącz w inspektorze reklam testowanie pojedynczego źródła reklam, korzystając z nend (Waterfall) źródeł reklam.

Kroki opcjonalne:

Parametry specyficzne dla sieci

Adapter nend obsługuje dodatkowe parametry żądania, które można przekazać do adaptera za pomocą klasy GADMAdapterNendExtras. Ta klasa zawiera te właściwości:

• interstitialType: Nend udostępnia opcję TypeNormal w przypadku zwykłych reklam pełnoekranowych i TypeVideo w przypadku pełnoekranowych reklam wideo. Jeśli nie dodasz tego dodatkowego parametru, Nend domyślnie używa typu reklamy pełnoekranowej TypeNormal.
• nativeType: Nend umożliwia wybór opcji TypeNormal w przypadku zwykłych reklam natywnych i TypeVideo w przypadku natywnych reklam wideo. Jeśli ten dodatkowy parametr nie zostanie dodany, domyślnym typem reklamy natywnej Nend będzie TypeNormal.

Oto przykłady ustawiania tych parametrów żądania reklamy:

let request = GADRequest()
let extras = GADMAdapterNendExtras()
extras.interstitialType = GADMAdapterNendInterstitialType.normal
extras.nativeType = GADMAdapterNendNativeType.normal
request.registerAdNetworkExtras(extras)

GADRequest *request = [GADRequest request];
GADMAdapterNendExtras *extras = [[GADMAdapterNendExtras alloc] init];
extras.interstitialType = GADMAdapterNendInterstitialTypeNormal;
extras.nativeType = GADMAdapterNendNativeTypeNormal;
[request registerAdNetworkExtras:extras];

Korzystanie z reklam natywnych

Renderowanie reklam

Adapter Nend zwraca reklamy natywne jako obiekty GADNativeAd . Uzupełnia te opisy pól reklam natywnych dla GADNativeAd

¹ Nend tylko udostępnia komponent z obrazem na potrzeby natywnych miejsc docelowych skonfigurowanych z opcją Wybór obrazu reklamy ustawionym na Duży obraz reklamowy w poziomie (5: 3).

² Nend nie udostępnia zasobu ikony dla natywnych miejsc docelowych skonfigurowanych z opcją Wybór obrazu reklamy ustawioną na Brak obrazu (tylko tekst).

Kody błędów

Jeśli adapter nie otrzyma reklamy od Nend, wydawcy mogą sprawdzić przyczynę błędu w odpowiedzi na żądanie reklamy, korzystając z elementu GADResponseInfo.adNetworkInfoArray w tych zajęciach:

Oto kody i powiązane z nimi wiadomości wysyłane przez adapter Nend, gdy nie można wczytać reklamy:

nend iOS Mediation Adapter – historia zmian

Następna wersja

• Usunięto wycofaną metodę przekazywania dostępu willBackgroundApplication z modułu ładowania reklam natywnych.
• Teraz wymagany jest iOS w wersji co najmniej 12.0.
• Wymaga teraz pakietu SDK do reklam mobilnych Google w wersji 11.0 lub nowszej.
• Plik Info.plist został dołączony do plików NendAdapter.xcframework.

Wersja 8.2.0.0

• Zweryfikowana zgodność z pakietem SDK nend 8.2.0.

Stworzone i przetestowane w:

• Pakiet SDK do reklam mobilnych Google w wersji 10.11.0.
• Nend SDK w wersji 8.2.0.

Wersja 8.1.0.0

• Usunięto obsługę architektury armv7.
• Teraz wymagany jest iOS w wersji co najmniej 11.0.
• Wymaga teraz pakietu SDK do reklam mobilnych Google w wersji 10.4.0 lub nowszej.

Stworzone i przetestowane w:

• Pakiet SDK do reklam mobilnych Google w wersji 10.8.0.
• Nend SDK w wersji 8.1.0.

Wersja 8.0.1.0

• Zweryfikowana zgodność z pakietem SDK nend 8.0.1.

Stworzone i przetestowane w:

• Pakiet SDK do reklam mobilnych Google w wersji 10.3.0.
• Nend SDK w wersji 8.0.1.

Wersja 8.0.0.0

• Zweryfikowana zgodność z pakietem SDK nend 8.0.0.

Stworzone i przetestowane w:

• Pakiet SDK do reklam mobilnych Google w wersji 10.2.0.
• Nend SDK w wersji 8.0.0.

Wersja 7.4.0.1

• Wymaga teraz pakietu SDK do reklam mobilnych Google w wersji 10.0.0 lub nowszej.

Stworzone i przetestowane w:

• Pakiet SDK do reklam mobilnych Google w wersji 10.0.0.
• Nend SDK w wersji 7.4.0.

Wersja 7.4.0.0

• Zweryfikowana zgodność z pakietem SDK nend 7.4.0.
• Zaktualizowano adapter, aby używał interfejsu didRewardUser API.
• Wymaga teraz pakietu SDK do reklam mobilnych Google w wersji 9.8.0 lub nowszej.

Stworzone i przetestowane w:

• Pakiet SDK do reklam mobilnych Google w wersji 9.10.0.
• Nend SDK w wersji 7.4.0.

Wersja 7.3.0.0

• Zweryfikowana zgodność z pakietem SDK nend 7.3.0.

Stworzone i przetestowane w:

• Pakiet SDK do reklam mobilnych Google w wersji 9.3.0.
• Nend SDK w wersji 7.3.0.

Wersja 7.2.0.0

• Zweryfikowana zgodność z pakietem SDK nend 7.2.0.
• Dodano obsługę architektury symulatora Arm64.

Stworzone i przetestowane w:

• Pakiet SDK do reklam mobilnych Google w wersji 9.1.0.
• Nend SDK w wersji 7.2.0.

Wersja 7.1.0.1

• Zweryfikowana zgodność z pakietem SDK do reklam mobilnych Google w wersji 9.0.0.
• Wymaga teraz pakietu SDK do reklam mobilnych Google w wersji 9.0.0 lub nowszej.

Stworzone i przetestowane w:

• Pakiet SDK do reklam mobilnych Google w wersji 9.0.0.
• Nend SDK w wersji 7.1.0.

Wersja 7.1.0.0

• Zweryfikowana zgodność z pakietem SDK nend 7.1.0.
• Teraz wymagany jest iOS w wersji co najmniej 10.0.

Stworzone i przetestowane

• Pakiet SDK do reklam mobilnych Google w wersji 8.12.0.
• Nend SDK w wersji 7.1.0.

Wersja 7.0.6.1

• Rozwiązaliśmy problem, który powodował, że w przypadku reklam pełnoekranowych wywołanie zwrotne adDidRecordClick nie było przekierowywane.

Stworzone i przetestowane

• Pakiet SDK do reklam mobilnych Google w wersji 8.9.0.
• Nend SDK w wersji 7.0.6.

Wersja 7.0.6.0

• Zweryfikowana zgodność z pakietem SDK nend 7.0.6.
• Dodaliśmy standardowe kody błędów i komunikaty o błędach adaptera.

Stworzone i przetestowane

• Pakiet SDK do reklam mobilnych Google w wersji 8.8.0.
• Nend SDK w wersji 7.0.6.

Wersja 7.0.5.0

• Zweryfikowana zgodność z pakietem SDK nend 7.0.5.

Stworzone i przetestowane

• Pakiet SDK do reklam mobilnych Google w wersji 8.5.0.
• Nend SDK w wersji 7.0.5.

Wersja 7.0.4.0

• Zweryfikowana zgodność z pakietem SDK nend 7.0.4.
• proste zależności od pakietu SDK do reklam mobilnych Google w wersji 8.0.0 lub nowszej.
• Zaktualizowano adapter, aby używać formatu .xcframework.

Stworzone i przetestowane

• Pakiet SDK do reklam mobilnych Google w wersji 8.5.0.
• Nend SDK w wersji 7.0.4.

Wersja 7.0.2.0

• Zweryfikowana zgodność z pakietem SDK nend 7.0.2.
• Rozwiązaliśmy problem z wyświetlaniem widoku multimediów w nieprawidłowej pozycji.

Stworzone i przetestowane

• Pakiet SDK do reklam mobilnych Google w wersji 7.69.0.
• Nend SDK w wersji 7.0.2.

Wersja 7.0.1.0

• Zweryfikowana zgodność z pakietem SDK nend 7.0.1.
• Zaktualizowano minimalną wersję pakietu SDK do reklam mobilnych Google do wersji 7.69.0.

Stworzone i przetestowane

• Pakiet SDK do reklam mobilnych Google w wersji 7.69.0.
• Nend SDK w wersji 7.0.1.

Wersja 7.0.0.0

• Zweryfikowana zgodność z pakietem SDK nend 7.0.0.

Stworzone i przetestowane

• Pakiet SDK do reklam mobilnych Google w wersji 7.65.0.
• Nend SDK w wersji 7.0.0.

Wersja 6.0.3.0

• Zweryfikowana zgodność z pakietem SDK nend 6.0.3.
• Zaktualizowano minimalną wersję pakietu SDK do reklam mobilnych Google do wersji 7.65.0.

Stworzone i przetestowane

• Pakiet SDK do reklam mobilnych Google w wersji 7.65.0.
• Nend SDK w wersji 6.0.3.

Wersja 6.0.2.0

• Zweryfikowana zgodność z pakietem SDK nend 6.0.2.
• Zaktualizowano minimalną wersję pakietu SDK do reklam mobilnych Google do wersji 7.64.0.

Stworzone i przetestowane

• Pakiet SDK do reklam mobilnych Google w wersji 7.64.0.
• Nend SDK w wersji 6.0.2.

Wersja 6.0.1.0

• Zweryfikowana zgodność z pakietem SDK nend 6.0.1.

Stworzone i przetestowane

• Pakiet SDK do reklam mobilnych Google w wersji 7.62.0.
• Nend SDK w wersji 6.0.1.

Wersja 6.0.0.0

• Zweryfikowana zgodność z pakietem SDK nend 6.0.0.
• Usunięto zajęcia GADNendRewardedNetworkExtras. Jeśli chcesz przekazywać rozszerzenia sieci do adaptera nend iOS, użyj klasy GADMAdapterNendExtras.
• Zmieniliśmy nazwy następujących wyliczeń z klasy GADMAdapterNendExtras:
  • GADMNendInterstitialType, by GADMAdapterNendInterstitialType.
  • GADMNendNativeType, by GADMAdapterNendNativeType.
• Zaktualizowano minimalną wersję pakietu SDK do reklam mobilnych Google do wersji 7.62.0.

Stworzone i przetestowane

• Pakiet SDK do reklam mobilnych Google w wersji 7.62.0.
• Nend SDK w wersji 6.0.0.

Wersja 5.4.1.0

• Zweryfikowana zgodność z pakietem SDK nend 5.4.1.
• Dodaliśmy obsługę reklam natywnych.
• Usunięto obsługę architektury i386.

Stworzone i przetestowane

• Pakiet SDK do reklam mobilnych Google w wersji 7.58.0.
• Nend SDK w wersji 5.4.1.

Wersja 5.3.1.0

• Zweryfikowana zgodność z pakietem SDK nend 5.3.1.

Twórz i testuj za pomocą

• Pakiet SDK do reklam mobilnych Google w wersji 7.52.0.
• Nend SDK w wersji 5.3.1.

Wersja 5.3.0.0

• Zweryfikowana zgodność z pakietem SDK nend 5.3.0.

Stworzone i przetestowane w:

• Pakiet SDK do reklam mobilnych Google w wersji 7.50.0.
• Nend SDK w wersji 5.3.0.

Wersja 5.1.1.0

• Zaktualizowano adapter, aby korzystać z nowego interfejsu API z nagrodami.
• Wymaga teraz pakietu SDK do reklam mobilnych Google w wersji 7.42.2 lub nowszej.
• Zweryfikowana zgodność z pakietem SDK nend 5.1.1.
• Zmieniono warunek sprawdzania rozmiaru banera. Odpowiedni rozmiar banera inteligentnego.
  • kGADAdSizeSmartBannerPortrait
    • iPhone: 320×50
    • iPad: 728 × 90 lub 320 × 50
  • kGADAdSizeSmartBannerLandscape
    • iPad: 728 × 90 lub 320 × 50
• Dodaliśmy obsługę elastycznych rozmiarów banerów reklamowych.

Wersja 5.1.0.0

• Zweryfikowana zgodność z pakietem SDK nend 5.1.0.

Wersja 5.0.3.0

• Zweryfikowana zgodność z pakietem SDK nend 5.0.3.

Wersja 5.0.2.0

• Zweryfikowana zgodność z pakietem SDK nend 5.0.2.

Wersja 5.0.1.0

• Zweryfikowana zgodność z pakietem SDK nend 5.0.1.

Wersja 5.0.0.0

• Zweryfikowana zgodność z pakietem SDK nend 5.0.0.

Wersja 4.0.6.0

• Zweryfikowana zgodność z pakietem SDK nend 4.0.6.
• Usuń, aby ustawić właściwość userFeature.

Wersja 4.0.5.0

• Zweryfikowana zgodność z pakietem SDK nend 4.0.5.

Wersja 4.0.4.0

• Zweryfikowana zgodność z pakietem SDK nend 4.0.4.

Wersja 4.0.3.0

• Zweryfikowana zgodność z pakietem SDK nend 4.0.3.

Wersja 4.0.2.0

• Pierwsza wersja projektu open source zapośredniczenia reklam mobilnych Google.
• Dodaliśmy obsługę reklam wideo opartych na nagrodach.

Poprzednie wersje

• Obsługuje banery i reklamy pełnoekranowe.