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

การกำหนดเป้าหมายช่วยให้คุณสามารถให้ข้อมูลบริบทและกลุ่มเป้าหมายแก่ Google Mobile Ads SDK for React Native เพื่อแสดงโฆษณาที่เกี่ยวข้องต่อผู้ใช้

คุณกำหนดค่าการกำหนดเป้าหมายได้ในระดับต่อไปนี้

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

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

ข้อกำหนดเบื้องต้น

ตั้งค่า Google Mobile Ads SDK for React Native ก่อนดำเนินการต่อ

ตั้งค่าการกำหนดค่าคำขอ

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

หากต้องการใช้การตั้งค่าการกำหนดเป้าหมายจากคำขอโฆษณาแรก ให้ตั้งค่าพร็อพเพอร์ตี้ requestConfiguration เมื่อเรียกใช้เมธอด initialize ดังนี้

const requestConfiguration: RequestConfiguration = {
  maxAdContentRating: MaxAdContentRating.G,
  ageRestrictedTreatment: AgeRestrictedTreatment.CHILD,
  publisherPrivacyPersonalizationState:
    PublisherPrivacyPersonalizationState.DISABLED,
  testDeviceIds: ["TEST_DEVICE_HASHED_ID"],
};

initialize({requestConfiguration}, (_status: InitializationStatus) => {
  // SDK initialization is complete.
});

แทนที่ TEST_DEVICE_HASHED_ID ด้วยรหัสอุปกรณ์ทดสอบที่แฮชแล้ว รหัสนี้ระบุอุปกรณ์ที่ควรได้รับโฆษณาทดสอบ

หากต้องการอัปเดตการตั้งค่าการกำหนดเป้าหมายหลังจากเริ่มต้น Google Mobile Ads SDK for React Native ให้เรียกใช้เมธอด setRequestConfiguration เมธอด setRequestConfiguration จะแทนที่การกำหนดค่าที่มีอยู่และมีผลกับคำขอโฆษณาที่ตามมา

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

const requestConfiguration: RequestConfiguration = {
  ...getRequestConfiguration(),
  maxAdContentRating: MaxAdContentRating.PG,
  ageRestrictedTreatment: AgeRestrictedTreatment.TEEN,
};

setRequestConfiguration(requestConfiguration);

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

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

คุณตั้งค่าการดูแลตามอายุได้ด้วยพร็อพเพอร์ตี้ ageRestrictedTreatment ใน RequestConfiguration

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

const requestConfiguration: RequestConfiguration = {
  // Indicate that ad requests should have child age treatment.
  ageRestrictedTreatment: AgeRestrictedTreatment.CHILD,
};

setRequestConfiguration(requestConfiguration);

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

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

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

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

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

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

const requestConfiguration: RequestConfiguration = {
  maxAdContentRating: MaxAdContentRating.G,
};

setRequestConfiguration(requestConfiguration);

โปรดดูรายละเอียดในหัวข้อต่อไปนี้

ไม่บังคับ: ตั้งค่า PPT API (เบต้า)

API การดูแลด้านความเป็นส่วนตัวสำหรับผู้เผยแพร่โฆษณา (PPT) ช่วยให้คุณระบุได้ว่าจะปิดการปรับโฆษณาตามโปรไฟล์ของผู้ใช้สำหรับคำขอโฆษณาทั้งหมดหรือไม่โดยใช้พร็อพเพอร์ตี้ publisherPrivacyPersonalizationState ในออบเจ็กต์ RequestConfiguration เมื่อคุณใช้ฟีเจอร์นี้ Google Mobile Ads SDK for React Native จะรวมพารามิเตอร์การดูแลด้านความเป็นส่วนตัวของผู้เผยแพร่โฆษณา (PPT) ไว้ในคำขอโฆษณาทั้งหมดตลอดเซสชันที่เหลือ

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

const requestConfiguration: RequestConfiguration = {
  publisherPrivacyPersonalizationState:
    PublisherPrivacyPersonalizationState.DISABLED,
};

setRequestConfiguration(requestConfiguration);

ตั้งค่าออบเจ็กต์ AdRequest

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

ออบเจ็กต์ AdRequest จะส่งไปยังเมธอด load ของคลาสรูปแบบโฆษณา เช่น InterstitialAd.load สำหรับโฆษณาคั่นระหว่างหน้าหรือ BannerAd.load สำหรับโฆษณาแบนเนอร์ ซึ่งต่างจากการกำหนดค่าส่วนกลางที่ตั้งค่าด้วยเมธอด setRequestConfiguration

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

หากต้องการส่งพารามิเตอร์เฉพาะเครือข่ายไปยัง Google Mobile Ads SDK for React Native เช่น พารามิเตอร์สำหรับโฆษณาแบบยุบได้ ให้ใช้พร็อพเพอร์ตี้ extras

ตัวอย่างต่อไปนี้ตั้งค่าคีย์พารามิเตอร์เพิ่มเติมของ collapsible เป็นค่า bottom

const request: AdRequest = {
  adUnitId: AD_UNIT_ID,
  extras: {
    collapsible: 'bottom',
  },
};

ระบุ URL ของเนื้อหา

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

const request: AdRequest = {
  adUnitId: AD_UNIT_ID,
  contentUrl: 'https://www.example.com',
};

URL ของเนื้อหาต้องมีความยาวไม่เกิน 512 อักขระ