late-sdk 0.0.1319 → 0.0.1320

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: cdc18f90fb94b536040ca7eadb2c10a8a468db8b79d35ce8cee4351b0629aeab
-  data.tar.gz: 79049cebe473cd026eae7554121cf9cb393d41a4eb6693eb753179f9b06b8bb4
+  metadata.gz: c71450269e1d831a0c4b4d88a753b91a5b7f030e6d250dc5d6d979d9b115e7ed
+  data.tar.gz: d52c6f1284cdaf1b77a3ff0788a0f50ab7edf992ad8c779798bf6807e3fef7b3
 SHA512:
-  metadata.gz: 28ff6d57f7ad5f003d02437db2ca472f040da125369459c79782785f3d06043d3f473e982b3d1ec20a0e6a3c0f8997ed60dc43e733aa103c516d00ac47409d09
-  data.tar.gz: 7464c4a47e5a7c949af4828cc4bddb322ffad83e6ef85e8897316cf995c39a557354146a51504e02d91f461658f2600d35b63461f5b25fdb0d8ddd75fe7a74de
+  metadata.gz: bd12ccd3a2d8b47428cc85d0646efea7068aa9a183745d647bab0fee80059ef8d82a34b50d39f650e873dbcec4ddf528a77b7b27e5ebb59a2ab35722ea2ff158
+  data.tar.gz: c5d32a09abbc0ec20789583db647606163c07c6dc50f2068de0c0e1123d003533aec547dd434dc03bddc612a3cffa72cd95dcc167896c496711688bae6ec00a3

data/docs/ListAdSets200ResponseAdSetsInner.md

@@ -20,10 +20,10 @@
 | **is_external** | **Boolean** |  | [optional] |
 | **platform_created_at** | **Time** |  | [optional] |
 | **status_read_at** | **Time** | Only with `live=true`. When `platformAdSetStatus` was read from the platform; null when this row was not read live. | [optional] |
-| **optimization_goal** | **String** | The ad set's optimization goal as last synced, in the platform's own enum (Meta `optimization_goal`, for example OFFSITE_CONVERSIONS or LINK_CLICKS). On TikTok with `live=true`, rows read live carry the ad group's `optimization_goal` exactly as TikTok's adgroup/get returns it now (for example ENGAGED_VIEW, ENGAGED_VIEW_FIFTEEN, CLICK, CONVERT). | [optional] |
-| **billing_event** | **String** | The ad set's billing event as last synced, where the platform reports one. On TikTok with `live=true`, rows read live carry the ad group's `billing_event` exactly as TikTok's adgroup/get returns it now (for example CPV, CPC, OCPM). | [optional] |
-| **bid_strategy** | **String** | The bid strategy as last synced, in the platform's own enum (Meta `bid_strategy`, for example LOWEST_COST_WITHOUT_CAP, COST_CAP). On Meta under a campaign budget this is the campaign's strategy. | [optional] |
-| **bid_amount** | **Float** | Bid cap or cost target in whole units of `currency`, as last synced. Null when the strategy has none. | [optional] |
+| **optimization_goal** | **String** | The ad set's optimization goal as last synced, in the platform's own enum (Meta `optimization_goal`, for example OFFSITE_CONVERSIONS or LINK_CLICKS; TikTok `optimization_goal`; Pinterest the conversion event of `optimization_goal_metadata`, for example CHECKOUT; X the line item `goal`; OpenAI the campaign `bidding_type`). Always null on Google, which has no per-ad-group optimization goal. On TikTok with `live=true`, rows read live carry the ad group's `optimization_goal` exactly as TikTok's adgroup/get returns it now (for example ENGAGED_VIEW, ENGAGED_VIEW_FIFTEEN, CLICK, CONVERT). | [optional] |
+| **billing_event** | **String** | The ad set's billing event as last synced, in the platform's own enum (Meta `billing_event`, TikTok `billing_event`, Pinterest `billable_event`, X `pay_by`, OpenAI `bidding_config.billing_event_type`). Always null on Google, which reports none per ad group. On TikTok with `live=true`, rows read live carry the ad group's `billing_event` exactly as TikTok's adgroup/get returns it now (for example CPV, CPC, OCPM). | [optional] |
+| **bid_strategy** | **String** | The bid strategy as last synced, in Meta's vocabulary (LOWEST_COST_WITHOUT_CAP, LOWEST_COST_WITH_BID_CAP, COST_CAP, LOWEST_COST_WITH_MIN_ROAS) on every platform that has an equivalent. On Meta under a campaign budget this is the campaign's strategy. TikTok maps bid_type / deep_bid_type, Pinterest AUTOMATIC_BID / MAX_BID / TARGET_AVG, X AUTO / MAX / TARGET, OpenAI Maximize Results / a max bid. Google bids at the campaign, so an ad group carries its campaign's strategy; one without a Meta equivalent (MANUAL_CPC, TARGET_IMPRESSION_SHARE, or a portfolio strategy's type such as TARGET_CPA) keeps Google's own name. Null on LinkedIn. | [optional] |
+| **bid_amount** | **Float** | Bid cap or cost target in whole units of `currency`, as last synced. Null when the strategy has none (automatic bidding, ROAS targets, a Google portfolio strategy). On Google a campaign target CPA, a Maximize clicks ceiling, the ad group's own target CPA override, or its CPC bid under MANUAL_CPC. | [optional] |
 | **promoted_object** | **Hash<String, Object>** | Meta only. The ad set's `promoted_object` verbatim (snake_case, for example pixel_id + custom_event_type, page_id, application_id), as last synced from its most recent ad. Null on other platforms and on an ad set with no ad yet; GET /v1/ads/accounts/live reads it live for every ad set. | [optional] |
 | **native_settings** | **Hash<String, Object>** | TikTok only, only with `live=true` and only on rows read live. TikTok's adgroup/get record verbatim (snake_case, TikTok's own names and enums): operation_status, optimization_goal, optimization_event, billing_event, bid_type, bid_price, budget, budget_mode, pacing, schedule_type, schedule_start_time, schedule_end_time, dayparting, placement_type, placements, location_ids, age_groups, gender, languages, interest_category_ids, interest_keyword_ids, actions, audience_ids, excluded_audience_ids, operating_systems, frequency, frequency_schedule, smart_audience_enabled, smart_interest_behavior_enabled. schedule_start_time and schedule_end_time are UTC wall clocks (YYYY-MM-DD HH:MM:SS). location_ids holds TikTok's native location ids (GeoNames ids for countries); GET /v1/ads/targeting/search?dimension=geo returns them as `platformId` on country results. Plus advertiser_currency and advertiser_timezone from TikTok's advertiser/info. A field TikTok does not return is absent. | [optional] |
 | **config_read_at** | **Time** | Only with `live=true`. When `nativeSettings` was read from the platform. Null on every row whose native settings were not read now (row past the cap, failed read, or a platform without a native read). | [optional] |

data/lib/zernio-sdk/models/list_ad_sets200_response_ad_sets_inner.rb

@@ -49,16 +49,16 @@ module Zernio
     # Only with `live=true`. When `platformAdSetStatus` was read from the platform; null when this row was not read live.
     attr_accessor :status_read_at
 
-    # The ad set's optimization goal as last synced, in the platform's own enum (Meta `optimization_goal`, for example OFFSITE_CONVERSIONS or LINK_CLICKS). On TikTok with `live=true`, rows read live carry the ad group's `optimization_goal` exactly as TikTok's adgroup/get returns it now (for example ENGAGED_VIEW, ENGAGED_VIEW_FIFTEEN, CLICK, CONVERT).
+    # The ad set's optimization goal as last synced, in the platform's own enum (Meta `optimization_goal`, for example OFFSITE_CONVERSIONS or LINK_CLICKS; TikTok `optimization_goal`; Pinterest the conversion event of `optimization_goal_metadata`, for example CHECKOUT; X the line item `goal`; OpenAI the campaign `bidding_type`). Always null on Google, which has no per-ad-group optimization goal. On TikTok with `live=true`, rows read live carry the ad group's `optimization_goal` exactly as TikTok's adgroup/get returns it now (for example ENGAGED_VIEW, ENGAGED_VIEW_FIFTEEN, CLICK, CONVERT).
     attr_accessor :optimization_goal
 
-    # The ad set's billing event as last synced, where the platform reports one. On TikTok with `live=true`, rows read live carry the ad group's `billing_event` exactly as TikTok's adgroup/get returns it now (for example CPV, CPC, OCPM).
+    # The ad set's billing event as last synced, in the platform's own enum (Meta `billing_event`, TikTok `billing_event`, Pinterest `billable_event`, X `pay_by`, OpenAI `bidding_config.billing_event_type`). Always null on Google, which reports none per ad group. On TikTok with `live=true`, rows read live carry the ad group's `billing_event` exactly as TikTok's adgroup/get returns it now (for example CPV, CPC, OCPM).
     attr_accessor :billing_event
 
-    # The bid strategy as last synced, in the platform's own enum (Meta `bid_strategy`, for example LOWEST_COST_WITHOUT_CAP, COST_CAP). On Meta under a campaign budget this is the campaign's strategy.
+    # The bid strategy as last synced, in Meta's vocabulary (LOWEST_COST_WITHOUT_CAP, LOWEST_COST_WITH_BID_CAP, COST_CAP, LOWEST_COST_WITH_MIN_ROAS) on every platform that has an equivalent. On Meta under a campaign budget this is the campaign's strategy. TikTok maps bid_type / deep_bid_type, Pinterest AUTOMATIC_BID / MAX_BID / TARGET_AVG, X AUTO / MAX / TARGET, OpenAI Maximize Results / a max bid. Google bids at the campaign, so an ad group carries its campaign's strategy; one without a Meta equivalent (MANUAL_CPC, TARGET_IMPRESSION_SHARE, or a portfolio strategy's type such as TARGET_CPA) keeps Google's own name. Null on LinkedIn.
     attr_accessor :bid_strategy
 
-    # Bid cap or cost target in whole units of `currency`, as last synced. Null when the strategy has none.
+    # Bid cap or cost target in whole units of `currency`, as last synced. Null when the strategy has none (automatic bidding, ROAS targets, a Google portfolio strategy). On Google a campaign target CPA, a Maximize clicks ceiling, the ad group's own target CPA override, or its CPC bid under MANUAL_CPC.
     attr_accessor :bid_amount
 
     # Meta only. The ad set's `promoted_object` verbatim (snake_case, for example pixel_id + custom_event_type, page_id, application_id), as last synced from its most recent ad. Null on other platforms and on an ad set with no ad yet; GET /v1/ads/accounts/live reads it live for every ad set.

data/lib/zernio-sdk/models/list_ad_sets200_response_ad_sets_inner_targeting.rb

@@ -14,7 +14,7 @@ require 'date'
 require 'time'
 
 module Zernio
-  # The audience this ad set delivers to, as the platform reports it at the last sync. LinkedIn and Meta; null for every other platform and for ad sets not yet re-synced.  On Meta it is the ad set's `targeting` verbatim (snake_case: geo_locations, age_min, custom_audiences, flexible_spec, ...), so it can be read, edited and sent back as is. On LinkedIn `include` and `exclude` (below) are the campaign's `targetingCriteria` verbatim, without reconstructing them from our normalized targeting spec. 
+  # The audience this ad set delivers to, as the platform reports it at the last sync, in the platform's own shape. Every platform; null only for an ad set not re-synced yet, or when the platform's targeting read failed on every sync so far (a failed read keeps the last stored value).  - Meta: the ad set's `targeting` verbatim (snake_case: geo_locations, age_min,   custom_audiences, flexible_spec, ...), so it can be read, edited and sent back as is. - LinkedIn: `include` and `exclude` (below) are the campaign's `targetingCriteria`   verbatim, without reconstructing them from our normalized targeting spec. - TikTok: the ad group's targeting fields from adgroup/get, verbatim (placement_type,   placements, location_ids, age_groups, gender, languages, interest_category_ids,   actions, audience_ids, excluded_audience_ids, operating_systems, ...). Only fields   TikTok returned are present. - Google: `campaignCriteria` (LOCATION, LANGUAGE, PROXIMITY, DEVICE, AGE_RANGE, GENDER,   USER_LIST, INCOME_RANGE, PARENTAL_STATUS) and `adGroupCriteria` (AGE_RANGE, GENDER,   USER_LIST, USER_INTEREST, INCOME_RANGE, PARENTAL_STATUS), each a Google criterion   verbatim (camelCase: resourceName, type, negative, bidModifier and the payload its type sets, for   example `location.geoTargetConstant`). Most Google targeting lives on the campaign,   so every ad group of a campaign carries the same `campaignCriteria`. Keywords are   not included (they have their own endpoints). Synced on Google's slower keyword cycle. - Pinterest: the ad group's `targeting_spec` verbatim (GEO, AGE_BUCKET, GENDER,   INTEREST, AUDIENCE_INCLUDE, LOCALE, ...). - X: `targeting_criteria`, the line item's criteria as X lists them (targeting_type,   targeting_value, operator_type, name), the same shape X's batch create takes. - OpenAI: the campaign's `targeting` (OpenAI targets at the campaign), plus the ad   group's `context_hints` when it has any. 
   class ListAdSets200ResponseAdSetsInnerTargeting < ApiModelBase
     # LinkedIn `targetingCriteria.include`, verbatim (an `and` of `or` facet clauses).
     attr_accessor :include

data/lib/zernio-sdk/version.rb

@@ -11,5 +11,5 @@ Generator version: 7.19.0
 =end
 
 module Zernio
-  VERSION = '0.0.1319'
+  VERSION = '0.0.1320'
 end