Uyumlulaştırma grupları

AdMob API, aşağıdakiler de dahil olmak üzere uyumlulaştırma grupları oluşturmanıza, listelemenize ve güncellemenize olanak tanır:

  • Bölgeler, biçim, platform ve IDFA hedefleme dahil olmak üzere uyumlulaştırma grubu hedeflemeyi belirtme
  • Mevcut bir uyumlulaştırma grubuna yeni uyumlulaştırma grubu satırları ekleme
  • Hangi uyumlulaştırma gruplarının bir uyumlulaştırma A/B denemesinin parçası olduğunu ve hangi uyumlulaştırma grubu satırlarının A veya B varyantına ait olduğunu görüntüleme

Örnekler

OAuth 2.0 kimlik bilgileri oluşturulduktan sonra AdMob API'yi kullanmaya başlayabilirsiniz. Uygulamanızın OAuth 2.0 kullanarak erişim isteğinde bulunabilmesi için kapsam bilgilerine de ihtiyacı vardır.

OAuth 2.0 kapsam bilgileri şöyledir:

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örebilir. Buna hesap bilgileri, envanter ve arabuluculuk ayarları, raporlar ve diğer veriler dahil olabilir. Ödemeler veya kampanya ayrıntıları gibi hassas veriler dahil değildir.

Oluştur

Uyumlulaştırma grubu oluşturmak için ilgili reklam birimleri de dahil olmak üzere uyumlulaştırma grubu hedefleme bilgilerini belirtmeniz gerekir. Aşağıdaki örnekte, 2 reklam birimi için Android geçiş reklamları için yeni bir uyumlulaştırma grubu oluşturulmaktadır. InMobi reklam kaynağı için oluşturma sırasında bir uyumlulaştırma grubu satırı eklenir. AdMob ağı, oluşturma sırasında varsayılan olarak ekleneceğinden dahil etmeniz gerekmez.

Aşağıdaki kod snippet'inde pub-XXXXXXXXXXXXXXXX yerine yayıncı kimliğinizi girin.

Ardından, YYYYYYYYYY yerine reklam birimi kimliğinizin son 10 hanesini aşağıdaki biçimde girin:

ca-app-pub-XXXXXXXXXXXXXXXX/YYYYYYYYYY

Bu örnekte iki reklam birimi olduğundan YYYYY11111 ilk reklam birimini, WWWWW11111 ise ilk reklam biriminin eşlemesini ifade eder. YYYYY22222 ve WWWWW22222 ikinci reklam birimini ve reklam birimi eşlemesini ifade eder.

curl (komut satırı)

WWWWWWWWWW yerine reklam birimi eşleme kimliğinizi yazın. Reklam birimi eşleme kimliği, accounts.adUnits.adUnitMappings.list yöntemi kullanılarak bulunabilir.

 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

Uyumlulaştırma gruplarınızı görüntülemek için pub-XXXXXXXXXXXXXXXX yerine yayıncı kimliğinizi girin.

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

Uyumlulaştırma grubunu güncellemek için alan maskelerinin listesini aşağıda bulabilirsiniz. Tekrarlanan alanlardaki (ör. listedeki öğeler) güncellemeler, mevcut değerleri tamamen yeni değerlerle değiştirir. Haritadaki değerler, anahtara göre dizine eklenerek güncellenebilir.

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 mediationGroupLineId için farklı bir negatif sayı kullanın. Mevcut uyumlulaştırma grubu satırlarını güncellemek için hem update_mask hem de yükte uyumlulaştırma grubu satırı kimliğine başvurun.

"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ı eklenmektedir. updateMask, yer tutucu olarak farklı negatif değerlere sahip 3 uyumlulaştırma grubu satırını içerir:

updateMask=mediationGroupLines["-1"],mediationGroupLines["-2"],mediationGroupLines["-3"]

Tüm URL'lerin, Tekdüzen Kaynak Tanımlayıcı (URI) spesifikasyonunda belirtilen söz dizimine uyması gerektiğinden özel karakterleri çevirmeniz gerekir. Bu nedenle, 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 yerine yayıncı kimliğinizi, ZZZZZZZZZZ yerine ise uyumlulaştırma grubu kimliğinizi girin. Uyumlulaştırma grubu kimliği, AdMob kullanıcı arayüzünde veya accounts.mediationGroups:list yöntemi kullanılarak bulunabilir.

YYYYYYYYYY yerine reklam birimi kimliğinizin son 10 hanesini şu biçimde girin:

ca-app-pub-XXXXXXXXXXXXXXXX/YYYYYYYYYY`

WWWWWWWWWW yerine reklam birimi eşleme kimliğinizi yazın. Reklam birimi eşleme kimliği, accounts.adUnits.adUnitMappings.list yöntemi kullanılarak bulunabilir.

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