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

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

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

ดาวน์โหลดการสาธิต API

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

RequestConfiguration

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

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

Kotlin

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

Java

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

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

การตั้งค่า "ติดแท็กสำหรับการดูแลให้เหมาะสมกับเด็ก" มีไว้เพื่อปฏิบัติตามกฎหมายว่าด้วยความคุ้มครองข้อมูลส่วนบุคคลทางอินเทอร์เน็ตของเด็ก (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 (PPT) API เป็นเครื่องมือที่ไม่บังคับซึ่งช่วยให้แอประบุได้ว่าต้องการปิดการปรับโฆษณาตามโปรไฟล์ของผู้ใช้สำหรับคำขอโฆษณาทั้งหมดหรือไม่โดยใช้เมธอด setPublisherPrivacyPersonalizationState() เมื่อใช้ฟีเจอร์นี้ พารามิเตอร์การดูแลด้านความเป็นส่วนตัวสำหรับผู้เผยแพร่โฆษณา (PPT) จะรวมอยู่ในคำขอโฆษณาทั้งหมดในอนาคตตลอดระยะเวลาที่เหลือของเซสชัน

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

Kotlin

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

Java

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

คำขอโฆษณา

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

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

คุณสามารถส่งคู่คีย์-ค่าที่กําหนดเองเพื่อกําหนดเป้าหมายแคมเปญ Google Ad Manager (รายการโฆษณา) ผ่าน AdManagerAdRequest.Builder.addCustomTargeting() ดังนี้

Kotlin

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

Java

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

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

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

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

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

คุณเพิ่มระดับการยกเว้นหมวดหมู่ระดับช่องลงในคําขอได้โดยใช้วิธีต่อไปนี้จาก AdManagerAdRequest.Builder addCategoryExclusion()

Kotlin

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

Java

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

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

ตัวระบุที่ได้จากผู้เผยแพร่โฆษณา

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

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

Kotlin

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

Java

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

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

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

คุณสามารถส่งข้อมูลกลุ่มเป้าหมายและข้อมูลตามบริบทเป็นสัญญาณที่ได้จากผู้เผยแพร่โฆษณา (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 = AdRequest.Builder()
  .addNetworkExtrasBundle(AdMobAdapter::class.java, extras)
  .build()

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", arrayListOf(6,284));
// Set the content to sedan, station wagon and SUV automotive values.
extras.putIntegerArrayList("IAB_CONTENT_2_2", arrayListOf(4,5,6));

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

URL ของเนื้อหา

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

Kotlin

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

Java

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

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

แอปพลิเคชันที่แสดงเนื้อหาแบบไดนามิกซึ่งมีไว้สําหรับกลุ่มเป้าหมายที่แตกต่างกันจะระบุรายการ URL สั้นๆ ได้โดยใช้วิธี setNeighboringContentUrls() เมื่อสร้าง AdManagerAdRequest

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()

Java

ArrayList<String> urls = new ArrayList<String>();
urls.add("https://www.mycontenturl1.com");
urls.add("https://www.mycontenturl2.com");
urls.add("https://www.mycontenturl3.com");
urls.add("https://www.mycontenturl4.com");
AdManagerAdRequest requestWithContent = new AdManagerAdRequest.Builder()
    .setNeighboringContentUrls(urls)
    .build();

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