ประสบการณ์การใช้งาน Search Ads 360

Search Ads 360 เวอร์ชันใหม่จะกำหนดรหัสใหม่ให้กับบัญชีผู้ใช้ แคมเปญ กลุ่มโฆษณา คีย์เวิร์ด (เกณฑ์) และโฆษณา มีการเปลี่ยนแปลงลักษณะการทำงานอีก 2 ประการสำหรับรหัสเหล่านี้ ได้แก่

• Search Ads 360 เวอร์ชันใหม่จะกำหนดรหัสลูกค้าที่ไม่ซ้ำกันทั่วโลกให้กับบัญชีดูแลจัดการ บัญชีดูแลจัดการย่อย และบัญชีลูกค้า หรือที่เรียกว่าเอเจนซี ผู้ลงโฆษณา และบัญชีเครื่องมือค้นหาตามลำดับ

• Search Ads 360 เวอร์ชันใหม่จะไม่กำหนดรหัสที่ไม่ซ้ำกันให้กับคีย์เวิร์ดและโฆษณาอีกต่อไป

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

เมื่อคุณใช้รหัส Search Ads 360 เวอร์ชันใหม่ในคำขอ การตอบกลับจะใช้รหัส Search Ads 360 เวอร์ชันใหม่ด้วย

แสดงรายการ Conversion

มีปลายทางใหม่สำหรับคำขอรายการที่มีรหัส Search Ads 360 เวอร์ชันใหม่ คุณต้องระบุรหัสลูกค้าของบัญชีลูกค้า นอกจากนี้ คุณยังคงระบุรหัสแคมเปญและรหัสกลุ่มโฆษณาเพื่อแสดงในพารามิเตอร์การค้นหาได้ และยังต้องใช้ endDate, rowCount, startDate และ startRow อยู่

คำขอ HTTP

GET https://www.googleapis.com/doubleclicksearch/v2/customer/customerId/conversion

แทรก/อัปเดต Conversion

เรารองรับคำขอต่อไปนี้ที่ใช้รหัส Search Ads 360 เวอร์ชันใหม่

• ระบุแหล่งที่มาของ Conversion เป็นคีย์เวิร์ดและโฆษณา
• ระบุแหล่งที่มาของ Conversion เป็นคีย์เวิร์ดเท่านั้น
• อัปเดต Conversion ด้วย criterionId (รหัสคีย์เวิร์ด) ของ Conversion ที่ระบุ

ส่วนปลายทางจะยังเหมือนเดิม คุณควรระบุรหัส Search Ads 360 เวอร์ชันใหม่ในทรัพยากร Conversion แต่ละรายการ แทนที่จะระบุ agencyId, advertiserId และ engineAccountId คุณควรระบุ customerId และใช้รหัส Search Ads 360 เวอร์ชันใหม่ใน campaignId, adGroupId, criterionId และ adId เมื่อจำเป็น

ตัวอย่างคำขอวิธีใช้รหัส Search Ads 360 เวอร์ชันใหม่เพื่อระบุแหล่งที่มาของ Conversion เป็นคีย์เวิร์ด

POST  https://www.googleapis.com/doubleclicksearch/v2/conversion
{
  "conversion" : [
    {
      "customerId": "123-123-1234"
      "campaignId": "10000001",
      "adGroupId": "20000001",
      "criterionId": "30000001",
      "conversionId": "floodlight conversion ID 1",
      "conversionTimestamp": "1660799917714",
      "type": "ACTION",
      "quantityMillis": "1000",
      "segmentationType": "FLOODLIGHT",
      "segmentationName": "Test"
    }
  ]
}
    

ระบุความพร้อมใช้งาน

คุณยังใช้รหัส Search Ads 360 เวอร์ชันใหม่ในเมธอด Conversion.updateAvailability() ได้ด้วย คุณต้องใช้รหัสลูกค้าบัญชีดูแลจัดการย่อย มีตัวอย่างดังต่อไปนี้

POST  https://www.googleapis.com/doubleclicksearch/v2/conversion/updateAvailability
{
  "availabilities": [
    {
      "customerId": "123-123-1234"
      "segmentationType": "FLOODLIGHT",
      "segmentationName": "Test",
      "availabilityTimestamp": "1389348800000"
    }
  ]
}