REST Resource: accounts.mediationGroups

แหล่งข้อมูล: กลุ่มสื่อกลาง

อธิบายกลุ่มสื่อกลาง AdMob

การแสดง JSON
{
  "name": string,
  "mediationGroupId": string,
  "displayName": string,
  "targeting": {
    object (MediationGroupTargeting)
  },
  "state": enum (State),
  "mediationGroupLines": {
    string: {
      object (MediationGroupLine)
    },
    ...
  },
  "mediationAbExperimentState": enum (ExperimentState)
}
ช่อง
name

string

ชื่อทรัพยากรสำหรับกลุ่มสื่อกลางนี้ รูปแบบคือ accounts/{publisherId}/MediationGroups/{MediationGroupId} ตัวอย่าง: accounts/pub-9876543210987654/MediationGroups/0123456789

mediationGroupId

string

รหัสของกลุ่มสื่อกลาง เช่น "0123456789" คุณสมบัตินี้เป็นแบบอ่านอย่างเดียว

displayName

string

ชื่อที่ผู้ใช้ระบุสำหรับกลุ่มสื่อกลาง ความยาวสูงสุดที่อนุญาตคือ 120 อักขระ

targeting

object (MediationGroupTargeting)

ชุดเกณฑ์ที่กำหนดเป้าหมายโดยกลุ่มสื่อกลางนี้ เช่น หน่วยโฆษณาและตำแหน่งทางภูมิศาสตร์

state

enum (State)

สถานะของกลุ่มสื่อกลาง ระบบจะแสดงเฉพาะกลุ่มสื่อกลางที่เปิดใช้

mediationGroupLines

map (key: string, value: object (MediationGroupLine))

กลุ่มสื่อกลางที่ใช้เพื่อแสดงสำหรับกลุ่มสื่อกลางนี้

คีย์คือรหัสของบรรทัดกลุ่มสื่อกลาง สำหรับการสร้าง ให้ใช้ค่าลบที่ไม่ซ้ำกันเป็นตัวยึดตำแหน่ง

ออบเจ็กต์ที่มีรายการคู่ "key": value ตัวอย่าง: { "name": "wrench", "mass": "1.3kg", "count": "3" }

mediationAbExperimentState

enum (ExperimentState)

เอาต์พุตเท่านั้น สถานะของการทดสอบ A/B สำหรับสื่อกลางที่อยู่ในกลุ่มสื่อกลางนี้

MediationGroupTargeting

ชุดของเกณฑ์ที่กำหนดเป้าหมายโดยกลุ่มสื่อกลางนี้ เช่น กลุ่มสื่อกลางสามารถกำหนดเป้าหมายรหัสหน่วยโฆษณา แพลตฟอร์ม รูปแบบ และตำแหน่งทางภูมิศาสตร์ที่เฉพาะเจาะจงได้

การแสดง JSON
{
  "platform": string,
  "format": string,
  "adUnitIds": [
    string
  ],
  "targetedRegionCodes": [
    string
  ],
  "excludedRegionCodes": [
    string
  ],
  "idfaTargeting": enum (IdfaTargeting)
}
ช่อง
platform

string

อธิบายแพลตฟอร์มของแอป เช่น "IOS", "Android"

format

string

รูปแบบโฆษณาที่กำหนดเป้าหมายโดยกลุ่มสื่อกลางนี้ เช่น "แบนเนอร์" "เนทีฟ"

adUnitIds[]

string

หน่วยโฆษณาที่กำหนดเป้าหมายโดยกลุ่มสื่อกลางนี้ ตัวอย่างเช่น "ca-app-pub-1234/8790"

targetedRegionCodes[]

string

รหัสประเทศ/ภูมิภาคแบบ Unicode (CLDR) ของสถานที่ตั้ง เช่น "US" ยกเลิกการตั้งค่าว่ากลุ่มสื่อกลางนี้กำหนดเป้าหมายไปยังภูมิภาคที่มีอยู่ทั้งหมดหรือไม่ ดูข้อมูลเพิ่มเติมได้ที่ http://www.unicode.org/reports/tr35/#unicode_region_subtag

excludedRegionCodes[]

string

รหัสประเทศ/ภูมิภาคแบบ Unicode (CLDR) ของสถานที่ตั้ง เช่น "US" ยกเลิกการตั้งค่าหากกลุ่มสื่อกลางนี้ไม่ได้ยกเว้นภูมิภาคใดๆ

idfaTargeting

enum (IdfaTargeting)

คุณสามารถใช้พารามิเตอร์นี้เพื่อกำหนดเป้าหมายคำขอโฆษณาตามความพร้อมใช้งานของ IDFA หากตั้งค่าเป็น "ทั้งหมด" กลุ่มสื่อกลางจะมีผลกับคำขอโฆษณาทั้งหมด (ทั้งที่มีและไม่มี IDFA) หากตั้งค่าเป็น "AVAILABLE" กลุ่มสื่อกลางจะมีผลกับคําขอโฆษณาที่มี IDFA หากตั้งค่าเป็น NOT_AVAILABLE กลุ่มสื่อกลางที่ใช้กับคำขอโฆษณาที่ไม่มี IDFA ไม่จำเป็นต้องระบุสำหรับอุปกรณ์ ANDROID

IdfaTargeting

ความพร้อมใช้งานของ IDFA สำหรับอุปกรณ์ iOS

Enum
IDFA_TARGETING_UNSPECIFIED ค่าเริ่มต้น ค่านี้ไม่ได้ใช้
ALL อุปกรณ์ทั้งหมดจะได้รับการกำหนดเป้าหมายโดยไม่คำนึงถึงความพร้อมใช้งานของ IDFA
AVAILABLE ระบบจะกำหนดเป้าหมายเฉพาะอุปกรณ์ที่มีความพร้อมใช้งาน IDFA
NOT_AVAILABLE ระบบจะกำหนดเป้าหมายเฉพาะอุปกรณ์ที่ไม่มีความพร้อมใช้งานของ IDFA

รัฐ

ประเภทสถานะที่ใช้ได้กับกลุ่มสื่อกลาง

Enum
STATE_UNSPECIFIED ค่าเริ่มต้นสำหรับช่องที่ยังไม่ได้ตั้งค่า โปรดอย่าใช้
ENABLED กลุ่มสื่อกลางนี้ทำงานอยู่และใช้เพื่อแสดงโฆษณาหรือรวบรวมสถิติ
DISABLED กลุ่มสื่อกลางถูกปิดใช้และจะไม่แสดงโฆษณาหรือรวบรวมสถิติอีกต่อไป กลุ่มสื่อกลางที่ปิดใช้แล้วจะเปิดใช้อีกครั้งได้

ExperimentState

สถานะการทดสอบ A/B สำหรับสื่อกลางสำหรับกลุ่มสื่อกลาง

Enum
EXPERIMENT_STATE_UNSPECIFIED ค่าเริ่มต้นสำหรับช่องที่ยังไม่ได้ตั้งค่า โปรดอย่าใช้
RUNNING กลุ่มสื่อกลางมีการทดสอบในสถานะ "ทำงานอยู่"
NOT_RUNNING ไม่มีการทดสอบอยู่ในสถานะ "ทำงาน" ในกลุ่มสื่อกลาง

วิธีการ

create

สร้างกลุ่มสื่อกลางภายใต้บัญชี AdMob ที่เฉพาะเจาะจง

list

แสดงรายการกลุ่มสื่อกลางภายใต้บัญชี AdMob ที่ระบุ

patch

อัปเดตกลุ่มสื่อกลางที่ระบุในบัญชี AdMob ที่ระบุ