Integracja Yahoo z zapośredniczeniem

Z tego przewodnika dowiesz się, jak używać pakietu SDK do reklam mobilnych Google do wczytywania i wyświetlania reklam z Yahoo za pomocą zapośredniczenia w ramach integracji kaskadowej. Opisano w nim, jak dodać Yahoo do konfiguracji zapośredniczenia jednostki reklamowej oraz jak zintegrować pakiet SDK i adapter Yahoo Mobile z aplikacjąAndroid .

Obsługiwane integracje i formaty reklam

Adapter zapośredniczenia AdMob w Yahoo:

Integracja
Ustalanie stawek
Wodospad
Formaty
Baner
Pełnoekranowa
Otrzymano
Natywna

Wymagania

  • Interfejs API Androida na poziomie 19 lub wyższym

  • Najnowszy pakiet SDK do reklam mobilnych Google

  • Skorzystaj z zapośredniczenia Wprowadzenie

Krok 1. Skonfiguruj konfiguracje w interfejsie Yahoo

Zaloguj się na platformie SSP Yahoo. W sekcji Aplikacje i witryny kliknij przycisk +, a następnie Aplikacja.

Wypełnij formularz i kliknij Save and Add Placement (Zapisz i dodaj miejsce docelowe), aby utworzyć aplikację.

Po utworzeniu aplikacji musisz utworzyć miejsce docelowe. Wybierz Typ miejsca docelowego, wypełnij formularz i kliknij Zapisz i zarabiaj.

Zanotuj swój identyfikator miejsca docelowego.

Musisz dodać do miejsca docelowego źródło reklamy. W kolejnym formularzu wybierz Yahoo SSP jako źródło reklamy i wypełnij formularz wymaganymi informacjami. Po wypełnieniu formularza kliknij Zapisz.

Na koniec przeciągnij utworzone przed chwilą Źródło reklamy do tabeli Kaskadowe źródła reklam, aby dodać je do miejsca docelowego.

Zapisz identyfikator witryny.

Włącz tryb testowy

Aby przetestować reklamy Yahoo, możesz utworzyć testowe źródło reklam i dodać je do kaskadowych źródeł reklam miejsca docelowego. Otwórz ustawienia identyfikatora miejsca docelowego, kliknij przycisk Dodaj i wybierz Przetestuj źródło reklamy.

Po utworzeniu źródła reklamy przeciągnij je do sekcji Kaskadowe źródła reklam miejsca docelowego.

Znakomicie. Masz już działającą integrację zapośredniczenia z Yahoo.

Krok 2. Skonfiguruj oferty reklamowe Yahoo w AdMob interfejsie

Konfigurowanie ustawień zapośredniczenia dla jednostki reklamowej

Musisz dodać Yahoo 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 Yahoo 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 Yahoo jako źródło reklam

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

Kliknij Yahoo . Następnie wpisz wartość eCPM dla Yahoo i kliknij Dalej.

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

Następnie wpisz dane Placement ID and Site IDotrzymane w poprzedniej sekcji. Następnie kliknij Gotowe.

Dodaj Yahoo do listy partnerów reklamowych zgodnych z RODO i amerykańskimi przepisami stanowymi

Wykonaj czynności opisane w sekcji Ustawienia RODO i Ustawienia amerykańskich przepisów stanowych , aby dodać Yahoo do listy partnerów reklamowych zgodnych z RODO i amerykańskimi przepisami stanowymi w AdMob UI.

Krok 3. Zaimportuj pakiet SDK Yahoo Mobile i adapter

Dodaj podane niżej zależności implementacji w najnowszych wersjach pakietu SDK Yahoo Ads i adaptera w pliku build.gradle na poziomie aplikacji:

repositories {
    google()
    mavenCentral()
    maven {
      url 'https://artifactory.yahooinc.com/artifactory/maven/'
    }
}

...
dependencies {
    implementation 'androidx.appcompat:appcompat:1.2.0'
    implementation 'com.google.android.gms:play-services-ads:22.6.0'
    implementation 'com.google.ads.mediation:yahoo:1.4.1.1'
}
...

Integracja ręczna

Krok 4. Zaimplementuj ustawienia prywatności w pakiecie Yahoo SDK

Amerykańskie przepisy stanowe o ochronie prywatności

Amerykańskie przepisy stanowe o ochronie prywatności wymagają przyznania użytkownikom prawa do wycofania zgody na „sprzedaż” „danych osobowych” (w znaczeniu określonym w ustawie), przy czym opcja ta jest dostępna za pomocą dobrze widocznego linku „Do Not Sell My Personal Information” („Nie sprzedawaj moich danych osobowych”) na stronie głównej sprzedającego. Przewodnik dotyczący 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 żadnej sieci reklamowej w łańcuchu zapośredniczenia. Dlatego musisz wskazać wszystkie sieci reklamowe w łańcuchu zapośredniczenia, które mogą uczestniczyć w sprzedaży danych osobowych, i stosować się do wskazówek tych sieci, aby zapewnić zgodność z zasadami.

Poniższy przykładowy kod pokazuje, jak przekazywać informacje o zgodzie do pakietu SDK Yahoo Mobile. Jeśli chcesz wywoływać tę metodę, rób to przed wysłaniem żądań reklam za pomocą pakietu SDK do reklam mobilnych Google.

Java

import com.yahoo.ads.YASAds;
import com.yahoo.ads.CcpaConsent;

// ...
CcpaConsent ccpaConsent = new CcpaConsent("<CCPA CONSENT>");
YASAds.addConsent(ccpaConsent);

Kotlin

import com.yahoo.ads.YASAds
import com.yahoo.ads.CcpaConsent

// ...
val ccpaConsent = CcpaConsent("<CCPA CONSENT>")
YASAds.addConsent(ccpaConsent)

Więcej informacji i wartości, które można podać w tej metodzie, znajdziesz w artykule Publisher Privacy Settings (Ustawienia prywatności wydawcy).

Krok 5. Dodaj wymagany kod

Integracja z Yahoo nie wymaga dodatkowego kodu.

Krok 6. Przetestuj implementację

Włącz reklamy testowe

Zarejestruj urządzenie testowe na potrzeby AdMob i włącz tryb testowy w Yahoo interfejsie użytkownika.

Weryfikacja reklam testowych

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

Kroki opcjonalne:

Korzystanie z reklam natywnych

Renderowanie reklam

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

Pole Wypełnianie przez adapter Yahoo
Nagłówek
Obraz
Treść
Ikona aplikacji
Wezwanie do działania
Nazwa reklamodawcy
Ocena w gwiazdkach
Sklep
Cena

Historia zmian adaptera zapośredniczenia w Yahoo Android

Następna wersja

  • Zaktualizowano minimalną wersję pakietu SDK do reklam mobilnych Google do wersji 22.4.0.

Wersja 1.4.1.1

  • Zaktualizowano adapter, aby używać nowej klasy VersionInfo.
  • Zaktualizowano minimalną wersję pakietu SDK do reklam mobilnych Google do wersji 22.0.0.

Stworzone i przetestowane w:

  • Pakiet SDK do reklam mobilnych Google w wersji 22.0.0.
  • Yahoo! Mobile SDK 1.4.1

Wersja 1.4.1.0

  • Zmiana nazwy adaptera Verizon Media na „Yahoo”.
  • Dodaliśmy opisowe kody błędów oraz przyczyny ładowania adaptera i błędów wyświetlania.
  • Zweryfikowana zgodność z pakietem SDK Yahoo Mobile w wersji 1.4.1
  • Zaktualizowano minimalną wersję pakietu SDK do reklam mobilnych Google do wersji 21.5.0.

Stworzone i przetestowane w:

  • Pakiet SDK do reklam mobilnych Google w wersji 21.5.0.
  • Yahoo! Mobile SDK 1.4.1