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

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

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

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

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

יצירת טיוטה

כדי ליצור 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, ומעבירים את שם המשאב של טיוטת הקמפיין. אם מחליטים לא להמשיך, הטיוטה מתבטלת והשינויים נמחקים. זו פעולה סינכרונית.