eCommerce · Admin API

Shopify

האינטגרציה עם Shopify מחברת את VellumUp לבלוג Shopify שלך באמצעות Custom App עם גישת Admin API. לאחר ההגדרה, כל מאמר שמתוזמן מתפרסם אוטומטית — עם התמונה הראשית, מטא-נתוני SEO וכל העיצוב שמור.

סקירה כללית

תוכן מאמר

מאמר מעוצב מלא שמתפרסם לבלוג Shopify שנבחר

תמונה ראשית

תמונה ראשית מועלית ל-Shopify Files ומצורפת לפוסט

מטא SEO

כותרת SEO ותיאור מטא ממופים לשדות פוסט הבלוג של Shopify

פרסום מתוזמן

מתפרסם אוטומטית בתאריך המתוזמן מלוח התוכן

דרישות

נדרש בלוג: עליך ליצור לפחות בלוג אחד ב-Shopify Admin לפני החיבור. עבור אל חנות מקוונת ← פוסטים בבלוג ← נהל בלוגים וצור אחד אם טרם עשית זאת.

חנות Shopify פעילה

כל תוכנית Shopify עובדת — Basic, Shopify, Advanced או Plus.

גישת מנהל

נדרשת הרשאה ליצור ולנהל Custom Apps ב-Shopify Admin שלך.

לפחות בלוג אחד

צור בלוג תחת חנות מקוונת ← פוסטים בבלוג ← נהל בלוגים לפני החיבור.

איך לחבר

שלב 1 — צור Custom App ב-Shopify

1
עבור אל הגדרות ← אפליקציות וערוצי מכירה
התחבר ל-Shopify Admin שלך ונווט אל הגדרות ← אפליקציות וערוצי מכירה.
2
לחץ על פתח אפליקציות ← צור אפליקציה
לחץ על הלחצן פתח אפליקציות, ואז על צור אפליקציה. תן לה שם ברור, כמו "VellumUp Integration".
3
פתח תצורה
עבור ללשונית תצורה ולחץ על הגדר ליד Admin API integration.
4
הגדר את ההרשאות הנדרשות
הפעל גישת קריאה וכתיבה עבור: write_content, read_content, write_publications, read_publications, write_files, read_files.
5
לחץ על שמור
שמור את התצורה כדי להחיל את ההיקפים שנבחרו.
6
התקן את האפליקציה
עבור ללשונית התקן אפליקציה ולחץ על התקן אפליקציה לאישור. האפליקציה פעילה כעת בחנות שלך.

שלב 2 — העתק את פרטי הגישה שלך

1
עבור ללשונית פרטי API
לאחר ההתקנה, נווט ללשונית פרטי API בתוך האפליקציה שלך.
2
העתק את Admin API access token
לחץ על הצג טוקן פעם אחת והעתק את ה-Admin API access token. הוא מוצג פעם אחת בלבד — שמור אותו במקום בטוח.
3
העתק את ה-API Key ו-API Secret Key
העתק גם את ה-API Key (Client ID) ואת ה-API Secret Key (Client Secret) המוצגים באותו הדף.

שים לב: ה-Admin API access token מוצג פעם אחת בלבד. אם פספסת אותו, תצטרך להסיר ולהתקין מחדש את האפליקציה כדי לקבל חדש.

שלב 3 — חבר ל-VellumUp

1
פתח אינטגרציות ← Shopify
בלוח הבקרה של VellumUp, עבור אל אינטגרציות ← Shopify ולחץ על חבר.
2
מלא את הפרטים שלך
הזן שם חנות (תווית ידידותית), שם הכותב שלך (כיצד תרצה להופיע בפוסטים), תת-דומיין החנות שלך (למשל my-store מ-my-store.myshopify.com), ה-Client ID וה-Client Secret שלך.
3
לחץ על חבר
VellumUp יאמת את פרטי הגישה שלך, יאחזר את הבלוגים שלך ויפעיל את האינטגרציה.

שים לב: VellumUp ממיר אוטומטית את תוכן המאמר — כולל כותרות, טבלאות ורשימות — ל-HTML נקי לפני הפרסום ב-Shopify.

עבור לאינטגרציה

תמיכה רב-לשונית

VellumUp משתמש ב-Native Translations API של Shopify לניהול תוכן רב-לשוני בצורה חלקה — ללא פוסטים כפולים, ללא הגדרה ידנית.

ארכיטקטורת פוסט יחיד: במקום ליצור פוסטים כפולים לכל שפה, תרגומים מצורפים ישירות למאמר המקורי שלך באמצעות מנגנון התרגום של Shopify.
אפס הגדרה ידנית: המערכת מפעילה ורושמת אוטומטית את ה-locales הנדרשים בהגדרות החנות שלך — אין מה להגדיר מצדך.
הגשה חכמה בחנות: Shopify מגיש אוטומטית את גרסת השפה הנכונה — כותרת, תוכן ותוכן עניינים — בהתאם למיקום הלקוח ולהגדרות החנות שלך.
צפייה ועריכת תרגומים ב-Shopify Admin: התקן את האפליקציה החינמית Translate & Adapt מ-Shopify App Store. היא מציגה את כל גרסאות השפה של המאמרים זו לצד זו ומאפשרת לך לבדוק או לערוך אותן ישירות.

פתרון בעיות

Issue	Solution
"Unauthorized" (401)	ודא שה-Admin API access token נכון והאפליקציה מותקנת בחנות שלך.
חנות לא נמצאה	בדוק את תת-הדומיין שלך. הזן רק את ה-handle ללא https:// או .myshopify.com — לדוגמה, my-store.
תמונות לא נטענות	ודא שהרשאות write_files ו-read_files מופעלות בתצורת ה-Custom App שלך ב-Shopify.
תרגום לא גלוי ללקוחות	Shopify עשוי להציג אזהרה: "Not visible to customers because it's not in a market." עבור ל-Shopify Admin → Settings → Markets, פתח את ה-market הרלוונטי והוסף שם את השפה. לאחר ההוספה, המאמר המתורגם יהיה נגיש בכתובת ה-locale שלו (למשל /he/blogs/...).

התנהגות פרסום

כאשר מאמר מתפרסם, VellumUp שולח את תוכן ה-HTML המלא לבלוג Shopify שנבחר דרך Admin API. התמונה הראשית מועלית ל-Shopify Files תחילה ואז מוגדרת כשער המאמר. כותרת ה-SEO והתיאור המטא מסונכרנים לשדות ה-SEO המובנים של Shopify. הפוסטים מתפרסמים מיידית בתאריך המתוזמן.

חזרה לתיעוד