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

เลือกแพลตฟอร์ม: Android (เบต้า) Android iOS Unity Flutter

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

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

อะแดปเตอร์สื่อกลางสำหรับ myTarget มีความสามารถดังนี้

ข้อกำหนด

• Android API ระดับ 24 ขึ้นไป

• GMA Next-Gen SDK เวอร์ชันล่าสุด

• ทำตามคู่มือเริ่มต้นใช้งานสื่อกลางให้เสร็จสมบูรณ์

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

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

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

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

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

นอกจาก slot_id แล้ว คุณยังต้องใช้ โทเค็นเพื่อการเข้าถึงแบบถาวร ของ 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

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

ลงชื่อเข้าใช้บัญชี Ad Manager

ไปที่การแสดงโฆษณา > กลุ่มผลตอบแทน แล้วคลิกปุ่มกลุ่มผลตอบแทนใหม่

ป้อนชื่อ ที่ไม่ซ้ำกันสำหรับกลุ่มผลตอบแทน ตั้งค่าสถานะ เป็นใช้งานอยู่, เลือกรูปแบบโฆษณา และตั้งค่าประเภทพื้นที่โฆษณา เป็นแอปบนอุปกรณ์เคลื่อนที่ ในส่วนการกำหนดเป้าหมาย > พื้นที่โฆษณา ให้เลือกหน่วยโฆษณาในส่วน พื้นที่โฆษณา และแอปพลิเคชันบนอุปกรณ์เคลื่อนที่ ที่คุณต้องการเพิ่มสื่อกลาง

จากนั้นคลิกปุ่มเพิ่มพาร์ทเนอร์ผลตอบแทน

หากมีพาร์ทเนอร์ผลตอบแทน สำหรับ myTarget อยู่แล้ว คุณสามารถเลือกพาร์ทเนอร์รายนั้นได้ หรือเลือกสร้างพาร์ทเนอร์ผลตอบแทนใหม่

เลือก myTarget เป็น เครือข่ายโฆษณา ป้อนชื่อ ที่ไม่ซ้ำกัน แล้วเปิดใช้สื่อกลาง

เปิดการเก็บรวบรวมข้อมูลอัตโนมัติ แล้วป้อน โทเค็นเพื่อการเข้าถึงแบบถาวร ที่ได้รับในส่วนก่อนหน้า

เมื่อเลือกพาร์ทเนอร์ผลตอบแทน แล้ว ให้เลือกสื่อกลาง SDK บนอุปกรณ์เคลื่อนที่ เป็นประเภทการผสานรวม เลือก Android เป็น แพลตฟอร์ม และเลือกใช้งานอยู่ เป็น สถานะ ป้อน รหัสสล็อต ที่ได้รับในส่วนก่อนหน้า จากนั้นป้อนค่า CPM เริ่มต้น

คลิกบันทึก ที่ด้านล่างของหน้าเมื่อดำเนินการเสร็จ

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

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

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

การผสานรวมกับ Android Studio (แนะนำ)

ในไฟล์ Gradle ระดับแอป ให้เพิ่มทรัพยากร Dependency และการกำหนดค่าการติดตั้งใช้งานต่อไปนี้

dependencies {
    implementation("com.google.android.libraries.ads.mobile.sdk:ads-mobile-sdk:0.25.0-beta01")
    implementation("com.google.ads.mediation:mytarget:5.45.3.0")
}

configurations.configureEach {
    exclude(group = "com.google.android.gms", module = "play-services-ads")
    exclude(group = "com.google.android.gms", module = "play-services-ads-lite")
}

dependencies {
    implementation 'com.google.android.libraries.ads.mobile.sdk:ads-mobile-sdk:0.25.0-beta01'
    implementation 'com.google.ads.mediation:mytarget:5.45.3.0'
}

configurations.configureEach {
    exclude group: 'com.google.android.gms', module: 'play-services-ads'
    exclude group: 'com.google.android.gms', module: 'play-services-ads-lite'
}

การผสานรวมด้วยตนเอง

• หากต้องการรวม myTarget SDK โปรดดูเอกสารประกอบ myTarget Android SDK

• ไปที่อาร์ติแฟกต์อะแดปเตอร์ myTarget ในที่เก็บ Maven ของ Google เลือกเวอร์ชันล่าสุด ดาวน์โหลดไฟล์ .aar ของอะแดปเตอร์ myTarget แล้วเพิ่มลงในโปรเจ็กต์

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

ความยินยอมจากผู้ใช้ในสหภาพยุโรปและ GDPR

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

ใน SDK เวอร์ชัน 5.1.0, myTarget ได้เพิ่ม API ความยินยอมของผู้ใช้ เพื่อรองรับข้อกำหนดด้านความเป็นส่วนตัว โค้ดตัวอย่างต่อไปนี้แสดงวิธีส่งข้อมูลความยินยอมนี้ไปยัง myTarget SDK หากเลือกเรียกใช้เมธอดนี้ เราขอแนะนำให้เรียกใช้ก่อนที่จะขอโฆษณาผ่าน GMA Next-Gen SDK

import com.my.target.common.MyTargetPrivacy;
// ...

MyTargetPrivacy.setUserConsent(true);

import com.my.target.common.MyTargetPrivacy
// ...

MyTargetPrivacy.setUserConsent(true)

นอกจากนี้ หากทราบว่าผู้ใช้อยู่ในหมวดหมู่ที่มีการจำกัดอายุ คุณสามารถใช้โค้ดต่อไปนี้เพื่อส่งข้อมูลความยินยอมนี้ไปยัง myTarget SDK

import com.my.target.common.MyTargetPrivacy;
// ...

MyTargetPrivacy.setUserAgeRestricted(true);

import com.my.target.common.MyTargetPrivacy
// ...

MyTargetPrivacy.setUserAgeRestricted(true)

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

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

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

ใน SDK เวอร์ชัน 5.9.0, myTarget ได้เพิ่ม API ความยินยอมของผู้ใช้ เพื่อรองรับข้อกำหนดด้านความเป็นส่วนตัว โค้ดตัวอย่างต่อไปนี้แสดงวิธีส่งข้อมูลความยินยอมนี้ไปยัง myTarget SDK หากเลือกเรียกใช้เมธอดนี้ เราขอแนะนำให้เรียกใช้ก่อนที่จะขอโฆษณาผ่าน GMA Next-Gen SDK

import com.my.target.common.MyTargetPrivacy;
// ...

MyTargetPrivacy.setCcpaUserConsent(true);

import com.my.target.common.MyTargetPrivacy
// ...

MyTargetPrivacy.setCcpaUserConsent(true)

โปรดติดต่อทีมสนับสนุนของ myTarget เพื่อขอ ข้อมูลเพิ่มเติมและค่าที่ระบุได้ในเมธอด

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

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

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

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

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

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

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

ขั้นตอนที่ไม่บังคับ

การใช้โฆษณาเนทีฟ

การแสดงโฆษณา

อะแดปเตอร์ myTarget จะแสดงโฆษณาเนทีฟเป็น NativeAd ออบเจ็กต์ และจะป้อนข้อมูลในช่องต่อไปนี้ สำหรับ สำหรับ NativeAd

myTarget SDK จะส่งคืน 0 สำหรับความกว้างและความสูงของ mediaView เสมอ ดังนั้น อะแดปเตอร์ myTarget จะส่งคืน 0 สำหรับ getAspectRatio() เสมอ myTarget SDK จะแก้ปัญหานี้ในรุ่นต่อๆ ไป

การติดตามการแสดงผลและการคลิก

GMA Next-Gen SDK ใช้การเรียกกลับของ myTarget SDK สำหรับการติดตามการแสดงผลและ การคลิก ดังนั้นรายงานจากทั้ง 2 แหล่งที่มาจึงควรตรงกันโดยมีความคลาดเคลื่อนน้อยมากหรือไม่มีเลย

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

หากอะแดปเตอร์รับโฆษณาจาก myTarget ไม่สำเร็จ คุณสามารถตรวจสอบข้อผิดพลาดพื้นฐานจากการตอบกลับของโฆษณาได้โดยใช้ ResponseInfo.getAdSourceResponses() ในคลาสต่อไปนี้

com.google.ads.mediation.mytarget.MyTargetAdapter
com.google.ads.mediation.mytarget.MyTargetNativeAdapter
com.google.ads.mediation.mytarget.MyTargetRewardedAdapter

รหัสและข้อความที่เกี่ยวข้องซึ่งอะแดปเตอร์ myTarget แสดงขึ้นเมื่อโหลดโฆษณาไม่สำเร็จมีดังนี้