טיוטות של קמפיינים

טיוטות קמפיין הן דרך להכין קבוצה של שינויים מתוכננים בקמפיין בסיס. לכל טיוטת קמפיין משויכים קמפיין בסיס וטיוטת קמפיין.

• קמפיין הבסיס הוא קמפיין רגיל בחשבון, עם מודעות, קבוצות של מודעות ופריטים אחרים.
• קמפיין הטיוטה הוא שכבה וירטואלית שבה השינויים מצטברים כשמבצעים פעולות, אבל הם לא משפיעים על קמפיינים אמיתיים בחשבון. כשתהיו מרוצים מהמצב של טיוטת הקמפיין, תוכלו להחיל אותה על קמפיין אמיתי בכמה דרכים שונות.

מונח חשוב: טיוטת קמפיין היא משאב שמשמש ליצירת טיוטות חדשות מקמפיין בסיס, ולקביעת השיוכים בין קמפיינים בסיסיים לבין טיוטות של קמפיינים. קמפיין הטיוטה הוא קמפיין וירטואלי שפועל כמו קמפיין, אבל אי אפשר להציג בו מודעות.

בקטלוג של דוגמאות הקוד אפשר למצוא דוגמה פתורה ליצירת ניסוי.

יצירת טיוטה

כדי ליצור CampaignDraft:

1. יוצרים אובייקט CampaignDraft עם השדות הבאים:

   • ‫base_campaign: שם המשאב של הקמפיין שעליו תתבסס הטיוטה.
   • ‫name: שם לטיוטת הקמפיין.

2. לאחר מכן יוצרים CampaignDraftOperation עם השדה create שמוגדר לאובייקט CampaignDraft שיצרתם.

3. בסוף, שולחים את הפעולה הזו אל Google Ads API באמצעות ה-method‏ CampaignDraftService.MutateCampaignDrafts. הבקשה create היא סינכרונית ומחזירה תשובה באופן מיידי.

שינוי של טיוטת קמפיין

אחרי שיוצרים טיוטת קמפיין, אפשר לאחזר את שם המשאב שלה מהשדה results של MutateCampaignDraftsResponse.

כדי לבצע שינויים בקמפיין, צריך לאחזר את שם המשאב של טיוטת הקמפיין שמשויכת אליו. בעזרת שם המשאב של טיוטת הקמפיין, אפשר לשלוח שאילתה אל GoogleAdsService.SearchStream כדי למצוא את טיוטת הקמפיין:

SELECT campaign_draft.draft_campaign
FROM campaign_draft
WHERE campaign_draft.resource_name = "CAMPAIGN_DRAFT_RESOURCE_NAME_HERE"

אחרי שמוצאים את שם המשאב של טיוטת הקמפיין, אפשר לשנות אותו כמו כל קמפיין אחר בחשבון. אי אפשר להציג מודעות בקמפיין הטיוטה, אבל הוא משמש כסביבת הכנה לשינויים שאפשר להחיל על קמפיין בסיס מאוחר יותר.

קידום או הסרה של טיוטת קמפיין

מונח מפתח: פעולות אסינכרוניות ב-Google Ads API מחזירות מה שנקרא פעולה ממושכת. פעולות ארוכות טווח הן דרך נוחה לדגום את השלמת הפעולה בלי לבצע קריאה מלאה ל-API.

אחרי שמסיימים להגדיר את טיוטת הקמפיין, יש כמה אפשרויות:

1. מקדמים את טיוטת הקמפיין לקמפיין הבסיס באמצעות הקריאה אל CampaignDraftService.PromoteCampaignDraft. כל השינויים שביצעתם בטיוטת הקמפיין יחולו על קמפיין הבסיס. זו פעולה אסינכרונית.
2. מסירים את טיוטת הקמפיין באמצעות הפעולה remove של CampaignDraftService.MutateCampaignDrafts, ומעבירים את שם המשאב של טיוטת הקמפיין. הפעולה הזו מבטלת את הטיוטה ומוחקת את כל השינויים אם החלטתם לא להמשיך. זו פעולה סינכרונית.