ทำไมเอกสาร API จึงเป็น Content Marketing Gold

สิ่งนี้ออกไปให้กับนักการตลาด B2B SaaS ของฉันทุกคนที่มีความหรูหราในการพยายามขายให้กับวิศวกรและนักพัฒนา

มันไม่ใช่งานง่าย มันไม่ง่ายเหมือนการลงโฆษณาที่ชาญฉลาดหรือการสัมมนาผ่านเว็บที่น่าสนใจ มันไม่ง่ายเหมือนการผลิต ebook และโพสต์สองสามโพสต์บน LinkedIn

มันซับซ้อนกว่าเล็กน้อย… แต่ไม่จำเป็นต้องรู้สึกว่าเป็นไปไม่ได้

ผลิตภัณฑ์ SaaS จำนวนมากได้เริ่มสร้างระบบนิเวศสำหรับนักพัฒนาซอฟต์แวร์และ API เพื่อนำเสนอข้อมูลและสร้างแรงบันดาลใจให้กับโซลูชันแบบกำหนดเองที่ช่วยเพิ่มรายได้และการเติบโตของธุรกิจ

เมื่อคุณดูความสำเร็จของระบบนิเวศ AppExchange ของ Salesforce และระบบนิเวศของนักพัฒนาซอฟต์แวร์ของ Shopify ที่เฟื่องฟู จะเห็นได้ชัดเจนว่าวิธีการนี้สามารถสร้างรายได้มหาศาลให้กับทั้งพาร์ทเนอร์และแบรนด์ ในปี 2564 พันธมิตรนักพัฒนาของ Shopify มีรายได้มากกว่า 230 ล้านดอลลาร์ และการศึกษาของ IDC (International Data Corporation) คาดการณ์ว่า Salesforce จะบริจาคเงิน 1.2 ล้านล้านดอลลาร์ให้กับเศรษฐกิจในท้องถิ่นทั่วโลก ไม่เลวใช่มั้ย ดูการเติบโตนี้จาก Shopify...

สิ่งนี้ไม่ได้เกิดขึ้นโดยบังเอิญ

มันเกิดขึ้นจากการลงทุนในชุมชนของคุณและลงทุนในเนื้อหาที่จะสนับสนุนพวกเขา

ช่อง YouTube ของ ShopifyDevs เป็นตัวอย่างที่ชัดเจนว่าการลงทุนในชุมชนของคุณเป็นอย่างไร ช่องนี้เต็มไปด้วยวิดีโอที่สนุก มีส่วนร่วม และออกแบบมาอย่างสวยงาม ซึ่งจะพูดถึงทุกอย่างตั้งแต่ขั้นตอนยุทธวิธีไปจนถึงการใช้ประโยชน์จาก API ไปจนถึงวิดีโอเชิงกลยุทธ์ระดับสูง

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

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

ในฐานะนักการตลาด เรามักจะมองข้ามความจริงที่ว่านี่เป็นพื้นที่ที่เราควรจะเล่นด้วย

เราไม่ควรปล่อยให้ทีมผลิตภัณฑ์ของเราออกไปพัฒนาเอกสาร API เราไม่ควรปล่อยให้ CTO เป็นผู้ต้องหาเวลาสร้างเอกสารชุดใหญ่

เราควรคิดถึงวิธีที่เราสามารถสนับสนุนทีมวิศวกรของเราเพื่อสร้างเอกสารและเนื้อหาที่จะเพิ่มคุณค่าให้กับชีวิตของลูกค้าได้อย่างแท้จริง

วิธีที่ดีที่สุดวิธีหนึ่งในการทำเช่นนั้นคือการยอมรับและลงทุนในเอกสารที่ดี

เอกสาร API ที่ยอดเยี่ยมนั้นถูกประเมินอย่างหนาแน่นว่าเป็นกลยุทธ์การตลาดเนื้อหาใน B2B SaaS

เอกสารที่ดีเยี่ยมสามารถ:

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

และอื่นๆ อีกมากมาย… นี่คือภาพรวมของฮับเอกสารยอดนิยมบางส่วนและประโยชน์ด้านการตลาดเนื้อหาที่พวกเขามอบให้กับแบรนด์ของพวกเขา:

แต่คุณต้องรู้ว่าคุณกำลังทำอะไรอยู่ ต่อไปนี้คือหกเทคนิคง่ายๆ ที่ควรคำนึงถึงเมื่อสร้างเอกสาร SaaS ของคุณ ฉันหวังว่าคุณสามารถใช้สิ่งนี้เพื่อให้แน่ใจว่าเอกสารที่คุณกำลังสร้างไม่ได้ถูกใช้เท่านั้น แต่ยังพบผ่านการค้นหาและกล่องจดหมายของลูกค้าของคุณเมื่อมีคนส่งอีเมลถึงพวกเขาว่า "ลองดูสิ"

มาเริ่มกันเลย…

รักษาเอกสารของคุณให้สะอาด

คุณไม่จำเป็นต้องคิดค้นล้อใหม่ที่นี่

บริษัทต่างๆ เช่น Shopify, Stripe, WorkOS และ Gitlab ได้แสดงให้เราเห็นว่าเอกสารที่ดีเป็นอย่างไร รูปแบบไม่จำเป็นต้องซับซ้อนเกินไป

ง่าย ๆ เข้าไว้.

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

ทำให้ง่ายต่อการนำทาง

คำแนะนำที่ใหญ่ที่สุดของฉันสำหรับนักการตลาดที่พยายามสร้างส่วนเอกสารในเว็บไซต์ของตนคือการปฏิบัติกับหน้าแรกของเอกสารให้เหมือนกับหน้า Landing Page เป้าหมายสำหรับหน้าแรกของศูนย์กลางเอกสารของคุณคือเพื่อ (i) นำพวกเขาไปยังเส้นทางหรือผลลัพธ์ที่พบบ่อยที่สุด และ (ii) ให้ความรู้แก่พวกเขาเกี่ยวกับสิ่งที่พวกเขาจะพบในเอกสารประกอบของบริษัท

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

นี่ไม่ใช่ที่ที่คุณชนะการเดินทางไปเมืองคานส์

นี่คือที่ที่คุณชนะการโปรโมตของคุณ

แนวทางที่น่าสนใจอีกประการหนึ่งที่ฉันเห็นโดยทีมงาน WorkOS คือความสามารถในการนำทางตามกรณีการใช้งาน Stripe ทำได้ดีโดยมีหน้าเอกสารก่อนหน้า API คุณสามารถเลือกได้ว่าต้องการหา Business Ops Docs หรือ Financial Services Docs...

ผลิตภัณฑ์อื่นที่ทำสิ่งนี้ได้ดีมากคือ Twilio:

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

จัดโครงสร้าง URL ของคุณด้วยความเป็นเลิศ

ต้องการเห็นเวทมนตร์ดิจิทัลหรือไม่? เยี่ยมชมเอกสารของ Stripe ดู URL และเลื่อน...

เมื่อคุณเลื่อน URL จะเปลี่ยนจาก docs/ api เป็น /api/authentication เป็น /api/metadata และส่วนขยายอื่น ๆ ทั้งหมดที่มี มันเป็นเรื่องของความงาม ทำไม

เนื่องจากแต่ละ URL เหล่านี้สามารถเชื่อมโยงได้และดึงดูดผู้คนไปยังส่วนนี้โดยเฉพาะ เป็นประสบการณ์ผู้ใช้ในอุดมคติ (การเลื่อนแบบไม่สิ้นสุด) ในขณะที่ยังคงให้ Stripe สามารถจัดทำดัชนีแต่ละส่วนเหล่านี้ใน Google ผ่านโดเมนของพวกเขา นี่คือสิ่งที่ความฝันของ SEO สร้างขึ้น...

ไม่เพียงแต่คุณจะสามารถบริโภคเนื้อหาโดยไม่ต้องไปที่หน้าใหม่ – คุณยังสามารถแบ่งปันเฉพาะส่วนต่างๆ โดยใช้ URL วันนี้ Stripe มีโดเมนอ้างอิงมากกว่า 45,000 โดเมนที่เชื่อมโยงกับเอกสารของพวกเขา กลยุทธ์ในการทำให้ส่วนสำคัญแต่ละส่วนเป็น URL ที่เชื่อมโยงได้เป็นวิธีที่ยอดเยี่ยมในการรับรองว่าผู้เขียน วิศวกร และนักพัฒนาจะเชื่อมโยงไปยังส่วนดังกล่าวตามความเหมาะสม

อย่าพยายาม 'ทำการตลาด' ในเอกสารของคุณ

การตลาดมีความสัมพันธ์แบบรักและเกลียดกับเอกสาร

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

อย่าให้ผู้คน 'ถือว่าความผิดพลาดของพวกเขา'

นี่เป็นคำแนะนำทางยุทธวิธีที่ค่อนข้างดี แต่นักพัฒนาต้องการค้นหาว่าทำไมสิ่งต่างๆ ถึงใช้ไม่ได้ผล

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

คำแนะนำสุดท้ายของฉันเกี่ยวกับการสร้างเอกสารที่ดีคือ...

เขียนเพื่อมนุษย์มาก่อน บอทที่สอง

นี่อาจเป็นส่วนที่สำคัญที่สุดของเอกสารประกอบ

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

แต่ความสามารถในการจับปริมาณการค้นหานั้นยากเย็นแสนเข็ญ หลังจากที่คุณแก้ปัญหาจริงและให้ความกระจ่างในเอกสารของคุณ สร้างเพื่อคนก่อน เพิ่มประสิทธิภาพที่สอง

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

ฉันมักจะพูดคุยถึงวิธีการใช้เนื้อหาเพื่อกำหนดรูปแบบวัฒนธรรม