AdMob API 可建立中介服務 A/B 實驗,盡量提升廣告成效 測試不同設定的效能A/B 測試可讓你評估 中介服務群組的兩種變化版本,將結果並列比較 請選取偏好的設定
以下列舉幾個您可以設定的實驗:
- 新增或移除廣告來源,看看對中介服務群組的影響
- 變更廣告的手動有效千次曝光出價,以變更刊登序列順序 來源
- 啟用或停用刊登序列廣告來源最佳化功能
- 變更系統呼叫廣告來源的次數
範例
先使用現有的中介服務群組,並建立其變化版本,以便查看 也就是 A 或 B 版本的成效較佳測試會拆分應用程式使用者 系統會根據您現有的中介服務群組設定和變化版本 百分比 (1%、10% 或 50%)。
curl (指令列)
使用 curl 的要求
載入用戶端密鑰檔案並產生授權 憑證
第一次執行這個步驟時,系統會要求您接受 在瀏覽器中輸入授權提示接受前,請務必確認 使用可存取 AdMob API 的 Google 帳戶登入。您的 應用程式將有權代表 目前登入的帳戶
如要進行驗證和授權,建議您使用 oauth2l 是簡便的指令列工具 才能使用 Google OAuth 2.0安裝 oauth2l 並執行下列指令。 將 path_to_credentials_json 替換為 註冊雲端時下載的
credentials.json
個檔案 應用程式。第一次執行時,指令會引導您執行 OAuth 2.0 授權流程。完成後,系統就會自動重新整理權杖。oauth2l header --json path_to_credentials_json --scope admob.monetization,admob.readonly
建立中介服務 A/B 實驗。
將
pub-XXXXXXXXXXXXXXXX
替換成您的發布商 ID 和ZZZZZZZZZZ
: 中介服務群組 ID您可以在 AdMob UI 中找到中介服務群組 ID 方法是使用accounts.mediationGroups:list
敬上 方法。您需要指定
treatmentMediationLines
敬上 和treatmentTrafficPercentage
, 不過,controlMediationLines
這些元件會沿用自上層中介服務群組 。下列請求會建立中介服務 A/B 實驗,並將 實驗組變化版本 B (又稱變化版本 B),其中包含單一中介服務 AdMob 聯播網的同一行程式碼
LIVE
模式。curl --http1.0 \ -X POST https://admob.googleapis.com/v1beta/accounts/pub-XXXXXXXXXXXXXXXX/mediationGroups/ZZZZZZZZZZ/mediationAbExperiments \ -H "Content-Type:application/json" \ -H "$(oauth2l header --json path_to_credentials_json --scope admob.monetization)" \ --data @- << EOF { "displayName":"Mediation A/B Experiment Test Name", "treatmentTrafficPercentage": "50", "treatmentMediationLines": [{ "mediationGroupLine": { "displayName": "Test mediation group line", "adSourceId": "5450213213286189855", "cpm_mode": "LIVE" } }] } EOF
請參閱下面的範例回應,其中
SSSSSSSSSSSSSSSSSSSSSS
代表 已建立的中介服務 A/B 實驗 ID,YYYYYYYYYY
則代表 廣告單元的最後 10 位數字 ID,請依循以下格式:ca-app-pub-XXXXXXXXXXXXXXXX/YYYYYYYYYY
。{ "name": "accounts/pub-XXXXXXXXXXXXXXXX/mediationGroups/ZZZZZZZZZZ/mediationAbExperiments/SSSSSSSSSSSSSSSSSSSSSS", "displayName": "Mediation A/B Experiment Test Name", "experimentId": "SSSSSSSSSSSSSSSSSSSSSS", "treatmentTrafficPercentage": "50", "treatmentMediationLines": [ { "mediationGroupLine": { "id": "11111111111111111", "displayName": "Test mediation group line", "adSourceId": "5450213213286189855", "cpmMode": "LIVE", "cpmMicros": "10000", "adUnitMappings": { "ca-app-pub-XXXXXXXXXXXXXXXX/YYYYYYYYYY": "accounts/pub-XXXXXXXXXXXXXXXX/adUnits/YYYYYYYYYY/adUnitMappings/ "ca-app-pub-XXXXXXXXXXXXXXXX/YYYYYYYYYY": "accounts/pub-XXXXXXXXXXXXXXXX/adUnits/YYYYYYYYYY/adUnitMappings/ }, "state": "ENABLED" } } ], "controlMediationLines": [ { "mediationGroupLine": { "id": "22222222222222222", "displayName": "AdMob Network (control)", "adSourceId": "5450213213286189855", "cpmMode": "LIVE", "cpmMicros": "10000", "adUnitMappings": { "ca-app-pub-XXXXXXXXXXXXXXXX/YYYYYYYYYY": "accounts/pub-XXXXXXXXXXXXXXXX/adUnits/YYYYYYYYYY/adUnitMappings/ "ca-app-pub-XXXXXXXXXXXXXXXX/YYYYYYYYYY": "accounts/pub-XXXXXXXXXXXXXXXX/adUnits/YYYYYYYYYY/adUnitMappings/ }, "state": "ENABLED" } } ], "state": "RUNNING" }
確認中介服務 A/B 實驗正在執行。
致電
accounts.mediationGroups:list
敬上 取得該中介服務群組的中介服務 A/B 實驗狀態。詳情請見 中介服務群組 指南 詳細資料。mediationAbExperimentState
敬上 為執行中的中介服務 A/B 實驗和NOT_RUNNING
,已設為RUNNING
(如果中介服務群組中沒有正在執行的實驗)。要求範例:
curl --http1.0 \ -X GET https://admob.googleapis.com/v1beta/accounts/pub-XXXXXXXXXXXXXXXX/mediationGroups \ -H "$(oauth2l header --json path_to_credentials_json --scope admob.readonly)"
停止中介服務 A/B 實驗並選取變化版本。
將
pub-XXXXXXXXXXXXXXXX
替換成您的發布商 ID 和ZZZZZZZZZZ
: 中介服務群組 ID您可以在 AdMob UI 中找到中介服務群組 ID 方法是使用accounts.mediationGroups:list
敬上 方法。如要完成實驗,請在要求中指定勝出的變化版本:
VARIANT_CHOICE_A
:使用版本 A 的中介服務行,並完成 實驗。版本 A 會在 建立實驗VARIANT_CHOICE_B
:使用版本 B 的中介服務行,然後完成 實驗。版本 B 包含新增的放送行。
要求範例:
curl --http1.0 \ -X POST https://admob.googleapis.com/v1beta/accounts/pub-XXXXXXXXXXXXXXXX/mediationGroups/ZZZZZZZZZZ/mediationAbExperiments:stop \ -H "Content-Type:application/json" \ -H "$(oauth2l header --json
path_to_credentials_json
--scope admob.monetization)" \ --data @- << EOF { "variantChoice": "VARIANT_CHOICE_A" }回應範例:
{ "experimentId": "SSSSSSSSSSSSSSSSSSSSSS", "state": "EXPIRED", }