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

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