Conversion

ทรัพยากร Conversion มีเมธอดที่ช่วยให้ผู้ใช้สร้าง แก้ไข และเรียกข้อมูล Conversion ของ Floodlight หลายรายการพร้อมกันได้ 

ดูรายการวิธีการสำหรับแหล่งข้อมูลนี้ได้ที่ท้ายหน้า

การนําเสนอทรัพยากร

รายการ Conversion

{
  "kind": "doubleclicksearch#conversionList",
  "conversion": [
    {
      "agencyId": long,
      "advertiserId": long,
      "engineAccountId": long,
      "campaignId": long,
      "customerId": string,
      "adGroupId": long,
      "criterionId": long,
      "adId": long,
      "clickId": string,
      "dsConversionId": long,
      "conversionId": string,
      "state": string,
      "type": string,
      "revenueMicros": long,
      "currencyCode": string,
      "quantityMillis": long,
      "segmentationType": string,
      "segmentationId": long,
      "segmentationName": string,
      "conversionTimestamp": unsigned long,
      "conversionModifiedTimestamp": unsigned long,
      "floodlightOrderId": string,
      "customMetric": [
        {
          "name": string,
          "value": double
        }
      ],
      "customDimension": [
        {
          "name": string,
          "value": string
        }
      ],
      "countMillis": long,
      "attributionModel": string,
      "productGroupId": long,
      "inventoryAccountId": long,
      "productId": string,
      "productCountry": string,
      "productLanguage": string,
      "channel": string,
      "storeId": string,
      "deviceType": string,
      "adUserDataConsent": string,
      "sessionAttributesEncoded": bytes
    }
  ]
}
ชื่อพร็อพเพอร์ตี้ ค่า คำอธิบาย หมายเหตุ
conversion[] list Conversion ที่ขอ
conversion[].adGroupId long รหัสกลุ่มโฆษณา DS
conversion[].adId long รหัสโฆษณา DS
conversion[].adUserDataConsent string แสดงความยินยอมสำหรับค่ากำหนดของบริการแพลตฟอร์มหลัก (CPS) ในการตั้งค่า ไม่มีค่าเริ่มต้น ค่าที่ยอมรับได้คือ "ให้สิทธิ์แล้ว": สถานะความยินยอมที่ต้องการคือให้สิทธิ์ อ่านค่ากำหนด CPS จากการตั้งค่า GTE ถูกปฏิเสธ: สถานะความยินยอมที่ต้องการคือปฏิเสธ รายการ CPS ว่างเปล่า

ค่าที่ยอมรับมีดังนี้
  • "DENIED"
  • "GRANTED"
  • "UNKNOWN"
conversion[].advertiserId long รหัสผู้ลงโฆษณา DS
conversion[].agencyId long รหัสเอเจนซี DS
conversion[].attributionModel string พร้อมให้บริการแก่ผู้ลงโฆษณาหลังจากติดต่อฝ่ายสนับสนุนลูกค้าของ DoubleClick Search เท่านั้น
conversion[].campaignId long รหัสแคมเปญ DS
conversion[].channel string ช่องทางการขายของผลิตภัณฑ์ ค่าที่ยอมรับมีดังนี้
  • "local": กิจการที่มีหน้าร้านจริง
  • "online": ร้านค้าออนไลน์
conversion[].clickId string รหัสคลิก DS สําหรับ Conversion
conversion[].conversionId string สําหรับ Conversion ออฟไลน์ ผู้ลงโฆษณาจะเป็นผู้ระบุรหัสนี้ ผู้ลงโฆษณาระบุรหัสใดก็ได้ที่สื่อความหมาย Conversion แต่ละรายการในคําขอต้องระบุรหัสที่ไม่ซ้ำกัน และการรวมรหัสและการประทับเวลาต้องไม่ซ้ำกันกับ Conversion ทั้งหมดภายในผู้ลงโฆษณา
สําหรับ Conversion ออนไลน์ DS จะคัดลอก dsConversionId หรือ floodlightOrderId ไปยังพร็อพเพอร์ตี้นี้โดยขึ้นอยู่กับคําสั่ง Floodlight ของผู้ลงโฆษณา
conversion[].conversionModifiedTimestamp unsigned long เวลาที่มีการแก้ไข Conversion ครั้งล่าสุดเป็นมิลลิวินาทีของยุค UTC
conversion[].conversionTimestamp unsigned long เวลาที่เกิด Conversion เป็นมิลลิวินาทีของยุค UTC
conversion[].countMillis long พร้อมให้บริการแก่ผู้ลงโฆษณาหลังจากติดต่อฝ่ายสนับสนุนลูกค้าของ DoubleClick Search เท่านั้น
conversion[].criterionId long รหัสเกณฑ์ (คีย์เวิร์ด) DS
conversion[].currencyCode string รหัสสกุลเงินของรายได้จาก Conversion ควรอยู่ในรูปแบบตัวอักษรของ ISO 4217 (อักขระ 3 ตัว) เขียนได้
conversion[].customDimension[] list มิติข้อมูลที่กําหนดเองสําหรับ Conversion ซึ่งสามารถใช้กรองข้อมูลในรายงานได้
conversion[].customDimension[].name string ชื่อมิติข้อมูลที่กำหนดเอง
conversion[].customDimension[].value string ค่ามิติข้อมูลที่กำหนดเอง
conversion[].customMetric[] list เมตริกที่กําหนดเองสําหรับ Conversion
conversion[].customMetric[].name string ชื่อเมตริกที่กําหนดเอง
conversion[].customMetric[].value double ค่าตัวเลขของเมตริกที่กําหนดเอง
conversion[].customerId string รหัสลูกค้า Search Ads 360 เวอร์ชันใหม่ ต้องเป็นบัญชีลูกค้า เมื่อตั้งค่าช่องนี้แล้ว คุณควรตั้งค่าช่องรหัสอื่นๆ ทั้งหมดเป็นรหัส Search Ads 360 เวอร์ชันใหม่
conversion[].deviceType string ประเภทอุปกรณ์ที่เกิด Conversion

ค่าที่ยอมรับมีดังนี้
  • "DESKTOP"
  • "HIGH_END_MOBILE"
  • "OTHER_DEVICE"
  • "TABLET"
conversion[].dsConversionId long รหัสที่ DoubleClick Search สร้างขึ้นสําหรับ Conversion แต่ละรายการ
conversion[].engineAccountId long รหัสบัญชีเครื่องมือค้นหา DS
conversion[].floodlightOrderId string รหัสคำสั่งซื้อ Floodlight ที่ผู้ลงโฆษณาระบุสำหรับ Conversion
conversion[].inventoryAccountId long รหัสที่ DS สร้างขึ้นและใช้เพื่อระบุบัญชีสินค้าคงคลังที่ประกอบด้วยผลิตภัณฑ์นั้นๆ โดยไม่ซ้ำกัน
conversion[].productCountry string ประเทศที่ลงทะเบียนสำหรับฟีด Merchant Center ที่มีผลิตภัณฑ์ ใช้รหัส ISO 3166 เพื่อระบุประเทศ
conversion[].productGroupId long รหัสกลุ่มผลิตภัณฑ์ DS
conversion[].productId string รหัสผลิตภัณฑ์ (SKU)
conversion[].productLanguage string ภาษาที่ลงทะเบียนสำหรับฟีด Merchant Center ที่มีผลิตภัณฑ์ ใช้รหัส ISO 639 เพื่อระบุภาษา
conversion[].quantityMillis long จํานวน Conversion นี้ในหน่วยมิลลิวินาที เขียนได้
conversion[].revenueMicros long จํานวนรายได้ของ Conversion TRANSACTION นี้ในหน่วยไมโคร (ค่าคูณด้วย 1000000 ไม่มีทศนิยม) ตัวอย่างเช่น หากต้องการระบุมูลค่ารายได้เป็น "10" ให้ป้อน "10000000" (10 ล้าน) ในคำขอ เขียนได้
conversion[].segmentationId long ตัวระบุการแบ่งกลุ่มตัวเลข (เช่น รหัสกิจกรรม DoubleClick Search Floodlight)
conversion[].segmentationName string ตัวระบุการแบ่งกลุ่มที่เข้าใจง่าย (เช่น ชื่อกิจกรรม DoubleClick Search Floodlight)
conversion[].segmentationType string ประเภทการแบ่งกลุ่มของ Conversion นี้ (เช่น FLOODLIGHT)

ค่าที่ยอมรับได้ ได้แก่
  • "FLOODLIGHT"
conversion[].sessionAttributesEncoded bytes แอตทริบิวต์เซสชันสําหรับเหตุการณ์ ซึ่งแสดงเป็นสตริง JSON ที่เข้ารหัส Base64 เนื้อหาควรสร้างจากคลังภาพที่ Google มีให้
conversion[].state string สถานะของ Conversion ซึ่งก็คือ ACTIVE หรือ REMOVED หมายเหตุ: ระบบเลิกใช้งานสถานะ DELETED แล้ว

ค่าที่ยอมรับมีดังนี้
  • "ACTIVE"
  • "DELETED":  (เลิกใช้งานแล้ว)
  • "REMOVED"
เขียนได้
conversion[].storeId string รหัสของร้านค้าในพื้นที่ที่โฆษณาผลิตภัณฑ์ ใช้ได้เฉพาะเมื่อช่องเป็น "local"
conversion[].type string ประเภท Conversion ซึ่งก็คือ ACTION หรือ TRANSACTION Conversion ACTION คือการกระทำของผู้ใช้ที่ไม่มีมูลค่าที่วัดเป็นจำนวนเงินได้ ส่วน Conversion TRANSACTION คือการกระทำที่มีมูลค่าที่วัดเป็นจำนวนเงินได้ ตัวอย่างเช่น การสมัครรับอีเมล (ACTION) เทียบกับการซื้อผ่านอีคอมเมิร์ซ (TRANSACTION)

ค่าที่ยอมรับได้มีดังนี้
  • "ACTION"
  • "TRANSACTION"
kind string ระบุว่านี่คือทรัพยากร ConversionList ค่า: สตริงคงที่ doubleclicksearch#conversionList

เมธอด

get
ดึงข้อมูลรายการ Conversion จากบัญชีเครื่องมือค้นหา DoubleClick
getByCustomerId
ดึงข้อมูลรายการ Conversion จากบัญชีเครื่องมือค้นหา DoubleClick Search โดยใช้รหัสลูกค้า Search Ads 360 ใหม่
แทรก
แทรก Conversion ใหม่หลายรายการลงใน DoubleClick Search
update
อัปเดต Conversion หลายรายการใน DoubleClick Search
updateAvailability
อัปเดตความพร้อมใช้งานของกิจกรรม Floodlight กลุ่มหนึ่งใน DoubleClick Search