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

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

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

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

การผสานรวม
การเสนอราคา  1
น้ำตก
รูปแบบ
แบนเนอร์  2
โฆษณาคั่นระหว่างหน้า
ได้รับรางวัลแล้ว
โฆษณาคั่นระหว่างหน้าที่มีการให้รางวัล  2

1 การผสานรวมการเสนอราคาอยู่ใน รุ่นเบต้าแบบจำกัดผู้ใช้งาน โปรดติดต่อผู้จัดการฝ่ายดูแลลูกค้าเพื่อขอสิทธิ์เข้าถึง

2 รูปแบบนี้เท่านั้น ได้รับการรองรับในการผสานรวม Waterfall

ข้อกำหนด

  • SDK โฆษณาในอุปกรณ์เคลื่อนที่ของ Google เวอร์ชันล่าสุด
  • Unity 4 ขึ้นไป
  • เพื่อทำให้ใช้งานได้ใน Android
    • API ของ Android ระดับ 21 ขึ้นไป
  • เพื่อทำให้ใช้งานได้บน iOS
    • เป้าหมายการติดตั้งใช้งาน iOS 12.0 ขึ้นไป
  • โปรเจ็กต์ที่ Unity กำลังทำงานซึ่งกำหนดค่าด้วย Google SDK โฆษณาในอุปกรณ์เคลื่อนที่ โปรดดู เริ่มต้นใช้งานเพื่อดูรายละเอียด
  • ดำเนินการสื่อกลางให้เสร็จสิ้น คู่มือเริ่มต้นใช้งาน

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

Sign up and sign in to your ironSource Ads account.

To add your application to the ironSource Ads dashboard, click the New App button.

Enter app details

Select Live App, enter the URL of your app, and click Import App Info.

If your app is not available, select App Not Live in the Application Store and provide a Temporary Name for your app. Select your platform.

Fill out the rest of the form and click Add App.

Take note of your new App Key, which is displayed after the app has been added. You will need this value for setting up your AdMob ad unit ID. Select the ad formats your app supports. Then click Continue.

Android

iOS

Create instance

Next, configure a network instance for the app you added.

Bidding

Navigate to LevelPlay > Setup > SDK networks, then select your app. Under Bidding, click the edit icon to view the bidding instance ID.

Android

iOS

Take note of the Instance ID.

Android

iOS

Waterfall

Navigate to Ads > Setup > Instances. Select the app and click Create Instance.

Enter the necessary details and click Save and close.

Once the instance is created, the Instance ID is listed in the Instance ID field.

Locate your Reporting API Key

Bidding

This step isn't required for bidding integrations.

Waterfall

In addition to the App Key and Instance ID, you'll also need your ironSource Ads Secret Key and Refresh Token to set up your AdMob ad unit ID.

Navigate to My Account in your ironSource Ads publisher dashboard then click the API tab. Take note of your Secret Key and Refresh Token.

Turn on test mode

Follow the instructions in ironSource Ads's Integration testing guide on how to enable ironSource Ads test ads.

ขั้นตอนที่ 2: ตั้งค่าดีมานด์โฆษณาใน AdMob UI

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

Android

ดูวิธีการได้ที่ขั้นตอนที่ 2 ในคู่มือสําหรับ Android

iOS

โปรดดูวิธีการในขั้นตอนที่ 2 ในคู่มือสำหรับ iOS

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

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

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

ดาวน์โหลดปลั๊กอินสื่อกลางโฆษณาในอุปกรณ์เคลื่อนที่ของ Google เวอร์ชันล่าสุดสำหรับ ironSource โฆษณาจากลิงก์ดาวน์โหลดใน Changelog และดึงข้อมูล GoogleMobileAdsIronSourceMediation.unitypackage จากไฟล์ ZIP

ในเครื่องมือแก้ไขโปรเจ็กต์ Unity ให้เลือกเนื้อหา > นำเข้าแพ็กเกจ > กำหนดเอง แพ็กเกจ แล้วค้นหาไฟล์ GoogleMobileAdsIronSourceMediation.unitypackage ที่คุณดาวน์โหลด ตรวจสอบว่าได้เลือกไฟล์ทั้งหมดแล้ว และคลิกนำเข้า

จากนั้นเลือกชิ้นงาน > ตัวแก้ไขบริการ Google Play > รีโซลเวอร์ Android > แรง แก้ปัญหา ไลบรารีตัวแปลค่าบริการ Unity Play จะดำเนินการ Dependency แก้ไขตั้งแต่ต้นและคัดลอกทรัพยากร Dependency ที่ประกาศไว้ไปยัง ไดเรกทอรี Assets/Plugins/Android ของแอป Unity

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

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

ปลั๊กอินสื่อกลางโฆษณาในอุปกรณ์เคลื่อนที่ของ Google สำหรับโฆษณา ironSource เวอร์ชัน 1.0.0 วันที่ ประกอบด้วย IronSource.SetConsent() โค้ดตัวอย่างต่อไปนี้แสดงวิธีผ่าน ข้อมูลความยินยอมต่อ ironSource Ads SDK หากคุณเลือกที่จะโทรถึง เราขอแนะนำให้คุณดำเนินการก่อนที่จะขอโฆษณาผ่าน SDK โฆษณาในอุปกรณ์เคลื่อนที่ของ Google

using GoogleMobileAds.Api.Mediation.IronSource;
// ...

IronSource.SetConsent(true);

ดูเอกสารประกอบของ ironSource Ads ใน การตั้งค่าขั้นสูงสำหรับกฎระเบียบ เพื่อดูรายละเอียดเพิ่มเติม

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

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

ปลั๊กอินสื่อกลางโฆษณาในอุปกรณ์เคลื่อนที่ของ Google สำหรับโฆษณา ironSource เวอร์ชัน 2.2.4 วันที่ ประกอบด้วย IronSource.SetMetaData() โค้ดตัวอย่างต่อไปนี้แสดงวิธีผ่าน ข้อมูลความยินยอมต่อ ironSource Ads SDK ต้องตั้งค่าตัวเลือกเหล่านี้ก่อน คุณเริ่มต้นโฆษณาบนมือถือของ Google SDK เพื่อให้แน่ใจว่าจะมีการส่งต่อ URL ไปยัง ironSource Ads SDK อย่างถูกต้อง

using GoogleMobileAds.Api.Mediation.IronSource;
// ...

IronSource.SetMetaData("do_not_sell", "true");

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

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

Android

กฎ Proguard

หากคุณย่อ ปรับให้ยากต่อการอ่าน (Obfuscate) และเพิ่มประสิทธิภาพแอป โฆษณา IronSource ต้องใช้กฎ ProGuard เพิ่มเติมสำหรับโปรเจ็กต์ของคุณ

เมื่อสร้างโปรเจ็กต์ ให้เลือก Android เป็นแพลตฟอร์ม จากนั้นให้ทำดังนี้ เปิดการตั้งค่าโปรแกรมเล่น แล้วเลือกไฟล์ User Proguard ใต้ การตั้งค่าการเผยแพร่ โดย Unity ควรแสดงตำแหน่งที่โค้ด สร้างไฟล์ proguard-user.txt ไฟล์เพื่อให้คุณแก้ไขแล้ว

ไฟล์ User Proguard ของ Unity

ปรึกษา คู่มือการผสานรวม Android SDK ของโฆษณา IronSource เพื่อดูข้อมูลเพิ่มเติมเกี่ยวกับกฎ ProGuard ที่จำเป็นสำหรับโปรเจ็กต์ของคุณ แล้วเพิ่มกฎเหล่านั้นลงในไฟล์ proguard-user.txt

iOS

การผสานรวม SKAdNetwork

ทำตามเอกสารประกอบของโฆษณา ironSource เพื่อเพิ่มตัวระบุ SKAdNetwork ลงใน Info.plist ของโครงการ

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

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

อย่าลืม ลงทะเบียนอุปกรณ์ทดสอบ สำหรับ AdMob และเปิดใช้โหมดทดสอบใน IronSource UI

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

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

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

หากอะแดปเตอร์ไม่ได้รับโฆษณาจาก ironSource Ads ผู้เผยแพร่โฆษณาสามารถตรวจสอบ ข้อผิดพลาดที่แท้จริงจากการตอบกลับโฆษณาโดยใช้ ResponseInfo ภายใต้ ชั้นเรียนต่อไปนี้

Android

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

iOS

GADMAdapterIronSource
GADMAdapterIronSourceRewarded

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

Android

รหัสข้อผิดพลาด เหตุผล
101 พารามิเตอร์เซิร์ฟเวอร์ ironSource Ads ที่กำหนดค่าใน AdMob UI ขาดหายไป/ไม่ถูกต้อง
102 โฆษณา ironSource จำเป็นต้องมีบริบทกิจกรรมเพื่อเริ่มต้น SDK
103 โฆษณา ironSource สามารถโหลดโฆษณาได้เพียง 1 รายการต่อรหัสอินสแตนซ์ ironSource
105 โฆษณา ironSource ไม่สนับสนุนขนาดโฆษณาแบนเนอร์ที่ขอ
106 ironSource Ads SDK ไม่เริ่มต้น
501-1056 ข้อผิดพลาดของ SDK โฆษณา ironSource ดูเอกสารประกอบ เพื่อดูรายละเอียดเพิ่มเติม

iOS

รหัสข้อผิดพลาด เหตุผล
101 พารามิเตอร์เซิร์ฟเวอร์ ironSource Ads ที่กำหนดค่าใน AdMob UI ขาดหายไป/ไม่ถูกต้อง
102 อะแดปเตอร์โฆษณา ironSource ไม่สนับสนุนรูปแบบโฆษณาที่ร้องขอ
103 โหลดโฆษณา ironSource สำหรับการกำหนดค่าเครือข่ายนี้แล้ว
104 โฆษณา ironSource ไม่สนับสนุนขนาดโฆษณาแบนเนอร์ที่ขอ
508-1037 ข้อผิดพลาดของ SDK โฆษณา ironSource ดูเอกสารประกอบ เพื่อดูรายละเอียดเพิ่มเติม

บันทึกการเปลี่ยนแปลงปลั๊กอินของสื่อกลาง IronSource Unity

เวอร์ชัน 3.2.1

เวอร์ชัน 3.2.0

เวอร์ชัน 3.1.1

เวอร์ชัน 3.1.0

เวอร์ชัน 3.0.1

เวอร์ชัน 3.0.0

เวอร์ชัน 2.6.1

เวอร์ชัน 2.6.0

เวอร์ชัน 2.5.0

เวอร์ชัน 2.4.0

เวอร์ชัน 2.3.1

เวอร์ชัน 2.3.0

เวอร์ชัน 2.2.7

เวอร์ชัน 2.2.6

เวอร์ชัน 2.2.5

เวอร์ชัน 2.2.4

เวอร์ชัน 2.2.3

เวอร์ชัน 2.2.2

เวอร์ชัน 2.2.1

เวอร์ชัน 2.2.0

เวอร์ชัน 2.1.5

เวอร์ชัน 2.1.4

เวอร์ชัน 2.1.3

เวอร์ชัน 2.1.2

เวอร์ชัน 2.1.1

เวอร์ชัน 2.1.0

เวอร์ชัน 2.0.3

เวอร์ชัน 2.0.2

เวอร์ชัน 2.0.1

เวอร์ชัน 2.0.0

เวอร์ชัน 1.10.0

เวอร์ชัน 1.9.1

เวอร์ชัน 1.9.0

เวอร์ชัน 1.8.2

เวอร์ชัน 1.8.1

เวอร์ชัน 1.8.0

เวอร์ชัน 1.7.0

เวอร์ชัน 1.6.0

เวอร์ชัน 1.5.0

เวอร์ชัน 1.4.0

เวอร์ชัน 1.3.2

เวอร์ชัน 1.3.1

  • รองรับอะแดปเตอร์ Android IronSource เวอร์ชัน 6.10.0.0
  • รองรับอะแดปเตอร์ iOS IronSource เวอร์ชัน 6.8.6.0

เวอร์ชัน 1.3.0

  • รองรับอะแดปเตอร์ Android IronSource เวอร์ชัน 6.10.0.0
  • รองรับอะแดปเตอร์ iOS เวอร์ชัน 6.8.4.1.0

เวอร์ชัน 1.2.0

  • รองรับอะแดปเตอร์ Android IronSource เวอร์ชัน 6.9.0.1
  • รองรับอะแดปเตอร์ iOS เวอร์ชัน 6.8.4.1.0

เวอร์ชัน 1.1.2

  • รองรับอะแดปเตอร์ Android IronSource เวอร์ชัน 6.8.4.1
  • รองรับอะแดปเตอร์ iOS IronSource เวอร์ชัน 6.8.4.1

เวอร์ชัน 1.1.1

  • รองรับอะแดปเตอร์ Android IronSource เวอร์ชัน 6.8.4.1
  • รองรับอะแดปเตอร์ iOS IronSource เวอร์ชัน 6.8.3.0

เวอร์ชัน 1.1.0

  • อัปเดตปลั๊กอินให้รองรับ มีการให้รางวัล API เวอร์ชันเบต้าแบบเปิดใหม่
  • รองรับอะแดปเตอร์ Android IronSource เวอร์ชัน 6.8.1.2
  • รองรับอะแดปเตอร์ iOS เวอร์ชัน 6.8.0.1

เวอร์ชัน 1.0.4

  • รองรับอะแดปเตอร์ Android IronSource เวอร์ชัน 6.7.11.0
  • รองรับอะแดปเตอร์ iOS IronSource เวอร์ชัน 6.7.11.0

เวอร์ชัน 1.0.3

  • รองรับอะแดปเตอร์ Android IronSource เวอร์ชัน 6.7.10.0
  • รองรับอะแดปเตอร์ iOS IronSource เวอร์ชัน 6.7.10.0

เวอร์ชัน 1.0.2

  • รองรับอะแดปเตอร์ Android IronSource เวอร์ชัน 6.7.9.1.1
  • รองรับอะแดปเตอร์ iOS IronSource เวอร์ชัน 6.7.10.0
  • แก้ไขความขัดแย้งกับปลั๊กอินสื่อกลาง Chartboost Unity

เวอร์ชัน 1.0.1

  • รองรับอะแดปเตอร์ Android IronSource เวอร์ชัน 6.7.9.0
  • รองรับอะแดปเตอร์ iOS เวอร์ชัน 6.7.9.2.0

เวอร์ชัน 1.0.0

  • เปิดตัวครั้งแรก
  • รองรับอะแดปเตอร์ Android IronSource เวอร์ชัน 6.7.9.0
  • รองรับอะแดปเตอร์ iOS IronSource เวอร์ชัน 6.7.9.1.0