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

เลือกแพลตฟอร์ม: Android iOS Unity Flutter Android (เดิม)

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

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

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

ข้อกำหนดเบื้องต้น

ก่อนดำเนินการต่อ โปรดตรวจสอบสิ่งต่อไปนี้

  • Google Mobile Ads Unity Plugin เวอร์ชันล่าสุด
  • Unity Editor เวอร์ชัน 2019.4 ขึ้นไป
  • หากต้องการติดตั้งใช้งานใน Android
    • ระดับ API 24 ขึ้นไปของ Android
  • หากต้องการติดตั้งใช้งานใน iOS
    • เป้าหมายการติดตั้งใช้งาน iOS เวอร์ชัน 13.0 ขึ้นไป
  • โปรเจ็กต์ Unity ที่ใช้งานได้ซึ่งกำหนดค่าด้วย Google Mobile Ads Unity Plugin ดูรายละเอียดได้ที่หัวข้อตั้งค่า Google Mobile Ads Unity Plugin
  • ตั้งค่าสื่อกลาง

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

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

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

    Android

    จากนั้นระบุ URL ของ Google Play สำหรับแอปของคุณ

    iOS

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

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

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

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

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

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

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

    เนทีฟ

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

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

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

    อัปเดต app-ads.txt

    ผู้ขายที่ได้รับอนุญาตสำหรับแอป app-ads.txt เป็นความคิดริเริ่มของ IAB Tech Lab ที่ช่วยตรวจสอบว่าคุณจะขายพื้นที่โฆษณาในแอปผ่านช่องทางที่คุณได้รับอนุญาตเท่านั้น คุณจะต้องใช้ไฟล์ app-ads.txt เพื่อป้องกันไม่ให้เสียรายได้จากโฆษณาเป็นจำนวนมาก หากยังไม่ได้ดำเนินการ ให้สร้างไฟล์ app-ads.txt สำหรับ Ad Manager

    หากต้องการใช้ app-ads.txt สำหรับ myTarget โปรดดูวิธีสร้างและเผยแพร่ไฟล์

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

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

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

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

    Android

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

    iOS

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

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

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

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

    OpenUPM-CLI

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

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

    OpenUPM

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

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

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

    รายละเอียด OpenUPM

    จากนั้นไปที่หน้าต่าง > Package Manager เพื่อเปิด Unity Package Manager และ เลือกรีจิสทรีของฉันจากเมนูแบบเลื่อนลง

    Unity Registries

    เลือกแพ็กเกจ การผสานรวม MyTarget กับโฆษณา Google บนอุปกรณ์เคลื่อนที่ แล้วคลิกติดตั้ง

    ติดตั้งจาก OpenUPM

    แพ็กเกจ Unity

    ดาวน์โหลดปลั๊กอินสื่อกลาง Google Mobile Ads สำหรับ myTarget เวอร์ชันล่าสุดจากลิงก์ดาวน์โหลดใน บันทึกการเปลี่ยนแปลง และแตกไฟล์ GoogleMobileAdsMyTargetMediation.unitypackage จากไฟล์ zip

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

    นำเข้าจาก Unity

    จากนั้นเลือก Assets > External Dependency Manager > Android Resolver > Force Resolve ไลบรารี External Dependency Manager จะทำการแก้ปัญหา Dependency ตั้งแต่ต้นและคัดลอก Dependency ที่ประกาศไว้ไปยังไดเรกทอรี Assets/Plugins/Android ของแอป Unity

    บังคับแก้ไข

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

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

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

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

MyTarget.SetUserConsent(true);

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

    MyTarget.SetUserAgeRestricted(true);

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

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

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

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

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

MyTarget.SetCCPAUserConsent(true);

    โปรดติดต่อทีมสนับสนุนของ myTargetเพื่อขอข้อมูลเพิ่มเติม

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

    Android

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

    iOS

    การผสานรวม SKAdNetwork

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

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

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

    ตรวจสอบว่าคุณได้ลงทะเบียนอุปกรณ์ทดสอบสำหรับ Ad Manager และเปิดใช้โหมดทดสอบใน UI ของ myTarget แล้ว

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

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

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

    หากอะแดปเตอร์ไม่ได้รับโฆษณาจาก 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 SDK ของ myTarget แสดงข้อผิดพลาด
    101 พารามิเตอร์เซิร์ฟเวอร์ myTarget ที่กำหนดค่าไว้ใน UI ของ Ad Manager ขาดหายไป/ไม่ถูกต้อง
    102 ขนาดโฆษณาที่ขอไม่ตรงกับขนาดแบนเนอร์ที่ myTarget รองรับ
    103 คำขอโฆษณาไม่ใช่คำขอโฆษณาเนทีฟแบบรวม
    104 โฆษณาเนทีฟที่โหลดจาก myTarget แตกต่างจากโฆษณาเนทีฟที่ขอ
    105 โฆษณาเนทีฟที่โหลดจาก myTarget ไม่มีชิ้นงานที่จำเป็นบางรายการ (เช่น รูปภาพหรือไอคอน)
    106 SDK ของ myTarget แสดงโฆษณาไม่สำเร็จ

    iOS

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

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

    เวอร์ชัน 3.42.0 (อยู่ระหว่างดำเนินการ)

    เวอร์ชัน 3.41.1

    เวอร์ชัน 3.41.0

    เวอร์ชัน 3.40.0

    เวอร์ชัน 3.39.0

    เวอร์ชัน 3.38.0

    เวอร์ชัน 3.37.0

    เวอร์ชัน 3.36.0

    เวอร์ชัน 3.35.0

    เวอร์ชัน 3.34.0

    เวอร์ชัน 3.33.0

    เวอร์ชัน 3.32.1

    เวอร์ชัน 3.32.0

    เวอร์ชัน 3.31.0

    เวอร์ชัน 3.30.1

    เวอร์ชัน 3.30.0

    เวอร์ชัน 3.29.0

    เวอร์ชัน 3.28.0

    เวอร์ชัน 3.27.1

    เวอร์ชัน 3.27.0

    เวอร์ชัน 3.26.0

    เวอร์ชัน 3.25.0

    เวอร์ชัน 3.24.0

    เวอร์ชัน 3.23.0

    เวอร์ชัน 3.22.0

    เวอร์ชัน 3.21.1

    เวอร์ชัน 3.21.0

    เวอร์ชัน 3.20.0

    เวอร์ชัน 3.19.0

    เวอร์ชัน 3.18.2

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

    เวอร์ชัน 2.0.0

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

    เวอร์ชัน 1.1.0

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

    เวอร์ชัน 1.0.0

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