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

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

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

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

ข้อกำหนด

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

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

ก่อนอื่น ให้ลงชื่อสมัครใช้หรือลงชื่อเข้าสู่ระบบบัญชี myTarget ไปที่หน้าแอปโดยคลิก APPS ในส่วนหัว เพิ่มแอปโดยคลิกเพิ่มแอป

หากแอปรองรับทั้งแพลตฟอร์ม Android และ iOS คุณต้องตั้งค่าแพลตฟอร์มแต่ละอย่างแยกกัน

Android

ถัดไป ให้ระบุ URL ของ Google Play สำหรับแอปของคุณ

iOS

ถัดไป ให้ระบุ URL ของ iTunes** สำหรับแอปของคุณ

เมื่อเพิ่มแอป myTarget กำหนดให้คุณต้องสร้างหน่วยโฆษณาก่อน จึงจะทำขั้นตอนให้เสร็จสมบูรณ์ได้

เลือกBANNERจากรูปแบบโฆษณาที่มี แล้วคลิกปุ่มBANNER

โฆษณาคั่นระหว่างหน้า

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

ได้รับรางวัลแล้ว

เลือกวิดีโอที่มีการให้รางวัลจากรูปแบบโฆษณาที่มี แล้วคลิกปุ่มเพิ่มหน่วยโฆษณา

เนทีฟ

เลือก NATIVE จากรูปแบบโฆษณาที่มี แล้วคลิกเพิ่มหน่วยโฆษณา

ในหน้ารายละเอียดของหน่วยโฆษณา ให้จดบันทึกรหัสช่องโฆษณาซึ่งจะอยู่ในการตั้งค่าหน่วยโฆษณาเป็น slot_id รหัสช่องโฆษณานี้จะใช้เพื่อตั้งค่า AdMob หน่วยโฆษณาในส่วนถัดไป

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

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

ทำตามวิธีการในเอกสารประกอบของ myTarget เพื่อเพิ่มและกำหนดค่าอุปกรณ์ทดสอบใน myTarget UI

ขั้นตอนที่ 2: ตั้งค่าความต้องการ myTarget ใน AdMob UI

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

Android

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

iOS

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

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

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

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

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

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

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

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

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

ปลั๊กอินสื่อกลางโฆษณา Google Mobile สำหรับ myTarget เวอร์ชัน 2.1.0 ประกอบด้วย SetUserConsent() และ SetUserAgeRestricted() เมธอด ตัวอย่างต่อไปนี้ แสดงวิธีส่งข้อมูลความยินยอมของผู้ใช้ไปยัง myTarget SDK หากคุณ เลือกที่จะเรียกใช้วิธีนี้ ขอแนะนำให้คุณดำเนินการก่อนที่จะส่งคำขอ ผ่าน SDK โฆษณาในอุปกรณ์เคลื่อนที่ของ Google

using GoogleMobileAds.Api.Mediation.MyTarget;
// ...

MyTarget.SetUserConsent(true);

หากผู้ใช้ทราบว่าผู้ใช้อยู่ในหมวดหมู่ที่จำกัดอายุผู้ชม คุณยังสามารถเรียกใช้ SetUserAgeRestricted() วิธี

MyTarget.SetUserAgeRestricted(true);

ดูของ myTarget คู่มือความเป็นส่วนตัวและ GDPR เพื่อดูข้อมูลเพิ่มเติม

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

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

ปลั๊กอินสื่อกลางโฆษณา Google Mobile สำหรับ myTarget เวอร์ชัน 3.13.3 ประกอบด้วย SetCCPAUserConsent(bool) วิธี โค้ดตัวอย่างต่อไปนี้แสดงวิธีผ่าน ข้อมูลความยินยอมของผู้ใช้ไปยัง myTarget SDK หากคุณเลือกที่จะเรียกใช้วิธีนี้ เราขอแนะนำให้คุณทำก่อนที่จะขอโฆษณาผ่านบัญชี Google SDK โฆษณาในอุปกรณ์เคลื่อนที่

using GoogleMobileAds.Api.Mediation.MyTarget;
// ...

MyTarget.SetCCPAUserConsent(true);

ติดต่อฝ่ายสนับสนุนของ myTarget สำหรับ ข้อมูลเพิ่มเติม

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

Android

ไม่ต้องมีโค้ดเพิ่มเติมสำหรับการผสานรวม myTarget

iOS

การผสานรวม SKAdNetwork

ทำตามเอกสารประกอบของ myTarget เพื่อเพิ่มตัวระบุ SKAdNetwork ลงในไฟล์ Info.plist ของโปรเจ็กต์

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

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

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

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

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

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

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

Android

com.google.ads.mediation.mytarget.MyTargetAdapter
com.google.ads.mediation.mytarget.MyTargetNativeAdapter
com.google.ads.mediation.mytarget.MyTargetRewardedAdapter

iOS

GADMAdapterMyTarget
GADMediationAdapterMyTargetNative
GADMediationAdapterMyTargetRewarded

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

Android

รหัสข้อผิดพลาด เหตุผล
100 myTarget SDK แสดงผลข้อผิดพลาด
101 พารามิเตอร์เซิร์ฟเวอร์ myTarget ที่กำหนดค่าใน AdMob UI ขาดหายไป/ไม่ถูกต้อง
102 ขนาดโฆษณาที่ขอไม่ตรงกับขนาดแบนเนอร์ที่ myTarget รองรับ
103 คำขอโฆษณาไม่ใช่คำขอโฆษณาเนทีฟแบบรวม
104 โฆษณาเนทีฟที่โหลดจาก myTarget แตกต่างจากโฆษณาเนทีฟที่ขอ
105 โฆษณาเนทีฟที่โหลดจาก myTarget ขาดเนื้อหาที่จำเป็นบางอย่าง (เช่น รูปภาพหรือไอคอน)

iOS

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

บันทึกการเปลี่ยนแปลงปลั๊กอิน myTarget Unity Mediation

เวอร์ชันถัดไป

  • เปลี่ยนชื่อ DummyClient เป็น PlaceholderClient แล้ว

เวอร์ชัน 3.17.0

เวอร์ชัน 3.16.2

เวอร์ชัน 3.16.1

เวอร์ชัน 3.16.0

เวอร์ชัน 3.15.0

เวอร์ชัน 3.14.0

เวอร์ชัน 3.13.2

เวอร์ชัน 3.13.1

เวอร์ชัน 3.13.0

เวอร์ชัน 3.12.0

เวอร์ชัน 3.11.4

เวอร์ชัน 3.11.3

เวอร์ชัน 3.11.2

เวอร์ชัน 3.11.1

เวอร์ชัน 3.11.0

เวอร์ชัน 3.10.2

เวอร์ชัน 3.10.1

เวอร์ชัน 3.10.0

เวอร์ชัน 3.9.0

เวอร์ชัน 3.8.2

เวอร์ชัน 3.8.1

เวอร์ชัน 3.8.0

เวอร์ชัน 3.7.0

เวอร์ชัน 3.6.1

เวอร์ชัน 3.6.0

เวอร์ชัน 3.5.2

เวอร์ชัน 3.5.1

เวอร์ชัน 3.5.0

เวอร์ชัน 3.4.0

เวอร์ชัน 3.3.0

เวอร์ชัน 3.2.0

เวอร์ชัน 3.1.0

เวอร์ชัน 3.0.0

  • อัปเดตปลั๊กอินให้รองรับ มีการให้รางวัล API เวอร์ชันเบต้าแบบเปิดใหม่
  • รองรับอะแดปเตอร์ Android ของ myTarget เวอร์ชัน 5.3.9.0
  • รองรับอะแดปเตอร์ iOS เวอร์ชัน 5.0.4.0 ของฉัน

เวอร์ชัน 2.3.2

  • รองรับอะแดปเตอร์ Android ของ myTarget เวอร์ชัน 5.2.5.0
  • รองรับอะแดปเตอร์ iOS เวอร์ชัน 4.8.9.0 ของฉัน

เวอร์ชัน 2.3.1

  • รองรับอะแดปเตอร์ Android ของ myTarget เวอร์ชัน 5.2.5.0
  • รองรับอะแดปเตอร์ iOS เวอร์ชัน 4.8.5.0 ของฉัน

เวอร์ชัน 2.3.0

  • รองรับอะแดปเตอร์ Android ของ myTarget เวอร์ชัน 5.2.2.0
  • รองรับอะแดปเตอร์ iOS ของ myTarget เวอร์ชัน 4.8.0.0

เวอร์ชัน 2.2.0

  • รองรับอะแดปเตอร์ Android ของ myTarget เวอร์ชัน 5.1.4.0
  • รองรับอะแดปเตอร์ iOS ของ myTarget เวอร์ชัน 4.8.0.0

เวอร์ชัน 2.1.2

  • รองรับอะแดปเตอร์ Android ของ myTarget เวอร์ชัน 5.1.3.0
  • รองรับอะแดปเตอร์ iOS ของ myTarget เวอร์ชัน 4.7.11.0

เวอร์ชัน 2.1.1

  • รองรับอะแดปเตอร์ Android ของ myTarget เวอร์ชัน 5.1.1.0
  • รองรับอะแดปเตอร์ iOS ของ myTarget เวอร์ชัน 4.7.10.0

เวอร์ชัน 2.1.0

  • รองรับ myTarget Android SDK เวอร์ชัน 5.1.0
  • รองรับ myTarget iOS SDK เวอร์ชัน 4.7.9
  • เพิ่มวิธีการต่อไปนี้
    • MyTarget.SetUserConsent() เพื่อส่งต่อสถานะความยินยอมของผู้ใช้ไปยัง MyTarget SDK
    • MyTarget.SetUserAgeRestricted ที่ตั้งค่าแฟล็กเพื่อระบุว่าผู้ใช้อยู่ในหมวดหมู่ที่จำกัดอายุผู้ชมหรือไม่ (เช่น มีอายุต่ำกว่า 16 ปี)
    • MyTarget.IsUserConsent() วิธีดูสถานะความยินยอมปัจจุบันของผู้ใช้
    • MyTarget.IsUserAgeRestricted() เพื่อดูการแจ้งว่าไม่เหมาะสมที่ระบุว่าผู้ใช้อยู่ในหมวดหมู่ที่จำกัดอายุผู้ชม (เช่น มีอายุต่ำกว่า 16 ปี)

เวอร์ชัน 2.0.1

  • รองรับ myTarget Android SDK เวอร์ชัน 5.0.2
  • รองรับ myTarget iOS SDK เวอร์ชัน 4.7.8

เวอร์ชัน 2.0.0

  • รองรับ myTarget Android SDK เวอร์ชัน 5.0.0
  • รองรับ myTarget iOS SDK เวอร์ชัน 4.7.7

เวอร์ชัน 1.1.0

  • รองรับ myTarget Android SDK เวอร์ชัน 4.7.2
  • รองรับ myTarget iOS SDK เวอร์ชัน 4.7.6

เวอร์ชัน 1.0.0

  • เปิดตัวครั้งแรก
  • รองรับ myTarget Android SDK เวอร์ชัน 4.6.27
  • รองรับ myTarget iOS SDK เวอร์ชัน 4.6.24