เริ่มต้นใช้งาน

เอกสารนี้มีไว้สำหรับนักพัฒนาซอฟต์แวร์ที่ต้องการใช้ API การจัดการ AdSense เพื่อรับข้อมูลเกี่ยวกับบัญชี AdSense เอกสารนี้ถือว่าคุณคุ้นเคยกับแนวคิดการเขียนโปรแกรมเว็บและรูปแบบข้อมูลเว็บแล้ว

ก่อนจะเริ่ม

รับบัญชี AdSense

ลงชื่อสมัครใช้หรือลงชื่อเข้าใช้บัญชี AdSense เพื่อเริ่มต้นใช้งาน

ทำความคุ้นเคยกับ AdSense

หากคุณไม่คุ้นเคยกับแนวคิดของ AdSense โปรดอ่านข้อมูลเบื้องต้นเกี่ยวกับ AdSense และทดสอบกับ UI ของ AdSense ก่อนเริ่มเขียนโค้ด

เลือกไลบรารีของไคลเอ็นต์

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

• การตรวจสอบสิทธิ์
• การค้นพบบริการ
• การสร้างคำขอไปยัง API
• การแยกวิเคราะห์คำตอบ

อ่านคำแนะนำในการติดตั้งและกำหนดค่าไลบรารีของไคลเอ็นต์ที่เลือก ซึ่งโดยทั่วไปจะอยู่ในไฟล์ README ในไดเรกทอรีรากของที่เก็บ

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

ลงทะเบียนแอปพลิเคชันของคุณ

หากต้องการใช้ AdSense Management API คุณต้องลงทะเบียนแอปพลิเคชันที่คุณกำลังพัฒนาโดยสร้างโปรเจ็กต์และสร้าง Client-ID

ลงทะเบียนแอป

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

หมายเหตุ: บัญชี Google ที่ใช้ในการลงทะเบียนควรเป็นบัญชีนักพัฒนาซอฟต์แวร์ กล่าวคือ บัญชีที่คุณต้องการให้ผู้ใช้แอปพลิเคชันเห็นว่าเป็นนักพัฒนาซอฟต์แวร์ของแอปพลิเคชัน บัญชีนี้ไม่จำเป็นต้องเชื่อมโยงกับข้อมูลการเข้าสู่ระบบ AdSense เนื่องจากผู้ใช้จะให้สิทธิ์เข้าถึงบัญชีของตนขณะใช้แอปพลิเคชัน

บทแนะนำการเริ่มต้นอย่างรวดเร็ว

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

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

   ไคลเอ็นต์โฆษณาแสดงถึงการเชื่อมโยงระหว่างบัญชี AdSense กับผลิตภัณฑ์ AdSense เช่น โฆษณาแบบคอนเทนต์หรือโฆษณา Search บัญชี AdSense มีลูกค้าโฆษณา 1 รายหรือหลายรายก็ได้

   1. สำหรับเว็บแอปพลิเคชัน ระบบจะเปลี่ยนเส้นทางผู้ใช้ไปยังเว็บไซต์ซึ่ง จะเลือกให้สิทธิ์เข้าถึงได้ เมื่อให้สิทธิ์แล้ว ระบบจะเปลี่ยนเส้นทางผู้ใช้ไปยัง URL เรียกกลับที่ระบุไว้ในคอนโซล Google API
   2. แอปพลิเคชันที่ติดตั้งทำงานคล้ายคลึงกัน ไลบรารีของไคลเอ็นต์จะพยายามเปิดหน้าต่างเบราว์เซอร์และใช้รหัสการให้สิทธิ์ สำหรับแอปพลิเคชัน Android, Chrome และ iOS วิธีนี้เป็นวิธีการเฉพาะแพลตฟอร์ม
2. ใช้โปรแกรมสำรวจ Google APIs สำหรับ reports.generate เพื่อขอรายงานต่อไปนี้
   • date_range: YESTERDAY
   • dimensions: DATE
   • metrics: ESTIMATED_EARNINGS

   รายงานให้ข้อมูลเชิงลึกเกี่ยวกับรายได้ที่ได้รับ รวมถึงสิ่งที่ส่งผลต่อรายได้เหล่านั้น ซึ่งสามารถแสดงได้ในทั้งบัญชีหรือกับส่วนย่อยของหน่วยโฆษณาผ่านการใช้แชแนล

3. ลองขอรายงานเดียวกันนี้จากแอปพลิเคชันของคุณ
4. คุณสามารถกรองรายงานตามหน่วยโฆษณา ดึงข้อมูลรายการหน่วยโฆษณาโดยใช้ adunits.list โปรดทราบว่าจำเป็นต้องมีรหัสไคลเอ็นต์โฆษณา (ดาวน์โหลดจากขั้นตอนที่ 1) หลังจากเลือกหน่วยโฆษณาแล้ว ให้ใช้รหัสในพารามิเตอร์ตัวกรองสำหรับ reports.generate ดังนี้

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

   • date_range: YESTERDAY
   • dimensions: DATE
   • metrics: ESTIMATED_EARNINGS
   • filter: AD_UNIT_ID==ca-pub-123456789:987654321
5. ลองกรองตามแชแนลที่กำหนดเองหรือแชแนล URL หรือใช้ตัวกรองหลายรายการผสมกัน

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

คุณพร้อมเริ่มต้นใช้งานแล้วด้วยการสำรวจการโทรและแหล่งข้อมูลอื่นๆ ที่มีอยู่ในเอกสารอ้างอิง