ב-Google Ads API, חלק משדות ההודעות משמשים לציון בחירה של שיטת בידינג עבור קמפיין. הם יכולים להיות:
- הודעות ריקות באמת: לדוגמה, ל-campaign.manual_cpmאין שדות משנה מוגדרים.
- הודעות עם שדות אופציונליים: לדוגמה, campaign.manual_cpcכולל את שדה המשנה האופציונליenhanced_cpc_enabled.
כדי לעדכן שדה פרימיטיבי כמו
campaign.name, מגדירים אותו ישירות:
campaign.name = "Test campaign value"
כדי לעדכן הודעה מקוננת עם שדות משנה שניתנים להגדרה, כמו campaign.manual_cpc
כשמפעילים אופטימיזציית עלות לקליק (eCPC), מגדירים אותה כך:
campaign.manual_cpc.enhanced_cpc_enabled = True
הגדרת הודעות ריקות באמת
כדי להשתמש בשיטת בידינג כמו manual_cpm, שהיא הודעה ריקה:
- קבלת מופע ריק של סוג ההודעה
(ManualCpm).
- משתמשים ב-client.copy_fromכדי להקצות את המופע הריק הזה לשדה של הקמפיין.
- מוסיפים ידנית את שם השדה (manual_cpm) ל-update_maskב-CampaignOperation. הכלי לעזרה בנושא מסכת שדות לא יכול לזהות באופן אוטומטי שהוגדרה במפורש הודעה ריקה.
client = GoogleAdsClient.load_from_storage()
# Assume 'campaign' is an existing Campaign object you are updating.
# 1. Get an empty ManualCpm type
empty_cpm = client.get_type('ManualCpm')
# 2. Copy it to the campaign's manual_cpm field
client.copy_from(campaign.manual_cpm, empty_cpm)
# 3. Manually add "manual_cpm" to the update_mask.
from google.api_core.protobuf_helpers import field_mask
campaign_operation = client.get_type('CampaignOperation')
campaign_operation.update = campaign
campaign_operation.update_mask = field_mask(None, campaign)
campaign_operation.update_mask.paths.append("manual_cpm")
# The resulting proto sent to the API will include:
# manual_cpm {
# }
הגדרת הודעות עם שדות משנה אופציונליים
כדי להשתמש בשיטת הבידינג manual_cpc בלי להפעיל את enhanced_cpc_enabled, אפשר לנסות גישה דומה לגישה של ManualCpm.
עם זאת, מכיוון שלשדה ManualCpc יש שדות משנה, הוספת manual_cpc אל update_mask תוביל לשגיאה FieldMaskError.FIELD_HAS_SUBFIELDS. ה-API דורש ספציפיות רבה יותר כשלהודעה במסכה יש שדות משנה.
כדי להגדיר נכון את campaign.manual_cpc ולוודא ש-enhanced_cpc_enabled לא מוגדר:
- יוצרים מופע של אובייקט ManualCpcריק ומקצים אותו ל-campaign.manual_cpc.
- מוסיפים באופן ידני את הנתיב לכל שדה משנה שניתן לשינוי של ManualCpcאלupdate_maskב-CampaignOperation. במקרה הזה, שדה המשנה הרלוונטי הואenhanced_cpc_enabled.
client = GoogleAdsClient.load_from_storage()
# Assume 'campaign' is an existing Campaign object you are updating.
# 1. Instantiate and assign an empty ManualCpc
campaign.manual_cpc = client.get_type('ManualCpc')
# 2. Manually add the subfield path to the update_mask.
from google.api_core.protobuf_helpers import field_mask
campaign_operation = client.get_type('CampaignOperation')
campaign_operation.update = campaign
campaign_operation.update_mask = field_mask(None, campaign)
# For ManualCpc, because it has subfields, you MUST specify the subfield
# path in the update_mask. This tells the API you are updating something
# within manual_cpc. By not setting enhanced_cpc_enabled on the campaign
# object, it defaults to false.
campaign_operation.update_mask.paths.append("manual_cpc.enhanced_cpc_enabled")
# The update_mask paths will include: ['manual_cpc.enhanced_cpc_enabled']
# This correctly signals to the API that ManualCpc is the chosen strategy,
# with enhanced_cpc_enabled in its default state.
כששולחים בקשות באמצעות הדפוסים האלה, אפשר לאמת את מטען הנתונים על ידי הפעלת רישום ביומן ובדיקת הבקשה.