Integracja pakietu Verve HyBid SDK z zapośredniczeniem

Z tego przewodnika dowiesz się, jak używać pakietu GMA Next-Gen SDK do wczytywania i wyświetlania reklam displayowych z pakietu SDK Verve HyBid za pomocą Zapośredniczenia AdMob, które obejmuje integracje z określaniem stawek. Dowiesz się z niego, jak dodać pakiet SDK Verve HyBid do konfiguracji zapośredniczenia jednostki reklamowej oraz jak zintegrować pakiet SDK i adapter Verve HyBid z aplikacją na Androida.

Obsługiwane integracje i formaty reklam

Adapter zapośredniczenia do pakietu SDK Verve HyBid ma te możliwości:

¹ Integracja określania stawek jest w wersji alfa. Aby poprosić o dostęp, skontaktuj się z menedżerem konta.

Wymagania wstępne

Zanim przejdziesz dalej, sprawdź te kwestie:

• Android API na poziomie 24 lub wyższym.

• Najnowsza wersja GMA Next-Gen SDK.

• Skonfiguruj zapośredniczenie AdMob.

Krok 1. Skonfiguruj ustawienia w interfejsie pakietu SDK Verve HyBid

Aby skonfigurować ustawienia, skontaktuj się z firmą Verve.

Krok 2. Skonfiguruj żądania pakietu SDK Verve HyBid w interfejsie AdMob

Konfigurowanie ustawień zapośredniczenia dla jednostki reklamowej

Musisz dodać pakiet SDK Verve HyBid do konfiguracji zapośredniczenia 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 Verve HyBid jako źródła reklam.

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

Wpisz format reklamy i platformę, a następnie 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.

Powinna się teraz wyświetlić karta jednostek reklamowych z wybranymi przez Ciebie jednostkami:

Dodawanie pakietu SDK Verve HyBid jako źródła reklam

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

Wykonaj czynności opisane w artykułach Ustawienia dotyczące rozporządzeń europejskich i Ustawienia dotyczące amerykańskich przepisów stanowych, aby dodać Verve Group do listy partnerów reklamowych w interfejsie AdMob, którzy przestrzegają rozporządzeń europejskich i amerykańskich przepisów stanowych.

Krok 3. Zaimportuj pakiet SDK i adapter Verve HyBid

Integracja z Android 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. Używaj najnowszych wersji pakietu SDK i adaptera Verve HyBid:

dependencies {
    implementation("com.google.android.libraries.ads.mobile.sdk:ads-mobile-sdk:1.5.0")
    implementation("com.google.ads.mediation:verve:3.9.3.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. Skonfiguruj ustawienia prywatności w pakiecie SDK Verve

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.

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

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

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

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

Zastąp US_PRIVACY_STRING ciągiem tekstowym dotyczącym ochrony prywatności w USA.

Szczegółowe informacje znajdziesz w dokumentacji dotyczącej prywatności pakietu SDK Verve HyBid w sekcji poświęconej zgodności z ustawą CCPA.

Krok 5. Dodaj wymagany kod

Integracja pakietu Verve HyBid SDK nie wymaga dodatkowego kodu.

Krok 6. 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 Verve HyBid, włącz w inspektorze reklam testowanie pojedynczego źródła reklam, korzystając ze źródeł reklam Verve (określanie stawek).

Aby dowiedzieć się, jak przeprowadzić dodatkową konfigurację, zapoznaj się z  dokumentacją pakietu SDK Verve HyBid.

Kody błędów

Jeśli adapter nie otrzyma reklamy z pakietu Verve HyBid SDK, wydawcy mogą sprawdzić błąd w odpowiedzi na reklamę, używając metody ResponseInfo.getAdSourceResponses() w tych klasach:

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

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

Historia zmian adaptera zapośredniczenia Verve na Androida

Wersja 3.9.3.0

• Zweryfikowano zgodność z pakietem SDK Verve HyBid w wersji 3.9.3.

Zbudowano i przetestowano z:

• Pakiet SDK do reklam mobilnych Google w wersji 25.5.0.
• Pakiet SDK do wyświetlania reklam mobilnych Google nowej generacji w wersji 1.5.0.
• Pakiet SDK Verve HyBid w wersji 3.9.3.

Wersja 3.9.2.0

• Przypnij zależność adaptera od Kotlina do wersji 1.9.0 (minimalnej wersji Kotlina obsługiwanej przez pakiet GMA NextGen SDK).
• Zweryfikowana zgodność z pakietem SDK Verve HyBid w wersji 3.9.2.

Zbudowano i przetestowano z:

• Pakiet SDK do reklam mobilnych Google w wersji 25.4.0.
• Pakiet SDK do wyświetlania reklam mobilnych Google nowej generacji w wersji 1.4.0.
• Pakiet SDK Verve HyBid w wersji 3.9.2.

Wersja 3.9.1.0

• Zweryfikowana zgodność z pakietem SDK Verve HyBid w wersji 3.9.1.

Zbudowano i przetestowano z:

• Pakiet SDK do reklam mobilnych Google w wersji 25.4.0.
• Pakiet SDK do wyświetlania reklam mobilnych Google nowej generacji w wersji 1.3.1.
• Pakiet SDK Verve HyBid w wersji 3.9.1.

Wersja 3.9.0.0

• Filtruj żądania z ograniczeniem wiekowym w przypadku pakietu SDK Verve, gdy parametr AgeRestrictedTreatment ma wartość CHILD.
• Zweryfikowana zgodność z pakietem SDK Verve HyBid w wersji 3.9.0.

Zbudowano i przetestowano z:

• Pakiet SDK do reklam mobilnych Google w wersji 25.4.0.
• Pakiet SDK do wyświetlania reklam mobilnych Google nowej generacji w wersji 1.2.1.
• Pakiet SDK Verve HyBid w wersji 3.9.0.

Wersja 3.8.2.0

• Zweryfikowana zgodność z pakietem SDK Verve HyBid w wersji 3.8.2.

Zbudowano i przetestowano z:

• Pakiet SDK do reklam mobilnych Google w wersji 25.3.0.
• Pakiet SDK do wyświetlania reklam mobilnych Google nowej generacji w wersji 1.2.1.
• Pakiet SDK Verve HyBid w wersji 3.8.2.

Wersja 3.8.1.1

• Filtrowanie widoków, które można kliknąć, aby odróżnić kliknięcie informacji o treści od zwykłego kliknięcia reklamy w przypadku VerveNativeAd.

Zbudowano i przetestowano z:

• Pakiet SDK do reklam mobilnych Google w wersji 25.2.0.
• Pakiet SDK do wyświetlania reklam mobilnych Google nowej generacji w wersji 1.0.1.
• Pakiet SDK Verve HyBid w wersji 3.8.1.

Wersja 3.8.1.0

• Dodano właściwość umożliwiającą utworzenie adaptera z zależnością od pakietu SDK nowej generacji do reklam mobilnych Google.
• Zweryfikowana zgodność z pakietem SDK Verve HyBid w wersji 3.8.1.

Zbudowano i przetestowano z:

• Pakiet SDK do reklam mobilnych Google w wersji 25.1.0.
• Pakiet SDK Verve HyBid w wersji 3.8.1.

Wersja 3.7.1.1

• Usunęliśmy z adaptera Verve sprawdzanie rozmiaru banera, aby rozwiązać problemy z gromadzeniem sygnałów.

Zbudowano i przetestowano z:

• Pakiet SDK do reklam mobilnych Google w wersji 25.0.0.
• Pakiet SDK Verve HyBid w wersji 3.7.1.

Wersja 3.7.1.0

• Pierwsza wersja.
• Zweryfikowana zgodność z pakietem SDK Verve HyBid w wersji 3.7.1.

Zbudowano i przetestowano z:

• Pakiet SDK do reklam mobilnych Google w wersji 24.8.0.
• Pakiet SDK Verve HyBid w wersji 3.7.1.