ผสานรวม ironSource กับสื่อกลาง

เลือกแพลตฟอร์ม: Android (เบต้า) Android iOS Unity Flutter

คู่มือนี้จะแสดงวิธีใช้ GMA Next-Gen SDK เพื่อโหลดและแสดงโฆษณาจาก ironSource Ads โดยใช้ สื่อกลาง AdMob ซึ่งครอบคลุมการผสานรวมแบบลำดับขั้น โดยจะครอบคลุมวิธีเพิ่ม ironSource Ads ลงในการกำหนดค่าสื่อกลางของหน่วยโฆษณา วิธีตั้งค่าการเพิ่มประสิทธิภาพแหล่งที่มาของโฆษณา และวิธีผสานรวม ironSource Ads SDK และอะแดปเตอร์เข้ากับแอป Android

การผสานรวมและรูปแบบโฆษณาที่รองรับ

อะแดปเตอร์สื่อกลางสำหรับ ironSource Ads มีความสามารถดังนี้

¹ รูปแบบนี้รองรับเฉพาะการผสานรวมแบบลำดับขั้น

ข้อกำหนด

• Android API ระดับ 24 ขึ้นไป

• [สำหรับการเสนอราคา]: หากต้องการผสานรวมรูปแบบโฆษณาที่รองรับทั้งหมดในการเสนอราคา ให้ใช้ IronSource Adapter 8.5.0.1 ขึ้นไป (แนะนำให้ใช้เวอร์ชันล่าสุด)

• GMA Next-Gen SDK เวอร์ชันล่าสุด

• ทำตามคู่มือเริ่มต้นใช้งานสื่อกลางให้เสร็จสมบูรณ์

ขั้นตอนที่ 1: ตั้งค่าการกำหนดค่าใน UI ของ ironSource Ads

ลงชื่อสมัครใช้ และ ลงชื่อเข้าใช้ บัญชี ironSource Ads ของคุณ

เพิ่มแอปใหม่

หากต้องการเพิ่มแอปใหม่ ให้ไปที่โฆษณา > แอป แล้วคลิกเพิ่มแอป

กรอกข้อมูลในแบบฟอร์ม แล้วคลิกเพิ่มแอป

จดคีย์แอป ไว้ จากนั้นเลือกรูปแบบโฆษณาที่แอปของคุณรองรับ แล้ว คลิก ต่อไป

สร้างอินสแตนซ์

จากนั้นกำหนดค่าอินสแตนซ์สำหรับแอปที่คุณเพิ่ม

ไปที่โฆษณา > การตั้งค่า > อินสแตนซ์ เลือกแอป แล้วคลิกสร้างอินสแตนซ์

ค้นหาคีย์ Reporting API ของคุณ

อัปเดต app-ads.txt

ผู้ขายที่ได้รับอนุญาตสำหรับแอป app-ads.txt เป็นความคิดริเริ่มของ IAB Tech Lab ที่ช่วยตรวจสอบว่าคุณจะขายพื้นที่โฆษณาแอปผ่านช่องทางที่คุณได้รับอนุญาตเท่านั้น คุณจะต้องใช้ไฟล์ app-ads.txt เพื่อป้องกันไม่ให้เสียรายได้จากโฆษณาเป็นจำนวนมาก หากยังไม่ได้ดำเนินการ ให้ตั้งค่าไฟล์ app-ads.txt สำหรับแอป

หากต้องการใช้ app-ads.txt สำหรับ ironSource โปรดดู ผู้ค้าปลีกที่ได้รับอนุญาตของ ironSource

เปิดโหมดทดสอบ

ทำตามวิธีการในคู่มือ การทดสอบการผสานรวม ของ ironSource Ads เกี่ยวกับวิธีเปิดใช้โฆษณาทดสอบของ ironSource Ads

ขั้นตอนที่ 2: ตั้งค่าดีมานด์ของ ironSource Ads ใน UI ของ AdMob

กำหนดค่าการตั้งค่าสื่อกลางสำหรับหน่วยโฆษณา

คุณต้องเพิ่ม ironSource Ads ลงในการกำหนดค่าสื่อกลางสำหรับหน่วยโฆษณา

ก่อนอื่น ให้ลงชื่อเข้าใช้บัญชี AdMob จากนั้นไปที่แท็บสื่อกลาง หากมีกลุ่มสื่อกลางอยู่แล้วที่ต้องการแก้ไข ให้คลิกชื่อกลุ่มสื่อกลางนั้นเพื่อแก้ไข แล้วข้ามไปที่ เพิ่ม ironSource Ads เป็นแหล่งที่มาของโฆษณา

หากต้องการสร้างกลุ่มสื่อกลางใหม่ ให้เลือกสร้างกลุ่มสื่อกลาง

ป้อนรูปแบบโฆษณาและแพลตฟอร์ม แล้วคลิกต่อไป

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

เชื่อมโยงกลุ่มสื่อกลางนี้กับหน่วยโฆษณา AdMob ที่มีอยู่อย่างน้อย 1 หน่วย แล้วคลิกเสร็จสิ้น

ตอนนี้คุณควรเห็นการ์ดหน่วยโฆษณาที่แสดงหน่วยโฆษณาที่คุณเลือก

เพิ่ม ironSource Ads เป็นแหล่งที่มาของโฆษณา

การเสนอราคา

ในการ์ดการเสนอราคา ในส่วนแหล่งที่มาของโฆษณา ให้เลือกเพิ่มแหล่งที่มาของโฆษณา จากนั้นเลือก ironSource Ads

คลิก วิธีลงนามในข้อตกลงสำหรับพาร์ทเนอร์ และ ตั้งค่าการเป็นพาร์ทเนอร์การเสนอราคา กับ ironSource Ads.



คลิกรับทราบและยอมรับ แล้วคลิกต่อไป



หากมีการแมปสำหรับ ironSource Ads อยู่แล้ว คุณสามารถเลือกการแมปนั้นได้ หรือคลิกเพิ่มการแมป



จากนั้นป้อน คีย์แอป และ รหัสอินสแตนซ์ ที่ได้รับในส่วนก่อนหน้า แล้วคลิกเสร็จสิ้น

การแสดงวิดีโอตามลำดับขั้น

ในการ์ดการแสดงวิดีโอตามลำดับขั้น ในส่วนแหล่งที่มาของโฆษณา ให้เลือกเพิ่มแหล่งที่มาของโฆษณา

เลือก ironSource Ads แล้วเปิดใช้สวิตช์เพิ่มประสิทธิภาพ ป้อนคีย์ลับ และโทเค็นการรีเฟรช ที่ได้รับในส่วนก่อนหน้าเพื่อตั้งค่าการเพิ่มประสิทธิภาพแหล่งที่มาของโฆษณาสำหรับ ironSource Ads จากนั้นป้อนค่า eCPM สำหรับ ironSource Ads แล้วคลิกต่อไป



หากมีการแมปสำหรับ ironSource Ads อยู่แล้ว คุณสามารถเลือกการแมปนั้นได้ หรือคลิกเพิ่มการแมป

จากนั้นป้อน คีย์แอป และ รหัสอินสแตนซ์ ที่ได้รับในส่วนก่อนหน้า แล้วคลิกเสร็จสิ้น

เพิ่ม ironSource Mobile ลงในรายชื่อพาร์ทเนอร์โฆษณาตามกฎระเบียบ GDPR และกฎระเบียบของรัฐในสหรัฐอเมริกา

ทำตามขั้นตอนในการตั้งค่ากฎระเบียบของยุโรปและการตั้งค่ากฎระเบียบของรัฐในสหรัฐอเมริกาเพื่อเพิ่ม ironSource Mobile ลงในรายชื่อพาร์ทเนอร์โฆษณาตามกฎระเบียบของยุโรปและกฎระเบียบของรัฐในสหรัฐอเมริกาใน UI ของ AdMob

ขั้นตอนที่ 3: นำเข้า ironSource Ads SDK และอะแดปเตอร์

การผสานรวมกับ Android Studio (แนะนำ)

ในไฟล์ settings.gradle.kts ระดับโปรเจ็กต์ ให้เพิ่มที่เก็บต่อไปนี้

dependencyResolutionManagement {
  repositories {
    google()
    mavenCentral()
    maven {
      url = uri("https://android-sdk.is.com/")
    }
  }
}

ในไฟล์ Gradle ระดับแอป ให้เพิ่มทรัพยากร Dependency และการกำหนดค่าการใช้งานต่อไปนี้

dependencies {
    implementation("com.google.android.libraries.ads.mobile.sdk:ads-mobile-sdk:0.25.0-beta01")
    implementation("com.google.ads.mediation:ironsource:9.3.0.1")
}

configurations.configureEach {
    exclude(group = "com.google.android.gms", module = "play-services-ads")
    exclude(group = "com.google.android.gms", module = "play-services-ads-lite")
}

dependencies {
    implementation 'com.google.android.libraries.ads.mobile.sdk:ads-mobile-sdk:0.25.0-beta01'
    implementation 'com.google.ads.mediation:ironsource:9.3.0.1'
}

configurations.configureEach {
    exclude group: 'com.google.android.gms', module: 'play-services-ads'
    exclude group: 'com.google.android.gms', module: 'play-services-ads-lite'
}

การผสานรวมด้วยตนเอง

1. ดาวน์โหลด ironSource Ads Android SDK เวอร์ชันล่าสุด แล้วเพิ่มลงในโปรเจ็กต์

2. ไปที่ อาร์ติแฟกต์อะแดปเตอร์ ironSource Ads ในที่เก็บ Maven ของ Google เลือกเวอร์ชันล่าสุด ดาวน์โหลดไฟล์ .aar ของอะแดปเตอร์ IronSource แล้วเพิ่มลงในโปรเจ็กต์

ขั้นตอนที่ 4: ใช้การตั้งค่าความเป็นส่วนตัวใน ironSource Ads SDK

ความยินยอมจากผู้ใช้ในสหภาพยุโรปและ GDPR

เพื่อปฏิบัติตาม นโยบายความยินยอมของผู้ใช้ EU ของ Google คุณต้องเปิดเผยข้อมูลบางอย่างต่อ ผู้ใช้ในเขตเศรษฐกิจยุโรป (EEA), สหราชอาณาจักร และสวิตเซอร์แลนด์ รวมถึงขอรับ ความยินยอมจากผู้ใช้สำหรับการใช้คุกกี้หรือพื้นที่เก็บข้อมูลอื่นๆ ในเครื่องตามที่กฎหมาย กำหนด และสำหรับการเก็บรวบรวม การแชร์ และการใช้ข้อมูลส่วนตัวเพื่อการปรับโฆษณาตาม โปรไฟล์ของผู้ใช้ นโยบายนี้เป็นผลมาจากข้อกำหนดด้าน ePrivacy และกฎระเบียบให้ความคุ้มครองข้อมูลส่วนบุคคลของผู้บริโภค (GDPR) ของสหภาพยุโรป คุณมีหน้าที่ ตรวจสอบว่ามีการส่งต่อความยินยอมไปยังแหล่งที่มาของโฆษณาแต่ละแห่งใน เชนสื่อกลาง (Mediation Chain) Google ไม่สามารถส่งต่อตัวเลือกความยินยอมของผู้ใช้ไปยังเครือข่ายดังกล่าวโดยอัตโนมัติ

ตั้งแต่ ironSource SDK เวอร์ชัน 7.7.0 เป็นต้นไป ironSource จะอ่านความยินยอมตาม GDPR ที่แพลตฟอร์มการจัดการความยินยอมตั้งค่าไว้โดยอัตโนมัติ ซึ่งรวมถึง UMP SDK และแพลตฟอร์มการจัดการความยินยอมที่รองรับ ข้อกำหนดความยินยอมเพิ่มเติมของ Google ดูข้อมูลเพิ่มเติมได้ที่ การรองรับ Google UMP และ CMP ที่รองรับความยินยอมเพิ่มเติมของ Google

กฎหมายคุ้มครองความเป็นส่วนตัวของรัฐในสหรัฐอเมริกา

กฎหมายคุ้มครองความเป็นส่วนตัวของรัฐในสหรัฐอเมริกา กำหนดให้ผู้ใช้มีสิทธิ์ เลือกไม่รับ "การขาย" "ข้อมูลส่วนบุคคล" ของตน (ตามที่กฎหมายให้คำจำกัดความ ไว้) โดยเว็บไซต์จะต้องให้ตัวเลือกไม่รับการขายผ่านลิงก์ "ไม่อนุญาตให้ขายข้อมูลส่วนบุคคลของฉัน" ที่แสดงไว้อย่างชัดเจนบนหน้าแรกของฝ่ายที่ทำ "การขาย" คู่มือการปฏิบัติตามกฎหมายความเป็นส่วนตัวของรัฐในสหรัฐอเมริกา ช่วยให้คุณเปิดใช้ การประมวลผลข้อมูลแบบจำกัด สำหรับการแสดงโฆษณา Google ได้ แต่ Google ไม่สามารถใช้การตั้งค่านี้กับเครือข่ายโฆษณาแต่ละเครือข่ายในเชนสื่อกลางได้ ดังนั้น คุณต้องระบุเครือข่ายโฆษณาแต่ละเครือข่ายในเชนสื่อกลางที่อาจเข้าร่วมในการขายข้อมูลส่วนบุคคล และทำตามคำแนะนำจากเครือข่ายเหล่านั้นเพื่อให้มั่นใจว่ามีการปฏิบัติตามข้อกำหนด

ใน SDK เวอร์ชัน 6.14.0 ironSource Ads ได้เพิ่ม API เพื่อรองรับกฎระเบียบ CCPA โค้ดตัวอย่างต่อไปนี้แสดงวิธีส่งข้อมูลความยินยอมนี้ไปยัง ironSource Ads SDK คุณต้องตั้งค่าตัวเลือกเหล่านี้ก่อนที่จะ เริ่มต้น GMA Next-Gen SDK เพื่อให้แน่ใจว่าตัวเลือกจะถูกส่งต่ออย่างถูกต้องไปยัง ironSource Ads SDK

LevelPlay.setMetaData("do_not_sell", "true");
IronSourceMediationSnippets.java

LevelPlay.setMetaData("do_not_sell", "true")
IronSourceMediationSnippets.kt

ดูรายละเอียดเพิ่มเติมและค่าที่ระบุได้ในเมธอดได้ที่เอกสารประกอบของ ironSource Ads เกี่ยวกับการตั้งค่าขั้นสูงของกฎระเบียบ

ขั้นตอนที่ 5: เพิ่มโค้ดที่จำเป็น

โหลดโฆษณาด้วยบริบทกิจกรรม

ส่งบริบท Activity เมื่อโหลดรูปแบบโฆษณาแบนเนอร์ โฆษณาคั่นระหว่างหน้า และโฆษณาที่มีการให้รางวัล หากไม่มีบริบทกิจกรรม การโหลดโฆษณาจะล้มเหลว

กฎ Proguard

หากคุณ ลดขนาด ปรับโค้ดให้ยากต่อการอ่าน และเพิ่มประสิทธิภาพแอป ironSource Ads จะกำหนดให้คุณเพิ่มกฎ ProGuard เพิ่มเติมลงในโปรเจ็กต์ ดูข้อมูลเพิ่มเติมได้ใน คู่มือการผสานรวม Android SDK ของ ironSource Ads

ขั้นตอนที่ 6: ทดสอบการติดตั้งใช้งาน

เปิดใช้โฆษณาทดสอบ

ตรวจสอบว่าคุณได้ ลงทะเบียนอุปกรณ์ทดสอบ สำหรับ AdMob และ เปิดใช้โหมดทดสอบใน UI ของ ironSource Ads แล้ว

ยืนยันโฆษณาทดสอบ

หากต้องการยืนยันว่าคุณได้รับโฆษณาทดสอบจาก ironSource Ads ให้เปิดใช้ การทดสอบแหล่งที่มาของโฆษณาแหล่งเดียว ในเครื่องมือตรวจสอบโฆษณาโดยใช้แหล่งที่มาของโฆษณา ironSource Ads (การเสนอราคา) และ ironSource Ads (การแสดงวิดีโอตามลำดับขั้น)

รหัสข้อผิดพลาด

หากอะแดปเตอร์ไม่ได้รับโฆษณาจาก ironSource Ads คุณสามารถตรวจสอบข้อผิดพลาดพื้นฐานจากการตอบกลับของโฆษณาได้โดยใช้ ResponseInfo.getAdSourceResponses() ในคลาสต่อไปนี้

com.google.ads.mediation.ironsource.IronSourceAdapter
com.google.ads.mediation.ironsource.IronSourceRewardedAdapter

ต่อไปนี้คือรหัสและข้อความที่อะแดปเตอร์ ironSource Ads แสดงขึ้นเมื่อโหลดโฆษณาไม่สำเร็จ