Ta strona została przetłumaczona przez Cloud Translation API.

Zintegruj Chartboost z zapośredniczeniem

Ten przewodnik pokazuje, jak za pomocą pakietu SDK do reklam mobilnych Google wczytywać i wyświetlać reklamy z Chartboost za pomocą mediacji, obejmującej integracje kaskadowe. W tym artykule znajdziesz informacje o tym, jak dodać Chartboosta do konfiguracji pośrednictwa jednostki reklamowej oraz jak zintegrować pakiet SDK i adapter Chartboosta z aplikacją na iOS.

Obsługiwane integracje i formaty reklam

Adapter mediacji dla Chartboost ma te możliwości:

Integracja
Określanie stawek
Wodospad
Formaty
Baner
Pełnoekranowa
Z nagrodą
Natywna

Wymagania

docelowa wersja iOS 12.0 lub nowsza

Najnowsza wersja pakietu SDK do reklam mobilnych Google
Przejdź przez proces zapośredniczenia, korzystając z przewodnika dla początkujących.

Krok 1. Skonfiguruj konfiguracje w interfejsie Chartboost

Zarejestruj się na koncie Chartboost i zaloguj się, gdy Twoje konto zostanie zweryfikowane. Następnie otwórz kartę Zarządzanie aplikacjami.

Panel aplikacji Chartboost

Aby utworzyć aplikację, kliknij przycisk Dodaj nową aplikację.

Zarządzanie aplikacjami

Wypełnij resztę formularza i kliknij przycisk Dodaj aplikację, aby zakończyć proces.

Formularz dotyczący nowej aplikacji

Po utworzeniu aplikacji zostaniesz przekierowany do jej panelu. Zapisz identyfikator aplikacji i podpis aplikacji.

Ustawienia aplikacji

Aby skonfigurować identyfikator jednostki reklamowej Ad Managera, musisz podać w usłudze Chartboost identyfikator użytkownika i podpis użytkownika. Aby znaleźć te parametry, w interfejsie Chartboost kliknij Zapośredniczenie Chartboost.

Panel pośrednictwa Chartboost

Otwórz kartę Zasoby > Eksplorer interfejsu API i zapisz identyfikator użytkownika oraz podpis użytkownika znajdujące się w sekcji Uwierzytelnianie.

Chartboost API Explorer

Włączanie trybu testowego

Aby włączyć tryb testowy w aplikacji, otwórz kartę Zarządzanie aplikacjami w interfejsie Chartboost, wybierz aplikację z listy i kliknij Edytuj ustawienia aplikacji.

Edytowanie ustawień aplikacji

W ustawieniach aplikacji możesz włączyć tryb testowy.

Tryb testowy Chartboost

Gdy tryb testowy zostanie włączony, możesz żądać reklam za pomocą utworzonego wcześniej identyfikatora jednostki reklamowej i otrzymać reklamę testową Chartboost.

Gdy będziesz już otrzymywać reklamy testowe Chartboost, Twoja aplikacja zostanie umieszczona w sprawdzaniu aplikacji wydawcy Chartboost. Aby zarabiać na reklamach w Chartboost, musisz uzyskać zatwierdzenie aplikacji wydawcy przez Chartboost.

Krok 2. Skonfiguruj zapotrzebowanie Chartboost w interfejsie Ad Managera

Konfigurowanie ustawień zapośredniczenia dla jednostki reklamowej

Zaloguj się na konto Ad Managera.

Kliknij Wyświetlanie > Grupy zysku, a potem kliknij przycisk Nowa grupa zysku.

Wpisz unikalną nazwę grupy zysku, ustaw stan na Aktywna, wybierz Format reklamy i ustaw Typ zasobów reklamowych na Aplikacja mobilna. W sekcji Targetowanie > Zasoby wybierz jednostkę reklamową w sekcji Zasoby reklamowe i Aplikacja mobilna, do której chcesz dodać zapośredniczenie.

Następnie kliknij przycisk Dodaj partnera zysku.

Jeśli masz już partnera zysku w Chartboost, możesz go wybrać. W przeciwnym razie wybierz Utwórz nowego partnera zysku.

Jako sieć reklamowa wybierz Chartboost, wpisz unikalną nazwę i włącz zapośredniczenie.

Włącz Automatyczne zbieranie danych i wpisz identyfikator użytkownika oraz podpis użytkownika uzyskane w poprzedniej sekcji.

Po wybraniu partnera zysku wybierz Zapośredniczenie mobilne SDK jako Typ integracji, iOS jako Platforma i Aktywny jako Stan. Wpisz identyfikator aplikacji, sygnaturę aplikacji i miejsce docelowe reklamy uzyskane w poprzedniej sekcji. Następnie wpisz wartość Domyślny CPM.

Lokalizacje reklam Chartboost (nazwane lokalizacje) to proste nazwy miejsc w aplikacji, w których chcesz wyświetlać reklamy. Ad Manager wysyła żądania do lokalizacji określonej w ustawieniach. Po wysłaniu żądań Chartboost doda lokalizację do interfejsu użytkownika na potrzeby raportowania.

W interfejsie Chartboost możesz wyświetlić swoje lokalizacje reklam na stronie Podstawowe ustawienia, klikając Ustawienia zaawansowane. Więcej informacji znajdziesz w przewodniku po nazwanych lokalizacjach Chartboost.

Gdy skończysz, u dołu strony kliknij Zapisz.

Dodawanie Chartboost do listy partnerów reklamowych zgodnych z RODO i przepisami stanowymi w USA

Aby dodać Chartboost do listy partnerów reklamowych zgodnych z RODO i amerykańskimi przepisami stanowymi w interfejsie Ad Managera, wykonaj czynności opisane w sekcji Ustawienia RODO i Ustawienia dotyczące przepisów stanowych w USA.

Krok 3. Zaimportuj pakiet SDK i adapter Chartboost

Za pomocą CocoaPods (zalecane)

Dodaj ten wiersz do pliku Podfile projektu:
```
pod 'GoogleMobileAdsMediationChartboost'
```
W wierszu poleceń uruchom:
```
pod install --repo-update
```

Integracja ręczna

Pobierz najnowszą wersję pakietu Chartboost SDK i połącz w projekcie biblioteki Chartboost.framework i CHAMoatMobileAppKit.framework.
Pobierz najnowszą wersję adaptera Chartboost za pomocą linku do pobrania w Changelog i połącz ChartboostAdapter.framework w projekcie.
Dodaj do projektu te ramy:
- StoreKit
- Foundation
- CoreGraphics
- WebKit
- AVFoundation
- UIKit

Krok 4. Wprowadź ustawienia prywatności w pakiecie SDK Chartboost

Zgoda użytkowników z UE i RODO

Zgodnie z polityką Google w zakresie zgody użytkownika z UE musisz zadbać o to, aby użytkownicy z Europejskiego Obszaru Gospodarczego (EOG) otrzymali odpowiednie informacje i wyrazili zgodę na wykorzystywanie identyfikatorów urządzeń i danych osobowych. 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). Aby uzyskać zgodę, musisz wskazać wszystkie sieci reklamowe w łańcuchu zapośredniczenia, które mogą zbierać, otrzymywać lub używać danych osobowych, oraz podać informacje o wykorzystywaniu tych danych. Obecnie Google nie może automatycznie przekazywać wyboru użytkownika dotyczącego wyrażenia zgody do takich sieci.

W wersji pakietu SDK 8.2.0 firma Chartboost dodała metodę addDataUseConsent. Podany niżej przykładowy kod ustawia zgodę na wykorzystanie danych na CHBGDPRConsentNonBehavioral. Jeśli zdecydujesz się wywołać tę metodę, zalecamy, aby zrobić to przed wysłaniem żądania reklam za pomocą pakietu SDK do reklam mobilnych Google.

Swift

let dataUseConsent = CHBDataUseConsent.GDPR(CHBDataUseConsent.GDPR.Consent.nonBehavioral)
Chartboost.addDataUseConsent(dataUseConsent)

Objective-C

CHBGDPRDataUseConsent *dataUseConsent = [CHBGDPRDataUseConsent gdprConsent:CHBGDPRConsentNonBehavioral];
[Chartboost addDataUseConsent:dataUseConsent];

Więcej informacji oraz wartości, które można podać w ramach każdej metody, znajdziesz w artykule na temat RODO i Metody ochrony prywatności na iOS firmy Chartboost.

Amerykańskie przepisy stanowe o ochronie prywatności

Przepisy stanowe w USA dotyczące prywatności wymagają, aby użytkownicy mieli możliwość wycofania zgody na „sprzedaż” swoich „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 dotyczący zgodności z przepisami stanowymi USA o ochronie prywatności umożliwia włączenie ograniczonego przetwarzania danych w przypadku wyświetlania reklam Google, ale Google nie może zastosować tego ustawienia w przypadku każdej sieci reklamowej w łańcuchu zapośredniczenia. Dlatego musisz wskazać w łańcuchu zapośredniczenia wszystkie sieci reklamowe, które mogą uczestniczyć w sprzedaży danych osobowych, i stosować się do wskazówek tych sieci, aby zapewnić zgodność.

W wersji pakietu SDK 8.2.0 firma Chartboost dodała metodę addDataUseConsent. Podany niżej przykładowy kod ustawia zgodę na wykorzystanie danych na CHBCCPAConsentOptInSale. Jeśli zdecydujesz się wywołać tę metodę, zalecamy, aby zrobić to przed wysłaniem żądania reklamy za pomocą pakietu SDK do reklam mobilnych Google.

Swift

let dataUseConsent = CHBDataUseConsent.CCPA(CHBDataUseConsent.CCPA.Consent.optInSale)
Chartboost.addDataUseConsent(dataUseConsent)

Objective-C

CHBCCPADataUseConsent *dataUseConsent = [CHBCCPADataUseConsent ccpaConsent:CHBCCPAConsentOptInSale];
[Chartboost addDataUseConsent:dataUseConsent];

Więcej informacji oraz wartości, które można podać w ramach poszczególnych metod, znajdziesz w artykule na temat CCPA i Metody ochrony prywatności na iOS firmy Chartboost.

Kody błędów

Jeśli adapter nie otrzyma reklamy z Chartboost, możesz sprawdzić błąd podstawowy w odpowiedzi reklamy, używając GADResponseInfo.adNetworkInfoArray w ramach tych klas:

GADMAdapterChartboost
GADMediationAdapterChartboost

Oto kody i odpowiednie komunikaty z adaptera Chartboost, które pojawiają się, gdy nie udaje się załadować reklamy:

Kod błędu	Przyczyna
101	Parametry serwera Chartboost skonfigurowane w interfejsie Ad Managera są nieprawidłowe lub ich brakuje.
102	Pakiet SDK Chartboost zwrócił błąd inicjalizacji.
103	Reklama Chartboost nie jest zapisywana w pamięci podręcznej w momencie wyświetlania.
104	Żądany rozmiar reklamy nie odpowiada obsługiwanemu rozmiarowi banera w usłudze Chartboost.
105	Wersja systemu operacyjnego urządzenia jest starsza niż minimalna obsługiwana wersja pakietu SDK Chartboost.
200-299	Błędy pamięci podręcznej pakietu SDK Chartboost. Więcej informacji znajdziesz w kodu.
300-399	Błędy pakietu SDK Chartboost. Więcej informacji znajdziesz w kodu.
400-499	Błędy kliknięć związane z pakietem SDK Chartboost. Więcej informacji znajdziesz w kodu.

Historia zmian adaptera do zapośredniczenia reklam Chartboost na iOS

Wersja 9.8.0.0

Weryfikowana zgodność z pakietem SDK Chartboost w wersji 9.8.0.

Został opracowany i przetestowany z użyciem:

Pakiet SDK do reklam mobilnych Google w wersji 11.11.0.
Wersja pakietu SDK Chartboost 9.8.0.

Wersja 9.7.0.1

Zaktualizowaliśmy komponent CFBundleShortVersionString, tak aby zawierał 3 elementy zamiast 4.

Został opracowany i przetestowany z użyciem:

Pakiet SDK do reklam mobilnych Google w wersji 11.10.0.
Wersja pakietu SDK Chartboost 9.7.0.

Wersja 9.7.0.0

Weryfikowana zgodność z pakietem SDK Chartboost w wersji 9.7.0.

Został opracowany i przetestowany z użyciem:

Pakiet SDK do reklam mobilnych Google w wersji 11.2.0.
Wersja pakietu SDK Chartboost 9.7.0.

Wersja 9.6.0.1

Teraz wymagana jest co najmniej wersja 12.0 systemu iOS.
Wymaga teraz pakietu SDK do reklam mobilnych Google w wersji 11.0 lub nowszej.
Uwzględnij Info.plist w ramach ramowych ChartboostAdapter.xcframework.

Został opracowany i przetestowany z użyciem:

Pakiet SDK do reklam mobilnych Google w wersji 11.0.1.
Wersja pakietu SDK Chartboost 9.6.0.

Wersja 9.6.0.0

Weryfikowana zgodność z pakietem SDK Chartboost w wersji 9.6.0.
Wycofana metoda GADMobileAds.sharedInstance.sdkVersion została zastąpiona metodą GADMobileAds.sharedInstance.versionNumber.
Dodano implementację GADMediationInterstitialAd.

Został opracowany i przetestowany z użyciem:

Pakiet SDK do reklam mobilnych Google w wersji 10.14.0.
Wersja pakietu SDK Chartboost 9.6.0.

Wersja 9.5.1.0

Weryfikowana zgodność z pakietem SDK Chartboost w wersji 9.5.1.

Został opracowany i przetestowany z użyciem:

Pakiet SDK do reklam mobilnych Google w wersji 10.12.0.
Wersja pakietu SDK Chartboost 9.5.1.

Wersja 9.4.0.0

Weryfikowana zgodność z pakietem SDK Chartboost w wersji 9.4.0.

Został opracowany i przetestowany z użyciem:

Pakiet SDK do reklam mobilnych Google w wersji 10.7.0.
Wersja pakietu SDK Chartboost 9.4.0.

Wersja 9.3.1.0

Weryfikowana zgodność z pakietem SDK Chartboost w wersji 9.3.1.

Został opracowany i przetestowany z użyciem:

Pakiet SDK do reklam mobilnych Google w wersji 10.7.0.
Wersja pakietu SDK Chartboost 9.3.1.

Wersja 9.3.0.0

Weryfikowana zgodność z pakietem SDK Chartboost w wersji 9.3.0.
Teraz wymaga minimalnej wersji iOS 11.0.
Wymaga teraz pakietu SDK do reklam mobilnych Google w wersji 10.4.0 lub nowszej.

Został opracowany i przetestowany z użyciem:

Pakiet SDK do reklam mobilnych Google w wersji 10.4.0.
Wersja pakietu SDK Chartboost 9.3.0.

Wersja 9.2.0.0

Usunięto import GADMChartboostExtras w pliku nagłówka ChartboostAdapter.
Weryfikowana zgodność z pakietem SDK Chartboost w wersji 9.2.0.
Wymaga teraz pakietu SDK do reklam mobilnych Google w wersji 10.0.0 lub nowszej.
Usunięto obsługę architektury armv7.
Wymaga teraz co najmniej iOS 11.0.

Został opracowany i przetestowany z użyciem:

Pakiet SDK do reklam mobilnych Google w wersji 10.0.0.
Wersja pakietu SDK Chartboost 9.2.0.

Wersja 9.1.0.0

Weryfikowana zgodność z pakietem SDK Chartboost w wersji 9.1.0.

Został opracowany i przetestowany z użyciem:

Pakiet SDK do reklam mobilnych Google w wersji 9.11.0.
Wersja pakietu SDK Chartboost 9.1.0.

Wersja 9.0.0.0

Weryfikowana zgodność z pakietem SDK Chartboost w wersji 9.0.0.
Wersja zweryfikowana pod kątem zgodności z pakietem SDK do reklam mobilnych Google w wersji 9.10.0.
Zaktualizowano adapter, aby korzystał z interfejsu didRewardUser API.
Wymaga teraz pakietu SDK do reklam mobilnych Google w wersji 9.8.0 lub nowszej.

Został opracowany i przetestowany z użyciem:

Pakiet SDK do reklam mobilnych Google w wersji 9.10.0.
Wersja pakietu SDK Chartboost 9.0.0.

Wersja 8.5.0.2

Wersja zweryfikowana pod kątem zgodności 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.

Został opracowany i przetestowany z użyciem:

Pakiet SDK do reklam mobilnych Google w wersji 9.0.0.
Wersja pakietu SDK Chartboost: 8.5.0.