เกตเวย์ API คอนเวอร์ชั่นสำหรับ Control Plane API แบบหลายบัญชี: เอกสารอ้างอิง

การจัดการพิกเซล

สร้างการเชื่อมต่อพิกเซล

เริ่มนำพิกเซลของ Meta ใหม่มาใช้กับเกตเวย์ API คอนเวอร์ชั่น

สกีมา

POST https://{capig_domain}/capig/graphql/ 
_________________________________________________________________________________________________________________
      
mutation AddNewPixelModalMutation(
    $tenantId: ID!
    $input: PixelConnectionCreationInput!
) {
    tenantMutations(tenantId: $tenantId) {
          signalMutations {
              setupPixelSignalConfig(input: $input) {
              id
              domains
              connectionId
              connectionStatus {
                  id
                  accessTokenAvailable
                  active
                  connected
                  accessKey
                  eventBridgeActive
                  publishingEnabled
                  apiErrorCode
                  pixelID
                  pixelName
                  lastPublished
                  totalEventsPublished
                  lastReceived
                  totalEventsReceived
                  }
              }
          }
     }
}
_________________________________________________________________________________________________________    
tenantId: ID!
_________________________________________________________________________________________________________
input PixelConnectionCreationInput {
  businessId: String!
  pixelId: String!
  accessToken: String!
  apiVersion: String
  externalId: String!
  name: String
}      
     

ช่อง

PixelConnectionCreationInput

ข้อมูลที่ส่งคืนมา

รหัสข้อผิดพลาด

ตัวอย่างคำขอ

การเปลี่ยนแปลง

mutation AddNewPixelModalMutation(
   $tenantId: ID!
   $input: PixelConnectionCreationInput!
) {
   tenantMutations(tenantId: $tenantId) {
          signalMutations {
              setupPixelSignalConfig(input: $input) {
              id
              domains
              connectionId
              connectionStatus {
                  id
                  accessTokenAvailable
                  active
                  eventBridgeActive
                  publishingEnabled
                  apiErrorCode
                  pixelID
                  pixelName
                  lastPublished
                  totalEventsPublished
                  lastReceived
                  totalEventsReceived
                  }
              }
          }
   }
}
     

ตัวแปร

{
   "tenantId": "IaoreXfj",
   "input": {
       "pixelId": "18904456377094531",
       "businessId": "2840127409433732",
       "accessToken": "<accessToken>",
       "apiVersion": "v14.0",
       "externalId": "633612748410ba6e902"
   }
}
     

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

{
   "data": {
       "tenantMutations": {
           "signalMutations": {
               "setupPixelSignalConfig": {
                   "id": "SignalConfig:18904456377094531",
                   "domains": [],
                   "connectionId": "18904456377094531",
                   "connectionStatus": {
                       "id": "ConnectionStatus:18904456377094531",
                       "accessTokenAvailable": true,
                       "active": true,
                       "eventBridgeActive": true,
                       "publishingEnabled": true,
                       "apiErrorCode": null,
                       "pixelID": "18904456377094531",
                       "pixelName": null,
                       "lastPublished": 0.0,
                       "totalEventsPublished": 0.0,
                       "lastReceived": 0.0,
                       "totalEventsReceived": 0.0
                   }
               }
           }
       }
   }
}
     

ลบการเชื่อมต่อพิกเซล

ลบพิกเซลที่มีอยู่ออกจากเกตเวย์

สกีมา

POST https://{capig_domain}/capig/graphql/ 
_________________________________________________________________________________________________________________
      
mutation DeleteDataSourceModalMutation(
  $id: ID!
  $tenantId: ID!
) {
  tenantMutations(tenantId: $tenantId) {
    signalMutations {
      deleteDataSource(id: $id)
    }
  }
}
_________________________________________________________________________________________________________    
id: ID!
_____________________________________________________________________________________________________________
      
tenantId: ID!   
     

ช่อง

ข้อมูลที่ส่งคืนมา

รหัสข้อผิดพลาด

ตัวอย่างคำขอ

การเปลี่ยนแปลง

mutation DeleteDataSourceModalMutation(
 $id: ID!
 $tenantId: ID!
) {
 tenantMutations(tenantId: $tenantId) {
   signalMutations {
     deleteDataSource(id: $id)
   }
 }
}
     

ตัวแปร

{
   "id":"18904456377094531",
   "tenantId":"IaoreXfj"
}
     

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

{
   "data": {
       "tenantMutations": {
           "signalMutations": {
               "deleteDataSource": true
           }
       }
   }
}
     

เปิด/ปิดใช้งานเกตเวย์จากการรับเหตุการณ์พิกเซล

เปลี่ยนสถานะการรับเหตุการณ์พิกเซลของเกตเวย์

สกีมา

POST https://{capig_domain}/capig/graphql/ 
_________________________________________________________________________________________________________________
      
mutation updateSignalConfigStatusMutation(
    $id: ID!, $tenantId: ID!, $input: SignalConfigStatusInput!) {
  tenantMutations(tenantId: $tenantId) {
    signalMutations {
      updateSignalConfigEventsStatus(id: $id, input: $input) {
        success
        connectionStatus {
            id
            accessTokenAvailable
            active
            connected
            accessKey
            eventBridgeActive
            publishingEnabled
            apiErrorCode
            pixelID
            pixelName
            lastPublished
            totalEventsPublished
            lastReceived
            totalEventsReceived
        }
      }
    }
  }
}
_________________________________________________________________________________________________________    
id: ID!
_____________________________________________________________________________________________________________
      
tenantId: ID!
________________________________________________________________________________________________________
input SignalConfigStatusInput {
  status: Int!
}            
     

ช่อง

SignalConfigStatusInput

ข้อมูลที่ส่งคืนมา

UpdateSignalConfigStatusPayload

รหัสข้อผิดพลาด

ตัวอย่างคำขอ

การเปลี่ยนแปลง

mutation updateSignalConfigStatusMutation(
   $id: ID!, $tenantId: ID!, $input: SignalConfigStatusInput!) {
 tenantMutations(tenantId: $tenantId) {
   signalMutations {
     updateSignalConfigEventsStatus(id: $id, input: $input) {
       success
       connectionStatus {
         id
         connected
         active
         eventBridgeActive
         publishingEnabled
       }
     }
   }
 }
}
     

ตัวแปร

{
   "id": "18904456377094531",
   "tenantId": "IaoreXfj",
   "input": {
       "status": 1
       }
}
     

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

{
   "data": {
       "tenantMutations": {
           "signalMutations": {
               "updateSignalConfigEventsStatus": {
                   "success": true,
                   "connectionStatus": {
                       "id": "ConnectionStatus:18904456377094531",
                       "connected": true,
                       "active": true,
                       "eventBridgeActive": true,
                       "publishingEnabled": true
                   }
               }
           }
       }
   }
}
     

เปิด/ปิดใช้งานสถานะการเผยแพร่เหตุการณ์พิกเซล

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

สกีมา

POST https://{capig_domain}/capig/graphql/ 
_________________________________________________________________________________________________________________
      
mutation updateSignalConfigCapiPublishMutation(
$id: ID!, $tenantId: ID!, $input: SignalConfigStatusInput!) {
 tenantMutations(tenantId: $tenantId) {
   signalMutations {
     updateSignalConfigCapiPublish(id: $id, input: $input) {
       success
       connectionStatus {
           id
           accessTokenAvailable
           active
           connected
           accessKey
           eventBridgeActive
           publishingEnabled
           apiErrorCode
           pixelID
           pixelName
           lastPublished
           totalEventsPublished
           lastReceived
           totalEventsReceived
       }
     }
   }
 }
}
_________________________________________________________________________________________________________    
id: ID!
_____________________________________________________________________________________________________________
      
tenantId: ID!
________________________________________________________________________________________________________
input SignalConfigStatusInput {
  status: Int!
}            
     

ช่อง

SignalConfigStatusInput

ข้อมูลที่ส่งคืนมา

UpdateSignalConfigStatusPayload

รหัสข้อผิดพลาด

ตัวอย่างคำขอ

การเปลี่ยนแปลง

mutation updateSignalConfigCapiPublishMutation(
$id: ID!, $tenantId: ID!, $input: SignalConfigStatusInput!) {
 tenantMutations(tenantId: $tenantId) {
   signalMutations {
     updateSignalConfigCapiPublish(id: $id, input: $input) {
       success
       connectionStatus {
         id
         active
         eventBridgeActive
         publishingEnabled
       }
     }
   }
 }
}
     

ตัวแปร

{
   "id": "18904456377094531",
   "tenantId": "IaoreXfj",
   "input": {
       "status": 0
       }
}
     

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

{
   "data": {
       "tenantMutations": {
           "signalMutations": {
               "updateSignalConfigCapiPublish": {
                   "success": true,
                   "connectionStatus": {
                       "id": "ConnectionStatus:18904456377094531",
                       "active": false,
                       "eventBridgeActive": true,
                       "publishingEnabled": false
                   }
               }
           }
       }
   }
}
     

เปิด/ปิดใช้งานสถานะการเผยแพร่เหตุการณ์พิกเซลตามชื่อเหตุการณ์

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

สกีมา

POST https://{capig_domain}/capig/graphql/ 
_________________________________________________________________________________________________________________
      
mutation EventFilterStatusMutation($tenantId: ID!, $input: UpdateEventFilterInput!) {
 tenantMutations(tenantId: $tenantId) {
   updateEventFilter(input: $input) {
     updatedFilter {
       id
       eventName
       pixelId
       filterState
     }
   }
 }
}
_________________________________________________________________________________________________________    
tenantId: ID!
_____________________________________________________________________________________________________________
      
input UpdateEventFilterInput {
  eventName: String!
  pixelIds: [String!]
  filterState: EventFilterState!
}            
     

ช่อง

UpdateEventFilterInput

ข้อมูลที่ส่งคืนมา

UpdateEventFilterResult

รหัสข้อผิดพลาด

ตัวอย่างคำขอ

การเปลี่ยนแปลง

mutation EventFilterStatusMutation($tenantId: ID!, $input: UpdateEventFilterInput!) {
tenantMutations(tenantId: $tenantId) {
  updateEventFilter(input: $input) {
    updatedFilter {
      eventName
      pixelId
      filterState
    }
  }
}
}
     

ตัวแปร

{
"tenantId": "IaoreXfj",
"input": {
  "eventName": "AddToCart",
  "pixelIds": ["18904456377094531"],
  "filterState": "PUBLISH"
}
}
     

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

{
   "data": {
       "tenantMutations": {
           "updateEventFilter": {
               "updatedFilter": {
                   "eventName": "AddToCart",
                   "pixelId": "18904456377094531",
                   "filterState": "PUBLISH"
               }
           }
       }
   }
}
     

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

บล็อกการรับเหตุการณ์จากบางเว็บไซต์

สกีมา

POST https://{capig_domain}/capig/graphql/ 
_________________________________________________________________________________________________________________
      
mutation useComitDomainFilterChangeMutation($tenantId: ID!, $input: UpdateDomainFilterInput!) {
  tenantMutations(tenantId: $tenantId) {
    updateDomainFilter(input: $input) {
      updatedFilter {
        id
        domain
        pixelId
        filterState
      }
    }
  }
}
_________________________________________________________________________________________________________    
tenantId: ID!
_____________________________________________________________________________________________________________
      
input UpdateDomainFilterInput {
  domain: String!
  pixelIds: [String!]
  filterState: DomainFilterState!
}            
     

ช่อง

UpdateDomainFilterInput

ข้อมูลที่ส่งคืนมา

UpdateDomainFilterResult

รหัสข้อผิดพลาด

ตัวอย่างคำขอ

การเปลี่ยนแปลง

mutation useComitDomainFilterChangeMutation($tenantId: ID!, $input: UpdateDomainFilterInput!) {
 tenantMutations(tenantId: $tenantId) {
   updateDomainFilter(input: $input) {
     updatedFilter {
       id
       domain
       pixelId
       filterState
     }
   }
 }
}
     

ตัวแปร

{
 "tenantId": "IaoreXfj",
 "input": {
   "domain": "example.com",
   "filterState": "DROP"
 }
}
     

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

"data": {
       "tenantMutations": {
           "updateDomainFilter": {
               "updatedFilter": {
                   "id": "DomainFilter:example.com:global",
                   "domain": "example.com",
                   "pixelId": null,
                   "filterState": "DROP"
               }
           }
       }
   }
     

ดูเพิ่มเติม

• เกตเวย์ API คอนเวอร์ชั่นสำหรับ Control Plane API แบบหลายบัญชี
• Control Plane API: เอกสารอ้างอิง
• เอกสารอ้างอิงเกี่ยวกับ Control Plane API: การจัดการบัญชี
• เอกสารอ้างอิงเกี่ยวกับ Control Plane API: การจัดการผู้ใช้
• เอกสารอ้างอิงเกี่ยวกับ Control Plane API: การกำหนดค่าการกำหนดเส้นทางข้อมูลบัญชี
• เอกสารอ้างอิงเกี่ยวกับ Control Plane API: เกณฑ์ชี้วัดเหตุการณ์ในบัญชี
• เอกสารอ้างอิงเกี่ยวกับ Control Plane API: อ็อบเจ็กต์