Uyumlulaştırma grupları

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