การกำหนดเป้าหมาย

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

คู่มือนี้อธิบายวิธีระบุข้อมูลการกำหนดเป้าหมายให้กับ Google Mobile Ads SDK

หากต้องการดูตัวอย่างที่ใช้งานได้ ให้ดาวน์โหลดแอปเดโม Android API

ดาวน์โหลด API Demo

วิชาบังคับก่อน

ก่อนดำเนินการต่อ ให้ตั้งค่า Google Mobile Ads SDK (Legacy)

RequestConfiguration

RequestConfiguration จะรวบรวมข้อมูลการกำหนดเป้าหมายที่ใช้กับคำขอโฆษณาทุกรายการทั่วโลก หากต้องการดู แท็กการกำหนดเป้าหมายที่ใช้ได้ โปรดดู RequestConfiguration.Builder เอกสารประกอบ

หากต้องการอัปเดตการกำหนดค่าคำขอ ให้รับเครื่องมือสร้างจากการกำหนดค่าที่มีอยู่ ทำการอัปเดตที่เลือก แล้วตั้งค่าดังนี้

Kotlin

val requestConfiguration = MobileAds.getRequestConfiguration()
MobileAds.setRequestConfiguration(requestConfiguration)
RequestConfigurationSnippets.kt

Java

RequestConfiguration requestConfiguration = MobileAds.getRequestConfiguration();
MobileAds.setRequestConfiguration(requestConfiguration);
RequestConfigurationSnippets.java

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

ตั้งค่ากลุ่มทดสอบตามอายุ

Google Mobile Ads SDK (Legacy) มีการตั้งค่าการดูแลตามอายุเพื่อช่วยคุณจัดการการปฏิบัติตามกฎระเบียบด้านความเป็นส่วนตัวที่เกี่ยวข้อง กับเด็กและวัยรุ่น การตั้งค่าการดูแลตามอายุช่วยให้คุณระบุได้ว่า Google Mobile Ads SDK (Legacy) ควรใช้การป้องกันการแสดงโฆษณาที่เฉพาะเจาะจงสำหรับเด็ก วัยรุ่น หรืออายุที่ไม่ได้ระบุหรือไม่

คุณสามารถตั้งค่ากลุ่มทดสอบตามอายุด้วยเมธอด setAgeRestrictedTreatment() ด้วย RequestConfiguration.Builder API

ตัวอย่างต่อไปนี้ระบุว่าคำขอโฆษณาควรได้รับการดูแลตามอายุของเด็ก

Kotlin

val requestConfiguration =
  MobileAds.getRequestConfiguration()
    .toBuilder()
    // Indicate that ad requests should have child age treatment.
    .setAgeRestrictedTreatment(AgeRestrictedTreatment.CHILD)
    .build()
MobileAds.setRequestConfiguration(requestConfiguration)
RequestConfigurationSnippets.kt

Java

RequestConfiguration requestConfiguration =
    MobileAds.getRequestConfiguration().toBuilder()
        // Indicate that ad requests should have child age treatment.
        .setAgeRestrictedTreatment(AgeRestrictedTreatment.CHILD)
        .build();
MobileAds.setRequestConfiguration(requestConfiguration);
RequestConfigurationSnippets.java

หากต้องการระบุการดูแลตามอายุของวัยรุ่นหรืออายุที่ไม่ได้ระบุ ให้แทนที่การตั้งค่า CHILD ด้วยการตั้งค่าต่อไปนี้

• TEEN
• UNSPECIFIED

เมื่อใช้การตั้งค่านี้ Google Mobile Ads SDK (Legacy) จะรวมพารามิเตอร์ tfat ไว้ในคำขอโฆษณา โปรดปรึกษาที่ปรึกษาด้านกฎหมายเพื่อกำหนดการดูแลตามอายุที่เหมาะสมสำหรับผู้ใช้ตามภาระหน้าที่ทางกฎหมายและกฎระเบียบ ดูข้อมูลเพิ่มเติมได้ที่ ติดแท็กคำขอโฆษณาเพื่อให้มีการดูแลตามอายุ

ย้ายข้อมูลไปยังการดูแลตามอายุจาก TFCD และ TFUA

การตั้งค่าการดูแลตามอายุจะแทนที่การตั้งค่า .setTagForChildDirectedTreatment() (TFCD) และ .setTagForUnderAgeOfConsent() (TFUA) ที่เลิกใช้งานแล้ว

ตารางต่อไปนี้แสดงการตั้งค่า TFCD และ TFUA และการตั้งค่าการดูแลตามอายุที่เทียบเท่า

TFCD

TFCD	การดูแลตามอายุ
TAG_FOR_CHILD_DIRECTED_TREATMENT_TRUE	AgeRestrictedTreatment.CHILD
TAG_FOR_CHILD_DIRECTED_TREATMENT_FALSE	AgeRestrictedTreatment.UNSPECIFIED
TAG_FOR_CHILD_DIRECTED_TREATMENT_UNSPECIFIED	AgeRestrictedTreatment.UNSPECIFIED
ไม่มีการกำหนดค่า .setTagForChildDirectedTreatment()	AgeRestrictedTreatment.UNSPECIFIED
ไม่มีเวอร์ชันเทียบเท่า	AgeRestrictedTreatment.TEEN

TFUA

TFUA	การดูแลตามอายุ
TAG_FOR_UNDER_AGE_OF_CONSENT_TRUE	AgeRestrictedTreatment.CHILD
TAG_FOR_UNDER_AGE_OF_CONSENT_FALSE	AgeRestrictedTreatment.UNSPECIFIED
TAG_FOR_UNDER_AGE_OF_CONSENT_UNSPECIFIED	AgeRestrictedTreatment.UNSPECIFIED
ไม่มีการกำหนดค่า .setTagForUnderAgeOfConsent()	AgeRestrictedTreatment.UNSPECIFIED
ไม่มีเวอร์ชันเทียบเท่า	AgeRestrictedTreatment.TEEN

ทำความเข้าใจการโต้ตอบของการดูแลตามอายุกับ TFCD และ TFUA

หากคุณตั้งค่าการดูแลตามอายุและค่า TFCD หรือ TFUA ไว้ Google จะใช้การดูแลที่เข้มงวดมากที่สุด

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

ส่งต่อการดูแลตามอายุด้วยสื่อกลาง

หากคุณตั้งค่าการดูแลตามอายุโดยใช้Google Mobile Ads SDK (Legacy)อะแดปเตอร์สื่อกลางจะส่งต่อสัญญาณการดูแลตามอายุไปยังบุคคลที่สามที่ใช้สื่อกลาง SDK

ตารางต่อไปนี้แสดงเวอร์ชันอะแดปเตอร์สื่อกลางที่รองรับการส่งต่อสัญญาณการดูแลแบบจำกัดอายุไปยัง SDK ของบุคคลที่สามที่ใช้สื่อกลาง

ชื่ออะแดปเตอร์สื่อกลาง	เวอร์ชันต่ำสุดที่รองรับ
AppLovin	13.6.3.0
BidMachine	3.7.1.1
Bigo	5.9.0.1
Chartboost	9.12.1.1
DTExchange (Fyber)	8.4.5.1
i-mobile	2.3.2.4
InMobi	11.3.0.1
IronSource	9.4.3.0
Liftoff Monetize (Vungle)	7.7.4.2
LY (Line)	3.1.1.1
maio	2.0.9.0
Meta (Facebook)	6.21.0.4
Mintegral	17.1.61.1
Moloco	4.10.0.0
MyTarget	5.47.1.1
Pangle	8.1.0.3.1
PubMatic	5.1.2.2
Verve	3.9.0.0

การตั้งค่าที่มีเด็กเป็นกลุ่มเป้าหมาย

คำเตือน: เมธอด setTagForChildDirectedTreatment() เลิกใช้งานแล้ว ให้ตั้งค่าเมธอด setAgeRestrictedTreatment()

แทน

ตามวัตถุประสงค์ของ กฎหมายว่าด้วยความคุ้มครองข้อมูลส่วนบุคคลทางอินเทอร์เน็ตของเด็ก (Children's Online Privacy Protection Act หรือ COPPA), มีการตั้งค่าที่เรียกว่า "แท็กสำหรับการดูแลให้เหมาะสมกับเด็ก" การตั้งค่าแท็กนี้แสดงว่าคุณรับรองว่าการแจ้งเตือนนี้ถูกต้องและคุณได้รับอนุญาตให้ดำเนินการในนามของเจ้าของแอป คุณเข้าใจว่าการนำการตั้งค่านี้ไปใช้ในทางที่ผิดอาจส่งผลให้บัญชี Google ของคุณสิ้นสุดลง

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

คุณสามารถใช้การตั้งค่าให้มีเด็กเป็นกลุ่มเป้าหมายผ่าน setTagForChildDirectedTreatment()ได้ดังนี้

• เรียก setTagForChildDirectedTreatment ด้วย TAG_FOR_CHILD_DIRECTED_TREATMENT_TRUE เพื่อระบุว่าต้องการให้เนื้อหาของคุณมีเด็กเป็นกลุ่มเป้าหมายตามวัตถุประสงค์ของ COPPA ซึ่งจะป้องกันการส่ง ตัวระบุโฆษณา Android (AAID)

• เรียก setTagForChildDirectedTreatment ด้วย TAG_FOR_CHILD_DIRECTED_TREATMENT_FALSE เพื่อระบุว่าไม่ต้องการให้เนื้อหาของคุณได้รับการดูแลให้มีเด็กเป็นกลุ่มเป้าหมายตามวัตถุประสงค์ของ COPPA

• เรียก setTagForChildDirectedTreatment ด้วย TAG_FOR_CHILD_DIRECTED_TREATMENT_UNSPECIFIED หากไม่ต้องการระบุวิธีที่ต้องการให้เนื้อหาของคุณได้รับการดูแลตาม COPPA ในคำขอโฆษณา

ตัวอย่างต่อไปนี้ระบุว่าคุณต้องการให้เนื้อหาของคุณได้รับการดูแลให้มีเด็กเป็นกลุ่มเป้าหมายตามวัตถุประสงค์ของ COPPA

Kotlin

val requestConfiguration =
  MobileAds.getRequestConfiguration()
    .toBuilder()
    .setTagForChildDirectedTreatment(RequestConfiguration.TAG_FOR_CHILD_DIRECTED_TREATMENT_TRUE)
    .build()
MobileAds.setRequestConfiguration(requestConfiguration)
RequestConfigurationSnippets.kt

Java

RequestConfiguration requestConfiguration =
    MobileAds.getRequestConfiguration().toBuilder()
        .setTagForChildDirectedTreatment(
            RequestConfiguration.TAG_FOR_CHILD_DIRECTED_TREATMENT_TRUE)
        .build();
MobileAds.setRequestConfiguration(requestConfiguration);
RequestConfigurationSnippets.java

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

ผู้ใช้ที่มีอายุต่ำกว่าอายุที่ให้ความยินยอมได้

คำเตือน: เมธอด setTagForUnderAgeOfConsent() เลิกใช้งานแล้ว ให้ตั้งค่าเม0}เมธอด แทนsetAgeRestrictedTreatment()

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

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

เช่นเดียวกับการตั้งค่าที่มีเด็กเป็นกลุ่มเป้าหมาย มีเมธอดใน RequestConfiguration.Builder สำหรับตั้งค่าพารามิเตอร์ TFUA: setTagForUnderAgeOfConsent(), พร้อมตัวเลือกต่อไปนี้

• เรียก setTagForUnderAgeOfConsent() ด้วย TAG_FOR_UNDER_AGE_OF_CONSENT_TRUE เพื่อระบุว่าต้องการให้คำขอโฆษณาได้รับการดูแลสำหรับผู้ใช้ในเขตเศรษฐกิจยุโรป (EEA) ที่มีอายุต่ำกว่าอายุที่ยินยอมได้ ซึ่งจะป้องกันการส่งตัวระบุโฆษณา Android (AAID)ด้วย

• เรียก setTagForUnderAgeOfConsent() ด้วย TAG_FOR_UNDER_AGE_OF_CONSENT_FALSE เพื่อระบุว่าต้องการให้คำขอโฆษณา ไม่ ได้รับการดูแลสำหรับผู้ใช้ในเขตเศรษฐกิจยุโรป (EEA) ที่มีอายุต่ำกว่าอายุที่ยินยอมได้

• เรียก setTagForUnderAgeOfConsent() ด้วย TAG_FOR_UNDER_AGE_OF_CONSENT_UNSPECIFIED เพื่อระบุว่าคุณไม่ได้ระบุว่าคำขอโฆษณาควรได้รับการดูแลสำหรับผู้ใช้ในเขตเศรษฐกิจยุโรป (EEA) ที่มีอายุต่ำกว่าอายุที่ยินยอมได้หรือไม่

ตัวอย่างต่อไปนี้ระบุว่าคุณต้องการรวม TFUA ไว้ในคำขอโฆษณา

Kotlin

val requestConfiguration =
  MobileAds.getRequestConfiguration()
    .toBuilder()
    .setTagForUnderAgeOfConsent(RequestConfiguration.TAG_FOR_UNDER_AGE_OF_CONSENT_TRUE)
    .build()
MobileAds.setRequestConfiguration(requestConfiguration)
RequestConfigurationSnippets.kt

Java

RequestConfiguration requestConfiguration =
    MobileAds.getRequestConfiguration().toBuilder()
        .setTagForUnderAgeOfConsent(RequestConfiguration.TAG_FOR_UNDER_AGE_OF_CONSENT_TRUE)
        .build();
MobileAds.setRequestConfiguration(requestConfiguration);
RequestConfigurationSnippets.java

แท็กเพื่อเปิดใช้การตั้งค่าที่มีเด็กเป็นกลุ่มเป้าหมาย และ setTagForUnderAgeOfConsent() ไม่ควรตั้งค่าเป็น true พร้อมกัน หากตั้งค่าเป็น `true` พร้อมกัน การตั้งค่าให้มีเด็กเป็นกลุ่มเป้าหมายจะมีผลเหนือกว่า

การกรองเนื้อหาโฆษณา

เพื่อให้เป็นไปตามนโยบายโฆษณาที่ไม่เหมาะสม ของ Google Play ซึ่งรวมถึงข้อเสนอที่เกี่ยวข้องภายในโฆษณา โฆษณาทั้งหมดและข้อเสนอที่เกี่ยวข้องที่แสดงภายในแอปต้องเหมาะสมกับการจัดประเภทเนื้อหาของ แอป แม้ว่าตัวเนื้อหาเองจะเป็นไปตามนโยบายของ Google Play อยู่แล้ว

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

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

• MAX_AD_CONTENT_RATING_G
• MAX_AD_CONTENT_RATING_PG
• MAX_AD_CONTENT_RATING_T
• MAX_AD_CONTENT_RATING_MA

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

Kotlin

val requestConfiguration =
  MobileAds.getRequestConfiguration()
    .toBuilder()
    .setMaxAdContentRating(RequestConfiguration.MAX_AD_CONTENT_RATING_G)
    .build()
MobileAds.setRequestConfiguration(requestConfiguration)
RequestConfigurationSnippets.kt

Java

RequestConfiguration requestConfiguration =
    MobileAds.getRequestConfiguration().toBuilder()
        .setMaxAdContentRating(RequestConfiguration.MAX_AD_CONTENT_RATING_G)
        .build();
MobileAds.setRequestConfiguration(requestConfiguration);
RequestConfigurationSnippets.java

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

หมายเหตุ: การตั้งค่าตัวกรองการจัดประเภทเนื้อหาที่ระบุผ่าน Google Mobile Ads SDK (Legacy) จะลบล้างการตั้งค่าที่กำหนดค่าโดยใช้ UI ของ Ad Manager

Publisher Privacy Treatment (เบต้า)

Publisher Privacy Treatment (PPT) API เป็นเครื่องมือที่ไม่บังคับซึ่งช่วยให้แอประบุได้ว่าจะปิดการปรับโฆษณาตามโปรไฟล์ของผู้ใช้สำหรับคำขอโฆษณาทั้งหมดหรือไม่โดยใช้เมธอด setPublisherPrivacyPersonalizationState() เมื่อใช้ฟีเจอร์นี้ ระบบจะรวมพารามิเตอร์ Publisher Privacy Treatment (PPT) ไว้ในคำขอโฆษณาทั้งหมดในอนาคตสำหรับเซสชันที่เหลือ

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

Kotlin

val requestConfiguration =
  MobileAds.getRequestConfiguration()
    .toBuilder()
    .setPublisherPrivacyPersonalizationState(
      RequestConfiguration.PublisherPrivacyPersonalizationState.DISABLED
    )
    .build()
MobileAds.setRequestConfiguration(requestConfiguration)
RequestConfigurationSnippets.kt

Java

RequestConfiguration requestConfiguration =
    MobileAds.getRequestConfiguration().toBuilder()
        .setPublisherPrivacyPersonalizationState(
            RequestConfiguration.PublisherPrivacyPersonalizationState.DISABLED)
        .build();
MobileAds.setRequestConfiguration(requestConfiguration);
RequestConfigurationSnippets.java

หมายเหตุ: สำหรับคำขอโฆษณาที่มีสัญญาณด้านความเป็นส่วนตัวของผู้ใช้หลายรายการ สัญญาณที่จำกัดสิทธิ์มากที่สุด จะมีลำดับความสำคัญสูงกว่า ดูตัวอย่างเฉพาะได้ในเอกสารประกอบ Publisher Privacy Treatment API

คำขอโฆษณา

ออบเจ็กต์ AdManagerAdRequest จะรวบรวมข้อมูลการกำหนดเป้าหมายเพื่อส่ง ไปพร้อมกับคำขอโฆษณา

เพิ่มข้อมูลเพิ่มเติมของเครือข่าย

ข้อมูลเพิ่มเติมของเครือข่ายคือรายละเอียดเพิ่มเติมที่ส่งไปพร้อมกับคำขอโฆษณาซึ่งเฉพาะเจาะจงกับแหล่งที่มาของโฆษณาแหล่งเดียว

ข้อมูลโค้ดต่อไปนี้จะตั้งค่าคีย์พารามิเตอร์พิเศษเป็น collapsible โดยมีค่าเป็น bottom ให้กับ Google

Kotlin

val extras = Bundle()
extras.putString("collapsible", "bottom")
val adRequest =
  AdRequest.Builder().addNetworkExtrasBundle(AdMobAdapter::class.java, extras).build()
adView.loadAd(adRequest)
AdRequestSnippets.kt

Java

Bundle extras = new Bundle();
extras.putString("collapsible", "bottom");
AdRequest adRequest =
    new AdRequest.Builder().addNetworkExtrasBundle(AdMobAdapter.class, extras).build();
adView.loadAd(adRequest);
AdRequestSnippets.java

การกำหนดเป้าหมายเอง

คุณสามารถส่งคู่คีย์-ค่าที่กำหนดเองเพื่อกำหนดเป้าหมายแคมเปญ (รายการโฆษณา) ของ Google Ad Manager ได้ ตัวอย่างต่อไปนี้จะส่งคู่คีย์-ค่าที่กำหนดเองในคำขอโฆษณา

Kotlin

// Example: Pass custom targeting "age=25".
val newRequest = AdManagerAdRequest.Builder().addCustomTargeting("age", "25").build()
AdRequestSnippets.kt

Java

// Example: Pass custom targeting "age=25".
AdManagerAdRequest newRequest =
    new AdManagerAdRequest.Builder().addCustomTargeting("age", "25").build();
AdRequestSnippets.java

คุณสามารถส่งค่าหลายค่าสำหรับคีย์เป็นรายการสตริงได้ เช่น กำหนดเป้าหมายบุคคลที่มีอายุ 20 กว่าปีแทนที่จะกำหนดเป้าหมายเฉพาะผู้ที่มีอายุ 25 ปี

Kotlin

.addCustomTargeting("age", listOf("24", "25", "26"))
AdRequestSnippets.kt

Java

.addCustomTargeting("age", Arrays.asList("24", "25", "26"))
AdRequestSnippets.java

ดูตัวอย่างการกำหนดเป้าหมายเองของ Ad Manager เพื่อดูการใช้งานการกำหนดเป้าหมายเองในแอป Android API Demo

การยกเว้นหมวดหมู่

คุณสามารถเพิ่มระดับการยกเว้นหมวดหมู่ระดับช่องโฆษณาลงในคำขอได้โดยใช้ addCategoryExclusion() เมธอดดังนี้

Kotlin

// Example: Exclude "automobile" and "boat" categories.
val newRequest =
  AdManagerAdRequest.Builder()
    .addCategoryExclusion("automobile")
    .addCategoryExclusion("boat")
    .build()
AdRequestSnippets.kt

Java

// Example: Exclude "automobile" and "boat" categories.
AdManagerAdRequest newRequest =
    new AdManagerAdRequest.Builder()
        .addCategoryExclusion("automobile")
        .addCategoryExclusion("boat")
        .build();
AdRequestSnippets.java

ดูตัวอย่างการยกเว้นหมวดหมู่ของ Ad Manager เพื่อดูการใช้งานการยกเว้นหมวดหมู่ในแอป Android API Demo

ตัวระบุที่ผู้เผยแพร่โฆษณามีให้

คุณสามารถตั้งค่าตัวระบุที่ผู้เผยแพร่โฆษณามีให้ (PPID) เพื่อใช้ในการกำหนดความถี่สูงสุด การแบ่งกลุ่มและการกำหนดเป้าหมายผู้ชม การหมุนเวียนโฆษณาตามลำดับ และการควบคุมการแสดงโฆษณาตามกลุ่มผู้ชมแบบอื่นๆ ในทุกอุปกรณ์

หมายเหตุ: ฟีเจอร์นี้ไม่พร้อมให้บริการแก่ผู้เผยแพร่โฆษณาทุกราย โปรดดู รายละเอียด

ที่เกี่ยวกับ ตัวระบุที่ผู้เผยแพร่โฆษณามีให้

ตัวอย่างการตั้งค่า PPID มีดังนี้

Kotlin

val adRequest = AdManagerAdRequest.Builder().setPublisherProvidedId("AB123456789").build()
AdRequestSnippets.kt

Java

AdManagerAdRequest adRequest =
    new AdManagerAdRequest.Builder().setPublisherProvidedId("AB123456789").build();
AdRequestSnippets.java

ดูตัวอย่าง PPID ของ Ad Manager เพื่อดูการใช้งานตัวระบุที่ผู้เผยแพร่โฆษณามีให้ (PPID) ในแอป Android API Demo

สัญญาณที่ได้จากผู้เผยแพร่โฆษณา

คุณสามารถส่งข้อมูลกลุ่มเป้าหมายและข้อมูลตามบริบทเป็น สัญญาณที่ได้จากผู้เผยแพร่โฆษณา (PPS) ในคำขอโฆษณาได้ PPS ช่วยให้คุณใช้ข้อมูลผู้ใช้เพื่อปรับปรุง การสร้างรายได้แบบเป็นโปรแกรมได้โดยการสื่อสารลักษณะของกลุ่มเป้าหมายกับ ผู้เสนอราคาในการทำ ธุรกรรมทุกประเภท โดยใช้ การจัดหมวดหมู่มาตรฐานโดยไม่จำเป็นต้องแชร์ตัวระบุผู้ใช้ ลักษณะของกลุ่มเป้าหมาย อาจรวมถึงข้อมูลตามพฤติกรรมและความสนใจ (การจัดหมวดหมู่กลุ่มเป้าหมายของ IAB เวอร์ชัน 1.1) และข้อมูลตามบริบท (การจัดหมวดหมู่เนื้อหาของ IAB เวอร์ชัน 2.2)

Kotlin

val extras = Bundle()
// Set the demographic to an audience with an "Age Range" of 30-34 and an
// interest in mergers and acquisitions.
extras.putIntegerArrayList("IAB_AUDIENCE_1_1", arrayListOf(6, 284))
// Set the content to sedan, station wagon and SUV automotive values.
extras.putIntegerArrayList("IAB_CONTENT_2_2", arrayListOf(4, 5, 6))

val request =
  AdManagerAdRequest.Builder().addNetworkExtrasBundle(AdMobAdapter::class.java, extras).build()
AdRequestSnippets.kt

Java

Bundle extras = new Bundle();
// Set the demographic to an audience with an "Age Range" of 30-34 and an
// interest in mergers and acquisitions.
extras.putIntegerArrayList("IAB_AUDIENCE_1_1", new ArrayList<>(Arrays.asList(6, 284)));
// Set the content to sedan, station wagon and SUV automotive values.
extras.putIntegerArrayList("IAB_CONTENT_2_2", new ArrayList<>(Arrays.asList(4, 5, 6)));

AdManagerAdRequest request =
    new AdManagerAdRequest.Builder().addNetworkExtrasBundle(AdMobAdapter.class, extras).build();
AdRequestSnippets.java

URL เนื้อหา

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

Kotlin

val builder = AdManagerAdRequest.Builder()
builder.setContentUrl("https://www.example.com")
val request = builder.build()
AdRequestSnippets.kt

Java

AdManagerAdRequest.Builder builder = new AdManagerAdRequest.Builder();
builder.setContentUrl("https://www.example.com");
AdManagerAdRequest request = builder.build();
AdRequestSnippets.java

ความปลอดภัยของแบรนด์ (เบต้า)

หมายเหตุ: URL สำหรับเนื้อหาหลายรายการอยู่ในเวอร์ชันเบต้าแบบปิดสำหรับผู้เผยแพร่โฆษณาบางกลุ่ม

แอปพลิเคชันที่แสดงเนื้อหาแบบไดนามิกซึ่งมีไว้สำหรับกลุ่มเป้าหมายที่แตกต่างกันสามารถระบุรายการ URL สั้นๆ ได้ดังนี้

Kotlin

val urls =
  mutableListOf(
    "https://www.mycontenturl1.com",
    "https://www.mycontenturl2.com",
    "https://www.mycontenturl3.com",
    "https://www.mycontenturl4.com",
  )

val requestWithContent = AdManagerAdRequest.Builder().setNeighboringContentUrls(urls).build()
AdRequestSnippets.kt

Java

List<String> urls =
    Arrays.asList(
        "https://www.mycontenturl1.com",
        "https://www.mycontenturl2.com",
        "https://www.mycontenturl3.com",
        "https://www.mycontenturl4.com");

AdManagerAdRequest requestWithContent =
    new AdManagerAdRequest.Builder().setNeighboringContentUrls(urls).build();
AdRequestSnippets.java

.setNeighboringContentUrls() แตกต่างจาก .setContentUrl() ตรงที่ใช้สำหรับความปลอดภัยของแบรนด์เท่านั้น

หมายเหตุ: setNeighboringContentUrls จะใช้เฉพาะ URL 4 รายการแรกในรายการ ระบบจะละเว้น URL อื่นๆ