Dokumentation

Prebid Mobile SDK in Apps: Unterschied zwischen den Versionen

← Zum vorherigen Versionsunterschied
 
(13 dazwischenliegende Versionen desselben Benutzers werden nicht angezeigt)
Zeile 4: Zeile 4:
Hinweis: Die Einbauanleitung benutzt als Codebeispiele Schnipsel für Android und geht davon aus, dass das Google Mobile Ads SDK bereits in der App integriert ist.
Hinweis: Die Einbauanleitung benutzt als Codebeispiele Schnipsel für Android und geht davon aus, dass das Google Mobile Ads SDK bereits in der App integriert ist.
Grundsätzliche Dokumentation von Prebid Mobile befindet sich hier:
Grundsätzliche Dokumentation von Prebid Mobile befindet sich hier:
iOS: https://docs.prebid.org/prebid-mobile/pbm-api/ios/code-integration-ios.html
*Generelle Übersicht: https://docs.prebid.org/prebid-mobile/prebid-mobile.html
Android: https://docs.prebid.org/prebid-mobile/pbm-api/android/code-integration-android.html
*iOS: https://docs.prebid.org/prebid-mobile/pbm-api/ios/code-integration-ios.html
*Android: https://docs.prebid.org/prebid-mobile/pbm-api/android/code-integration-android.html
 
===Benötigte Dokumente===
*diese Dokumentation
*Excel Sheet mit Account ID und Config IDs für jedes iqadtile


==Schritt 1 - Prebid Mobile SDK einbinden==
==Schritt 1 - Prebid Mobile SDK einbinden==
iOS: https://github.com/prebid/prebid-mobile-ios
*iOS: https://github.com/prebid/prebid-mobile-ios
Android: https://github.com/prebid/prebid-mobile-android
*Android: https://github.com/prebid/prebid-mobile-android


==Schritt 2 - initiale globale Konfiguration==
==Schritt 2 - initiale globale Konfiguration==
Zu Beginn muss den Endpoint und die Account ID im SDK gesetzt werden und in eine initialisierungs Methode gepackt werden
Zu Beginn muss den Endpoint und die Account ID im SDK gesetzt werden und in eine initialisierungs Methode gepackt werden


*Prebid Server Account Id: '''<<<PREBID_SERVER_ACCOUNT_ID>>>'''
*Prebid Server Account Id: '''<<<PREBID_SERVER_ACCOUNT_ID>>>''', die ID ist für jede App anders, gilt innerhalb der App aber für alle Platzierungen gleich. Die ID kann aus dem Excel-Sheet entnommen werden.
*Prebid Server Url: '''https://client-pbs.relevant-digital.com/openrtb2/auction'''
*Prebid Server Url: '''https://iqdigital-pbs.relevant-digital.com/openrtb2/auction'''


===Beispiel===
===Beispiel===
Zeile 21: Zeile 26:
PrebidMobile.setPrebidServerAccountId("<<<PREBID_SERVER_ACCOUNT_ID>>>")  
PrebidMobile.setPrebidServerAccountId("<<<PREBID_SERVER_ACCOUNT_ID>>>")  


PrebidMobile.setCustomStatusEndpoint("https://client-pbs.relevant-digital.com/s 
PrebidMobile.setCustomStatusEndpoint("https://iqdigital-pbs.relevant-digital.com/status")   
tatus")   


PrebidMobile.initializeSdk(   
PrebidMobile.initializeSdk(   
     applicationContext,   
     applicationContext,   
     "https://client-pbs.relevant-digital.com/openrtb2/auction") { status ->   
     "https://iqdigital-pbs.relevant-digital.com/openrtb2/auction") { status ->   
         if (status == InitializationStatus.SUCCEEDED) {   
         if (status == InitializationStatus.SUCCEEDED) {   
             Log.d(TAG, "SDK initialized successfully!")   
             Log.d(TAG, "SDK initialized successfully!")   
Zeile 40: Zeile 44:
Für jede Werbeplatzierung (iqadtile) muss eine BannerAdUnit angelegt und konfiguriert werden:
Für jede Werbeplatzierung (iqadtile) muss eine BannerAdUnit angelegt und konfiguriert werden:


#'''Config Id''', diese ist für jedes iqadtile anders und wird in einer Tabelle von der iqdigital zur Verfügung gestellt
#'''Config Id''', diese ist für jedes iqadtile innerhalb einer App anders und wird im Excel-Sheet von der iqdigital zur Verfügung gestellt
#Die Größen, die für das iqadtile definiert worden sind, müssen der BannerAdUnit ebenfalls mitgeteilt werden. (Wichtig: im Normalfall müssen mehr als eine Size übergeben werden, sie unterscheiden sich oft von iqadtile zu iqadtile)
#Die Größen, die für das iqadtile definiert worden sind, müssen der BannerAdUnit ebenfalls mitgeteilt werden. (Wichtig: im Normalfall müssen mehr als eine Size übergeben werden, sie unterscheiden sich oft von iqadtile zu iqadtile)


Zeile 102: Zeile 106:
Die GPID ist dazu da, bestimmten Headerbidding Partnern mitzuteilen, für welche Platzierung sie bieten und deshalb sehr wichtig. Ein Fehlen dieser Information führt zu schlechteren Geboten!
Die GPID ist dazu da, bestimmten Headerbidding Partnern mitzuteilen, für welche Platzierung sie bieten und deshalb sehr wichtig. Ein Fehlen dieser Information führt zu schlechteren Geboten!


GPID entspricht der AdUnit, welche für das iqadtile benutzt wird, z.B. /183/FAZ_app_android_phone/homepage
*'''gpid''' entspricht der AdUnit + die iqadtile-Bezeichnung, welche für das iqadtile benutzt wird und welche mit einem Bindestrich "-" angehängt wird, z.B. /183/FAZ_app_android_phone/homepage-iqadtile3
pbadslot ist eine Kombination aus AdUnit und iqadtile, Beispiel /183/FAZ_app_android_phone/homepage#iqadtile3
*'''pbadslot''' ist der gleiche Wert wie bei '''gpid''', z.B. /183/FAZ_app_android_phone/homepage-iqadtile3
relevant_slotInstance ist die Nummer des iqadtiles, Beispiel 3 für iqadtile3
*'''relevant_slotInstance''' ist die Nummer des iqadtiles, Beispiel 3 für iqadtile3


====Beispiel====
====Beispiel für das iqadtile3====
<pre>
<pre>
adUnit?.impOrtbConfig = """   
adUnit?.impOrtbConfig = """   
     {   
     {   
         "ext": {   
         "ext": {   
             "gpid":"/183/FAZ_app_android_phone/homepage"   
             "gpid":"/183/FAZ_app_android_phone/homepage-iqadtile3"   
             "data": {   
             "data": {   
                 "pbadslot":"/183/FAZ_app_android_phone/homepage#iqadtile3"   
                 "pbadslot":"/183/FAZ_app_android_phone/homepage-iqadtile3"   
                 "relevant_slotInstance": "3" // optional extra to RY analytics   
                 "relevant_slotInstance": "3" // optional extra to RY analytics   
             }   
             }   
Abgerufen von „http://docs.iqd-ao.de/de/index.php?title=Prebid_Mobile_SDK_in_Apps“