Repository navigation
v0.42.0
Two contributions from @illia-sapryga: campaigns can now carry geo exclusions and an ad schedule from the start, and a conversion action can be moved to another goal.
Geo exclusions and ad schedule on campaigns (#121)
draft_campaign and update_campaign take two new parameters:
geo_exclude_ids: locations to exclude, for example a city inside a targeted state. They may not overlapgeo_target_ids.ad_schedule: the windows the campaign serves in, in the account time zone, validated likeadd_ad_schedule(no overlaps, at most six a day, minutes 0, 15, 30 or 45).
On a new campaign both are created in the same request as the campaign itself. The campaign is created paused, so a schedule only comes with a warning that it will serve inside those windows once enabled.
On update_campaign both replace what the campaign has: leaving the parameter out keeps the current values, an empty list clears them. The preview shows the current exclusions and windows next to the new ones. A first schedule, clearing a schedule and dropping an exclusion each need a double confirmation, because they change where or when a live campaign serves. Only what differs is removed or added, a location can move between targets and exclusions in one call, and the apply sends nothing if the exclusions or windows changed in Google Ads after the preview.
Moving a conversion action to another goal (#122)
draft_update_conversion_action takes category. The preview shows the current category and warns that campaigns bidding on either goal can start or stop optimizing toward the action. The dry run and the apply re-read the action and send nothing if its category changed in the meantime or the action is gone.
include_in_conversions_metric is now refused on update. Google rejects it at apply with IMMUTABLE_FIELD and a dry run did not catch that, so a plan could pass the test run and then fail. Whether an action counts in Conversions follows primary_for_goal and the goal of its category; use those instead.
Upgrade
pip install -U adloop
No config changes.