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

การแมปหน่วยโฆษณาคือการตั้งค่าการกำหนดค่าของบุคคลที่สามที่แมปกับหน่วยโฆษณา 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",
        }
      }
   }