AdMob API, aşağıdakiler de dahil olmak üzere uyumlulaştırma gruplarını oluşturmanıza, listelemenize ve güncellemenize olanak tanır:
- Uyumlulaştırma grubu hedeflemesini belirtme bölgeler, biçim, platform ve IDFA hedeflemesi dahil
- Yeni uyumlulaştırma grubu satırları ekleme mevcut bir uyumlulaştırma grubuna
- Hangi uyumlulaştırma gruplarının uyumlulaştırma A/B denemesinin parçası olduğunu ve nelerin her bir varyanta ait olan uyumlulaştırma grubu satırları: A veya B
Örnekler
OAuth 2.0 kimlik bilgileri oluşturulduktan sonra, AdMob API'yi kullanmaya hazırsınız. OAuth 2.0 kullanarak erişim isteğinde bulunmak için kapsam bilgilerine de ihtiyacınız olacaktır.
OAuth 2.0 kapsam bilgileri aşağıda verilmiştir:
Kapsam | Anlamı |
---|---|
https://www.googleapis.com/auth/admob.monetization |
AdMob para kazanma ayarlarınızı görme, oluşturma ve düzenleme. |
https://www.googleapis.com/auth/admob.readonly |
Tüm AdMob verilerini görüntüleyin. Hesap, bu kapsamda yer alabilir bilgileri, envanter ve uyumlulaştırma ayarlarını, raporlarını ve diğer verilerini içerir. Ödemeler veya kampanya ayrıntıları gibi hassas veriler dahil değildir. |
Oluştur
Uyumlulaştırma grubu oluşturmak için uyumlulaştırma grubu hedeflemesini belirtmeniz gerekir bilgileri de içerir. Aşağıdaki örnek, yeni bir uyumlulaştırma grubu ile ilgilidir. Bir uyumlulaştırma grubu satırı, InMobi reklam kaynağı için oluşturma sırasında eklenir. Herhangi bir oluşturma sırasında varsayılan olarak ekleneceği için AdMob ağını
Aşağıdaki kod snippet'inde pub-XXXXXXXXXXXXXXXX
öğesini yayıncınızla değiştirin
Kimlik.
Ardından, YYYYYYYYYY
değerini reklam biriminizin son 10 hanesiyle değiştirin
ID, uyumlu
şu biçime göre değişir:
ca-app-pub-XXXXXXXXXXXXXXXX/YYYYYYYYYY
Bu örnekte iki reklam birimi olduğundan, YYYYY11111
ilk reklamı ifade eder
birimi ve WWWWW11111
değerini ilk reklam biriminin eşlemesine ekleyin. YYYYY22222
ve
WWWWW22222
, ikinci reklam birimini ve reklam birimi eşlemesini belirtir.
curl (komut satırı)
WWWWWWWWWW
değerini reklam birimi eşleme kimliğinizle değiştirin. Reklam birimi eşleme kimliği
için
accounts.adUnits.adUnitMappings.list
yöntemidir.
curl --http1.0 -X POST https://admob.googleapis.com/v1beta/accounts/pub-XXXXXXXXXXXXXXXX/mediationGroups -H "Content-Type:application/json" -H "$(oauth2l header --json path_to_credentials_json --scope admob.monetization)" --data @- << EOF { "displayName": "Test Mediation Group" "targeting": { "platform": "ANDROID", "format": "INTERSTITIAL" "adUnitIds":["ca-app-pub-XXXXXXXXXXXXXXXX/YYYYY11111", "ca-app-pub-XXXXXXXXXXXXXXXX/YYYYY22222"} } "mediationGroupLines": { "-1": { "displayName": "test line", "adSourceId": "7681903010231960328", "cpmMode": "MANUAL", "cpmMicros": "150000", "state": "ENABLED", "adUnitMappings": { "ca-app-pub-XXXXXXXXXXXXXXXX/YYYYY11111": "accounts/pub-XXXXXXXXXXXXXXXX/adUnits/YYYYY11111/adUnitMappings/WWWWW11111", "ca-app-pub-XXXXXXXXXXXXXXXX/YYYYY22222": "accounts/pub-XXXXXXXXXXXXXXXX/adUnits/YYYYY22222/adUnitMappings/WWWWW22222" } } }
Liste
pub-XXXXXXXXXXXXXXXX
öğesini yayıncınızla değiştirin
ID (Uyumlulaştırma gruplarınızı görüntülemek için) tıklayın.
curl (komut satırı)
Örnek istek:
curl --http1.0 -X GET https://admob.googleapis.com/v1beta/accounts/pub-XXXXXXXXXXXXXXXX/mediationGroups \ -H "$(oauth2l header --json path_to_credentials_json --scope admob.monetization)"
Örnek yanıt:
{ "mediationGroups": [ { "name": "accounts/pub-XXXXXXXXXXXXXXXX/mediationGroups/ZZZZZZZZZZ", "mediationGroupId": "ZZZZZZZZZZ", "displayName": "Test Mediation Group", "state": "ENABLED", "state": "NOT_RUNNING", "targeting": { "platform": "iOS", "format": "BANNER", "targetedRegionCodes": "[CA]", "adUnits": ["YYYYY11111", "YYYYY22222"] }, "mediationGroupLines": { "11111111111111111": { "id": "11111111111111111", "displayName": "AdMob Network", "adSourceId": "5450213213286189855", "cpmMode": "LIVE", "state": "ENABLED", "experimentVariant": "ORIGINAL" }, "22222222222222222": { "id": "22222222222222222", "displayName": "test line", "adSourceId": "7681903010231960328", "cpmMode": "MANUAL", "cpmMicros": "150000", "adUnitMappings": { "ca-app-pub-XXXXXXXXXXXXXXXX/YYYYY11111": "accounts/pub-XXXXXXXXXXXXXXXX/adUnits/YYYYY11111/adUnitMappings/WWWWW11111", "ca-app-pub-XXXXXXXXXXXXXXXX/YYYYY22222": "accounts/pub-XXXXXXXXXXXXXXXX/adUnits/YYYYY22222/adUnitMappings/WWWWW22222" }, "state": "ENABLED", "experimentVariant": "ORIGINAL" } }, }] }
Yama
maskeler uyumlulaştırma grubunu güncellemek için. Yinelenen alanlarda güncellemeler (ör. mevcut değerleri tamamen yeni değerlerle değiştirin. Bireysel güncellemeler değerleri, anahtar tarafından dizine ekleme yoluyla yapılabilir.
Uyumlulaştırma grubu güncellemeleri için aşağıdaki alan maskeleri desteklenir:
targeting.adUnitIds
mediationGroupLines[mediationGroupLineId]
mediationGroupLines[mediationGroupLineId].state
mediationGroupLines[mediationGroupLineId].adUnitMappings[adUnitId]
Bir uyumlulaştırma grubunu yeni bir uyumlulaştırma grubu satırıyla güncellemek için farklı bir
mediationGroupLineId
için negatif sayı. Mevcut uyumlulaştırmayı güncellemek için
grup satırları kullanıyorsanız hem update_mask
hem de
aşağıda gösterildiği gibi ekleyin.
"updateMask" {
paths: "mediation_group_lines["123"].ad_unit_mappings["456"]"
}
"mediationGroup" {
"mediationGroupLines": {
"123": {
"id": "123"
"adUnitMappings": {
"456": "newAdUnitMappingId"
}
}
}
}
curl (komut satırı)
Aşağıdaki örnekte, mevcut bir uyumlulaştırma grubuna 3 yeni uyumlulaştırma satırı eklenmiştir.
updateMask
, farklı negatif özelliklere sahip 3 uyumlulaştırma grubu satırı içerir
değerlerini yer tutucu olarak kullanın:
updateMask=mediationGroupLines["-1"],mediationGroupLines["-2"],mediationGroupLines["-3"]
Tüm URL'lerin
Tekdüzen Kaynak Tanımlayıcısı (URI) spesifikasyonunda belirtilen söz dizimi,
Dolayısıyla updateMask
şu şekilde olur:
updateMask=mediationGroupLines%5B%22-1%22%5D,mediationGroupLines%5B%22-2%22%5D,mediationGroupLines%5B%22-3%22%5D
Aşağıdaki örneği çalıştırmak için pub-XXXXXXXXXXXXXXXX
değerini
yayıncı kimliğinizi ve ZZZZZZZZZZ
ile uyumlulaştırma grubu kimliğinizi ekleyin. Arabuluculuk
grup kimliğini AdMob kullanıcı arayüzünde veya accounts.mediationGroups:list
kullanılarak bulunabilir.
yöntemidir.
YYYYYYYYYY
değerini, reklam biriminizin son 10 hanesiyle değiştirin
ID, şu biçimde olmalıdır:
ca-app-pub-XXXXXXXXXXXXXXXX/YYYYYYYYYY`
WWWWWWWWWW
değerini reklam birimi eşleme kimliğinizle değiştirin. Reklam birimi eşleme kimliği
için
accounts.adUnits.adUnitMappings.list
yöntemidir.
curl --http1.0 -X PATCH https://admob.googleapis.com/v1beta/accounts/pub-XXXXXXXXXXXXXXXX/mediationGroups/ZZZZZZZZZZ? updateMask=mediationGroupLines%5B%22-1%22%5D,mediationGroupLines%5B%22-2%22%5D,mediationGroupLines%5B%22-3%22%5D -H "Content-Type:application/json" -H "$(oauth2l header --json path_to_credentials_json --scope admob.monetization)" --data @- << EOF { "mediationGroupLines": { "-1": { "displayName": "test line 2", "adSourceId": "7681903010231960458", "cpmMode": "MANUAL", "cpmMicros": "150000", "state": "ENABLED", "adUnitMappings": { "ca-app-pub-XXXXXXXXXXXXXXXX/YYYYYYYYYY": "accounts/pub-XXXXXXXXXXXXXXXX/adUnits/YYYYYYYYYY/adUnitMappings/WWWWWWWWWW" } }, "-2": { "displayName": "test line 3", "adSourceId": "7681903010231960328", "cpmMode": "MANUAL", "cpmMicros": "120000", "state": "ENABLED", "adUnitMappings": { "ca-app-pub-XXXXXXXXXXXXXXXX/YYYYYYYYYY": "accounts/pub-XXXXXXXXXXXXXXXX/adUnits/YYYYYYYYYY/adUnitMappings/WWWWWWWWWW" } }, "-3": { "displayName": "test line 4", "adSourceId": "7681903010231960328", "cpmMode": "MANUAL", "cpmMicros": "130000", "state": "ENABLED", "adUnitMappings": { "ca-app-pub-XXXXXXXXXXXXXXXX/YYYYYYYYYY": "accounts/pub-XXXXXXXXXXXXXXXX/adUnits/YYYYYYYYYY/adUnitMappings/WWWWWWWWWW" } } } } EOF