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

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

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

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

ดาวน์โหลด API Demo

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

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

RequestConfiguration

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

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

Kotlin

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

Java

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

โปรดตั้งค่าการกำหนดค่าคำขอก่อนที่จะ คุณ เริ่มต้นใช้งาน 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)

Java

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

หากต้องการระบุการดูแลตามอายุของวัยรุ่นหรืออายุที่ไม่ได้ระบุ ให้แทนที่การตั้งค่า 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 จะใช้การดูแลที่เข้มงวดมากที่สุด

การตั้งค่าให้เหมาะสมกับเด็ก

แทน

ตามวัตถุประสงค์ของ กฎหมายว่าด้วยความคุ้มครองข้อมูลส่วนบุคคลทางอินเทอร์เน็ตของเด็ก (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)

Java

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

คุณทำเครื่องหมายให้กับคำขอโฆษณาเพื่อรับการปฏิบัติสำหรับผู้ใช้ในเขตเศรษฐกิจยุโรป (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)

Java

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

แท็กเพื่อเปิดใช้การตั้งค่าให้เหมาะสมกับเด็ก และ 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)

Java

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

โปรดดูข้อมูลเพิ่มเติมดังต่อไปนี้

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)

Java

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

คำขอโฆษณา

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

เพิ่มส่วนเสริมของเครือข่าย

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

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

Kotlin

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

Java

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