hermoso
เข้าสู่ระบบ สมัครใช้งาน
MCP & CLI
APIราคา
เข้าสู่ระบบ สมัครใช้งาน

ส่งออกข้อมูลจาก Apple Search Ads

Apple มี reporting API แต่ไม่มีปุ่มส่งออกที่นำตัวเลขไปยังที่ที่คุณทำงานได้ ตัวเชื่อมต่อของ Hermoso ดึงรายงานให้คุณ และวางลงใน Google Sheet, แดชบอร์ด Looker Studio หรือไฟล์ JSON

Hermoso เชื่อมต่อกับ Apple Search Ads และเปิดให้เป็นเครื่องมือที่เอเจนต์เรียกใช้ได้: Claude, ChatGPT, Cursor, Codex, Cline, CLI หรือ HTTP ธรรมดา apple_ads_report ดึงประสิทธิภาพของแคมเปญ ad group, ad, คีย์เวิร์ด และคำค้น และแถวข้อมูลจะกลับมาในรูปของข้อมูล ไม่ใช่ไฟล์ CSV ที่คุณต้องดาวน์โหลดแล้วนำไปไว้ที่อื่นเอง

ตัวเชื่อมต่อ Apple Search Ads

Apple ไม่มี OAuth flow สำหรับ ads API ของตน การเชื่อมต่อจึงเป็นการแลกคีย์ ไม่ใช่การกดปุ่ม Hermoso สร้างคีย์ลงนาม คุณวางครึ่งสาธารณะลงใน Apple Ads และวาง id สามค่ากลับมา คู่มือการตั้งค่า Apple Search Ads อธิบายขั้นตอนทั้งหมด รวมถึงช่อง Public Key ที่คนส่วนใหญ่หาไม่เจอ การเชื่อมต่อหนึ่งครั้งใช้ได้กับเว็บแอป MCP server, CLI และ REST API ดังนั้นการส่งออกแบบเดียวกันใช้ได้จาก Claude, ChatGPT หรือ Cursor: เชื่อม Apple Search Ads กับ Claude หรือ กับ ChatGPT เพียงครั้งเดียว แล้วถามได้เลย

การรายงานเป็นเพียงส่วนหนึ่ง การเชื่อมต่อเดียวกันนี้ยังสร้างและดูแลบัญชีได้ด้วย ได้แก่ แคมเปญ ad group คีย์เวิร์ดและ negatives ออเดอร์งบประมาณ การกำหนดเป้าหมาย คำแนะนำคีย์เวิร์ด และประวัติการเปลี่ยนแปลง หน้าช่อง Apple Ads แสดงเครื่องมือทั้งหมด

รายงานมีอะไรบ้าง

การเรียกหนึ่งครั้ง ห้าระดับ apple_ads_report รายงานได้ที่ระดับ แคมเปญ, ad group, ad, คีย์เวิร์ด หรือ คำค้น และทุกแถวมีตัวชี้วัดเดียวกับที่แดชบอร์ดของ Apple แสดง ได้แก่ impressions, taps, installs, spend, tap-through rate, cost per tap และ cost per acquisition คุณขอเป็นยอดรวม หรือขอเป็นชุดข้อมูลที่ความละเอียด รายชั่วโมง รายวัน รายสัปดาห์ หรือรายเดือน ก็ได้ แถวจะเรียงตามค่าใช้จ่ายจากมากไปน้อย สูงสุด 5,000 แถวต่อหน้า พร้อมแถวยอดรวมทั้งหมดเมื่อขอ รายงานของ App Store ยังรวมออบเจ็กต์ที่ไม่มีการแสดงผลได้ด้วย ดังนั้นคีย์เวิร์ดที่หยุดอยู่จะแสดงเป็นศูนย์ ไม่ใช่หายไปจากรายการ

มีสองกฎที่ Apple บังคับใช้ ซึ่งเครื่องมือจะอธิบายให้ทราบแทนที่จะล้มเหลวอย่างเงียบๆ: รายงานที่ต่ำกว่าระดับแคมเปญต้องมี campaign id (มีเพียงรายงานระดับแคมเปญเท่านั้นที่ครอบคลุมทั้งบัญชี) และรายงานคำค้นทำงานตามเขตเวลาขององค์กรคุณเอง ไม่ใช่ UTC โฆษณาบน Apple Maps ก็ครอบคลุมด้วยเช่นกัน รายงานของ business-brands ใช้เครื่องมือเดียวกัน โดยเปลี่ยนพารามิเตอร์หนึ่งค่า

เชื่อม Apple Search Ads กับ Google Sheets

นี่คือปลายทางเดียวที่ Hermoso เขียนลงเองโดยตรง เชื่อม Google Drive ควบคู่กับ Apple Ads (การอนุญาต Google ครั้งเดียวครอบคลุม Drive, Sheets และ Docs) จากนั้นถามว่า: "ดึงประสิทธิภาพ Apple Search Ads ตามคีย์เวิร์ดของ 30 วันที่ผ่านมา แล้วใส่ลงในชีตใหม่ชื่อ Apple Ads" เอเจนต์จะเรียก apple_ads_report จากนั้น create_sheet และส่งลิงก์กลับมา สัปดาห์ถัดไป ถ้าขอคำเดิมพร้อมคำว่า "append" มันจะเพิ่มแถวด้วย append_to_sheet แทนการเริ่มใหม่

Hermoso ขอสโคป drive.file จาก Google ซึ่งเข้าถึงได้เฉพาะไฟล์ที่มันสร้างเองและไฟล์ที่คุณเลือก ไม่ใช่ Drive ทั้งหมดของคุณ ขั้นตอนฉบับเต็ม รวมถึงการแทนที่แท็บในที่เดิมและการจัดรูปแบบ อยู่ที่ เชื่อม Apple Search Ads กับ Google Sheets

ส่งออก Apple Search Ads ไปยัง Looker Studio

Hermoso ไม่มีตัวเชื่อมต่อ Looker Studio โดยตรง และเราอยากบอกตรงๆ มากกว่าทำให้ดูเหมือนมี มันไม่จำเป็นต้องมี Looker Studio อ่าน Google Sheets ด้วยตัวเชื่อมต่อในตัวของมันเอง ชีตด้านบนจึงเป็นสะพาน

  1. ให้เอเจนต์เขียนรายงานลงแท็บเดียว ความละเอียดรายวัน หนึ่งแถวต่อคีย์เวิร์ดต่อวัน มีแถวหัวตารางและคอลัมน์วันที่ ขอให้จัดคอลัมน์วันที่เป็นรูปแบบวันที่ (format_sheet ทำให้ได้) เพื่อให้ Looker Studio อ่านเป็นวันที่
  2. เพิ่มชีตเป็นแหล่งข้อมูล ใน Looker Studio สร้างแหล่งข้อมูล เลือก Google Sheets เลือกสเปรดชีตและแท็บนั้น และเปิด "Use first row as headers" ไว้
  3. สร้างรายงานครั้งเดียว ค่าใช้จ่ายรายวัน cost per acquisition ตามคีย์เวิร์ด และ installs ตามแคมเปญ สิ่งที่คุณมิฉะนั้นต้องมาสร้างใหม่ในสเปรดชีตทุกวันจันทร์
  4. เพิ่มข้อมูลต่อเนื่อง ทุกสัปดาห์เอเจนต์จะ append แถวใหม่ลงแท็บเดิม และแดชบอร์ดจะเห็นแถวเหล่านั้นในการรีเฟรชข้อมูลครั้งถัดไป ให้คงชื่อคอลัมน์เดิมระหว่างการรันแต่ละครั้ง เพราะ Looker Studio จับคู่ฟิลด์จากหัวตาราง

ชีตเดียวกันใช้กับ Power BI และ Tableau ได้ ซึ่งทั้งสองมีตัวเชื่อมต่อ Google Sheets ของตัวเอง

ส่งออก Apple Search Ads เป็น JSON

หากคุณต้องการแถวดิบแทนสเปรดชีต มีสามวิธีในการได้มา ทั้งหมดใช้การเชื่อมต่อเดียวกัน

REST API เครื่องมือ Hermoso ทุกตัวเรียกได้ที่ POST /v1/tools/{name} ด้วย API key ที่คุณสร้างในแอปที่แท็บ MCP & CLI เนื้อหาคำขอคืออาร์กิวเมนต์ของเครื่องมือ และฟิลด์ data ของคำตอบคือผลลัพธ์แบบมีโครงสร้าง โดยมีแถวอยู่ใน data.rows:

curl -sX POST https://app.hermoso.ai/v1/tools/apple_ads_report \
  -H "Authorization: Bearer hmk_..." -H 'content-type: application/json' \
  -d '{"level":"keyword","campaignId":"1234567890","startTime":"2026-09-01","endTime":"2026-09-07","granularity":"DAILY"}' \
  | jq '.data.rows' > apple-search-ads.json

CLI npx -y hermoso call apple_ads_report --json '{...}' --structured พิมพ์ผลลัพธ์แบบมีโครงสร้างเดียวกันเป็น JSON พร้อมนำไป redirect เข้าไฟล์หรือ pipe เข้าสคริปต์อื่นได้

เอเจนต์ของคุณ ในแชตใดก็ได้ ขอแถวเป็น JSON แล้วคุณจะได้รับในคำตอบ จัดรูปแบบตามที่คุณขอไว้แล้ว

สำหรับรายงานยาว limit รับได้สูงสุด 5,000 แถวต่อหน้า และ offset เลื่อนไปหน้าถัดไป ฟิลด์ hasMore ของผลลัพธ์บอกว่ามีหน้าอื่นอีกหรือไม่ การอ่านรายงานไม่ใช้เครดิต เอกสารอ้างอิง API ฉบับเต็มอยู่ใน เอกสารสำหรับนักพัฒนา

ปลายทางอื่น

"โดยตรง" หมายความว่า Hermoso เขียนลงไปเอง ปลายทางอื่นทั้งหมดคือขั้นตอนเดียวที่เครื่องมือที่คุณใช้อยู่ทำเองได้

  • Google Sheets, Google Docs, Google Drive, OneDrive: โดยตรง
  • Looker Studio, Power BI, Tableau: ผ่านชีต แต่ละตัวมีตัวเชื่อมต่อ Google Sheets ของตัวเอง
  • BigQuery: ผ่านชีต หรือผ่านเอเจนต์ของคุณเอง BigQuery สามารถ query Google Sheet ในฐานะ external table ได้ หากเอเจนต์ของคุณรันอยู่ในที่ที่มี BigQuery client และ credential ของโปรเจกต์คุณ มันสามารถ insert แถวที่ Hermoso ส่งกลับมาลงตารางได้โดยตรง
  • Excel: ผ่านชีตหรือไฟล์ ดาวน์โหลดชีตเป็น .xlsx หรือให้เอเจนต์วางไฟล์ไว้ใน Google Drive หรือ OneDrive
  • PostgreSQL, Redshift, Snowflake หรือคลังข้อมูลใดก็ตาม: ผ่านเอเจนต์ของคุณเองหรือ API Hermoso ส่ง JSON กลับมา สิ่งที่ถือ credential ของฐานข้อมูลคุณเป็นผู้เขียนลงไป Hermoso ไม่ได้ถือ credential ของคลังข้อมูล

ทำการส่งออกรายสัปดาห์โดยอัตโนมัติ

พรอมต์คือระบบอัตโนมัติ ประโยคอย่าง "ทุกวันจันทร์ ดึงประสิทธิภาพ Apple Search Ads ของสัปดาห์ที่แล้วตามคีย์เวิร์ดของทุกแคมเปญ append ลงในชีต Apple Ads และบอกฉันว่าคีย์เวิร์ดไหนเปลี่ยนมากที่สุดในด้าน cost per acquisition" เป็นงานที่สมบูรณ์ในตัว รันตามรอบด้วยการกำหนดเวลาที่ทีมของคุณมีอยู่แล้ว (งานตามกำหนดเวลาใน Claude หรือ ChatGPT หรือ cron job ที่เรียก Hermoso CLI หรือ API) แล้วชีตและแดชบอร์ดทุกตัวที่อ่านมันจะเป็นข้อมูลปัจจุบันเสมอ

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

คำถามที่พบบ่อย

ฉันจะส่งออกข้อมูล Apple Search Ads ได้อย่างไร

เชื่อม Apple Ads กับ Hermoso ครั้งเดียว แล้วขอรายงานที่คุณต้องการจากเอเจนต์ เช่น ประสิทธิภาพตามคีย์เวิร์ดของสัปดาห์ที่แล้ว เครื่องมือ apple_ads_report ดึงข้อมูลจาก reporting API ของ Apple และเอเจนต์จะเขียนลง Google Sheet ส่ง JSON ให้คุณ หรือทั้งสองอย่าง

ฉันเชื่อม Apple Search Ads กับ Google Sheets ได้ไหม

ได้ เชื่อม Apple Ads และ Google Drive ใน Hermoso แล้วขอให้เอเจนต์ใส่รายงานลงชีต มันจะสร้างชีตด้วย create_sheet หรือเพิ่มแถวลงชีตที่มีอยู่ด้วย append_to_sheet และทำซ้ำได้ทุกสัปดาห์

ฉันส่งออก Apple Search Ads ไปยัง Looker Studio ได้ไหม

ได้ ผ่าน Google Sheets Hermoso ไม่มีตัวเชื่อมต่อ Looker Studio โดยตรง เอเจนต์เขียนรายงานลงชีต คุณเพิ่มชีตนั้นเป็นแหล่งข้อมูล Google Sheets ใน Looker Studio ครั้งเดียว และทุกการ append จะปรากฏในการรีเฟรชถัดไปของแดชบอร์ด

ฉันส่งออกข้อมูล Apple Search Ads เป็น JSON ได้อย่างไร

เรียก POST /v1/tools/apple_ads_report บน Hermoso API ด้วย API key แล้วอ่าน data.rows จากคำตอบ หรือรัน hermoso call apple_ads_report --json '{...}' --structured จาก CLI ทั้งสองแบบให้แถวเดียวกันในรูปแบบ JSON

มี reporting API ของ Apple Search Ads ไหม

มี และ Hermoso สร้างบน API นั้น apple_ads_report ครอบคลุมประสิทธิภาพของแคมเปญ ad group, ad, คีย์เวิร์ด และคำค้น ส่วนเครื่องมือ Apple Ads อื่นๆ ใช้สร้างและจัดการบัญชี

ฉันขอรายงานคำค้นของ Apple Search Ads ได้ไหม

ได้ ขอระดับคำค้นและระบุชื่อแคมเปญ Apple ให้บริการคำค้นเฉพาะต่อแคมเปญเท่านั้น และทำงานตามเขตเวลาขององค์กรคุณเอง

รายงานหนึ่งฉบับส่งกลับมาได้กี่แถว

สูงสุด 5,000 แถวต่อหน้า เรียงตามค่าใช้จ่ายจากมากไปน้อย พร้อมธงที่บอกเอเจนต์ว่ามีหน้าอื่นอีกหรือไม่ รายงานคีย์เวิร์ดรายสัปดาห์ของบัญชีส่วนใหญ่พอดีในหนึ่งหน้า

ครอบคลุมโฆษณาบน Apple Maps ด้วยไหม

ครอบคลุม รายงานของแคมเปญ business-brands มาจากเครื่องมือเดียวกัน โดยตั้งประเภท promoted object เป็น Apple Maps แทนที่จะเป็น App Store

ฉันต้องมีนักพัฒนาเพื่อตั้งค่าหรือไม่

ไม่ต้อง เชื่อม Apple Ads ในแอปครั้งเดียว แล้วถามเอเจนต์ด้วยภาษาธรรมดา เช่น ดึงของสัปดาห์ที่แล้วตามคีย์เวิร์ดแล้วใส่ลงชีต API และ CLI มีไว้ให้หากคุณต้องการเขียนสคริปต์

เริ่มใช้ฟรี ไม่ต้องใช้บัตร พร้อมทุกฟีเจอร์ในทุกแพ็ก

เริ่มใช้ฟรี →   ดูราคา