คำถามที่พบบ่อยเกี่ยวกับการรายงาน

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

ขอบเขตการรายงานของฉันควรเป็นอะไร

สำหรับรายงานส่วนใหญ่ เราขอแนะนำให้คุณตั้งค่า Reports.reportScope บัญชีเครื่องมือค้นหาหรือผู้ลงโฆษณาเฉพาะราย สำหรับขนาดใหญ่มาก เช่น รายงานคีย์เวิร์ด รายงาน Conversion หรือ รายงานที่มีการแบ่งกลุ่มอย่างละเอียด เราขอแนะนำให้จำกัดขอบเขตเป็น บัญชีเครื่องมือค้นหาที่เฉพาะเจาะจง API อาจแสดงข้อผิดพลาดสำหรับรายงานที่มีขนาดใหญ่กว่า 10 ล้านแถว

เหตุใดฉันจึงได้รับข้อผิดพลาด "ต้องห้าม (403)"

ซึ่งน่าจะเป็นเพราะคุณต้อง รับโทเค็น OAuth สำหรับรีเฟรช

ฉันจะหารหัสสำหรับเอเจนซีและผู้ลงโฆษณาได้อย่างไร

หากคุณยังไม่มีรหัสสำหรับเอเจนซีและผู้ลงโฆษณาที่คุณมี สิทธิ์ในการดู ส่งคำขอ advertiser ที่มีคอลัมน์ agencyId และ advertiserId แต่ไม่ต้องระบุ reportScope Search Ads 360 จะแสดงรายการรหัสเอเจนซีและผู้ลงโฆษณาทั้งหมด บัญชี Google มีสิทธิ์ดู

ตัวอย่างคำขอมีดังนี้

POST  https://www.googleapis.com/doubleclicksearch/v2/reports/generate
Authorization: Bearer your OAuth 2.0 access token
Content-type: application/json
{
  "reportType": "advertiser",
  "columns": [
    { "columnName": "agency" },
    { "columnName": "agencyId" },
    { "columnName": "advertiser" },
    { "columnName": "advertiserId" }
  ],
  "statisticsCurrency": "usd"
}
        

ใช้สคริปต์ยูทิลิตีของ Search Ads 360 เพื่อส่งคำขอนี้

หากต้องการส่งคำขอ POST ที่เป็นข้อมูลดิบ JSON คุณสามารถใช้ sa360Api.py.py ดังนี้

1. คัดลอกออบเจ็กต์ JSON ตัวอย่าง (โค้ดทั้งหมดที่อยู่ระหว่าง และ วงเล็บปีกกา) ลงในไฟล์ข้อความใหม่ที่ชื่อ request.txt
2. เปลี่ยนรหัสเอเจนซีที่อยู่ในโค้ด JSON เป็นรหัสเอเจนซีของคุณเอง
3. นำความคิดเห็นออก เช่น // The date column segments the report by individual days.
4. รวมข้อมูลเข้าสู่ระบบ OAuth 2.0 เป็นสตริงเดียวที่คั่นด้วยคอมมาดังนี้ ติดตาม:
   client-ID,client-secret,refresh-token
   (ซึ่งเป็นสตริงเดียวกับที่ sa360Api.py แสดงเมื่อคุณเรียกใช้ sa360Api.py --login ตามที่อธิบายไว้ในการตั้งค่า การให้สิทธิ์)
5. เรียกใช้ sa360Api.py ดังนี้
   sa360Api.py --cred CREDENTIALS --server API-method --post < request.txt
   ในคำสั่งด้านบน ให้ใช้ CREDENTIALS แทนสตริงที่คุณประกอบขึ้นในขั้นตอนก่อนหน้า
   แทนที่ชื่อของเมธอด POST ในช่องด้านล่างสำหรับ API-method

   ตัวอย่างเช่น
   sa360Api.py --cred 123456789123.apps.googleusercontent.com,ABCDEFGHIJKLMNOPQR_abcdef,1/HIJklM01OPQR23NOP456rst890uvw --server https://www.googleapis.com/doubleclicksearch/v2/reports/generate --post < request.txt

หมายเหตุ:

เนื่องจาก statisticsCurrency เป็นช่องที่ต้องกรอก ให้ระบุ usd ในคำขอนี้ ในรายงานอื่นๆ ที่กำหนดขอบเขตเป็น ผู้ลงโฆษณาหรือต่ำกว่า คุณสามารถขอ รายงานจะแสดงในสกุลเงินอื่น

ข้อมูลการรายงานมีความใหม่เพียงใด

เมตริกบางรายการใหม่กว่าเมตริกอื่นๆ โปรดดูรายละเอียดในความใหม่ของข้อมูลการรายงาน ใน Search Ads 360 ได้อย่างไร

เพื่อให้มั่นใจว่ารายงานของคุณมีเมตริกที่ใช้ได้ทั้งหมด เราขอแนะนำให้รอประมาณ 4 ชั่วโมงหลังเที่ยงคืน (เขตเวลาของบัญชีเครื่องมือค้นหา) ก่อนขอรายงานของเมื่อวาน metrics; สำหรับรายงาน conversion เราขอแนะนำให้รอ 12 ชั่วโมงหลังเที่ยงคืน (เขตเวลาของผู้ลงโฆษณา Campaign Manager) หากคุณใช้ API เพื่ออัปโหลดข้อมูล Conversion โปรดดู insert.operation เพื่อดูรายละเอียดเกี่ยวกับความพร้อมใช้งานของข้อมูลที่อัปโหลด

แม้จะผ่านไปหลายวัน เมตริกจะยังคงเปลี่ยนแปลงเนื่องจากตัวกรองจดหมายขยะของเครื่องมือหรือออฟไลน์ Conversion ที่อัปโหลดผ่าน API วิธีดาวน์โหลดข้อมูลเหล่านี้ทีละน้อย การเปลี่ยนแปลง, ขอ รายงาน บนข้อมูลที่มีการเปลี่ยนแปลงนับตั้งแต่การดาวน์โหลดครั้งล่าสุดของคุณ หากคุณดาวน์โหลดการเพิ่ม การเปลี่ยนแปลง เราขอแนะนำให้คุณขอรายงานฉบับเต็มทุกครั้ง ตัวอย่างเช่น คุณอาจดาวน์โหลดการเปลี่ยนแปลงที่เพิ่มขึ้นทุก 2-3 วัน แล้วขอรายงานฉบับเต็มครั้งเดียว หนึ่งเดือน

การเปลี่ยนแปลงแอตทริบิวต์จะปรากฏในรายงานเมื่อใด

การเปลี่ยนแปลงแอตทริบิวต์ที่ผู้ใช้ทำใน Search Ads 360 อาจใช้เวลาประมาณ 1 นาทีจึงจะปรากฏ ที่คุณดาวน์โหลดผ่าน API การเปลี่ยนแปลงที่ทำขึ้นโดยตรงในเครื่องมือภายนอก (ไม่ใช่ ผ่าน Search Ads 360) จะต้องนำเข้าไปยัง Search Ads 360 ก่อนโดยใช้การซิงค์ขาเข้า

เราขอแนะนำให้กลับไปยัง เฉพาะข้อมูลที่มีการเปลี่ยนแปลงเพื่อระบุว่าเอนทิตีใดมีการเปลี่ยนแปลงแอตทริบิวต์

โฆษณาและคีย์เวิร์ดที่ไม่ได้ระบุแหล่งที่มาคืออะไร

บางครั้ง Search Ads 360 ไม่สามารถระบุแหล่งที่มาของเมตริกไปยังโฆษณาที่เฉพาะเจาะจงได้ ตัวอย่างเช่น โฆษณาที่มีแท็ก รูปแบบที่ไม่รองรับหรือ URL ของเซิร์ฟเวอร์คลิกที่มีข้อผิดพลาดอาจทําให้ Search Ads 360 ระบุแหล่งที่มาไม่ได้ เมตริกให้กับโฆษณา สําหรับกลุ่มโฆษณาแต่ละกลุ่ม Search Ads 360 จะรายงานเมตริกที่ไม่มีการระบุแหล่งที่มาซึ่งเป็นของ "โฆษณาที่ไม่ได้ระบุแหล่งที่มา" หากต้องการขอเมตริกเหล่านี้ในรายงาน ให้ตั้งค่า includeRemovedEntities ไปยัง true เพื่อให้คุณดูได้ง่ายว่าโฆษณาใดที่ไม่มีการระบุแหล่งที่มา ให้ใส่ลิงก์ isUnattributedAd ในคำขอ

ในทำนองเดียวกัน Search Ads 360 ไม่สามารถระบุแหล่งที่มาของเมตริกไปยังคีย์เวิร์ดที่เฉพาะเจาะจงได้ในบางครั้ง กรณีนี้จะเกิดขึ้นเมื่อมีความคลาดเคลื่อนในการรายงาน ในกรณีดังกล่าว ฟิลด์ คอลัมน์ keywordId สำหรับคีย์เวิร์ดที่ไม่ได้ระบุแหล่งที่มามีค่าเป็น 0

รายงานมี Conversion ที่ปรับขนาดหรือไม่

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

Floodlight จะใช้การปรับขนาดกับคอลัมน์การรายงานต่อไปนี้เสมอ

• dfaActions
• dfaRevenue
• dfaTransactions
• dfaWeightedActions
• คอลัมน์ที่บันทึกไว้ซึ่ง รายงานกิจกรรม Floodlight

conversion ไม่รวม Conversion ที่ปรับขนาด แสดงเฉพาะ Conversion ที่วัดแล้ว โดยตรง จำนวน Conversion และจำนวนเงินรายได้ในรายงาน conversion ไม่ได้ตรงกับ Conversion และรายได้ที่รายงานในคอลัมน์ที่ระบุไว้ข้างต้น

เหตุใด Conversion ดิบจึงไม่รวมเมตริกรวม X

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

จะทำอย่างไรหากที่นี่ไม่มีคำตอบสำหรับคำถาม

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

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

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

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

• ข้อมูลโค้ดของคำขอ

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