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

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

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

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

ข้อกำหนด

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

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

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

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

Android

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

iOS

จากนั้นระบุ URL ของ iTunes** สำหรับแอป

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

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

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

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

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

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

เนทีฟ

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

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

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

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

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

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

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

Android

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

iOS

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

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

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

OpenUPM-CLI

หากติดตั้ง OpenUPM-CLI แล้ว คุณสามารถติดตั้งปลั๊กอินสื่อกลาง myTarget ของ Google Mobile Ads สําหรับ Unity ลงในโปรเจ็กต์ได้โดยเรียกใช้คําสั่งต่อไปนี้จากไดเรกทอรีรูทของโปรเจ็กต์

openupm add com.google.ads.mobile.mediation.mytarget

OpenUPM

ในตัวแก้ไขโปรเจ็กต์ Unity ให้เลือกแก้ไข > การตั้งค่าโปรเจ็กต์ > เครื่องมือจัดการแพ็กเกจเพื่อเปิด การตั้งค่าเครื่องมือจัดการแพ็กเกจ Unity

ในแท็บ Scoped Registries ให้เพิ่ม OpenUPM เป็นรีจิสทรีที่กำหนดขอบเขตด้วยตัวเลือก รายละเอียดต่อไปนี้

  • ชื่อ: OpenUPM
  • URL: https://package.openupm.com
  • ขอบเขต: com.google

รายละเอียด OpenUPM

จากนั้นไปที่หน้าต่าง > เครื่องมือจัดการแพ็กเกจเพื่อเปิด ตัวจัดการแพ็กเกจ Unity และ เลือก My Registries จากเมนูแบบเลื่อนลง

รีจิสทรี Unity

เลือกแพ็กเกจสื่อกลาง myTarget ของ Google Mobile Ads แล้วคลิกติดตั้ง

ติดตั้งจาก OpenUPM

แพ็กเกจ Unity

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

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

นำเข้าจาก Unity

จากนั้นเลือกชิ้นงาน > เครื่องมือจัดการทรัพยากร Dependency ภายนอก > ตัวแก้ไข Android > บังคับให้แก้ไข เครื่องมือจัดการการขึ้นต่อกันภายนอก ไลบรารีจะดำเนินการแก้ไขทรัพยากร Dependency ใหม่ตั้งแต่ต้นและคัดลอก ทรัพยากร Dependency ที่ประกาศลงในไดเรกทอรี Assets/Plugins/Android ของ แอป Unity

บังคับแก้ไข

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

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

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

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

MyTarget.SetUserConsent(true);

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

MyTarget.SetUserAgeRestricted(true);

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

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

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

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

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

เวอร์ชัน 3.18.1

เวอร์ชัน 3.18.0

เวอร์ชัน 3.17.1

เวอร์ชัน 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

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

เวอร์ชัน 2.3.2

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

เวอร์ชัน 2.3.1

  • รองรับอะแดปเตอร์ Android ของ myTarget เวอร์ชัน 5.2.5.0
  • รองรับอะแดปเตอร์ iOS ของ myTarget เวอร์ชัน 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() เพื่อส่งต่อสถานะความยินยอมของผู้ใช้ไปยัง SDK ของ MyTarget
    • 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