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 pakietu Verve HyBid SDK z zapośredniczeniem

Wybierz platformę: Android iOS Android (starsza wersja)

Z tego przewodnika dowiesz się, jak za pomocą GMA Next-Gen SDK wczytywać i wyświetlać reklamy z pakietu Verve HyBid SDK przy użyciu mediacji, która obejmuje integracje z licytowaniem. Wyjaśniamy w nim, jak dodać pakiet Verve HyBid SDK do konfiguracji mediacji jednostki reklamowej oraz jak zintegrować pakiet Verve HyBid SDK i adapter z aplikacją na Androida.

Obsługiwane integracje i formaty reklam

Adapter zapośredniczeń dla pakietu Verve HyBid SDK ma te możliwości:

Integracja
Określanie stawek	¹
Kaskada
Formaty
Baner
Pełnoekranowa
Reklama pełnoekranowa z nagrodą
Z nagrodą
Natywna

¹ Integracja określania stawek jest w wersji alfa. Skontaktuj się z opiekunem klienta, aby poprosić o dostęp.

Wymagania wstępne

Zanim przejdziesz dalej, sprawdź te informacje:

Android w wersji API 24 lub nowszej.

Najnowsza wersja GMA Next-Gen SDK.
Skonfiguruj zapośredniczenie.

Krok 1. Skonfiguruj ustawienia w interfejsie pakietu Verve HyBid SDK

Aby skonfigurować to ustawienie, skontaktuj się z Verve.

Krok 2. Skonfiguruj popyt z pakietu Verve HyBid SDK 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 bezpiecznych sygnałów w pytaniach o stawkę

Kliknij kolejno Zasoby reklamowe i Bezpieczne sygnały. W sekcji Bezpieczne sygnały wyszukaj Verve HyBid SDK i włącz opcję Włącz integrację z aplikacją.

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 licytowania w SDK.

Kliknij Zapisz.

Konfigurowanie określania stawek przez pakiet Verve HyBid SDK

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

Kliknij Nowy licytujący.

Jako oferenta wybierz Verve Group.

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ę dla pakietu Verve HyBid 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 identyfikator strefy i token aplikacji uzyskane w poprzedniej sekcji.

Jeśli konfigurujesz mapowanie jednostek reklamowych na potrzeby reklamy pełnoekranowej z nagrodą w interfejsie Ad Managera, wybierz format Z nagrodą i użyj identyfikatora miejsca docelowego reklamy pełnoekranowej z nagrodą.

Na koniec kliknij Zapisz.

Dodawanie Verve Group do listy partnerów reklamowych zachowujących zgodność z RODO i amerykańskimi przepisami stanowymi

Aby dodać Verve Group do listy partnerów reklamowych zachowujących zgodność z rozporządzeniami europejskimi i amerykańskimi przepisami stanowymi dotyczącymi prywatności w interfejsie Ad Managera, wykonaj czynności opisane w sekcjach Ustawienia rozporządzeń europejskich i Ustawienia amerykańskich przepisów stanowych dotyczących prywatności.

Krok 3. Zaimportuj pakiet SDK i adapter Verve HyBid

Integracja z Androidem Studio (zalecana)

W pliku settings.gradle.kts na poziomie projektu dodaj te repozytoria:

dependencyResolutionManagement {
  repositories {
    google()
    mavenCentral()
    maven {
      url = uri("https://verve.jfrog.io/artifactory/verve-gradle-release")
    }
  }
}

Następnie w pliku build.gradle.kts na poziomie aplikacji dodaj te zależności i konfiguracje implementacji: Korzystaj z najnowszych wersji pakietu SDK i adaptera Verve HyBid:

dependencies {
    implementation("com.google.android.libraries.ads.mobile.sdk:ads-mobile-sdk:1.4.0")
    implementation("com.google.ads.mediation:verve:3.9.2.0")
}

configurations {
    all {
        exclude(group = "com.google.android.gms", module = "play-services-ads")
        exclude(group = "com.google.android.gms", module = "play-services-ads-lite")
    }
}

Krok 4. Wdróż ustawienia prywatności w pakiecie Verve 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 uzyskiwać ich zgodę na stosowanie plików cookie lub innych środków do lokalnego przechowywania danych, jeśli jest to wymagane przez prawo, a także na zbieranie, udostępnianie i wykorzystywanie danych osobowych na potrzeby 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.

Pakiet Verve HyBid SDK automatycznie odczytuje zgodę na wykorzystanie danych zgodnie z RODO ustawioną przez platformy do zarządzania zgodą użytkowników, w tym pakiet SDK UMP. Więcej informacji znajdziesz w artykule Zgodność z zasadami TCF w ramach RODO.

Amerykańskie przepisy stanowe o ochronie prywatności

Przepisy stanowe w USA dotyczące ochrony prywatności wymagają, aby użytkownicy mieli prawo wycofać zgodę na „sprzedaż” „danych osobowych” (w znaczeniu określonym w ustawie). Wycofanie zgody musi być możliwe za pomocą dobrze widocznego linku „Do Not Sell My Personal Information” („Nie sprzedawaj moich danych osobowych”) na stronie głównej podmiotu „sprzedającego”. 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 wskazać każdą sieć reklamową w łańcuchu zapośredniczenia, która może uczestniczyć w sprzedaży danych osobowych, i postępować zgodnie z wytycznymi każdej z tych sieci, aby zapewnić zgodność z przepisami.

Pakiet SDK Verve HyBid obsługuje ustawienia prywatności za pomocą metody. Poniższy przykładowy kod przekazuje te informacje o uzyskanej zgodzie do pakietu Verve HyBid SDK. Jeśli ręcznie przekazujesz do pakietu Verve HyBid SDK informacje o uzyskanej zgodzie użytkownika, zalecamy wywołanie przykładu przed wysłaniem żądania reklam za pomocą GMA Next-Gen SDK.

Java

HyBid.getUserDataManager().setIABUSPrivacyString(US_PRIVACY_STRING);VerveMediationSnippets.java

Kotlin

HyBid.getUserDataManager().setIABUSPrivacyString(US_PRIVACY_STRING)VerveMediationSnippets.kt

Zastąp US_PRIVACY_STRING ciągiem znaków dotyczącym prywatności w Stanach Zjednoczonych.

Szczegółowe informacje znajdziesz w dokumentacji dotyczącej prywatności pakietu SDK Verve HyBid w sekcji Zgodność z CCPA.

Krok 5. Dodaj wymagany kod

Integracja pakietu Verve HyBid SDK nie wymaga dodatkowego kodu.

Krok 6. Przetestuj implementację

Włączanie reklam testowych

Upewnij się, że zarejestrowano urządzenie testowe w Ad Managerze.

Weryfikowanie reklam testowych

Aby sprawdzić, czy otrzymujesz reklamy testowe z pakietu Verve HyBid SDK, włącz w inspektorze reklam testowanie pojedynczego źródła reklam, korzystając ze źródeł reklam Verve (licytowanie).

Dodatkowe informacje o konfiguracji znajdziesz w dokumentacji pakietu Verve HyBid SDK.

Kody błędów

Jeśli adapter nie otrzyma reklamy z pakietu Verve HyBid SDK, wydawcy mogą sprawdzić podstawowy błąd w odpowiedzi na żądanie reklamy, korzystając z tych klas:ResponseInfo.getAdSourceResponses()

net.pubnative.lite.sdk
com.google.ads.mediation.verve

Oto kody i komunikaty wyświetlane przez adapter pakietu SDK Verve HyBid, gdy nie uda się wczytać reklamy:

Kod błędu	Domena	Przyczyna
101	Żądany rozmiar reklamy nie pasuje do rozmiaru banera obsługiwanego przez pakiet Verve HyBid SDK.
102	net.pubnative.lite.sdk	Błąd Verve HyBid – nie udało się załadować reklamy.
103	com.google.ads.mediation.verve	Próba wyświetlenia reklamy pełnoekranowej o wartości null.
104	com.google.ads.mediation.verve	MobileAds.getRequestConfiguration() wskazuje, że użytkownik jest dzieckiem. Verve zostanie wycofana.