Integracja pakietu Verve HyBid SDK z zapośredniczeniem

Z tego przewodnika dowiesz się, jak używać GMA Next-Gen SDK, aby wczytywać i wyświetlać reklamy displayowe z pakietu Verve HyBid SDK za pomocą zapośredniczenia obejmującego integracje z określaniem stawek. Dowiesz się, jak dodać pakiet Verve HyBid SDK do konfiguracji zapośredniczenia jednostki reklamowej oraz jak zintegrować pakiet Verve HyBid SDK i adapter z aplikacją na Androida.

Obsługiwane integracje i formaty reklam

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

¹ Integracja z określeniem 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 w wersji 24 lub nowszej.

• Najnowsza wersja GMA Next-Gen SDK.

• Skonfiguruj zapośredniczenie.

Krok 1. Skonfiguruj ustawienia w interfejsie pakietu Verve HyBid SDK

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

Krok 2. Skonfiguruj popyt z pakietu Verve HyBid SDK w interfejsie Ad Managera

Zaloguj się na konto Ad Managera.

Włącz udostępnianie bezpiecznych sygnałów

Kliknij kolejno Administracja > Ustawienia globalne. Otwórz kartę Ustawienia konta Ad Exchange i sprawdź, czy opcja Udostępnianie bezpiecznych sygnałów jest włączona. Kliknij Zapisz.

Udostępnij bezpieczny sygnał w pytaniach o stawkę

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

Kliknij Zapisz.

Zezwól na udostępnianie bezpiecznych sygnałów w przypadku określania stawek przez pakiet SDK

Kliknij kolejno Wyświetlanie > Ustawienia na potrzeby kanałów popytu. Na karcie Ustawienia domyślne włącz opcję Zezwalaj na udostępnianie bezpiecznych sygnałów w przypadku określania stawek przez pakiet SDK.

Kliknij Zapisz.

Skonfiguruj określanie stawek przez pakiet Verve HyBid SDK

Kliknij kolejno Wyświetlanie > Licytujący, a następnie Otwórz określanie stawek przez pakiet SDK.

Kliknij Nowy licytujący.

Jako licytującego wybierz Verve Group.

Kliknij Dalej , aby włączyć określanie stawek przez pakiet SDK w przypadku tego licytującego.

Kliknij Gotowe.

Skonfiguruj mapowanie jednostek reklamowych

Kliknij kolejno Wyświetlanie > Licytujący, a następnie 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 Określona jednostka reklamowa. Wybierz jednostkę reklamową i format, Aplikacja mobilna jako Typ zasobów reklamowych, a następnie wybierz Aplikacja mobilna. Następnie wpisz Identyfikator strefy i AppToken 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.

Dodaj 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 przepisami stanowymi w USA w interfejsie Ad Managera, wykonaj czynności opisane w artykułach Ustawienia dotyczące rozporządzeń europejskich i Ustawienia dotyczące przepisów stanowych w USA.

Krok 3. Zaimportuj pakiet Verve HyBid SDK i adapter

Integracja z Androidem Studio (zalecane)

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 Verve HyBid SDK i adaptera:

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. 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, 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 gromadzenie, 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ą , w tym pakiet SDK UMP. Więcej informacji znajdziesz w artykule Zgodność z RODO i TCF.

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" swoich "danych osobowych" (w znaczeniu określonym w ustawie) . Rezygnacja musi być możliwa za pomocą dobrze widocznego linku "Do Not Sell My Personal Information" ("Proszę nie sprzedawać moich danych osobowych") na stronie głównej "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 z wytycznymi każdej z tych sieci, aby zapewnić zgodność.

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

Więcej informacji znajdziesz w dokumentacji pakietu Verve HyBid SDK dotyczącej prywatności na temat zgodności z ustawą CCPA.

Krok 5. Dodaj wymagany kod

Integracja z pakietem Verve HyBid SDK nie wymaga dodatkowego kodu.

Krok 6. Przetestuj implementację

Włącz reklamy testowe

Zarejestruj urządzenie testowe w usłudze Ad Manager.

Sprawdź reklamy testowe

Aby sprawdzić, czy otrzymujesz reklamy testowe z pakietu Verve HyBid SDK, włącz testowanie pojedynczych źródeł reklam w inspektorze reklam, używając źródeł reklam Verve (określanie stawek).

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 reklamę za pomocą ResponseInfo.getAdSourceResponses() w tych klasach:

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

Oto kody i towarzyszące im komunikaty zwracane przez adapter pakietu Verve HyBid SDK, gdy nie uda się wczytać reklamy:

Dziennik zmian adaptera zapośredniczenia Verve na Androida

Wersja 3.9.3.0 (w toku)

Wersja 3.9.2.0

• Przypnij zależność adaptera od Kotlina do wersji 1.9.0 (minimalna wersja Kotlina obsługiwana przez pakiet SDK nowej generacji do reklam mobilnych Google).
• Sprawdzono zgodność z pakietem Verve HyBid SDK w wersji 3.9.2.

Kompilacja i testowanie:

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

Wersja 3.9.1.0

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

Kompilacja i testowanie:

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

Wersja 3.9.0.0

• Filtruj żądania ograniczone wiekiem w przypadku pakietu Verve SDK, gdy nowe ustawienie AgeRestrictedTreatment ma wartość CHILD.
• Sprawdzono zgodność z pakietem Verve HyBid SDK w wersji 3.9.0.

Kompilacja i testowanie:

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

Wersja 3.8.2.0

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

Kompilacja i testowanie:

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

Wersja 3.8.1.1

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

Kompilacja i testowanie:

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

Wersja 3.8.1.0

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

Kompilacja i testowanie:

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

Wersja 3.7.1.1

• Usunięto sprawdzanie rozmiaru banera z adaptera Verve, aby rozwiązać problemy z gromadzeniem sygnałów.

Kompilacja i testowanie:

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

Wersja 3.7.1.0

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

Kompilacja i testowanie:

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