เชื่อม Apple Search Ads กับ Claude หรือ ChatGPT ภายในห้านาที

ตัวเชื่อมต่อ Apple Search Ads ของ Hermoso จะเชื่อมบัญชี Apple Ads ของคุณกับ Claude, ChatGPT, Cursor, CLI หรือ HTTP ธรรมดา เพื่อให้เอเจนต์รันโฆษณาค้นหาใน App Store ให้คุณได้ มันสร้างแคมเปญ ad group คีย์เวิร์ดเป้าหมาย และ negatives อ่านกลับสิ่งที่ Apple บันทึกไว้จริง และรายงานประสิทธิภาพลงไปถึงระดับคำค้นที่คนพิมพ์ก่อนติดตั้งแอป ทุกอย่างที่มันสร้างจะถูกสร้างในสถานะ หยุดชั่วคราว และการเปิดใช้งบประมาณเป็นขั้นตอนแยกที่ต้องยืนยันอย่างชัดเจน รายงานส่งเข้า Google Sheet, แดชบอร์ด Looker Studio หรือไฟล์ JSON ได้ และ หน้า Apple Ads MCP แสดงทุกสิ่งที่ตัวเชื่อมต่อทำได้

การเชื่อมต่อใช้เวลาประมาณห้านาที คุณจะไม่ต้องรัน openssl และไม่มีรหัสผ่าน Apple ใดส่งเข้า Hermoso

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

หากต้องการเชื่อม Apple Search Ads กับ Claude ให้เพิ่ม Hermoso เป็นตัวเชื่อมต่อใน Claude แล้วเชื่อมบัญชี Apple Ads ภายใน Hermoso ครั้งเดียว ใน Claude เปิด Customize › Connectors › Add custom connector ตั้งชื่อว่า Hermoso วาง https://app.hermoso.ai/mcp แล้วอนุมัติด้วยบัญชี Hermoso ของคุณ ไม่มีคีย์ให้วางใน Claude จากนั้นเชื่อม Apple Ads ใน Hermoso ที่ การตั้งค่า › Connectors ตามขั้นตอนที่อยู่ด้านล่างของหน้านี้ หลังจากนั้น Claude เรียกเครื่องมือ Apple Ads ทั้งหมดที่ Hermoso มีได้ สั่งด้วยภาษาธรรมดา ไม่ว่าจะเป็นการขอรายงาน การเปลี่ยนคีย์เวิร์ด หรือแคมเปญใหม่ ใน Claude Code ทำได้ด้วยสองคำสั่งแทน: /plugin marketplace add hermoso-ai/hermoso แล้วตามด้วย /plugin install hermoso@hermoso Hermoso ใน Claude มีขั้นตอนฉบับเต็ม

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

ChatGPT ทำงานแบบเดียวกัน ใน ChatGPT เปิด Plugins แล้วเลือก Add › Create MCP App ตั้งชื่อว่า Hermoso วาง https://app.hermoso.ai/mcp เป็น Server URL คง Authentication ไว้ที่ OAuth แล้วอนุมัติด้วยบัญชี Hermoso ของคุณ หากไม่เห็น Create MCP App ให้เปิด Developer mode หนึ่งครั้งที่ Settings › Plugins › Developer mode เมื่อเชื่อม Apple Ads ใน Hermoso แล้ว ChatGPT จะดึงรายงานคีย์เวิร์ดของคุณ เขียนลง Google Sheet หรือร่างแคมเปญให้คุณตรวจก่อนได้ Hermoso ใน ChatGPT มีขั้นตอนอธิบายไว้

Cursor, Codex และ MCP client อื่นๆ

MCP client ใดก็ตามที่รองรับ Model Context Protocol จะเข้าถึงเครื่องมือชุดเดียวกันที่ที่อยู่เดียวกัน Cursor อ่าน https://app.hermoso.ai/mcp จากไฟล์ mcp.json ของมัน ส่วน Codex รับปลั๊กอิน Hermoso ด้วย codex plugin marketplace add hermoso-ai/hermoso ซึ่งสั่งงานเครื่องมือชุดเดียวกันจากเทอร์มินัลได้ ไม่ว่าคุณจะใช้ client ไหน ข้อมูลรับรองของ Apple จะไม่ผ่านแชต เอเจนต์เรียกเครื่องมือของ Hermoso และ Hermoso ลงนามทุกคำขอไปยัง Apple ด้วยคีย์ที่ Hermoso ถืออยู่ หน้า Apple Ads MCP แสดงเครื่องมือทั้งหมด

สิ่งที่ควรถามเมื่อเชื่อมต่อแล้ว

• “ขอรายงานประสิทธิภาพ Apple Search Ads ของสัปดาห์ที่แล้วแยกตามคีย์เวิร์ด และแสดงสิบอันดับแรกที่มี cost per acquisition สูงสุดให้ฉันดูหน่อย”
• “นำ spend, installs และ CPA ของ 30 วันที่ผ่านมา แยกตามแคมเปญ ไปใส่ใน Google Sheet ใหม่ชื่อ Apple Ads” (เชื่อม Google Drive ก่อน)
• “คำค้นไหนในเดือนนี้ที่ทำให้มีการติดตั้งในแคมเปญ US ของฉัน แต่ฉันยังไม่ได้ตั้งเป็นคีย์เวิร์ดแบบ exact”
• “เพิ่ม ‘budget planner’ และ ‘expense tracker’ เป็นคีย์เวิร์ดแบบ exact ใน Brand ad group และเพิ่ม ‘jobs’ เป็น negative”
• “Apple แนะนำคีย์เวิร์ดอะไรสำหรับแอปของฉันบ้าง และฉันได้ impression share เท่าไรจากคีย์เวิร์ดที่ตั้งประมูลอยู่แล้ว”
• “สร้างแคมเปญที่หยุดไว้สำหรับแอปของฉันในสหราชอาณาจักร งบประมาณรายวัน 50 ดอลลาร์ แล้วแสดงให้ดูว่า Apple บันทึกอะไรไว้”

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

อย่างแรก สิ่งที่ทำให้คนส่วนใหญ่ติดอยู่

คำแนะนำของ Apple เองระบุว่า: “จาก Ads UI เลือก Account Settings › API วางคีย์ลงในช่อง Public Key”

ช่องนั้นไม่มีอยู่สำหรับ Account Admin ลงชื่อเข้าใช้ในฐานะแอดมินของบัญชีคุณ เปิด Account Settings › API แล้วสิ่งที่แสดงคือตารางหัวข้อ Manage API Access (รายการผู้ให้บริการบุคคลที่สามพร้อมการกระทำเดียวคือ Remove Access) และไม่มีช่องคีย์ใดๆ ในหน้านั้น มันดูเหมือนฟีเจอร์ที่ยังไม่มี ซึ่งเป็นเหตุผลที่คนมักหยุดตรงนี้แล้วสรุปว่า API ใช้ไม่ได้กับตนเอง

จริงๆ แล้วใช้ได้ ช่อง Public Key เป็นของผู้ใช้ที่ถือ API role และการเป็นแอดมินของบัญชีไม่ใช่หนึ่งในนั้น กล่องเชิญของ Apple มีหกบทบาท และมีเพียงสองบทบาทที่เป็น API role:

• API Account Manager: “สิทธิ์อ่านและเขียนสำหรับทุก campaign group เพื่อการจัดการผ่าน API”. นี่คือบทบาทที่ควรเลือก หากคุณต้องการให้ Hermoso สร้างแคมเปญ ไม่ใช่แค่รายงานผล
• API Account Read Only: “สิทธิ์อ่านอย่างเดียวสำหรับทุก campaign group เพื่อการจัดการผ่าน API”. พอสำหรับการรายงานเท่านั้น ไม่มีอย่างอื่น

อีกสี่บทบาท (Account Admin, Account Finance, Account Read Only และ Limited Access) ไม่สามารถสร้างข้อมูลรับรอง API ได้เลย ดังนั้นวิธีแก้คือส่งคำเชิญถึงตัวคุณเอง:

1. เปิด Account Settings › User Management แล้วเลือก Invite Users
2. เชิญอีเมลที่คุณควบคุมได้ (ของคุณเอง หรืออีเมลกลางอย่าง ads-api@yourcompany.com เพื่อให้ข้อมูลรับรองอยู่ต่อได้แม้คนใดคนหนึ่งจะออกไป) โดยใช้บทบาท API Account Manager
3. ยอมรับคำเชิญจากกล่องจดหมายนั้น แล้วลงชื่อเข้าใช้ Apple Ads ในฐานะผู้ใช้คนนั้น

ตอนนี้ Account Settings › API จะมีช่อง Public Key อยู่แล้ว

การเชื่อมต่อ ทีละขั้นตอน

1. เริ่มต้นใน Hermoso การตั้งค่า › Connectors › Apple Ads › Connect Hermoso จะสร้างคีย์ลงนาม EC P-256 (คีย์ prime256v1 ตัวเดียวกับที่คำสั่ง openssl สองคำสั่งของ Apple จะสร้าง) และแสดงให้คุณเฉพาะ ครึ่งสาธารณะ คัดลอกไว้
2. ส่งครึ่งสาธารณะให้ Apple ในฐานะผู้ใช้ที่มี API role เปิด Account Settings › API วางลงในช่อง Public Key แล้วกด Save
3. คัดลอก id ทั้งสามกลับมา Apple จะแสดง clientId, teamId และ keyId เหนือช่องนั้น ครบทั้งสามค่า
4. เสร็จสิ้นใน Hermoso วาง id ทั้งสามแล้วบันทึก Hermoso จะแลกโทเคนกับ Apple และอ่านรายการองค์กรของคุณ ก่อน เก็บข้อมูลใดๆ ดังนั้น id ที่พิมพ์ผิดจะล้มเหลวตรงนั้น ขณะที่คุณยังเห็นสิ่งที่วางอยู่ ไม่ใช่ตอนรายงานแรกอีกหนึ่งชั่วโมงให้หลัง
5. เลือกองค์กร หากข้อมูลรับรองของคุณครอบคลุมมากกว่าหนึ่งองค์กร การเชื่อมต่อจะผูกกับองค์กรที่คุณเลือก

หากมีอะไรผิดพลาด

ไม่มีช่อง Public Key ในหน้า API

คุณกำลังลงชื่อเข้าใช้ในฐานะ Account Admin หรือหนึ่งในสี่บทบาทที่ไม่ใช่ API ให้เชิญตัวเองเป็น API Account Manager แล้วลงชื่อเข้าใช้ในฐานะผู้ใช้คนนั้น (ดูด้านบน) นี่คือสาเหตุที่พบบ่อยที่สุดที่การเชื่อมต่อ Apple Ads ไม่เคยเกิดขึ้น

Apple ปฏิเสธข้อมูลรับรอง

id ทั้งสามต้องเป็นของคีย์ที่ Apple ถืออยู่ คัดลอก clientId, teamId และ keyId ใหม่จากด้านบนของช่อง Public Key ไม่ใช่จากคีย์เก่าที่คุณเปลี่ยนไปแล้ว หากยังล้มเหลว ให้เริ่มการเชื่อมต่อใหม่ใน Hermoso การทำเช่นนั้นจะสร้างคู่คีย์ใหม่ และคุณวางครึ่งสาธารณะใหม่ลงใน Apple

เซสชันการตั้งค่าหมดอายุ

Hermoso เก็บคีย์ส่วนตัวที่สร้างไว้เป็นเวลา 24 ชั่วโมง ขณะที่คุณไปวางครึ่งสาธารณะใน Apple เมื่อเกินนั้นคีย์จะหายไป ซึ่งเป็นการออกแบบโดยตั้งใจ ให้เริ่มการเชื่อมต่อใหม่แล้ววาง public key ใหม่

ฉันสร้างคีย์ด้วย openssl ไว้แล้ว

ก็ใช้ต่อได้เลย วางคีย์ส่วนตัว EC P-256 ที่มีอยู่เมื่อเชื่อมต่อ แทนที่จะใช้ของ Hermoso คีย์สาธารณะที่อยู่ในบัญชี Apple ของคุณแล้วจะยังใช้งานได้ต่อ ต้องเป็น EC P-256 (prime256v1) เท่านั้น Apple ไม่รับเส้นโค้งอื่น

ฉันจัดการหลายองค์กรของ Apple Ads

เชื่อมแต่ละองค์กรในโปรไฟล์ Hermoso ของตัวเอง การเชื่อมต่อหนึ่งครั้งผูกกับองค์กรเดียว ซึ่งป้องกันไม่ให้แคมเปญของเอเจนซีไปลงในบัญชีของลูกค้าคนอื่น

สิ่งที่ตัวเชื่อมต่อ Apple Search Ads ทำได้

สร้าง: create_apple_ads_campaign, create_apple_ads_ad_group, add_apple_ads_keywords, add_apple_ads_negative_keywords, update_apple_ads_object, set_apple_ads_status, delete_apple_ads_object

อ่าน: list_apple_ads_campaigns (สถานะ สถานะการแสดงผล งบประมาณรายวันและรวม ประเทศที่แคมเปญวิ่ง และเหตุผลที่ Apple ระบุเองเมื่อแคมเปญวิ่งไม่ได้), list_apple_ads_ad_groups (bid เริ่มต้น และว่า Search Match ของ Apple เปิดอยู่หรือไม่), list_apple_ads_keywords (การกำหนดเป้าหมายและ negative พร้อม match type และ bid), apple_ads_report (impressions, taps, installs, spend, TTR, CPT และ CPA ในระดับแคมเปญ, ad group, ad, คีย์เวิร์ด หรือคำค้น) และ list_apple_ads_orgs

ทุกอย่างเรียกใช้จาก Claude, Claude Code, Codex, Cursor, Cline, OpenClaw, Hermes หรือ MCP client อื่นใด และจากสตูดิโอบนเว็บได้ เป็นเอนจินเดียวกันทั้งสองทาง ดู ภาพรวม MCP หรือ เอกสารอ้างอิงเครื่องมือโฆษณา

และอื่นๆ: มันสร้างครีเอทีฟและโฆษณาได้ (create_apple_ads_creative, create_apple_ads_ad) โหลดคีย์เวิร์ดได้สูงสุด 1,000 รายการในการเรียกครั้งเดียว (bulk_apple_ads_keywords) และอ่านข้อมูลของ Apple เอง ได้แก่ apple_ads_keyword_suggestions, apple_ads_impression_share, apple_ads_search_term_popularity และ apple_ads_change_history เครื่องมือเหล่านี้ทุกตัวเรียกใช้จากแชตเดียวกันได้

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

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

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

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

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

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

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

สำหรับแถวดิบ ให้เรียกเครื่องมือผ่าน Hermoso REST API ด้วย API key: POST https://app.hermoso.ai/v1/tools/apple_ads_report โดยส่งอาร์กิวเมนต์ของรายงานเป็น JSON body แล้วอ่านแถวจาก data.rows ในคำตอบ จากเทอร์มินัล npx -y hermoso call apple_ads_report --json '{...}' --structured จะพิมพ์ผลลัพธ์เดียวกันออกมาเป็น JSON ตัวอย่างคำขอฉบับเต็ม

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

ฉันจะเชื่อม Apple Search Ads กับ Claude ได้อย่างไร

เพิ่ม Hermoso เป็น custom connector ใน Claude ด้วย URL https://app.hermoso.ai/mcp แล้วอนุมัติด้วยบัญชี Hermoso ของคุณ จากนั้นเชื่อม Apple Ads ใน Hermoso ที่ การตั้งค่า › Connectors Claude จะรายงาน แก้ไข และสร้างแคมเปญ Apple Search Ads ของคุณผ่านเครื่องมือ Apple Ads ของ Hermoso ได้

ChatGPT อ่านข้อมูล Apple Search Ads ของฉันได้ไหม

ได้ เพิ่ม https://app.hermoso.ai/mcp ใน ChatGPT ที่ Plugins › Add › Create MCP App แล้วเชื่อม Apple Ads ใน Hermoso ChatGPT จะดึง impressions, taps, installs, spend, TTR, CPT และ CPA แยกตามแคมเปญ ad group, ad, คีย์เวิร์ด หรือคำค้น และเขียนแถวลง Google Sheet ได้

มี MCP server ของ Apple Search Ads ไหม

มี MCP server ที่โฮสต์ของ Hermoso ที่ https://app.hermoso.ai/mcp เปิดชุดเครื่องมือ Apple Ads ทั้งหมดให้ Claude, ChatGPT, Cursor, Codex หรือ MCP client ใดก็ได้ ได้แก่ การรายงาน แคมเปญ ad group คีย์เวิร์ดและ negatives ครีเอทีฟและโฆษณา และคำแนะนำคีย์เวิร์ดของ Apple ทุกอย่างที่มันสร้างจะอยู่ในสถานะหยุดชั่วคราว

ทำไมไม่มีช่อง Public Key ในหน้า Apple Ads API

เพราะคุณลงชื่อเข้าใช้ในฐานะ Account Admin Apple แสดงช่องนั้นเฉพาะผู้ใช้ที่ถือ API role แอดมินจะเห็นตาราง “Manage API Access” ของผู้ให้บริการบุคคลที่สามแทน โดยไม่มีช่องคีย์ใดๆ ในหน้า ให้เชิญตัวเองเป็น API Account Manager ที่ Account Settings › User Management ลงชื่อเข้าใช้ในฐานะผู้ใช้คนนั้น แล้วช่องจะปรากฏ

ฉันต้องใช้บทบาท Apple Ads ไหน

API Account Manager หากคุณต้องการให้ Hermoso สร้างแคมเปญ ad group และคีย์เวิร์ด Apple อธิบายว่า “สิทธิ์อ่านและเขียนสำหรับทุก campaign group เพื่อการจัดการผ่าน API” API Account Read Only พอสำหรับการรายงานเท่านั้น อีกสี่บทบาทที่ Apple มี (Account Admin, Account Finance, Account Read Only และ Limited Access) ไม่สามารถสร้างข้อมูลรับรอง API ได้เลย

ฉันต้องรัน openssl ไหม

ไม่ต้อง คำแนะนำของ Apple ให้คำสั่ง openssl สองคำสั่ง Hermoso สร้างคู่คีย์ EC P-256 ให้คุณ และแสดงให้คุณเฉพาะครึ่งสาธารณะ ครึ่งส่วนตัวคือสิ่งที่ลงนามคำขอของคุณ และคุณไม่เคยเห็น วาง หรือเก็บมัน หากคุณมีคีย์จากเครื่องมืออื่นอยู่แล้ว นำมาใช้ได้เลย

การเชื่อมต่อ Apple Ads มีค่าใช้จ่ายหรือมีความเสี่ยงต่องบประมาณไหม

ไม่มี การอ่านข้อมูลเรียกได้โดยไม่มีค่าใช้จ่าย และทุกออบเจ็กต์ที่ Hermoso สร้างจะถูกสร้างในสถานะ PAUSED โดยไม่มีตัวข้าม การเปิดใช้งานออบเจ็กต์เป็นสวิตช์เดียวที่เปิดการใช้จ่ายจริง และต้องมีการยืนยันอย่างชัดเจน

clientId, teamId และ keyId คืออะไร

ตัวระบุสามค่าที่ Apple แสดงเหนือช่อง Public Key เมื่อคุณบันทึกคีย์แล้ว ค่าเหล่านี้ระบุตัวผู้ใช้ API ของคุณต่อ Apple ส่วนคีย์ส่วนตัวเป็นตัวพิสูจน์ว่าเป็นคุณ วางทั้งสามค่ากลับเข้า Hermoso การเชื่อมต่อก็เสร็จ

การเชื่อมต่อหนึ่งครั้งครอบคลุมหลายองค์กรของ Apple Ads ได้ไหม

การเชื่อมต่อหนึ่งครั้งผูกกับองค์กรเดียวที่คุณเลือกตอนสร้าง Apple ถือ orgId คล้ายกับ campaign group ดังนั้นการลงชื่อเข้าใช้หนึ่งครั้งอาจครอบคลุมได้หลายองค์กร เอเจนซีที่มีลูกค้าหนึ่งรายต่อหนึ่งองค์กรเชื่อมแต่ละองค์กรในโปรไฟล์ Hermoso ของตัวเอง

ฉันต้องหมุนเวียนคีย์ทุก 180 วันไหม

ไม่ต้อง Apple จำกัด client secret ไว้ที่ 180 วัน ซึ่งเป็นเหตุผลที่คำแนะนำของ Apple ให้คุณตั้งเตือนการหมุนเวียน Hermoso เก็บคีย์ส่วนตัวไว้ และสร้าง secret อายุสั้นใหม่ทุกครั้งที่แลกโทเคน ดังนั้นจึงไม่มีอะไรค้างอยู่ในไฟล์ตั้งค่าให้หมดอายุ

ฉันส่งออกข้อมูล Apple Search Ads ไปยัง Google Sheets หรือ Looker Studio ได้ไหม

ได้ เชื่อม Google Drive ควบคู่กับ Apple Ads แล้วเอเจนต์ของคุณจะเขียนรายงานลง Google Sheet ด้วย create_sheet หรือ append_to_sheet Hermoso ไม่มีตัวเชื่อมต่อ Looker Studio โดยตรง Looker Studio อ่านชีตนั้นด้วยตัวเชื่อมต่อ Google Sheets ของมันเอง

ฉันขอข้อมูล Apple Search Ads เป็น JSON ได้ไหม

ได้ เรียก POST /v1/tools/apple_ads_report บน Hermoso API ด้วย API key แล้วอ่าน data.rows หรือรัน hermoso call apple_ads_report ด้วย --structured จาก CLI