เกตเวย์ API คอนเวอร์ชั่นและ Signals Gateway: คู่มือการแก้ไขปัญหา

ขั้นตอนการแก้ไขปัญหาสำหรับโฮสต์

ใช้ขั้นตอนการแก้ไขปัญหาตามลำดับสำหรับผลิตภัณฑ์เกตเวย์, เกตเวย์ API คอนเวอร์ชั่น หรือ Signals Gateway ตามด้านล่างนี้เพื่อแก้ไขปัญหา

ตำแหน่งข้อมูลของการตรวจสอบระบบของผลิตภัณฑ์เกตเวย์

ไปที่

https://<Gateway Products Endpoint>/hub/health/

โฮสต์จะสามารถตรวจสอบสถานะเซิร์ฟเวอร์ของอินสแตนซ์ได้ผ่านบริการตรวจสอบประสิทธิภาพการทำงานนี้

ปัญหาที่ 1: UI เกตเวย์ของโฮสต์ไม่สามารถเข้าถึงได้หรือไม่แสดงข้อมูลใดๆ

ขั้นตอนที่ 1 ใช้ตัวตรวจสอบ DNS ออนไลน์ เช่น https://dnschecker.org/ เพื่อตรวจสอบยืนยันว่าโดเมนเกตเวย์ได้รับการแก้ไขเป็นที่อยู่ IP ที่ถูกต้องตามที่ระบุไว้ในการตั้งค่าอินสแตนซ์และมีการเผยแพร่อย่างครบถ้วน หรือไม่ ให้คุณรอสักระยะหนึ่งเพื่อให้ DNS ได้รับการเผยแพร่อย่างครบถ้วน และตรวจสอบว่าคุณได้สร้างบันทึก CNAME ในผู้รับจดทะเบียนโดเมนของคุณแล้ว

ขั้นตอนที่ 2 เครือข่ายอาจไม่สามารถเข้าถึงได้ชั่วคราว โปรดรอสักครู่ก่อนที่จะเข้าสู่ระบบ UI ผลิตภัณฑ์เกตเวย์อีกครั้ง หรือรีเฟรชหน้าเว็บ

ขั้นตอนที่ 3 ทรัพยากรของอินสแตนซ์อาจไม่เพียงพอ ยกเลิกการทำงานของพ็อดเพื่อปล่อยทรัพยากรโดยทำตามขั้นตอนด้านล่างนี้

เชื่อมต่อกับตัวจัดการเซสชั่นและเรียกใช้คำสั่ง kubectl delete deployment capig เพื่อหยุดการทำงานของพ็อดผลิตภัณฑ์เกตเวย์
รอ 5 นาที แล้วจึงเรียกใช้คำสั่ง kubectl get pods -A สถานะพ็อดทั้งหมดควรเป็นกำลังทำงานอยู่หรือเสร็จสมบูรณ์แล้ว
หากไม่เป็นเช่นนั้น ให้เรียกใช้คำสั่ง kubectl delete deployment hub เพื่อหยุดการทำงานของพ็อดฮับ ทำขั้นตอนข้างต้นซ้ำ

ขั้นตอนที่ 4 ถอนการติดตั้งและติดตั้งอินสแตนซ์อีกครั้งหากเป็นอินสแตนซ์ใหม่

ขั้นตอนที่ 5 แจ้งให้ผู้ติดต่อของ Meta ทราบ (ถ้ามี)

ไฟล์บันทึกของผลิตภัณฑ์เกตเวย์
คุณสามารถดาวน์โหลดได้จากหน้าเว็บ /hub/settings/updates โดยคลิกที่ปุ่ม "ดาวน์โหลดไฟล์บันทึก"
บันทึกภาพหน้าจอเครื่องมือ UI เกตเวย์ของโฮสต์ที่เกิดข้อผิดพลาด

"Error 400: Identity Pool does not exist (myproject-3-XXXXX.svc.id.goog)" เกิดขึ้นระหว่างการเริ่มต้นใช้งานโฮสต์ GCP

ข้อผิดพลาดนี้มักเกิดขึ้นเนื่องจากคุณไม่ได้สร้างคลัสเตอร์ Google Kubernetes Engine ในบัญชี GCP ของคุณและต้องใช้เวลาในการสร้างทรัพยากรพื้นฐานบางอย่างในครั้งแรก คุณควรใช้สคริปต์ถอนการติดตั้งที่อธิบายไว้ในคู่มือการถอนการติดตั้งเพื่อล้างการติดตั้งและลองติดตั้งใหม่อีกครั้ง

เซสชั่น CloudShell หมดเวลาระหว่างที่เริ่มต้นใช้งานโฮสต์ GCP

หากปล่อยเซสชั่น CloudShell ทิ้งไว้เป็นเวลานาน เทอร์มินัล CloudShell อาจถูกยกเลิกการเชื่อมต่อได้ แม้แต่ในกรณีนี้ การติดตั้งอาจจะเสร็จสมบูรณ์ไปแล้ว หากต้องการดูคำแนะนำในการติดตั้ง โปรดเปิดหน้า GCP Cloud Storage และค้นหาที่เก็บข้อมูลที่ชื่อ capig-{your_login_id}-XXX-storage-bucket ซึ่งจะมีไฟล์ชื่อ capig-onboarding-guide.txt โปรดเปิดไฟล์ดังกล่าวและทำตามคำแนะนำที่ให้ไว้

ขั้นตอนการแก้ไขปัญหาสำหรับบัญชี: การเชื่อมต่อกับเกตเวย์

ทำตามขั้นตอนการแก้ไขปัญหาด้านล่างเพื่อช่วยแก้ไขปัญหา:

ปัญหาที่ 1: ไม่สามารถติดตั้งให้เสร็จเรียบร้อยได้

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

ปัญหาที่ 2: ไม่สามารถเข้าถึง UI ของเกตเวย์หรือไม่มีการแสดงข้อมูลเลย

ขั้นตอนที่ 1 ตรวจสอบว่าเครือข่ายล่มชั่วคราวหรือไม่ รอสักครู่เพื่อเข้าสู่ระบบ UI ของผลิตภัณฑ์เกตเวย์อีกครั้งหรือรีเฟรชหน้าเว็บ

ขั้นตอนที่ 2 แจ้งให้ผู้ติดต่อของ Meta ทราบ (ถ้ามี)

ไฟล์บันทึกของผลิตภัณฑ์เกตเวย์
บันทึกภาพหน้าจอของคอนโซลจากเครื่องมือของผู้พัฒนาของ UI เกตเวย์ของโฮสต์ที่เกิดข้อผิดพลาด

ปัญหาที่ 3: ไม่ได้รับเหตุการณ์เกตเวย์หลังจากติดตั้งเสร็จเรียบร้อย

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

การวินิจฉัย

เปิด UI ของผลิตภัณฑ์เกตเวย์ของคุณ จากนั้นเลือก เว็บไซต์ -> เว็บไซต์ที่ถูกบล็อก จากเมนูทางด้านซ้าย

การแก้ไขปัญหา

เลิกบล็อกเว็บไซต์ใดก็ตามที่คุณต้องการรับและเผยแพร่เหตุการณ์

ขั้นตอนที่ 2 อาจไม่ได้ติดตั้งพิกเซลด้วยวิธีมาตรฐาน เพื่อให้ผลิตภัณฑ์เกตเวย์ทำงานได้อย่างถูกต้อง เราขอแนะนำให้เพิ่มพิกเซลลงในแท็ก <head> ของเว็บไซต์ของคุณโดยตรง

การวินิจฉัย

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

การแก้ไขปัญหา

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

ขั้นตอนที่ 3 การกำหนดค่า DNS อาจไม่สมบูรณ์หรือไม่ถูกต้อง พิกเซลจะสื่อสารกับเกตเวย์บนโดเมนที่เหมาะสำหรับการสื่อสารนี้ ซึ่งตามหลักการแล้วจะเป็นหน้าเว็บเดียวกันกับหน้าเว็บที่ส่งพิกเซล ตัวอย่างเช่น หากส่งพิกเซลบน advertiser.com ตามหลักการแล้ว พิกเซลบน gateway.advertiser.com จะสามารถเข้าถึงเกตเวย์ได้

โดเมนย่อยของโดเมนของบัญชี (โดเมนที่ส่งพิกเซล) จะต้องเชื่อมโยงกับโดเมนย่อยของโฮสต์ผ่านบันทึก CNAME บนผู้ให้บริการ DNS ของผู้ลงโฆษณา เพื่อให้พิกเซลสามารถเข้าถึงตำแหน่งข้อมูลของผลิตภัณฑ์เกตเวย์ได้โดยผ่านการเรียกใช้คำขอของบุคคลที่หนึ่ง

การวินิจฉัย

ใช้ตัวตรวจสอบ DNS ออนไลน์ เช่น https://dnschecker.org/ เพื่อตรวจสอบยืนยันว่าบันทึก CNAME ตามที่อธิบายไว้ข้างต้นนั้นได้รับการตั้งค่าอย่างถูกต้องหรือไม่ โดยที่โดเมนย่อยของบัญชีจะชี้ไปที่โดเมนย่อยของโฮสต์อย่างถูกต้อง ซึ่งจะชี้ไปที่โดเมนที่มีการปรับสมดุลการโหลดซึ่งได้รับการกำหนดให้เมื่อสร้างขึ้น ในที่สุดแล้ว หากโดเมนย่อยของบัญชีไม่ได้ชี้ไปที่โดเมนที่มีโหลดสมดุล โปรดดูส่วนการแก้ไขปัญหาเพื่อดำเนินขั้นตอนต่อไป

การแก้ไขปัญหา

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

ขั้นตอนที่ 4 เหตุการณ์อาจถูกบล็อกโดยนโยบายการรักษาความปลอดภัยของเนื้อหา (CSP) เว็บไซต์บางเว็บอาจมี CSP ที่บล็อกเหตุการณ์ต่างๆ ไม่ให้ผลิตภัณฑ์เกตเวย์สามารถรับได้

การวินิจฉัย

ตรวจสอบว่ามีการตั้งค่าส่วนหัวการตอบกลับนโยบายการรักษาความปลอดภัยของเนื้อหาบนเซิร์ฟเวอร์จากเว็บไซต์ของผู้ลงโฆษณาหรือไม่

การแก้ไขปัญหา

อนุญาตให้เพิ่มโดเมนย่อยลงในกฎ CSP เพื่อให้เป็นข้อยกเว้นจากนโยบาย

ขั้นตอนที่ 5 ยกเลิกการเชื่อมต่อพิกเซลให้หมด แล้วเชื่อมต่ออีกครั้ง

ขั้นตอนที่ 6 ตรวจสอบว่าคุณใช้โทเค็นการเข้าถึงระบบที่ถูกต้อง

การวินิจฉัย

เข้าไปที่ https://<Gateway Product Endpoint>/capig/graphiql/. วางคำสั่งด้านล่างพร้อมด้วย tenantId เพื่อรับโทเค็นการเข้าถึงที่เกี่ยวข้อง

query test {
   tenantQueries (tenantId:"") {
    account {
      signalConfigs {
        connectionId
        connectionStatus {
          badToken
          accessTokenAvailable 
        }
      }
    }
  }
}

หากต้องการค้นหา tenantId ให้ไปที่ UI ของผลิตภัณฑ์เกตเวย์ แล้วเลือกบัญชีที่เกี่ยวข้องซึ่งมีลิงก์ URL แสดงเป็น https://<Gateway Product Endpoint>/hub/capig/?tenant=<tenentId>

หากผลของ badToken ส่งคืนเป็น true กลับมา ให้แก้ไขโดยคลิกที่ปุ่ม “เพิ่มแหล่งข้อมูล” เพื่อเพิ่มแหล่งข้อมูลเดียวกันอีกครั้ง

ขั้นตอนที่ 7 ตรวจสอบยืนยันกับโฮสต์ของคุณว่าสามารถเข้าถึง UI ของโฮสต์ได้หรือไม่ และทำตามขั้นตอนการแก้ไขปัญหาในคู่มือนี้