「IOS Google Ad Manager Mediation」修訂間的差異

出自TAMedia
跳至導覽 跳至搜尋
 
(未顯示同一使用者於中間所作的 8 次修訂)
行 1: 行 1:
= 簡介 =
= 簡介 =
本文將說明如何設定 Google Ad Manager mediation 來投放 TAmedia 廣告,Google Ad Manager 與 AdMob 使用相同 SDK,TAmedia 提供的 mediation 程式碼也使用同一套,可先參考 Google Ad Manager 官方教學瞭解初始化及請求廣告方式([https://developers.google.com/ad-manager/mobile-ads-sdk/ios/quick-start?hl=zh-tw GAM quick-start]),再閱讀本文了解如何串接 mediation,亦有提供範例的 demo app 可下載參考。
本文將說明如何設定 Google Ad Manager mediation 來投放 TAmedia 廣告,Google Ad Manager 與 AdMob 使用相同 SDK,TAmedia 提供的 mediation 程式碼也使用同一套,可先參考 Google Ad Manager 官方教學瞭解初始化及請求廣告方式([https://developers.google.com/ad-manager/mobile-ads-sdk/ios/quick-start?hl=zh-tw GAM quick-start]),再閱讀本文了解如何串接 mediation,亦有提供範例的 demo app 可下載參考。
= 詳細範例 =
= Demo App =
[[媒體: IOS_GoogleMediation_demo.zip | Google Mediation Demo App ]]
[[媒體: IOS_GoogleMediation_demo.zip | Google Mediation Demo App ]]
= 整合中介程式碼 =
= 整合中介程式碼 =
將中介程式[[媒體:TAmediaGADMediationAdapter_1.1.0.zip ‎ | TAmedia iOS 中介程式碼]]以及 TAmedia SDK 加入專案內<br/>
將中介程式[[媒體:TAmediaGADMediationAdapter_1.1.0.zip ‎ | TAmedia iOS 中介程式碼]]以及[[Download SDK|TAmedia SDK]]加入專案內,若尚未整合過 TAmedia SDK 可參考[[SDK8 Getting Started Guide|整合教學]]<br/>


[[檔案: iOS_admob_mediation_adapter.png |300 px]]<br/>
[[檔案: iOS_admob_mediation_adapter.png |300 px]]<br/>
行 11: 行 12:
整合 mediation 前請先參閱[https://developers.google.com/ad-manager/mobile-ads-sdk/ios/quick-start?hl=zh-tw Google Ad Manager 設定],確保已經可以正常顯示 GAM 的廣告,再來實作 mediation。<br/>
整合 mediation 前請先參閱[https://developers.google.com/ad-manager/mobile-ads-sdk/ios/quick-start?hl=zh-tw Google Ad Manager 設定],確保已經可以正常顯示 GAM 的廣告,再來實作 mediation。<br/>
===1.先至 GAM 後台廣告單元區塊>新增或編輯廣告單元===
===1.先至 GAM 後台廣告單元區塊>新增或編輯廣告單元===
編輯既有廣告單元<br/>
新增廣告單元或編輯既有廣告單元<br/>
[[檔案:GAM_create_slotId.png|800 px]]<br/>
[[檔案:GAM_create_slotId.png|800 px]]<br/>
新增廣告則根據廣告樣式選擇大小<br/>
廣告大小根據廣告樣式選擇<br/>
{| class="wikitable"
{| class="wikitable"
|-
|-
行 35: 行 36:
'''Label''' 可自行定義<br/>
'''Label''' 可自行定義<br/>
'''Class Name''' 必須為 {Project Name}.TADCustomEvent (此 class 為 TAmedia 提供的中介程式)可參考[https://developers.google.com/ad-manager/mobile-ads-sdk/ios/custom-events/setup?hl=zh-tw#create Google 官方設定]<br/>
'''Class Name''' 必須為 {Project Name}.TADCustomEvent (此 class 為 TAmedia 提供的中介程式)可參考[https://developers.google.com/ad-manager/mobile-ads-sdk/ios/custom-events/setup?hl=zh-tw#create Google 官方設定]<br/>
'''Parameter''' 設定上根據廣告類型的差異有所不同,Banner及Interstitial請帶入版位ID,Native則可以帶入客製化的參數
'''Parameter''' 設定上根據廣告類型的差異有所不同,Banner及Interstitial請帶入版位ID,Native則帶入客製化的參數
{| class="wikitable"
{| class="wikitable"
|-
|-
! !! Banner !! Interstitial !! Native
! !! Banner !! Interstitial !! Native
|-
|-
| '''Parameter''' || TAmedia 所提供的版位 ID || TAmedia 所提供的版位 ID || 客製化Json參數 / TAmedia 所提供的版位 ID
| '''Parameter''' || TAmedia 所提供的版位 ID || TAmedia 所提供的版位 ID || 客製化Json參數
|}
|}
'''Native 廣告客製化Json參數說明'''<br/>
'''Native 廣告客製化Json參數說明'''<br/>
行 89: 行 90:
{| class="wikitable"
{| class="wikitable"
|-
|-
! Banner 廣告參數範例 !! Native 廣告參數範例  
! Banner 廣告參數範例 !! Interstitial 廣告參數範例 !! Native 廣告參數範例  
|-
|-
| [[檔案: GAM_yield_group_banner_sample.png |300 px]]||[[檔案: GAM_yield_group_native_sample.png |300 px]]
| [[檔案: GAM_yield_group_banner_sample.png |300 px]]|| [[檔案: GAM_yield_group_interstitial_sample.png |300 px]] ||[[檔案: GAM_yield_group_native_sample.png |300 px]]
|}
|}


行 105: 行 106:
===填入廣告版位===
===填入廣告版位===
[[檔案: GAM_setting_ad_slot_id.png |800 px]]<br/>
[[檔案: GAM_setting_ad_slot_id.png |800 px]]<br/>
===Demo app ===
===Demo===
{| class="wikitable"
{| class="wikitable"
|-
|-
行 112: 行 113:
| [[檔案: GAM_demo_home.png |300 px]]||[[檔案: GAM_demo_menu.png |300 px]]
| [[檔案: GAM_demo_home.png |300 px]]||[[檔案: GAM_demo_menu.png |300 px]]
|}
|}
===Banner===
===Banner===
{| class="wikitable"
{| class="wikitable"

於 2023年10月18日 (三) 07:20 的最新修訂

簡介

本文將說明如何設定 Google Ad Manager mediation 來投放 TAmedia 廣告,Google Ad Manager 與 AdMob 使用相同 SDK,TAmedia 提供的 mediation 程式碼也使用同一套,可先參考 Google Ad Manager 官方教學瞭解初始化及請求廣告方式(GAM quick-start),再閱讀本文了解如何串接 mediation,亦有提供範例的 demo app 可下載參考。

Demo App

Google Mediation Demo App

整合中介程式碼

將中介程式 TAmedia iOS 中介程式碼以及TAmedia SDK加入專案內,若尚未整合過 TAmedia SDK 可參考整合教學

IOS admob mediation adapter.png

廣告單元 / 收益群組

整合 mediation 前請先參閱Google Ad Manager 設定,確保已經可以正常顯示 GAM 的廣告,再來實作 mediation。

1.先至 GAM 後台廣告單元區塊>新增或編輯廣告單元

新增廣告單元或編輯既有廣告單元
GAM create slotId.png
廣告大小根據廣告樣式選擇

Banner Interstitial Native
大小 320x50, 300x250 1024x768, 768x1024, 480x320, 320x480 自訂顯示

GAM create slot ad format.png

2.進入廣告單元後點選收益群組>新增收益群組

GAM yield group.png

3.選擇廣告格式

GAM create yield group.png

4.新增收益夥伴

GAM create yield partner.png

5.設定收益夥伴資訊

GAM create yield partner setting.png
這邊設定很重要:
千次曝光價格將影響 TAmedia 廣告展示的優先順序,GAM 依照千次曝光價格價格高者優先曝光
Label 可自行定義
Class Name 必須為 {Project Name}.TADCustomEvent (此 class 為 TAmedia 提供的中介程式)可參考Google 官方設定
Parameter 設定上根據廣告類型的差異有所不同,Banner及Interstitial請帶入版位ID,Native則帶入客製化的參數

Banner Interstitial Native
Parameter TAmedia 所提供的版位 ID TAmedia 所提供的版位 ID 客製化Json參數

Native 廣告客製化Json參數說明
可根據 MediaView 想呈現圖片或影片,或影音相關設定輸入不同參數,也可以直接修改中介程式碼
下面表格呈現各種設定所帶來的效果

MediaView顯示影音 MediaView顯示大圖(1200x628) MediaView顯示小圖(960x640)

adUnitId: TAmedia廣告版位
mediaType: VIDEO
videoStartUnmuted: 影片聲音預設開關, true: 有聲音, false: 無聲音
videoCustomControlRequest: 影片上是否要顯示秒數, 靜音, 前往瀏覽等UI按鈕, true: 不顯示, false: 顯示

{
  "parameters": {
    "adUnitId": "{ADUNIT_ID}",
    "mediaType": "VIDEO",
    "videoStartUnmuted":true,
    "videoCustomControlRequest":true
  }
}

adUnitId: TAmedia廣告版位
mediaType: BIG_IMAGE

{
  "parameters": {
    "adUnitId": "{ADUNIT_ID}",
    "mediaType": "BIG_IMAGE"
  }
}

adUnitId: TAmedia廣告版位
mediaType: SMALL_IMAGE

{
  "parameters": {
    "adUnitId": "{ADUNIT_ID}",
    "mediaType": "SMALL_IMAGE"
  }
}

收益群組參數範例

Banner 廣告參數範例 Interstitial 廣告參數範例 Native 廣告參數範例
GAM yield group banner sample.png GAM yield group interstitial sample.png GAM yield group native sample.png

6. 完成

設定完以上動作後就可以透過 GAM 來取得 TAmedia 廣告

使用詳細範例

下載範例程式

Google Mediation Demo App

填入App ID

GAM setting plist app id.png
輸入由 AdMob 或 Google Ad Manager console 取得的 App ID

填入廣告版位

GAM setting ad slot id.png

Demo

選擇廣告平台 選擇廣告類型
GAM demo home.png GAM demo menu.png

Banner 320x50 廣告 Banner 300x250 廣告
GAM demo banner 320x50.png GAM demo banner 300x250.png

Interstitial

Interstitial 廣告
GAM demo interstitial.png|

Native

Native 圖片廣告 Native 影音廣告
GAM demo native image.png GAM demo native video.png