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

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

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

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

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

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

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

  • Google Mobile Ads Unity Plugin เวอร์ชันล่าสุด
  • Unity Editor เวอร์ชัน 2019.4 ขึ้นไป
  • หากต้องการติดตั้งใช้งานใน Android
    • Android API ระดับ 24 ขึ้นไป
  • หากต้องการติดตั้งใช้งานใน 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 จะกำหนดให้คุณสร้างหน่วยโฆษณาก่อนจึงจะทำกระบวนการให้เสร็จสมบูรณ์ได้

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

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

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

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

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

    เนทีฟ

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

    ในหน้ารายละเอียดของหน่วยโฆษณา ให้จดรหัสช่องโฆษณาซึ่งจะอยู่ในการตั้งค่าหน่วยโฆษณาเป็น 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 ไว้ คุณสามารถติดตั้งปลั๊กอินสื่อกลาง myTarget ของ Google Mobile Ads สำหรับ Unity ลงในโปรเจ็กต์ได้โดยเรียกใช้คำสั่งต่อไปนี้จากไดเรกทอรีรากของโปรเจ็กต์

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

    OpenUPM

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

    ในแท็บ Scoped Registries ให้เพิ่ม OpenUPM เป็น Scoped Registry โดยระบุรายละเอียดต่อไปนี้

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

    รายละเอียด OpenUPM

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

    Unity Registry

    เลือกแพ็กเกจ การผสานรวม 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 myTarget SDK แสดงโฆษณาไม่สำเร็จ

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

    เวอร์ชัน 2.3.2

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

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

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