กลุ่มสื่อกลาง

AdMob API ช่วยให้คุณสร้าง แสดงรายการ และอัปเดตกลุ่มสื่อกลางต่อไปนี้ได้

  • การระบุการกำหนดเป้าหมายกลุ่มสื่อกลาง ซึ่งรวมถึงการกำหนดเป้าหมายตามภูมิภาค รูปแบบ แพลตฟอร์ม และ IDFA
  • การเพิ่มบรรทัดกลุ่มสื่อกลางใหม่ ในกลุ่มสื่อกลางที่มีอยู่
  • ดูว่ากลุ่มสื่อกลางใดเป็นส่วนหนึ่งของการทดสอบ A/B สำหรับสื่อกลาง และสิ่งใด บรรทัดกลุ่มสื่อกลางอยู่ในตัวแปรแต่ละรายการ: A หรือ B

ตัวอย่าง

เมื่อสร้างข้อมูลเข้าสู่ระบบ OAuth 2.0 แล้ว ให้ทำดังนี้ คุณก็พร้อมที่จะเริ่มใช้ AdMob API แล้ว วิธีขอสิทธิ์เข้าถึงโดยใช้ OAuth 2.0 แอปพลิเคชันของคุณจะต้องมีข้อมูลขอบเขตด้วย

ข้อมูลขอบเขตของ OAuth 2.0 มีดังนี้

ขอบเขต ความหมาย
https://www.googleapis.com/auth/admob.monetization ดู สร้าง และแก้ไขการตั้งค่าการสร้างรายได้จาก AdMob
https://www.googleapis.com/auth/admob.readonly ดูข้อมูล AdMob ทั้งหมด ซึ่งอาจรวมถึงบัญชี การตั้งค่าพื้นที่โฆษณาและสื่อกลาง รายงาน และข้อมูลอื่นๆ แต่ไม่รวมข้อมูลที่ละเอียดอ่อน เช่น การชำระเงินหรือรายละเอียดของแคมเปญ

สร้าง

หากต้องการสร้างกลุ่มสื่อกลาง คุณต้องระบุการกำหนดเป้าหมายกลุ่มสื่อกลาง รวมถึงหน่วยโฆษณาที่เกี่ยวข้อง ตัวอย่างต่อไปนี้จะสร้าง กลุ่มสื่อกลางสำหรับโฆษณาคั่นระหว่างหน้าของ Android สำหรับหน่วยโฆษณา 2 หน่วย กลุ่มสื่อกลาง 1 กลุ่ม เพิ่มขึ้นขณะสร้างแหล่งที่มาของโฆษณา InMobi คุณไม่จำเป็นต้องระบุ เครือข่าย AdMob เนื่องจากระบบจะเพิ่มเครือข่ายนี้ในขณะที่สร้างโดยค่าเริ่มต้น

ในข้อมูลโค้ดด้านล่าง ให้แทนที่ pub-XXXXXXXXXXXXXXXX ด้วย publisher ของคุณ รหัส

จากนั้นแทนที่ YYYYYYYYYY ด้วยตัวเลข 10 หลักสุดท้ายของหน่วยโฆษณา บัตรประจำตัว เป็นไปตามข้อกำหนด เป็นรูปแบบดังนี้

ca-app-pub-XXXXXXXXXXXXXXXX/YYYYYYYYYY

เนื่องจากในตัวอย่างนี้มีหน่วยโฆษณา 2 หน่วย YYYYY11111 จึงหมายถึงโฆษณาแรก และ WWWWW11111 เข้ากับการแมปหน่วยโฆษณาแรก YYYYY22222 และ WWWWW22222 หมายถึงหน่วยโฆษณาที่ 2 และการแมปหน่วยโฆษณา

curl (บรรทัดคำสั่ง)

แทนที่ WWWWWWWWWW ด้วยรหัสการแมปหน่วยโฆษณา รหัสการแมปหน่วยโฆษณา ได้โดยใช้ accounts.adUnits.adUnitMappings.list 

 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"
      }
  }
}

รายการ

แทนที่ pub-XXXXXXXXXXXXXXXX ด้วย ผู้เผยแพร่โฆษณาของคุณ รหัสเพื่อดูกลุ่มสื่อกลาง

curl (บรรทัดคำสั่ง)

ตัวอย่างคำขอ

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)"

ตัวอย่างคำตอบ

{
"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"
      }
    },
  }]
}

แพตช์

ต่อไปนี้คือรายการฟิลด์ มาสก์ เพื่ออัปเดตกลุ่มสื่อกลาง การอัปเดตฟิลด์ที่ซ้ำได้ เช่น รายการใน แทนที่ค่าที่มีอยู่ด้วยค่าใหม่โดยสมบูรณ์ การอัปเดตสำหรับรายบุคคล ซึ่งสามารถทำได้โดยการจัดทำดัชนีด้วยคีย์

ระบบรองรับมาสก์ช่องต่อไปนี้สำหรับการอัปเดตกลุ่มสื่อกลาง

  • targeting.adUnitIds
  • mediationGroupLines[mediationGroupLineId]
  • mediationGroupLines[mediationGroupLineId].state
  • mediationGroupLines[mediationGroupLineId].adUnitMappings[adUnitId]

หากต้องการอัปเดตกลุ่มสื่อกลางด้วยบรรทัดกลุ่มสื่อกลางใหม่ ให้ใช้คอลัมน์ จำนวนลบสำหรับ mediationGroupLineId เพื่ออัปเดตสื่อกลางที่มีอยู่ โปรดอ้างอิงรหัสบรรทัดของกลุ่มสื่อกลางทั้งใน update_mask และ เพย์โหลดดังที่แสดงด้านล่าง

"updateMask" {
    paths: "mediation_group_lines["123"].ad_unit_mappings["456"]"
}

"mediationGroup" {
  "mediationGroupLines": {
   "123": {
     "id": "123"
     "adUnitMappings": {
      "456": "newAdUnitMappingId"
     }
    }
  }
}

curl (บรรทัดคำสั่ง)

ตัวอย่างด้านล่างเพิ่มบรรทัดสื่อกลางใหม่ 3 บรรทัดลงในกลุ่มสื่อกลางที่มีอยู่ updateMask ประกอบด้วยกลุ่มสื่อกลาง 3 บรรทัดที่มีค่าลบที่แตกต่างกัน เป็นค่าตัวยึดตำแหน่ง

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

คุณต้องแปลอักขระพิเศษเนื่องจาก URL ทั้งหมดต้องเป็นไปตาม ไวยากรณ์ที่ระบุโดยข้อกำหนด Uniform Resource Identifier (URI) เพื่อให้ updateMask กลายเป็น:

updateMask=mediationGroupLines%5B%22-1%22%5D,mediationGroupLines%5B%22-2%22%5D,mediationGroupLines%5B%22-3%22%5D

หากต้องการเรียกใช้ตัวอย่างต่อไปนี้ ให้แทนที่ pub-XXXXXXXXXXXXXXXX ด้วย รหัสผู้เผยแพร่โฆษณาและ ZZZZZZZZZZ พร้อมกับรหัสกลุ่มสื่อกลาง สื่อกลาง คุณสามารถดูรหัสกลุ่มได้ใน UI ของ AdMob หรือใช้ accounts.mediationGroups:list

แทนที่ YYYYYYYYYY ด้วยตัวเลข 10 หลักสุดท้ายของหน่วยโฆษณา รหัส โดยมีรูปแบบดังนี้

ca-app-pub-XXXXXXXXXXXXXXXX/YYYYYYYYYY`

แทนที่ WWWWWWWWWW ด้วยรหัสการแมปหน่วยโฆษณา รหัสการแมปหน่วยโฆษณา ได้โดยใช้ accounts.adUnits.adUnitMappings.list 

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