ผสานรวม Liftoff สร้างรายได้ด้วยสื่อกลาง

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

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

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

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

ข้อกำหนด

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

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

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

ลงชื่อสมัครใช้หรือเข้าสู่ระบบบัญชี Liftoff Monetize

เพิ่มแอปไปยังแดชบอร์ด Liftoff Monetize โดยคลิกปุ่มเพิ่มแอปพลิเคชัน

กรอกแบบฟอร์มโดยป้อนรายละเอียดที่จำเป็นทั้งหมด

เมื่อสร้างแอปแล้ว ให้เลือกแอปจากแดชบอร์ดแอปพลิเคชัน Liftoff Monetize

จดรหัสแอปไว้

เพิ่มตําแหน่งโฆษณาใหม่

หากต้องการสร้างตําแหน่งโฆษณาใหม่เพื่อใช้กับการไกล่เกลี่ย ให้ไปที่ แดชบอร์ดตําแหน่ง Liftoff Monetize คลิกปุ่มเพิ่มตําแหน่งโฆษณา แล้วเลือกแอปจากรายการแบบเลื่อนลง

รายละเอียดการเพิ่มตําแหน่งโฆษณาใหม่มีดังนี้

จดรหัสอ้างอิง แล้วคลิกตกลง

ค้นหาคีย์ API ของ Reporting

อัปเดต app-ads.txt

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

หากต้องการใช้ app-ads.txt สำหรับ Liftoff Monetize ให้ดาวน์โหลดและต่อท้ายรายการ app-ads.txt ของ Liftoff Monetize ลงในไฟล์ app-ads.txt ที่มีอยู่ ดูข้อมูลเพิ่มเติมได้ที่ app-ads.txt

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

หากต้องการเปิดใช้โฆษณาทดสอบ ให้ไปที่แดชบอร์ด Liftoff Monetize แล้วไปที่ แอปพลิเคชัน

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

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

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

เพิ่ม Liftoff Monetize ในบริษัท

เปิดใช้การแชร์สัญญาณที่ปลอดภัย

แชร์สัญญาณที่ปลอดภัยในคำขอราคาเสนอ

อนุญาตการแชร์สัญญาณที่ปลอดภัยสำหรับการเสนอราคา SDK

กำหนดค่าการเสนอราคาของ Liftoff Monetize

กำหนดค่าการแมปหน่วยโฆษณา

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

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

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

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

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

dependencies {
    implementation("com.google.android.libraries.ads.mobile.sdk:ads-mobile-sdk:0.24.0-beta02")
    implementation("com.google.ads.mediation:vungle:7.7.0.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:vungle:7.7.0.1'
}

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

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

• ดาวน์โหลด Vungle Android SDK เวอร์ชันล่าสุด และแตกไฟล์ .aar และ JAR ภายใต้โฟลเดอร์ libs แล้วเพิ่มลงในโปรเจ็กต์

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

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

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

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

ตั้งแต่ Vungle SDK เวอร์ชัน 7.4.1 เป็นต้นไป Liftoff Monetize จะอ่านความยินยอมตาม GDPR ที่ตั้งค่าโดยแพลตฟอร์มการจัดการความยินยอมที่รองรับข้อกำหนดความยินยอมเพิ่มเติมของ Google รวมถึง UMP SDK โดยอัตโนมัติ ดูข้อมูลเพิ่มเติมได้ที่ วิธีการใช้งานที่แนะนำสำหรับ GDPR

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

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

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

VunglePrivacySettings.setCCPAStatus(true);
LiftoffMonetizeMediationSnippets.java

VunglePrivacySettings.setCCPAStatus(true)
LiftoffMonetizeMediationSnippets.kt

ดูรายละเอียดเพิ่มเติมและค่าที่ระบุได้ในเมธอดได้ที่การใช้งาน CCPA

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

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

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

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

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

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

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

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

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

อแดปเตอร์ Liftoff Monetize รองรับพารามิเตอร์คำขอเพิ่มเติมต่อไปนี้ ซึ่งส่งไปยังอแดปเตอร์ได้

userId

สตริงที่แสดงรหัสผู้ใช้ที่ได้รับสิ่งจูงใจของ Liftoff Monetize

adOrientation

จำนวนเต็มที่ระบุการวางแนวการนำเสนอสำหรับโฆษณาแบบเต็มหน้าจอ

setBackButtonImmediatelyEnabled

บูลีนเพื่อเปิดหรือปิดใช้ปุ่มย้อนกลับในโฆษณาเปิดแอปทันที ตั้งค่าเป็น true เพื่อเปิดใช้ปุ่มย้อนกลับทันที หรือตั้งค่าเป็น false ค่าเริ่มต้นคือ false ดูข้อมูลเพิ่มเติมได้ที่เอกสารประกอบของ Liftoff Monetize เกี่ยวกับวิธีผสานรวมโฆษณาเปิดแอป

ต่อไปนี้เป็นตัวอย่างโค้ดวิธีสร้างคำขอโฆษณาที่ตั้งค่าพารามิเตอร์เหล่านี้

Bundle extras = new Bundle();
extras.putString(VungleConstants.KEY_USER_ID, "myUserID");
extras.putInt(VungleConstants.KEY_ORIENTATION, 1);
// Optional: Enables the back button on App Open ads immediately.
extras.putBoolean(VungleConstants.KEY_BACK_BUTTON_IMMEDIATELY_ENABLED, true);

AdRequest request =
    new AdRequest.Builder()
        .addNetworkExtrasBundle(VungleAdapter.class, extras) // Rewarded.
        .addNetworkExtrasBundle(VungleInterstitialAdapter.class, extras) // Interstitial.
        // App Open ads use VungleMediationAdapter
        .addNetworkExtrasBundle(VungleMediationAdapter.class, extras)
        .build();
LiftoffMonetizeMediationSnippets.java

val extras = Bundle()
extras.putString(VungleConstants.KEY_USER_ID, "myUserID")
extras.putInt(VungleConstants.KEY_ORIENTATION, 1)
// Optional: Enables the back button on App Open ads immediately.
extras.putBoolean(VungleConstants.KEY_BACK_BUTTON_IMMEDIATELY_ENABLED, true)

val request =
  AdRequest.Builder()
    .addNetworkExtrasBundle(VungleAdapter::class.java, extras) // Rewarded.
    .addNetworkExtrasBundle(VungleInterstitialAdapter::class.java, extras) // Interstitial.
    // App Open ads use VungleMediationAdapter
    .addNetworkExtrasBundle(VungleMediationAdapter::class.java, extras)
    .build()
LiftoffMonetizeMediationSnippets.kt

การแสดงผลโฆษณาเนทีฟ

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

¹ อะแดปเตอร์ Liftoff Monetize ไม่ได้ให้สิทธิ์เข้าถึงชิ้นงานรูปภาพหลักโดยตรงสำหรับโฆษณาเนทีฟ แต่จะแสดงวิดีโอหรือรูปภาพใน MediaView แทน

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

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

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

สําหรับข้อผิดพลาดที่มาจาก Vungle SDK โปรดดูรหัสข้อผิดพลาด: Vungle SDK สําหรับ iOS และ Android