บริการแจ้งเตือน

บริการการแจ้งเตือนของ AFP ช่วยให้แพลตฟอร์ม AFP Transparent ได้รับการแจ้งเตือนเมื่อPlatformChildSiteได้รับอนุมัติ ซึ่งหมายความว่าเว็บไซต์พร้อมใช้งานใน API แล้ว

หากต้องการรับการแจ้งเตือน ให้ใช้เซิร์ฟเวอร์ที่ยอมรับคำขอ POST และแยกวิเคราะห์เพย์โหลด JSON ที่ระบุไว้ในสคีมา (ดูตัวอย่างการตั้งค่า) จากนั้นคุณต้องระบุ URL ปลายทางให้กับผู้จัดการพาร์ทเนอร์เชิงกลยุทธ์เพื่อเปิดใช้งานบริการ

สคีมา

เพย์โหลดการแจ้งเตือนต้องเป็นไปตามสคีมาต่อไปนี้

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "title": "Notification",
  "type": "object",
  "properties": {
    "platformPublisherId": {
      "type": "string",
      "description": "The unique identifier for the platform publisher."
    },
    "publisherId": {
      "type": "string",
      "description": "The unique identifier for the publisher."
    },
    "platformChildSiteName": {
      "type": "string",
      "description": "The name of the PlatformChildSite the notification refers to (populated for SITE_APPROVAL)."
    },
    "notificationType": {
      "type": "string",
      "enum": ["SITE_APPROVAL"],
      "description": "Type of notification"
    },
  },
  "required": ["platformPublisherId", "publisherId", "notificationType"],
  "additionalProperties": false
}

คุณสามารถเพิ่ม notificationTypes และช่องอื่นๆ ได้ในภายหลัง

ตัวอย่าง

การแจ้งเตือน SITE_APPROVAL จะมีลักษณะดังนี้

{
  "platformPublisherId" : "pub-123",
  "publisherId" : "pub-456",
  "platformChildSiteName" : "accounts/pub-123/platforms/my-platform/childAccounts/pub-456/sites/child-domain.com",
  "notificationType": "SITE_APPROVAL"
}

ตัวอย่างการตั้งค่า

ต่อไปนี้เป็นตัวอย่างเซิร์ฟเวอร์ NodeJS ที่บันทึกเนื้อหาของการแจ้งเตือน

// Import express
const express = require('express');

// Create an express application
const app = express();

// Middleware to parse JSON bodies
app.use(express.json());

// Define a route to receive POST requests
app.post('/notification', (req, res) => {
    console.log('Received platformPublisherId:', req.body.platformPublisherId)
    console.log('Received publisherId:', req.body.publisherId)
    console.log('Received platformChildSiteName:', req.body.platformChildSiteName)
    console.log('Received notification type', req.body.notificationType)

    // Send a response back to the client
    res.status(200).send('Notification received');
});

// Start the server
const PORT = process.env.PORT || 8080;
app.listen(PORT, () => {
  console.log(`Server running on port ${PORT}`);
});

ตัวอย่าง URL ปลายทาง: https://yourdomain.com/your-endpoint

ยืนยันว่าปลายทางทํางานโดยส่งคําขอ POST โดยใช้ curl

curl -X POST https://yourdomain.com/your-endpoint \
     -H "Content-Type: application/json" \
     -d '{"platformPublisherId" : "pub-123", \
          "publisherId" : "pub-456", \
          "platformChildSiteName" : "accounts/pub-123/platforms/my-platform/childAccounts/pub-456/sites/child-domain.com", \
          "notificationType": "SITE_APPROVAL"}'

กำหนดค่า robots.txt

ตรวจสอบว่าบริการแจ้งเตือนได้รับอนุญาตให้เข้าถึงอุปกรณ์ปลายทางของคุณ บริการแจ้งเตือนจะปฏิบัติตามคำสั่งที่ระบุไว้ในไฟล์ robots.txt ของรูทโดเมนของคุณ (หากมี)

User-agent: GoogleOther
Disallow: <ensure your endpoint is not disallowed>