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

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

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

ก่อนดำเนินการต่อ ให้ตั้งค่า GMA Next-Gen SDK

RequestConfiguration

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

สร้างออบเจ็กต์ RequestConfiguration ด้วยแท็กการกำหนดเป้าหมายที่ต้องการโดยใช้ เครื่องมือสร้าง จากนั้นตั้งค่าการกำหนดค่าโดยเรียกใช้ MobileAds.setRequestConfiguration()

Kotlin

val requestConfiguration = RequestConfiguration
  .Builder()
  // Set your targeting tags.
  .setTagForChildDirectedTreatment(RequestConfiguration.TagForChildDirectedTreatment.TAG_FOR_CHILD_DIRECTED_TREATMENT_TRUE)
  .build()

MobileAds.setRequestConfiguration(requestConfiguration)

Java

RequestConfiguration requestConfiguration = new RequestConfiguration
  .Builder()
  // Set your targeting tags.
  .setTagForChildDirectedTreatment(TagForChildDirectedTreatment.TAG_FOR_CHILD_DIRECTED_TREATMENT_TRUE)
  .build();

MobileAds.setRequestConfiguration(requestConfiguration);

หากต้องการใช้แท็กการกำหนดเป้าหมายจากคำขอโฆษณารายการแรก ให้ระบุการกำหนดค่าคำขอระหว่างการเริ่มต้น SDK ดังนี้

Kotlin

val requestConfiguration = RequestConfiguration
  .Builder()
  // Set your targeting tags.
  .setTagForChildDirectedTreatment(RequestConfiguration.TagForChildDirectedTreatment.TAG_FOR_CHILD_DIRECTED_TREATMENT_TRUE)
  .build()

CoroutineScope(Dispatchers.IO).launch {
  // Initialize GMA Next-Gen SDK on a background thread.
  MobileAds.initialize(
    this@MainActivity,
    InitializationConfig
      // Sample AdMob app ID: ca-app-pub-3940256099942544~3347511713
      .Builder("SAMPLE_APP_ID")
      .setRequestConfiguration(requestConfiguration)
      .build()
  ) {
    // Adapter initialization is complete.
  }
  // Other methods on MobileAds can now be called.
}

Java

RequestConfiguration requestConfiguration = new RequestConfiguration
    .Builder()
    // Set your targeting tags.
    .setTagForChildDirectedTreatment(TagForChildDirectedTreatment.TAG_FOR_CHILD_DIRECTED_TREATMENT_TRUE)
    .build();

new Thread(
    () -> {
      // Initialize GMA Next-Gen SDK on a background thread.
      MobileAds.initialize(
          this,
          // Sample AdMob app ID: ca-app-pub-3940256099942544~3347511713
          new InitializationConfig
              .Builder("SAMPLE_APP_ID")
              .setRequestConfiguration(requestConfiguration)
              .build(),
          initializationStatus -> {
            // Adapter initialization is complete.
          });
      // Other methods on MobileAds can now be called.
    })
    .start();

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

GMA Next-Gen SDK มีการตั้งค่าการดูแลตามอายุเพื่อช่วยคุณจัดการการปฏิบัติตามกฎระเบียบด้านความเป็นส่วนตัวที่เกี่ยวข้อง กับเด็กและวัยรุ่น GMA Next-Gen SDK การตั้งค่าการดูแลตามอายุช่วยให้คุณระบุได้ว่า GMA Next-Gen SDK ควรใช้ การป้องกันการแสดงโฆษณาที่เฉพาะเจาะจงสำหรับเด็กหรือวัยรุ่นหรือไม่ เมื่อใช้การตั้งค่านี้ GMA Next-Gen SDK จะรวมพารามิเตอร์ tfat ไว้ในคำขอโฆษณา โปรดปรึกษาที่ปรึกษาด้านกฎหมายเพื่อกำหนดการดูแลตามอายุตามหลักเกณฑ์สำหรับผู้ใช้ตามภาระหน้าที่ทางกฎหมายและกฎระเบียบ

คุณสามารถตั้งค่าการดูแลตามอายุด้วยเมธอด 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);

ตั้งค่าการดูแลตามอายุของวัยรุ่น

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

Kotlin

val requestConfiguration = MobileAds.getRequestConfiguration().toBuilder()
    // Indicate that ad requests should have teenage treatment.
    .setAgeRestrictedTreatment(AgeRestrictedTreatment.TEEN)
    .build()
MobileAds.setRequestConfiguration(requestConfiguration)

Java

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

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

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

Kotlin

val requestConfiguration = MobileAds.getRequestConfiguration().toBuilder()
    // Indicate that ad requests should have unspecified age treatment.
    .setAgeRestrictedTreatment(AgeRestrictedTreatment.UNSPECIFIED)
    .build()
MobileAds.setRequestConfiguration(requestConfiguration)

Java

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

ย้ายข้อมูลไปยังการดูแลตามอายุจาก 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 = RequestConfiguration
  .Builder()
  .setTagForChildDirectedTreatment(RequestConfiguration.TagForChildDirectedTreatment.TAG_FOR_CHILD_DIRECTED_TREATMENT_TRUE)
  .build()

MobileAds.setRequestConfiguration(requestConfiguration)

Java

RequestConfiguration requestConfiguration = new RequestConfiguration
  .Builder()
  .setTagForChildDirectedTreatment(TagForChildDirectedTreatment.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) ที่มีอายุต่ำกว่าอายุที่ให้ความยินยอมได้ ซึ่งจะ ป้องกันการส่งตัวระบุโฆษณา (AAID)ของ Android ด้วย

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

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

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

Kotlin

val requestConfiguration = RequestConfiguration
  .Builder()
  .setTagForUnderAgeOfConsent(RequestConfiguration.TagForUnderAgeOfConsent.TAG_FOR_UNDER_AGE_OF_CONSENT_TRUE)
  .build()

MobileAds.setRequestConfiguration(requestConfiguration)

Java

RequestConfiguration requestConfiguration = new RequestConfiguration
  .Builder()
  .setTagForUnderAgeOfConsent(TagForUnderAgeOfConsent.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 = RequestConfiguration
  .Builder()
  .setMaxAdContentRating(RequestConfiguration.MaxAdContentRating.MAX_AD_CONTENT_RATING_G)
  .build()

MobileAds.setRequestConfiguration(requestConfiguration)

Java

RequestConfiguration requestConfiguration = new RequestConfiguration
  .Builder()
  .setMaxAdContentRating(MaxAdContentRating.MAX_AD_CONTENT_RATING_G)
  .build();

MobileAds.setRequestConfiguration(requestConfiguration);

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

การดูแลด้านความเป็นส่วนตัวสำหรับผู้เผยแพร่โฆษณา (เบต้า)

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

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

Kotlin

val requestConfiguration = RequestConfiguration
  .Builder()
  .setPublisherPrivacyPersonalizationState(RequestConfiguration.PublisherPrivacyPersonalizationState.DISABLED)
  .build()

MobileAds.setRequestConfiguration(requestConfiguration)

Java

RequestConfiguration requestConfiguration = new RequestConfiguration
  .Builder()
  .setPublisherPrivacyPersonalizationState(RequestConfiguration.PublisherPrivacyPersonalizationState.DISABLED)
  .build();

MobileAds.setRequestConfiguration(requestConfiguration);

คำขอโฆษณา

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

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

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

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

Kotlin

val extras = Bundle()
extras.putString("collapsible", "bottom")
val adRequest =
  NativeAdRequest.Builder("AD_UNIT_ID", listOf(NativeAd.NativeAdType.NATIVE))
    .setGoogleExtrasBundle(extras)
    .build()
NativeAdLoader.load(adRequest, adCallback)

Java

Bundle extras = new Bundle();
extras.putString("collapsible", "bottom");
NativeAdRequest adRequest =
  new NativeAdRequest.Builder("AD_UNIT_ID", Arrays.asList(NativeAd.NativeAdType.NATIVE))
    .setGoogleExtrasBundle(extras)
    .build();
NativeAdLoader.load(adRequest, adCallback);