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

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

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

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

Adapter สื่อกลางสำหรับ myTarget มีความสามารถต่อไปนี้

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

ข้อกำหนด

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

• ล่าสุด GMA Next-Gen SDK

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

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

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

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

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

หมายเหตุ: หากต้องการเพิ่มหน่วยโฆษณาลงในแอปที่มีอยู่ ให้เปิดหน้ารายละเอียดแอปโดย คลิกชื่อแอป แล้วคลิกสร้างหน่วยโฆษณา

แบนเนอร์

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

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

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

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

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

เนทีฟ

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

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

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

อัปเดต app-ads.txt

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

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

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

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

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

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

คุณต้องเพิ่ม myTarget ลงในการกำหนดค่าสื่อกลางสำหรับหน่วยโฆษณา

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

หากต้องการสร้างกลุ่มสื่อกลางใหม่ ให้เลือกสร้างกลุ่มสื่อกลาง

ป้อนรูปแบบโฆษณาและแพลตฟอร์ม แล้วคลิกต่อไป

ตั้งชื่อกลุ่มสื่อกลาง แล้วเลือกสถานที่ตั้งที่จะกำหนดเป้าหมาย จากนั้นตั้งค่าสถานะกลุ่มสื่อกลางเป็นเปิดใช้ แล้วคลิกเพิ่มหน่วยโฆษณา

เชื่อมโยงกลุ่มสื่อกลางนี้กับหน่วยโฆษณา AdMob ที่มีอยู่ อย่างน้อย 1 หน่วย จากนั้นคลิกเสร็จสิ้น

ตอนนี้คุณควรเห็นการ์ดหน่วยโฆษณาที่แสดงหน่วยโฆษณาที่คุณเลือก

เพิ่ม myTarget เป็นแหล่งที่มาของโฆษณา

ในการ์ดสื่อกลางตามลำดับขั้นในส่วนแหล่งที่มาของโฆษณา ให้เลือกเพิ่มแหล่งที่มาของโฆษณา

เลือก myTarget แล้วเปิดใช้สวิตช์เพิ่มประสิทธิภาพ ป้อนโทเค็นเพื่อการเข้าถึงแบบถาวร ที่ได้รับในส่วนก่อนหน้าเพื่อตั้งค่าการเพิ่มประสิทธิภาพแหล่งที่มาของโฆษณาสําหรับ myTarget จากนั้นป้อนค่า eCPM สำหรับ myTarget แล้วคลิกต่อไป

หมายเหตุ: คุณต้องตั้งค่าการเพิ่มประสิทธิภาพแหล่งที่มาของโฆษณาเพียงครั้งเดียวต่อเครือข่าย

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

จากนั้นป้อน รหัสช่อง ที่ได้รับในส่วนก่อนหน้า จากนั้นคลิกเสร็จสิ้น

หมายเหตุ: การเพิ่มประสิทธิภาพแหล่งที่มาของโฆษณาต้องใช้เวลา 2-3 วันในการรวบรวมข้อมูลให้เพียงพอเพื่อคำนวณ eCPM สำหรับเครือข่ายสื่อกลางได้อย่างแม่นยำ ในระหว่างนี้ สถานะการเพิ่มประสิทธิภาพแหล่งที่มาของโฆษณาคือ PENDING ดังนั้นคุณต้องตั้งค่า eCPM ของเครือข่ายด้วยตนเอง เมื่อคำนวณ eCPM ได้แล้ว แหล่งที่มาของโฆษณาจะเริ่มอัปเดต eCPM ในนามของคุณโดยอัตโนมัติ

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

สำคัญ: ตรวจสอบว่าคุณมีสิทธิ์การจัดการบัญชีเพื่อทำการกำหนดค่าความยินยอมของผู้ใช้ EU และ GDPR, กฎระเบียบของรัฐในสหรัฐอเมริกา และแพลตฟอร์มการรับส่งข้อความสำหรับผู้ใช้ให้เสร็จสมบูรณ์ ดูรายละเอียดได้ที่จัดการสิทธิ์ของผู้ใช้ในการเข้าถึงบัญชีของคุณ

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

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

หมายเหตุ: การไม่ผสานรวม myTarget และGMA Next-Gen SDK เวอร์ชันที่เข้ากันได้อาจทำให้เกิดปัญหาในการสร้าง

การผสานรวม Android Studio (แนะนํา)

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

Kotlin

dependencies {
    implementation("com.google.android.libraries.ads.mobile.sdk:ads-mobile-sdk:0.24.0-beta02")
    implementation("com.google.ads.mediation:mytarget:5.27.4.1")
}

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.24.0-beta02'
    implementation 'com.google.ads.mediation:mytarget:5.27.4.1'
}

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: ใช้การตั้งค่าความเป็นส่วนตัวใน SDK ของ myTarget

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

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

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

Java

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

MyTargetPrivacy.setUserConsent(true);

Kotlin

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

MyTargetPrivacy.setUserConsent(true)

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

Java

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

MyTargetPrivacy.setUserAgeRestricted(true);

Kotlin

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

Java

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

MyTargetPrivacy.setCcpaUserConsent(true);

Kotlin

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

MyTargetPrivacy.setCcpaUserConsent(true)

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

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

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

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

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

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

สำคัญ: ปิดใช้โหมดทดสอบสำหรับ AdMob และ myTarget ก่อนที่จะเปิดตัวแอป

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

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

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

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

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

อแดปเตอร์ myTarget จะแสดงโฆษณาเนทีฟเป็นออบเจ็กต์ NativeAd โดยจะแสดงคำอธิบายช่องโฆษณาเนทีฟต่อไปนี้ สำหรับ NativeAd

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

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

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

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

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

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

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

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

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