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

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

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

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

ข้อกำหนด

  • Unity 4 ขึ้นไป
  • SDK โฆษณาบนอุปกรณ์เคลื่อนที่ของ Google ล่าสุด
  • เพื่อทำให้ใช้งานได้ใน Android
    • Android API ระดับ 19 ขึ้นไป
  • เพื่อทำให้ใช้งานได้ใน 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 เวอร์ชันล่าสุดสำหรับ 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 สำหรับ myTarget เวอร์ชัน 2.1.0 มีเมธอด SetUserConsent() และ SetUserAgeRestricted() โค้ดตัวอย่างต่อไปนี้แสดงวิธีส่งข้อมูลความยินยอมของผู้ใช้ไปยัง myTarget SDK หากคุณเลือกเรียกใช้เมธอดนี้ เราขอแนะนำให้ดำเนินการก่อนส่งคำขอโฆษณาผ่าน Google Mobile Ads SDK

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

MyTarget.SetUserConsent(true);

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

MyTarget.SetUserAgeRestricted(true);

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

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

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

ปลั๊กอินสื่อกลางโฆษณาในอุปกรณ์เคลื่อนที่ของ Google สำหรับ 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 ไม่มีชิ้นงานโฆษณาเนทีฟที่จำเป็น

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

เวอร์ชัน 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 มีการให้รางวัลรุ่นเบต้าแบบเปิดใหม่
  • รองรับอะแดปเตอร์ myTarget Android เวอร์ชัน 5.3.9.0
  • รองรับอะแดปเตอร์ myTarget iOS เวอร์ชัน 5.0.4.0

เวอร์ชัน 2.3.2

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

เวอร์ชัน 2.3.1

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

เวอร์ชัน 2.3.0

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

เวอร์ชัน 2.2.0

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

เวอร์ชัน 2.1.2

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

เวอร์ชัน 2.1.1

  • รองรับอะแดปเตอร์ myTarget Android เวอร์ชัน 5.1.1.0
  • รองรับอะแดปเตอร์ myTarget iOS เวอร์ชัน 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