คู่มือนี้จะแสดงวิธีใช้ 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
ความยินยอมของสหภาพยุโรปและ GDPR
ภายใต้นโยบายความยินยอมของผู้ใช้ 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
- รองรับอะแดปเตอร์ myTarget Android เวอร์ชัน 5.20.0.0
- รองรับอะแดปเตอร์ myTarget iOS เวอร์ชัน 5.20.1.0
- สร้างและทดสอบด้วย Google Mobile Ads Unity Plugin เวอร์ชัน 8.7.0
เวอร์ชัน 3.14.0
- รองรับอะแดปเตอร์ myTarget Android เวอร์ชัน 5.18.0.0
- รองรับอะแดปเตอร์ myTarget iOS เวอร์ชัน 5.19.0.0
- สร้างและทดสอบด้วย Google Mobile Ads Unity Plugin เวอร์ชัน 8.5.0
เวอร์ชัน 3.13.2
- รองรับอะแดปเตอร์ myTarget Android เวอร์ชัน 5.16.5.0
- รองรับอะแดปเตอร์ myTarget iOS เวอร์ชัน 5.17.5.0
- สร้างและทดสอบด้วย Google Mobile Ads Unity Plugin เวอร์ชัน 8.3.0
เวอร์ชัน 3.13.1
- ย้ายเนื้อหาของอะแดปเตอร์ไปที่
GoogleMobileAds/Mediation/MyTarget/
แล้ว - เนมสเปซของอะแดปเตอร์ที่มีการเปลี่ยนโครงสร้างภายในเพื่อใช้
GoogleMobileAds.Mediation.MyTarget
- รองรับอะแดปเตอร์ myTarget Android เวอร์ชัน 5.16.4.1
- รองรับอะแดปเตอร์ myTarget iOS เวอร์ชัน 5.17.4.0
- สร้างและทดสอบด้วย Google Mobile Ads Unity Plugin เวอร์ชัน 8.1.0
เวอร์ชัน 3.13.0
- รองรับอะแดปเตอร์ myTarget Android เวอร์ชัน 5.16.4.0
- รองรับอะแดปเตอร์ myTarget iOS เวอร์ชัน 5.17.4.0
- สร้างและทดสอบด้วย Google Mobile Ads Unity Plugin เวอร์ชัน 8.0.0
เวอร์ชัน 3.12.0
- รองรับอะแดปเตอร์ myTarget Android เวอร์ชัน 5.15.5.0
- รองรับอะแดปเตอร์ myTarget iOS เวอร์ชัน 5.16.0.0
- สร้างและทดสอบด้วย Google Mobile Ads Unity Plugin เวอร์ชัน 7.3.0
เวอร์ชัน 3.11.4
- รองรับอะแดปเตอร์ myTarget Android เวอร์ชัน 5.15.4.0
- รองรับอะแดปเตอร์ myTarget iOS เวอร์ชัน 5.15.2.0
- สร้างและทดสอบด้วย Google Mobile Ads Unity Plugin เวอร์ชัน 7.2.0
เวอร์ชัน 3.11.3
- เปลี่ยนชื่อเมธอด
IsConsent()
จากคลาสMyTarget
เป็นGetUserConsent()
- เพิ่มเมธอดต่อไปนี้ไปยังคลาส
MyTarget
SetCCPAUserConsent(bool)
GetCCPAUserConsent()
- รองรับอะแดปเตอร์ myTarget Android เวอร์ชัน 5.15.3.0
- รองรับอะแดปเตอร์ myTarget iOS เวอร์ชัน 5.15.2.0
- สร้างและทดสอบด้วย Google Mobile Ads Unity Plugin เวอร์ชัน 7.2.0
เวอร์ชัน 3.11.2
- รองรับอะแดปเตอร์ myTarget Android เวอร์ชัน 5.15.2.1
- รองรับอะแดปเตอร์ myTarget iOS เวอร์ชัน 5.15.2.0
- สร้างและทดสอบด้วย Google Mobile Ads Unity Plugin เวอร์ชัน 7.0.2
เวอร์ชัน 3.11.1
- รองรับอะแดปเตอร์ myTarget Android เวอร์ชัน 5.15.1.0
- รองรับอะแดปเตอร์ myTarget iOS เวอร์ชัน 5.15.1.0
- สร้างและทดสอบด้วย Google Mobile Ads Unity Plugin เวอร์ชัน 7.0.0
เวอร์ชัน 3.11.0
- รองรับอะแดปเตอร์ myTarget Android เวอร์ชัน 5.15.0.0
- รองรับอะแดปเตอร์ myTarget iOS เวอร์ชัน 5.15.0.1
- สร้างและทดสอบด้วย Google Mobile Ads Unity Plugin เวอร์ชัน 7.0.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
- เปลี่ยนชื่อเมธอด
MyTarget.IsUserConsent()
เป็นMyTarget.IsConsent()
แล้ว - รองรับอะแดปเตอร์ myTarget Android เวอร์ชัน 5.9.1.0
- รองรับอะแดปเตอร์ myTarget iOS เวอร์ชัน 5.7.2.0
เวอร์ชัน 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 SDKMyTarget.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