การแก้ปัญหา

หากพบปัญหาขณะใช้ Search Ads 360 API โปรดดูส่วนการแก้ปัญหานี้

หากพบปัญหาที่แก้ไม่ได้หลังจากอ่านแหล่งข้อมูลในเว็บไซต์นี้แล้ว โปรดติดต่อทีมสนับสนุนและเตรียมข้อมูลต่อไปนี้ให้พร้อม

  • รหัสเอเจนซีและรหัสผู้ลงโฆษณา Search Ads 360 ที่คุณพยายามเข้าถึง

  • หมายเลขโปรเจ็กต์จากคอนโซล Google API

  • ชื่อผู้ใช้ของบัญชี Google ที่คุณใช้เข้าถึง API
    บัญชีนี้คือบัญชีที่ได้รับสิทธิ์เข้าถึง Search Ads 360 ซึ่งเป็นบัญชีเดียวกับที่คุณใช้ตั้งค่าการให้สิทธิ์

  • ข้อมูลโค้ดของคําขอ

  • การตอบกลับ JSON
    หากการตอบกลับเป็นข้อผิดพลาด โปรดระบุข้อความแสดงข้อผิดพลาดด้วย ไม่ใช่แค่รหัสข้อผิดพลาดที่เป็นตัวเลข

ข้อผิดพลาดในการให้สิทธิ์

ข้อผิดพลาดในการให้สิทธิ์ที่พบได้ทั่วไปมีดังนี้

ข้อความ คำอธิบาย

Access Not Configured. Please use Google API Console to activate the API for your project.

ข้อผิดพลาดนี้จะเกิดขึ้นหากคุณไม่ได้เปิดใช้ Search Ads 360 API สำหรับบัญชี ตรวจสอบว่าคุณได้ทำสิ่งต่อไปนี้แล้ว

  1. ไปที่คอนโซล Google API

  2. เลือกโปรเจ็กต์ หากยังไม่ได้สร้างโปรเจ็กต์ โปรดดูหัวข้อสร้างโปรเจ็กต์สำหรับไคลเอ็นต์

  3. ขยาย API และการตรวจสอบสิทธิ์ในแถบด้านข้างทางซ้าย จากนั้นคลิก API ในรายการ API ให้ตรวจสอบว่าสถานะเป็นเปิดสำหรับ Search Ads 360 API

Invalid grant

ข้อผิดพลาดนี้จะเกิดขึ้นเมื่อโทเค็นการรีเฟรชไม่ถูกต้อง คุณสามารถรับโทเค็นการรีเฟรชได้โดยเรียกใช้สคริปต์ยูทิลิตี Search Ads 360 ดังนี้

sa360Api.py --login

ดูข้อมูลเพิ่มเติมเกี่ยวกับเวิร์กโฟลว์ที่แนะนำสำหรับการให้สิทธิ์

Invalid client
no application name

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

ข้อผิดพลาดในการให้สิทธิ์ประเภทอื่นๆ

โปรดใช้บัญชี Google ที่ได้รับสิทธิ์เข้าถึง Search Ads 360 เมื่อลงชื่อเข้าใช้คอนโซล Google API เพื่อดึงข้อมูลรหัสไคลเอ็นต์และรหัสลับไคลเอ็นต์ และเมื่อรับโทเค็นการรีเฟรช

ข้อผิดพลาดในการอัปโหลด Conversion

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

รหัสข้อผิดพลาด ข้อความ คำอธิบาย
0x00000101

Click ID '{ID}' is not found

รหัสคลิกที่คุณระบุในคำขอ insert หรือ update ไม่ถูกต้อง อัปโหลด Conversion อีกครั้งหลังจากที่คุณทำสิ่งต่อไปนี้แล้ว

0x00000106 Either a click ID or keyword ID is required

Conversion ไม่ได้ระบุแหล่งที่มา ระบุคอลัมน์ clickId หรือคอลัมน์ customerId, campaignId, adGroupId และ criterionId ที่ระบุคีย์เวิร์ด

0x0000010C Either of Floodlight activity ID or Floodlight activity name is required

ระบุ segmentationType: "FLOODLIGHT" และกิจกรรม Floodlight ในคอลัมน์ segmentationName หรือ segmentationId

เมื่อคุณแก้ไข Conversion ที่ Search Ads 360 บันทึกผ่านแท็ก Floodlight คุณต้องใช้กิจกรรม Floodlight เพื่อระบุ Conversion

0x0000010E Floodlight activity name '{name}' is not found

ชื่อกิจกรรม Floodlight ที่ระบุในคอลัมน์ segmentationName ไม่ถูกต้องหรือยังไม่พร้อมใช้งาน หากเห็นข้อผิดพลาดนี้ ให้ตรวจสอบปัญหาที่พบบ่อยต่อไปนี้

  • ชื่อจะคำนึงถึงตัวพิมพ์เล็กและตัวพิมพ์ใหญ่ ดังนั้นโปรดตรวจสอบว่าคำขอของคุณตรงกับตัวพิมพ์เล็กและตัวพิมพ์ใหญ่ทุกประการ
  • ตรวจสอบว่าคุณไม่ได้ใส่อักขระ Unicode ที่พิมพ์ไม่ได้หรือเว้นวรรค 2 ครั้งในชื่อกิจกรรม Floodlight
  • ตรวจสอบว่าคุณได้ระบุชื่อกิจกรรม Floodlight ไม่ใช่คอลัมน์ Floodlight
  • ตรวจสอบว่ามีกิจกรรม Floodlight สำหรับผู้ลงโฆษณาที่เป็นเจ้าของรหัสคลิกหรือคีย์เวิร์ดในคำขอของคุณ
  • หลังจากสร้างหรือแก้ไขกิจกรรม Floodlight แล้ว ให้รอ 2-3 ชั่วโมงก่อนอัปโหลด Conversion สำหรับกิจกรรมดังกล่าว
0x00000115 Custom dimension '{name}' is not found

ตรวจสอบว่าตัวแปร Floodlight ที่กำหนดเองที่คุณระบุได้รับการตั้งค่าเป็นมิติข้อมูล (ไม่ใช่เมตริก) สำหรับผู้ลงโฆษณาที่เชื่อมโยงกับ clickId, criterionId หรือ productGroupId ที่คุณระบุแหล่งที่มาของ Conversion

0x00000116 Custom metric '{name}' is not found

ตรวจสอบว่าได้ตั้งค่าตัวแปร Floodlight ที่กำหนดเองซึ่งคุณระบุไว้เป็นเมตริก (ไม่ใช่มิติข้อมูล) สำหรับผู้ลงโฆษณาที่เชื่อมโยงกับ clickId, criterionId หรือ productGroupId ที่คุณระบุแหล่งที่มาของ Conversion

0x00000119 A conversion ID or advertiser conversion ID is required to modify an existing conversion

คำขอ update ไม่ได้ระบุคอลัมน์ conversionId ต้องระบุ conversionId เพื่อระบุ Conversion ที่ต้องการแก้ไข ดูการเลิกใช้งาน dsConversionId

0x0000011A The advertiser conversion ID is already specified for a conversion with Search Ads 360 conversion ID {ID}

มีผู้ใช้ที่อัปโหลด Conversion สำหรับขอบเขตและรหัส Conversion ของผู้ลงโฆษณาเดียวกันกับที่ระบุไว้ในคอลัมน์ conversionId แล้ว

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

0x0000011B Advertiser conversion ID '{ID}' is not found

คำขอ update พยายามอัปเดตรหัส Conversion ของผู้ลงโฆษณาที่ไม่มีอยู่ ตรวจสอบปัญหาที่พบบ่อยต่อไปนี้

  • ตรวจสอบว่าคุณระบุรหัสที่ถูกต้องในคอลัมน์ conversionId สําหรับ Conversion ที่อัปโหลดผ่าน API ค่านี้คือ conversionId ที่คุณระบุเมื่อแทรก Conversion สำหรับ Conversion ที่บันทึกผ่านแท็ก Floodlight รหัสนี้คือรหัสคำสั่งซื้อ Floodlight
  • ตรวจสอบว่า conversionTimestamp คือการประทับเวลาของ Conversion ที่มีอยู่ โดยใช้หน่วยมิลลิวินาที Epoch ในเขตเวลา UTC การประทับเวลาที่แปลงจากเขตเวลาท้องถิ่น หรือที่ระบุเป็นวินาทีแทนมิลลิวินาทีไม่ตรงกับ Conversion ที่มีอยู่
  • สําหรับ Conversion ที่บันทึกผ่านแท็ก Floodlight ให้ตรวจสอบว่าคุณได้ระบุกิจกรรม Floodlight ของ Conversion ในคอลัมน์ segmentationName หรือ segmentationId และ Conversion เกิดขึ้นภายใน 28 วันที่ผ่านมา
0x0000011D User does not have permission to view advertiser {advertiser ID}

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

เมื่อลงชื่อเข้าใช้คอนโซล Google API เพื่อดึงข้อมูลรหัสไคลเอ็นต์และรหัสลับไคลเอ็นต์ และเมื่อได้รับโทเค็นการรีเฟรช โปรดตรวจสอบว่าได้ใช้บัญชี Google ที่ได้รับสิทธิ์เข้าถึงผู้ลงโฆษณารายนั้น

0x0000011F Advertiser conversion ID is already specified in this request

Conversion อย่างน้อย 2 รายการในคำขอระบุขอบเขตและรหัส Conversion ของผู้ลงโฆษณาเดียวกัน

รหัส Conversion ของผู้ลงโฆษณาคือรหัสที่คุณสร้างและระบุในคอลัมน์ conversionId Search Ads 360 กำหนดให้รหัสนี้ต้องไม่ซ้ำกันสำหรับขอบเขตหนึ่งๆ

0x0000011E The requested Floodlight activity '{name}' does not match the conversion type (ACTION/TRANSACTION)

รหัสหรือชื่อกิจกรรม Floodlight ที่คุณระบุไม่ตรงกับประเภท Conversion ที่คุณระบุ

0x00000124 Conversion timestamp is before click timestamp

conversionTimestamp เกิดขึ้นก่อนเวลาของการคลิกที่คุณระบุในคอลัมน์ clickId ตรวจสอบว่าได้ระบุการประทับเวลาเป็นมิลลิวินาที Epoch ในเขตเวลา UTC ไม่ใช่วินาทีหรือเขตเวลาท้องถิ่น

0x00000125 Conversion age is older than the max supported age

คำขอ update พยายามแก้ไข Conversion ที่เก่าเกินกว่าจะแก้ไขได้ คุณจะแก้ไข Conversion ที่ Search Ads 360 บันทึกผ่านแท็ก Floodlight ได้ภายใน 28 วันนับจากconversionTimestampเท่านั้น

0x00000126 Service internal error

โปรดลองส่งคำขออีกครั้งในภายหลัง ซึ่งน่าจะเป็นข้อผิดพลาดชั่วคราว โปรดติดต่อทีมสนับสนุนของ SA360 หากยังพบข้อผิดพลาดนี้อยู่

0x00000129 Invalid customer ID: {ID}

Search Ads 360 ไม่พบรหัสลูกค้าที่คุณระบุในคอลัมน์ customerId ระบุรหัสลูกค้า Search Ads 360 เวอร์ชันใหม่ของบัญชีลูกค้าที่มีคีย์เวิร์ด เช่น 123-456-7890

0x0000012C Cannot find this keyword ID in Search Ads 360.

Search Ads 360 ไม่พบคีย์เวิร์ดที่ระบุโดยคอลัมน์ customerId, campaignId, adGroupId และ criterionId ตรวจสอบว่ารหัสทั้ง 4 รายการเป็นรหัส Search Ads 360 เวอร์ชันใหม่ และคีย์เวิร์ดเป็นของกลุ่มโฆษณา แคมเปญ และบัญชีลูกค้าที่คุณระบุ

0x0000012E Please provide the full set of new Search Ads 360 IDs: {missing ID}

Conversion ที่มาจากคีย์เวิร์ดต้องระบุ customerId, campaignId, adGroupId และ criterionId ข้อความจะระบุรหัสที่ขาดหายไป ดูระบุแหล่งที่มาของ Conversion เป็นคีย์เวิร์ดเท่านั้น

0x0000012F Editing a click ID older than 60 days is not supported.

คำขอ update ของคุณระบุ clickId ที่สร้างขึ้นนานกว่า 60 วันที่ผ่านมา คุณแก้ไข Conversion ได้ภายใน 60 วันนับจากวันที่เกิดการคลิกเท่านั้น

0x0000013C Conversion editing using integer DS conversion ID is deprecated. Please use conversion ID instead.

คำขอ update ของคุณระบุคอลัมน์ dsConversionId ที่เลิกใช้งานแล้ว หรือส่งรหัส Conversion ของ Search Ads 360 ในคอลัมน์ conversionId ระบุ Conversion ด้วยรหัส Conversion ของผู้ลงโฆษณาแทน ดูการเลิกใช้งาน dsConversionId

โค้ดตอบกลับและข้อความแสดงข้อผิดพลาดของรายงาน

หากคุณขอรายงานและการตอบกลับเป็นข้อความแสดงข้อผิดพลาด โปรดดูข้อมูลเพิ่มเติมเกี่ยวกับข้อผิดพลาดที่หัวข้อโค้ดตอบกลับใน Search Ads 360 API และการตอบกลับข้อผิดพลาดมาตรฐาน

ข้อมูลใน UI ของ Search Ads 360 ไม่ตรงกับรายงานที่ API แสดงผล

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