การแมปหน่วยโฆษณา

การแมปหน่วยโฆษณาคือการกําหนดค่าของบุคคลที่สามซึ่งแมปกับหน่วยโฆษณา AdMob และช่วยให้หน่วยโฆษณาส่งคําขอโฆษณาไปยังเครือข่ายโฆษณาของบุคคลที่สามได้

เมื่อสร้างกลุ่มสื่อกลาง ระบบจะใช้การแมปหน่วยโฆษณาเป็นพารามิเตอร์สําหรับบรรทัดกลุ่มสื่อกลางแต่ละรายการ เพื่อเป็นการตั้งค่าสําหรับหน่วยโฆษณาที่ระบุเพื่อส่งคําขอเครือข่ายโฆษณาของบุคคลที่สาม คุณต้องสร้างการแมปหน่วยโฆษณาแยกต่างหากนอกกลุ่มสื่อกลางและบรรทัดกลุ่มสื่อกลาง ซึ่งต่างจากใน UI ของ AdMob หลังจากสร้างแล้ว คุณสามารถแสดงรายการการแมปหน่วยโฆษณาทั้งหมดและใช้เป็นการพารามิเตอร์เมื่อสร้างหรืออัปเดตบรรทัดกลุ่มสื่อกลางด้วยการแมปหน่วยโฆษณาใหม่

ตัวอย่าง

เมื่อสร้างข้อมูลเข้าสู่ระบบ 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 ทั้งหมด ข้อมูลนี้อาจรวมถึงข้อมูลบัญชี การตั้งค่าพื้นที่โฆษณาและสื่อกลาง รายงาน และข้อมูลอื่นๆ แต่ไม่รวมข้อมูลที่ละเอียดอ่อน เช่น การชำระเงินหรือรายละเอียดของแคมเปญ

เริ่มต้นสร้างการแมปหน่วยโฆษณาแรกโดยทำดังนี้

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

คำขอที่ใช้ curl

  1. โหลดไฟล์รหัสลับไคลเอ็นต์และสร้างข้อมูลเข้าสู่ระบบการให้สิทธิ์

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

    สำหรับการตรวจสอบสิทธิ์และการให้สิทธิ์ เราขอแนะนำให้ใช้ oauth2l ซึ่งเป็นเครื่องมือบรรทัดคำสั่งง่ายๆ สำหรับการทำงานกับ Google OAuth 2.0 ติดตั้ง oauth2l แล้วเรียกใช้คำสั่งด้านล่าง โดยแทนที่ path_to_credentials_json ด้วยเส้นทางไปยังไฟล์ credentials.json ที่คุณดาวน์โหลดเมื่อลงทะเบียนแอปพลิเคชันที่อยู่ในระบบคลาวด์ สำหรับการเรียกใช้ครั้งแรก คำสั่งดังกล่าวจะนำคุณสู่ขั้นตอนการให้สิทธิ์ OAuth 2.0 การเรียกใช้ครั้งต่อๆ ไปจะรีเฟรชโทเค็นโดยอัตโนมัติ

    oauth2l header --json path_to_credentials_json --scope admob.readonly,admob.monetization

  2. แสดงรายการแหล่งที่มาของโฆษณา

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

    curl --http1.0 -X GET https://admob.googleapis.com/v1beta/accounts/pub-XXXXXXXXXXXXXXXX/adSources \
 -H "$(oauth2l header --json path_to_credentials_json --scope admob.readonly)"

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

    {
 "adSources": [
   {
     "name": "accounts/pub-XXXXXXXXXXXXXXXX/adSources/5450213213286189855",
     "adSourceId": "5450213213286189855",
     "title": "AdMob Network",
   }
 ]
}

  3. แสดงรายการอะแดปเตอร์

    แทนที่ SSSSSSSSSSSSSSSSSSSS ด้วยรหัสแหล่งที่มาของโฆษณาสำหรับอะแดปเตอร์ที่สนใจ

    ใช้คำสั่งต่อไปนี้เพื่อดูรายการอะแดปเตอร์

    curl --http1.0 -X GET https://admob.googleapis.com/v1beta/accounts/pub-XXXXXXXXXXXXXXXX/adSources/SSSSSSSSSSSSSSSSSSSS/adapters \
 -H "$(oauth2l header --json path_to_credentials_json --scope admob.readonly)"

    ตัวอย่างการตอบกลับสําหรับแหล่งที่มาของโฆษณาเครือข่าย AdMob ที่มีรหัส 5450213213286189855

    {
 "adapters": [
  {
     "name": "accounts/pub-XXXXXXXXXXXXXXXX/adSources/5450213213286189855/adapters/1",
     "adapterId": "1",
     "title": "AdMob Network Android SDK",
     "platform": "ANDROID",
     "formats": ["BANNER", "INTERSTITIAL",
       "REWARDED", "NATIVE", "REWARDED_INTERSTITIAL", "APP_OPEN"],
     "adapterConfigMetadata": [{
       "adapterConfigMetadataId": "118",
       "adapterConfigMetadataLabel": "Ad unit ID"
     }]
  },
  {
     "name": "accounts/pub-XXXXXXXXXXXXXXXX/adSources/5450213213286189855/adapters/2",
     "adapterId": "2",
     "title": "AdMob Network iOS SDK",
     "platform": "ANDROID",
     "formats": ["BANNER", "INTERSTITIAL",
       "REWARDED", "NATIVE", "REWARDED_INTERSTITIAL", "APP_OPEN"],
     "adapterConfigMetadata": [{
       "adapterConfigMetadataId": "119",
       "adapterConfigMetadataLabel": "Ad unit ID"
     }]
  }]
}

  4. สร้างการแมปหน่วยโฆษณา

    แทนที่ YYYYYYYYYY ด้วยข้อมูลโค้ดเศษของรหัสหน่วยโฆษณา ส่วนของรหัสหน่วยโฆษณาคือตัวเลข 10 หลักสุดท้ายของรหัสหน่วยโฆษณาซึ่งอยู่ในรูปแบบ "ca-app-pub-XXXXXXXXXXXXXXXX/YYYYYYYYYY" ดูวิธีการค้นหารหัสหน่วยโฆษณา

    curl --http1.0 -X POST \
 https://admob.googleapis.com/v1beta/accounts/pub-XXXXXXXXXXXXXXXX/adUnits/YYYYYYYYYY/adUnitMappings \
 -H "$(oauth2l header --json path_to_credentials_json --scope admob.monetization)" \
 -H "Content-Type: application/json" --data @- << EOF
{
   "name": "InMobi ad unit mapping",
   "adapterId": "8",
   "adUnitConfigurations": {
     "174": "inMobiAccountId",
     "176": "inMobiPlacementId"
   }
}
EOF

  5. แสดงรายการการแมปหน่วยโฆษณาทั้งหมด

    แทนที่ YYYYYYYYYY ด้วยข้อมูลโค้ดเศษของรหัสหน่วยโฆษณา ส่วนของรหัสหน่วยโฆษณาคือตัวเลข 10 หลักสุดท้ายของรหัสหน่วยโฆษณาจากรูปแบบ "ca-app-pub-XXXXXXXXXXXXXXXX/YYYYYYYYYY" ดูวิธีการค้นหารหัสหน่วยโฆษณา

     curl --http1.0 -X GET \
 https://admob.googleapis.com/v1beta/accounts/pub-XXXXXXXXXXXXXXXX/adUnits/YYYYYYYYYY/adUnitMappings \
 -H "$(oauth2l header --json path_to_credentials_json --scope admob.readonly)"

    {
 "adUnitMappingName":
 "accounts/pub-XXXXXXXXXXXXXXXX/adUnits/YYYYYYYYYY/adUnitMappings/ZZZZZZZZZZ"
   {
     "adapterId": "1",
     "state": "ENABLED",
     "adUnitConfigurations": {
       "adUnitMappingConfigurationKey": "adUnitId",
       "adUnitMappingConfigurationValue": "118",
     }
   }
}