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

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

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

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

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

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

  • Google Mobile Ads SDK for React Native เวอร์ชันล่าสุด
  • เฟรมเวิร์ก React Native เวอร์ชัน 0.85.0 ขึ้นไป
  • วิธีติดตั้งใช้งานใน Android
    • Android API ระดับ 24 ขึ้นไป
  • วิธีติดตั้งใช้งานใน iOS
    • เป้าหมายการติดตั้งใช้งาน iOS เวอร์ชัน 13.0 ขึ้นไป
  • โปรเจ็กต์ React Native ที่ใช้งานได้ซึ่งกำหนดค่าด้วย Google Mobile Ads SDK for React Native ดูรายละเอียดได้ที่หัวข้อตั้งค่า Google Mobile Ads SDK for React Native
    • ตรวจสอบว่าคุณได้ดาวน์โหลดและแตกโฟลเดอร์ adapters จากโฟลเดอร์ gma-sdk-react-native แล้ว หากไม่มีโฟลเดอร์ adapters ให้ทำตามขั้นตอนที่ 1, 2 และ 3 ในหัวข้อติดตั้ง Google Mobile Ads SDK for React Native
  • ตั้งค่าสื่อกลาง AdMob

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

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

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

Android

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

iOS

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

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

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

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

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

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

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

เนทีฟ

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

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

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

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

Android

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

iOS

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

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

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

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

ในไดเรกทอรีรากของโปรเจ็กต์ ให้ติดตั้งGoogle Mobile Ads SDK for React Native อะแดปเตอร์สื่อกลางสำหรับ myTarget ดำเนินการต่อไปนี้ให้เสร็จสมบูรณ์

  1. คัดลอกไฟล์ tar ของอะแดปเตอร์ Google Mobile Ads SDK for React Native จากไดเรกทอรี gma-sdk-react-native/adapters/mytarget/ ไปยังไดเรกทอรี local_packages/ ของโปรเจ็กต์ หากไม่มีโฟลเดอร์ adapters โปรดดูข้อกำหนดเบื้องต้น

    mkdir -p local_packages
cp EXTRACT_DIR/gma-sdk-react-native/adapters/mytarget/gma-mediation-mytarget-0.1.0.tgz local_packages/

    แทนที่ EXTRACT_DIR ด้วยเส้นทางไปยังไดเรกทอรีที่คุณแตกไฟล์เก็บถาวร

  2. ติดตั้งแพ็กเกจอะแดปเตอร์โดยใช้เครื่องมือจัดการแพ็กเกจที่ต้องการ ดังนี้

    npm

    npm install ./local_packages/gma-mediation-mytarget-0.1.0.tgz

    ไหมพรม

    yarn add ./local_packages/gma-mediation-mytarget-0.1.0.tgz

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

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

อะแดปเตอร์ myTarget React Native เวอร์ชัน N/A และใหม่กว่ารองรับการส่งสัญญาณความยินยอมตาม GDPR จาก UMP SDK และแพลตฟอร์มการจัดการความยินยอมที่ผสานรวมกับ ข้อกำหนดความยินยอมเพิ่มเติมของ Google ไปยัง myTarget SDK

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

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

ดูส่วนกฎหมายคุ้มครองความเป็นส่วนตัวของรัฐในสหรัฐอเมริกาในคู่มือนักพัฒนาซอฟต์แวร์ Android และ iOS

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

Android

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

iOS

การผสานรวม SKAdNetwork

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

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

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

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

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

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

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

พารามิเตอร์เฉพาะเครือข่าย

อะแดปเตอร์ myTarget รองรับการส่งออบเจ็กต์ MyTargetMediationExtras ไปยังคำขอโฆษณาเพื่อตั้งค่าพารามิเตอร์เฉพาะเครือข่าย

ใช้พารามิเตอร์ isIosDebugMode เพื่อเปิดหรือปิดใช้การบันทึกแก้ไขข้อบกพร่องจากอะแดปเตอร์ iOS ของ myTarget iOS Adapter ที่สำคัญจะเปิดใช้การบันทึกโดยค่าเริ่มต้น ดูข้อมูลเพิ่มเติมได้ที่คู่มือพารามิเตอร์เฉพาะเครือข่าย iOS

โค้ดตัวอย่างต่อไปนี้แสดงวิธีตั้งค่า isIosDebugMode

import { MyTargetMediationExtras } from '@google/gma-mediation-mytarget';

const request: AdRequest = {
  // ...
  mediationExtras: [
    new MyTargetMediationExtras({
      isIosDebugMode: true, // Enable debug logging on iOS
    }),
  ],
};

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

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

iOS

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

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

เวอร์ชัน 0.1.0

  • การเผยแพร่ครั้งแรก