การทำผังผู้ใช้ในแอพและเพจต่างๆ

Facebook จะออก ID ผู้ใช้ในแอพสำหรับผู้ที่เข้าสู่ระบบอินสแตนซ์ของแอพเป็นครั้งแรกและสำหรับผู้ที่เข้าสู่ระบบด้วยการเข้าสู่ระบบแบบจำกัดข้อมูล และ Facebook จะออก ID ผู้ใช้ในเพจสำหรับผู้ที่ใช้บอท Messenger เป็นครั้งแรก โดยนิยามแล้ว หมายความว่าคนคนเดียวกันอาจได้รับ ID ไม่เหมือนกันเมื่อใช้แอพและบอทเหล่านี้

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

วิธีทำผังคนคนเดียวกันในแอพต่างๆ มี 3 วิธี ดังนี้

• ช่อง token_for_business ในส่วนของโหนดผู้ใช้
• คุณสมบัติ token_for_business ในอ็อบเจ็กต์ signed_request ที่ส่งผ่านไปยังแอพซึ่งแสดงภายในเฟรม Facebook Canvas
• จุดเชื่อมโยง ids_for_business ในส่วนของโหนดผู้ใช้

ก่อนจะใช้กลไกเหล่านี้ คุณจะต้องแจ้งให้ Facebook ทราบว่ามีธุรกิจเดียวกันเป็นเจ้าของหรือให้บริการแอพต่างๆ ของคุณ เพื่อแจ้งให้เราทราบ คุณต้องใช้ตัวจัดการธุรกิจของ Facebook เพื่อ:

• สร้างธุรกิจใหม่หรือ
• เชื่อมโยงแอพของคุณเข้ากับธุรกิจที่มีอยู่

ช่อง token_for_business ในโหนดผู้ใช้

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

GET /me?fields=token_for_business

ซึ่งจะให้ผลลัพธ์ดังนี้

{
  "id": "1234567890"
  "token_for_business": "weg23ro87gfewblwjef"
}

หมายเหตุเกี่ยวกับการใช้:

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

เพื่อความสะดวก ช่อง token_for_business สามารถใช้ได้กับ API ทุกเวอร์ชั่น

คุณสมบัติ token_for_business ในอ็อบเจ็กต์ signed_request ของ Canvas

หากแอพเชื่อมโยงกับตัวจัดการธุรกิจแล้วและผู้ใช้ลงชื่อเข้าใช้แอพแล้ว ระบบจะเพิ่มช่อง token_for_business และส่งไปยังแอพผ่าน signed_request ที่ส่งไปยังแอพ Canvas เมื่อโหลด เพื่อให้แอพที่มี Canvas ทำผังผู้ใช้ข้ามระหว่างหลายแอพได้ง่ายขึ้น ตัวอย่างเช่น:

{
  "algorithm": "HMAC-SHA256",
  "expires": 1414263600,
  "issued_at": 1414257389,
  "oauth_token": "CAAGEkq9GMZAkBAFnvvQ3M6msZBKITLa1gVZBVdnLTdJue2QeV6fMKRXn4G6fcEZB5ZAJyg3z6HdaKOJCCMJ1l9YFWmN4hq6nNnx77f9O7SYhsnPcJ6iH79xjFwqhrALgieDp7GiziMy5Y3Mol6RzHvCM5ceqQe9ZAijvrWZB5hEIwphbMQKEwZA4ZBozXP3NJgEZA3nZCMTTtvleWpxfmqIqO5XwxneCZBsZC4",
  "token_for_business": "AbwoGqummPbF3zp_",
  "user_id": "10154418713995634"
}

ค่าของช่อง token_for_business จะเหมือนกัน หากมีการสืบค้นในโหนด User โดยตรง เช่น ผ่าน /me?fields=token_for_business และยังยึดตามกฎเกณฑ์เดียวกันด้วย กล่าวคือหากมีการเปลี่ยนแปลงธุรกิจที่เป็นเจ้าของ ค่า token_for_business ก็จะเปลี่ยนไปด้วย

หากแอพไม่ได้เชื่อมโยงกับตัวจัดการธุรกิจหรือผู้ใช้ไม่ได้ลงชื่อเข้าใช้แอพ คุณสมบัติ token_for_business จะไม่ปรากฏในอ็อบเจ็กต์ signed_request

จุดเชื่อมโยง ids_for_business ในโหนดผู้ใช้

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

GET /me/ids_for_business

ตัวอย่างการตอบกลับ:

{
  "data": [
    {
      "id": "10153949089790582", 
      "app": {
        "name": "Business's App 1", 
        "namespace": "business_app_1", 
        "id": "647733625268125"
      }
    }, 
    {
      "id": "605665581", 
      "app": {
        "name": "Business's App 2", 
        "namespace": "business_app_2", 
        "id": "370612223054807"
      }
    }, 
    {
      "id": "10154053730190582", 
      "app": {
        "name": "Business's App 3", 
        "namespace": "business_app_3", 
        "id": "194890427204075"
      }
    }
  ]
}

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

คำถามที่พบบ่อย

ฉันต้องใช้ API การทำผังธุรกิจหรือไม่

ไม่ต้องใช้ API การทำผังธุรกิจจะมีประโยชน์เฉพาะกับธุรกิจที่ให้บริการแอพมากกว่า 1 แอพบน Facebook และต้องการทำผัง ID ผู้ใช้เดียวกันในแต่ละแอพ หากคุณมีแอพหลัก 1 แอพ คุณอาจไม่ต้องใช้ API การทำผังธุรกิจและไม่จำเป็นต้องตั้งค่าธุรกิจหรือเชื่อมโยงแอพกับธุรกิจ

ตัวจัดการธุรกิจคืออะไร

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

ฉันคิดว่าฉันไม่ต้องใช้ API การทำผังธุรกิจ แต่ฉันควรเชื่อมโยงแอพกับธุรกิจหรือไม่

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

ฉันสามารถเชื่อมโยงแอพกับหลายๆ ธุรกิจได้หรือไม่

ไม่ได้ หนึ่งแอพสามารถเชื่อมโยงกับหนึ่งธุรกิจได้เท่านั้น

ฉันสามารถโอนแอพไปให้อีกธุรกิจหนึ่งได้หรือไม่

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