הגדרת אובייקטים ריקים של הודעות כשדות

ב-Google Ads API, חלק משדות ההודעות משמשים לציון בחירה של שיטת בידינג עבור Campaign. הם יכולים להיות:

שימו לב: השדות של שיטת הבידינג ב-Campaign שייכים לקבוצה bidding_strategy oneof. הגדרת שיטת בידינג חדשה, כמו manual_cpm או manual_cpc, מוחקת באופן אוטומטי כל שיטת בידינג שהוגדרה בעבר בקבוצת oneof הזו.

כדי לעדכן שדה פרימיטיבי כמו campaign.name, מגדירים אותו ישירות:

campaign.name = "Test campaign value"

כדי לעדכן הודעה מקוננת עם שדות משנה שניתנים להגדרה, כמו campaign.manual_cpc כשמפעילים אופטימיזציית עלות לקליק, מגדירים אותה כך:

campaign.manual_cpc.enhanced_cpc_enabled = True

הגדרת הודעות ריקות באמת

כדי להשתמש בשיטת בידינג כמו manual_cpm, שהיא הודעה ריקה:

  1. מקבלים מופע ריק של סוג ההודעה (ManualCpm).
  2. משתמשים ב-client.copy_from כדי להקצות את המופע הריק הזה לשדה של הקמפיין.
  3. מוסיפים ידנית את שם השדה (manual_cpm) אל update_mask ב-CampaignOperation. הכלי ליצירת מסכות שדות לא יכול לזהות באופן אוטומטי שהוגדרה במפורש הודעה ריקה.
from google.ads.googleads import util
from google.ads.googleads.client import GoogleAdsClient
from google.api_core.protobuf_helpers import field_mask

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. Create the operation and manually add "manual_cpm" to the update_mask.
campaign_operation = client.get_type("CampaignOperation")
client.copy_from(campaign_operation.update, campaign)
client.copy_from(
    campaign_operation.update_mask,
    field_mask(None, util.convert_proto_plus_to_protobuf(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 לא מוגדר:

  1. יוצרים מופע של אובייקט ManualCpc ריק ומעתיקים אותו אל campaign.manual_cpc באמצעות client.copy_from.
  2. מוסיפים באופן ידני את הנתיב לכל שדה משנה שניתן לשינוי של ManualCpc אל update_mask ב-CampaignOperation. במקרה הזה, שדה המשנה הרלוונטי הוא enhanced_cpc_enabled.
from google.ads.googleads import util
from google.ads.googleads.client import GoogleAdsClient
from google.api_core.protobuf_helpers import field_mask

client = GoogleAdsClient.load_from_storage()
# Assume 'campaign' is an existing Campaign object you are updating.

# 1. Copy an empty ManualCpc object into campaign.manual_cpc.
client.copy_from(campaign.manual_cpc, client.get_type("ManualCpc"))

# 2. Manually add the subfield path to the update_mask.
campaign_operation = client.get_type("CampaignOperation")
client.copy_from(campaign_operation.update, campaign)
client.copy_from(
    campaign_operation.update_mask,
    field_mask(None, util.convert_proto_plus_to_protobuf(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.

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