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

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

ก่อนจะเริ่ม

สร้างบัญชี AdSense

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

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

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

เลือกคลังของไคลเอ็นต์

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

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

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

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

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

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

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

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

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

บทแนะนำการเริ่มใช้งานฉบับย่อ

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

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

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

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

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

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

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

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

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

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