LLM 코딩 에이전트용 공용 API 마이그레이션 레퍼런스

잠재 고객: 이 파일은 LLM 코딩 에이전트(Claude Code 또는 similar)는 레거시 Unity "Advertise API"에서 클라이언트 통합을 마이그레이션합니다. (

/advertise/v1/...

,

mz-advertiser-public-api

서비스)에서 새로운 Unity Ads 광고주 공용 API(

/ads/advertiser/public/v1/...

). 독립형으로 분할됩니다. entity blocks. 각 차단은 무엇이 바뀌었는지 그리고 정확히 어떻게 해야 할지 상태를 명시합니다. 읽기 개념 모델 변경 및 전역 변경 섹션 먼저 - 모든 차단에 적용됩니다.

이 파일을 사용하는 방법(에이전트 지침)

1. 이 프로시가 아니라 두 계약을 진실의 근원으로 취급하십시오. 레거시 =

   mz-advertiser-public-api/openapi/specs/advertise-v1.yml

   . New =

   ads-unified-platform/openapi/advertiser/platform-public-v1-routes.yaml

   . 이 가이드에서는 레거시 v1만 해당합니다. 클라이언트가

   /advertise/v2alpha1/...

   를 호출하는 경우 (

   advertise-v2-alpha.yml

   ) 별도로 및 표면 v2 전용 사용 인간.
2. 지정된 순서로 한 번에 한 엔티티 차단을 마이그레이션합니다(앱 → Attribution → Creatives → 소재 팩 → 캠페인 관리 → 캠페인 → 입찰 → 메모리 할당량 → 타게팅 → 할당). 수행 의존하는 블록이 컴파일/패스할 때까지 차단 시작하지 않습니다. 앱 우선: 모든 것이 키에 의해 새로운

   applicationId

   어트리뷰션은 즉시 이어집니다(앱 레벨). 관리 룩업(

   sdk-event-names

   /

   eligibility

   )은 캠페인보다 먼저 제공되므로 캠페인 설정
3. 레거시 기능이 ± No equivalent 아래에 나열되면**** 엔드포인트 중지하고 인간에게 열린 질문으로 표면. 가장 중요 예는

   DELETE app

   (애플리케이션 라이프사이클이 현재 USF에 소유됨) 및 사용 중단 예정 리텐션 제품 영역(리텐션 입찰/적격) — 블록을 참조하십시오.
4. 각 차단 후 필드 테이블별로 필드 이름을 다시 매핑합니다. 필드가 이동된 것으로 간주하지 마십시오. 표에 "unchanged"라고 표시되지 않는 한 변경되지 않습니다.
5. 돈 변경 단위(달러 → 마이크로 달러) 및 앱 식별자 변경 형식 (24-ch hex → UUID)。 이 두 가지 트랜스폼은 거의 모든 차단 터치합니다. 먼저 바로 가져옵니다

개념 모델 변경(첫 번째 읽기)

Application

레거시 모델

조직└── 앱 (campaignSetId, 24자 16진수) ← 경로 "앱"    ├── 소재    ├── 소재 팩    └── 캠페인(목적: 설치 |리텐션 |roas|creativeTesting|eventOptimization)        ├── cpi-bids | source-bids | roas-bids | 리텐션-입찰 | 이벤트-최적화-입찰        │ (5개의 별도의 하위 리소스, 각각 GET/PUT/PATCH, 달러 문자열)        ├── 타게팅(GET + PATCH)        ├── 메모리 할당량(GET + PATCH, 달러, 일일 OR dailyPerCountry 맵)        └── 소재(한 번에 하나씩 POST/DELETE)

새로운 모델

조직└── 애플리케이션applicationId, UUID) ← 경로 "applications"    ├── Creatives(현재 패치 + 삭제)    ├── 소재 팩    ├── 어트리뷰션(GET + PATCH, 앱 레벨) ← 새로운 어트리뷰션 배치    └── 캠페인(최적화 타입: cpi|legacyRetention|roas|appEventConversion; isCreativeTesting)        ├── bids (ONE PATCH .../bids; roas|매뉴얼 |manualSource|appEvent)        ├── 타게팅(패치 전용)        ├── 메모리 할당량 한도(패치만, 마이크로 달러, countryGroupDailyLimits)        ├── 소재        └── (입찰가 수, 메모리 할당량, 타게팅, 팩 수는 GET 캠페인에서 얻을 수 있습니까?includeFields=...)조직└── 캠페인(새로운 조직 전체 캠페인 목록, appIds 기준으로 필터링)

apps

applications

campaignSetId

applicationId

legacy campaignSetId → new applicationId

"0.201"

"2500.20"

cpi/source/roas/retention/event-optimization-bids

PATCH …/bids

GET campaign?includeFields=bids

GET …/budget

GET …/targeting

GET …/*-bids

GET …/assigned-creative-packs

GET campaign?includeFields=bids,budget,creativePacks

goal

optimizationType

creativeTesting

isCreativeTesting

eventOptimization

appEventConversion

appEventType

attributionLinks

GET/PATCH …/attribution

creativePackIds

전역 변경 사항(모든 엔드포인트에 적용)

"2500200000"

https://services.api.unity.com

https://services.api.unity.com/ads/advertiser

https://staging.services.api.unity.com/ads/advertiser

/advertise/v1

/public/v1

…/organizations/{orgId}/apps/{campaignSetId}

…/organizations/{organizationId}/applications/{applicationId}

…/advertise/v1/organizations/{orgId}/apps/{campaignSetId}/campaigns

…/ads/advertiser/public/v1/organizations/{orgId}/applications/{applicationId}/campaigns

unity

ads

organizationId

organizationId

campaignSetId

^[0-9a-fA-F]{24}$

applicationId

"2500.20"

"0.201"

^[a-f0-9]{24}$

{ total, offset, limit, results[] }

{ items[], meta:{ total, limit, offset } }

{ total, offset, limit, results[] }

offset

limit

offset

limit

GET …/applications

권한 부여, 인증역할/권한) — 403이 버그 가정하기 전에 읽어야 합니다.

x-unity-gateway.authorization.rules

advertise.*

advertise.campaigns.*

advertise.creatives.*

advertise.creative_packs.*

advertise.bids.update

advertise.targeting.update

advertise.apps.*

advertise.apps.get/list/create/update/delete

…/applications

advertise.apps.*

monetize.projects.*

1. 마이그레이션하기 전에 사용자에게 클라이언트 서비스 계정이 필요한 를 보유하고 있는지 확인하도록 요청합니다. 새로운 API에 대한 광고주 역할 — 레거시 API 자금이 전달되는 것으로 간주 하지 않음.
2. 레거시 API에서 작동한 요청이 새 API에서 동일한 값으로 403을 반환하는 경우 자격 증명, 요청 버그가 아니라 누락된 역할 부여로 취급합니다. 중지하고 표면; "수정"을 시도하는 요청을 수정하지 않습니다.

속도 제한(클라이언트 측 백오프 업데이트)

GET

POST

advertiseCreate

PATCH

DELETE

advertiseModify

advertiseBids

advertiseCampaignManagement

마스터 엔드포인트 맵

advertise-listApps

GET …/apps

publicOrganizationApplications

GET …/applications

advertise-createApp

POST …/apps

publicCreateApplication

POST …/applications

advertise-getApp

GET …/apps/{campaignSetId}

publicGetApplicationById

GET …/applications/{applicationId}

advertise-updateApp

PATCH …/apps/{campaignSetId}

publicUpdateApplication

PATCH …/applications/{applicationId}

advertise-deleteApp

DELETE …/apps/{campaignSetId}

advertise-listCreatives

GET …/apps/{id}/creatives

publicGetCreatives

GET …/applications/{id}/creatives

advertise-createCreative

POST …/apps/{id}/creatives

publicCreateCreative

POST …/applications/{id}/creatives

advertise-getCreative

GET …/creatives/{creativeId}

publicGetCreativeById

GET …/applications/{id}/creatives/{creativeId}

publicUpdateCreativeById

PATCH …/creatives/{creativeId}

publicDeleteCreativeById

DELETE …/creatives/{creativeId}

advertise-listCreativePacks

GET …/creative-packs

publicGetCreativePacks

GET …/applications/{id}/creative-packs

advertise-createCreativePack

POST …/creative-packs

publicCreateCreativePack

POST …/applications/{id}/creative-packs

advertise-getCreativePack

GET …/creative-packs/{packId}

publicGetCreativePackById

GET …/applications/{id}/creative-packs/{creativePackId}

advertise-updateCreativePack

PATCH …/creative-packs/{packId}

publicUpdateCreativePack

PATCH …/creative-packs/{creativePackId}

advertise-deleteCreativePack

DELETE …/creative-packs/{packId}

publicDeleteCreativePack

DELETE …/creative-packs/{creativePackId}

advertise-listCampaigns

GET …/apps/{id}/campaigns

publicGetCampaigns

GET …/organizations/{orgId}/campaigns?appIds={applicationId}

advertise-createCampaign

POST …/apps/{id}/campaigns

publicCreateCampaign

POST …/applications/{id}/campaigns

advertise-getCampaign

GET …/campaigns/{campaignId}

publicGetCampaignById

GET …/applications/{id}/campaigns/{campaignId}?includeFields=…

advertise-updateCampaign

PATCH …/campaigns/{campaignId}

publicUpdateCampaign

PATCH …/applications/{id}/campaigns/{campaignId}

advertise-deleteCampaign

DELETE …/campaigns/{campaignId}

publicDeleteCampaignById

DELETE …/applications/{id}/campaigns/{campaignId}

advertise-list/replace/patchCpiBids

GET/PUT/PATCH …/campaigns/{id}/cpi-bids

publicUpdateBids

manualBids

PATCH …/campaigns/{campaignId}/bids

…/source-bids

publicUpdateBids

manualSourceBids

PATCH …/campaigns/{campaignId}/bids

…/roas-bids

publicUpdateBids

roasBids

PATCH …/campaigns/{campaignId}/bids

…/event-optimization-bids

publicUpdateBids

appEventBids

PATCH …/campaigns/{campaignId}/bids

…/retention-bids

advertise-getBudget

GET …/campaigns/{id}/budget

GET campaign?includeFields=budget

advertise-updateBudget

PATCH …/campaigns/{id}/budget

publicPatchCampaignBudgetCap

PATCH …/campaigns/{campaignId}/budget-cap

advertise-getTargeting

GET …/campaigns/{id}/targeting

GET campaign

advertise-updateTargeting

PATCH …/campaigns/{id}/targeting

publicPatchCampaignTargeting

PATCH …/campaigns/{campaignId}/targeting

advertise-listAssignedCreativePacks

GET …/campaigns/{id}/assigned-creative-packs

GET campaign?includeFields=creativePacks

advertise-assignCreativePack

POST …/assigned-creative-packs

publicAssignCreativePacks

PATCH …/campaigns/{campaignId}/assign-creative-pack

advertise-unassignCreativePack

DELETE …/assigned-creative-packs/{id}

publicUnassignCreativePacks

DELETE …/campaigns/{campaignId}/unassign-creative-pack

advertise-listSdkEventNames

GET …/audience-pinpointer/sdk-event-names

publicGetSdkEventNames

GET …/applications/{id}/sdk-event-names

advertise-listEventOptInfo

GET …/audience-pinpointer/event-optimization-info

publicGetCampaignManagementEligibility

GET …/applications/{id}/eligibility

advertise-listRoasInfo

…RetentionInfo

GET …/audience-pinpointer/roas-info

…/retention-info

attributionClickUrl

attributionStartUrl

publicGetApplicationAttribution

publicUpdateApplicationAttribution

GET/PATCH …/applications/{id}/attribution

차단 A — 앱 → 응용 프로그램

변경한 사항

• 경로 세그먼트

  apps

  →

  applications

  ; id

  campaignSetId

  (24-char hex) →

  applicationId

  (UUID). 이는 모든 캠페인/머티리얼/팩 호출이 중첩된 위험이 가장 높은 리맵입니다. 밑 마이그레이션 중에

  legacy campaignSetId → new applicationId

  맵을 빌드하고 유지합니다.

• platform

  는 이제 Create에 대해 필수적이고 명시적 필드입니다(

  store

  에 의해 암시됨).
• 앱 레벨 어트리뷰션 URL(

  appAttributionClickUrl

  /

  appAttributionStartUrl

  )이 전용 어트리뷰션 엔드포인트 — 차단 J 를 참조하십시오.

• DELETE app

  는 동등하지 않음(의도적으로 확인됨) 애플리케이션 라이프사이클이 밖으로 이동 광고주가 Unity 서비스 재단(USF)에 대한 범위와 현재 애플리케이션 삭제가 비활성화된 플랫폼 전체. 새 애플리케이션 리소스는 리스트/생성/받기/업데이트만 노출합니다. 이 경우 클라이언트 API 통해 앱 삭제하고 중지하고 표면 표시합니다.
• 리스트가 모양을 변경하고 페이지 지정 / 필터를 잃었습니다. 레거시

  GET …/apps

  반환됨

  { total, offset, limit, results[] }

  with

  offset

  /

  limit

  and

  filter[store]

  /

  filter[storeId]

  쿼리 파라미터. 새로운

  GET …/applications

  는 모든 조직의 빈 JSON 배열을 반환합니다. 애플리케이션 — 엔벨로프, 페이지 지정, 필터 없음 파라미터를 놓고 필터링/페이지 지정 client-side.

필드 매핑 — create (advertise-createApp → CreateApplicationPublicDto)

name

name

store

apple

google

standalone_android

store

platform

AppleAppStore

GooglePlay

platform

iOS

Android

storeId

storeId

platform

store

adomain

gameId

gameId

appAttributionClickUrl

clickUrl

PATCH …/attribution

appAttributionStartUrl

startUrl

PATCH …/attribution

privacy.coppa

privacy.mixedAudience

projectId

projectName

store

GooglePlay

AppleAppStore

SamsungGalaxy

AmazonAppStore

MacAppStore

UDP

MicrosoftStore

HuaweiAppGallery

APK

platform

Android

iOS

OSX

Windows

Linux

WebGL

Windows_Store

PS4

PS5

XboxOne

tvOS

Switch

VisionOS

store

{store, platform}

apple

{AppleAppStore, iOS}

google

{GooglePlay, Android}

standalone_android

{SamsungGalaxy, Android}

{HuaweiAppGallery, Android}

{APK, Android}

필드 매핑 — 응답(app → ApplicationPublicResponseDto)

id

campaignSetId

id

name

name

store

storeId

store

storeId

gameId

gameId

appAttributionClickUrl

StartUrl

…/attribution

adomain

createdAt

updatedAt

platform

iconUrl

projectId

testMode

kidsSettings

coppa

mixedAudience

⚡️ ID 다시 매핑은 가장 높은 위험 단계입니다. 지속

legacy campaignSetId → new {applicationId}

그리고

campaignSetId

를 사용한 모든 다운스트림 경로를 다시 작성합니다.

차단 B — 소재

변경한 사항

• apps/{campaignSetId}

  대신

  applications/{applicationId}

  아래에 중첩되었습니다.
• 여전히

  multipart/form-data

  ,

  creativeInfo

  JSON 먼저 바이너리 파일 필드.
• 새로운 운영:

  PATCH …/creatives/{creativeId}

  (이름 변경) 및

  DELETE …/creatives/{creativeId}

• type

  열거형 값의 이름이 변경되었습니다 (snake_case). 다시 맵.
• 이미지 업로드 한도는 20MB(5MB)로, 플레이어블은 10MB로 증가했습니다.
• 비디오 업로드(

  videoFile

  )는 레거시와 동일하게 작동합니다(API 소유자에 의해 확인). OpenAPI 2026년 7월 말에 출시된 비디오 제작 배리언트를 문서화하는 스키마입니다. 사양에 비디오

  oneOf

  배리언트가 없습니다. 비디오가 지원되지 않는다고 가정하는 대신 사양을 새로 고칩니다.

type 열거형 리맵

squareEndCard

end_card_square

endCardPair

end_card_pair

portraitVideo

video_portrait

landscapeVideo

video_landscape

responsivePlayable

playable_responsive

portraitPlayable

playable_portrait

landscapePlayable

playable_landscape

squareVideo

banner

열거형 status

uploaded

processing

processingFailed

pendingModeration

approved

rejected

다중 부분 필드 이름

creativeInfo

squareEndCardFile

portraitEndCardFile

landscapeEndCardFile

playableFile

creativeInfo

fileName

orientation

landscape

portrait

both

CreativePublicResponseDto

id

name

language

type

status

files[]{name,url}

createdAt

updatedAt

차단 C — 소재 팩

변경한 사항

• applications/{applicationId}

  아래에 중첩되었습니다. CRUD 동사(GET/POST/GET/PATCH/DELETE)

• type

  는

  video

  ,

  playable

  ,

  video+playable

  ,

  banner

  의

  banner

  값을 얻습니다.
• 리스트 엔벨로프는 레거시 스타일의

  { total, offset, limit, results[] }

  입니다(캠페인/크리에이티브와는 달리).
• 더 풍부한 응답: 추가

  applicationId

  ,

  moderationStatus

  (

  pending

  /

  approved

  /

  rejected

  , nullable),

  ageRating

  (nullable),

  assignedCampaignIds[]

  ,

  createdAt

  /

  updatedAt

필드 매핑 — create (createCreativePack → CreateCreativePackPublicDto)

name

name

creativeIds[]

creativeIds[]

type

type

banner

androidStoreListing

androidStoreListing

appleProductPageId

appleProductPageId

필드 매핑 — 응답

id

id

name

type

creativeIds

campaignIds

assignedCampaignIds

applicationId

moderationStatus

ageRating

createdAt

updatedAt

차단 D — 캠페인

변경한 사항

• applications/{applicationId}

  아래에 중첩되었습니다. Get/Update/Delete는 앱별이며, 리스트는 현재 org-wide (

  GET …/organizations/{orgId}/campaigns

  , 필터

  appIds

  ) — 앱별 목록이 없습니다.

• goal

  →

  optimizationType

  (+

  isCreativeTesting

  부울 +

  appEventType

  ).
• 애트리뷰션 URL은 더 이상 캠페인 생성의 일부가 아닙니다. 캠페인을 통해 생성 후 설정

  PATCH

  (

  attributionLinks

  ) 또는 앱 어트리뷰션 엔드포인트(차단 J).

• scheduleEnd

  는 생성 필드가 아닙니다. 생성은

  start

  만 사용합니다.

  PATCH

  를 통해

  end

  를 설정합니다.

• GET campaign

  는

  includeFields

  (

  bids

  ,

  budget

  ,

  creativePacks

  ,

  application

  )를 지원합니다. 는 현재 입찰/메모리 할당량/할당 팩을 읽는 방법입니다.

• postInstallWindow

  값은 대문자와 확장:

  D0

  ,

  D1

  ,

  D3

  ,

  D7``D14

  ,

  D28

goal → optimizationType remap

installs

optimizationType: cpi

retention

optimizationType: legacyRetention

roas

optimizationType: roas

roasType

eventOptimization

optimizationType: appEventConversion

appEventType

creativeTesting

isCreativeTesting: true

optimizationType: cpi

cpiType: manual

필드 매핑 — create (createCampaign → CreateCampaignDto)

installs

optimizationType: cpi

retention

optimizationType: legacyRetention

roas

optimizationType: roas

roasType

eventOptimization

optimizationType: appEventConversion

appEventType

creativeTesting

isCreativeTesting: true

optimizationType: cpi

cpiType: manual

필드 매핑 — 업데이트(updateCampaign → UpdateCampaignPublicDto)

name

name

scheduleStart

scheduleEnd

start

end

end

enabled

paused

enabled:true

paused:false

autoStart

autoStart

ENABLED

DISABLED

attributionClickUrl

StartUrl

attributionLinks.{clickUrl,startUrl,viewUrl}

viewUrl

⚡️ 업데이트 응답은 더 얇은 오브젝트입니다 (

CampaignPublicDetailsResponseDto

:

id

,

name

,

start

,

end

,

autoStart

,

paused

,

attributionLinks

), 전체 캠페인이 아닙니다. 클라이언트가 PATCH 응답에서 다른 캠페인 필드를 읽으면

GET campaign

를 통해 다시 페치합니다.

필드 매핑 — 응답(레거시 campaign → CampaignPublicResponseDto)

id

id

name

billingType

name

billingType

goal

optimizationType

isCreativeTesting

appEventType

roasType

enabled

paused

enabled:true

paused:false

status

live

learning

paused

scheduleStart

scheduleEnd

start

end

end

biddingStrategy

manual

automated

bidConfigurationMethod

manual

auto

automated

auto

cpiBids[]

sourceBids[]

roasBids[]

eventOptimizationBids[]

manualBids[]

manualSourceBids[]

roasBids[]

appEventBids[]

includeFields=bids

retentionBids[]

budget

budget

includeFields=budget

campaignLimitType

dailyLimitType

eventOptimizationType

sdkEventName

appEventType

sdkEventNames[]

autoStart

enabled

disabled

canceled

autoStart

ENABLED

DISABLED

CANCELED_REJECTED

CANCELED_LESS_THAN_TWO_PACK

canceled

createdAt

updatedAt

createdAt

updatedAt

applicationId

attribution

deviceTargeting

budgetPacingType

forcePausedEnabled

isAutoEligible

includeFields를 통한 읽기

GET …/campaigns/{campaignId}?includeFields=bids,budget,creativePacks,application

budget

creativePackIds[]

application

차단 E — 입찰(단계점 5개 → 1개)

변경한 사항

cpi-bids

source-bids

roas-bids

retention-bids

event-optimization-bids

GET

PUT

PATCH

PATCH …/campaigns/{campaignId}/bids

GET campaign?includeFields=bids

엔드포인트 + 바디 리맵

cpi-bids

manualBids[]

{ country, bid }

bid

source-bids

manualSourceBids[]

{ country, sourceAppId, bid }

roas-bids

roasBids[]

{ country, target, maxBid? }

maxBid

event-optimization-bids

appEventBids[]

{ country, bid }

retention-bids

{country, baseBid, maxBid}

재화 변환하다(동사), 트랜스폼(명사)중요)

"0.201"

201000

goal

target

goal

"12.34"

target

"12.34"

0.1234

0.10

PUT

PATCH

PATCH

PATCH

[]

PUT []

⚡️ 새로운

PATCH

가 병합이 아니라 교체하기 때문에 레거시

PATCH

의 순진한 포팅 (병합) 콜은 요청에 포함되지 않은 모든 단가를 침묵적으로 내립니다. 전환 레거시 병합 스타일 전체 쓰기 업데이트:

GET campaign?includeFields=bids

를 통해 현재 단가를 읽고, 델타로 로컬에서전체 배열 전송합니다

차단 F — 메모리 할당량 → 메모리 할당량 한도

변경한 사항

• GET …/budget

  가 사라졌습니다 →

  GET campaign?includeFields=budget

  를 통해 읽습니다.

• PATCH …/budget

  →

  PATCH …/campaigns/{campaignId}/budget-cap

  .
• 달러 → 마이크로 달러 (문자열).
• 국가별 맵(

  dailyPerCountry: { "US": "123.45", … }

  )은 명명된 국가 그룹(

  countryGroupDailyLimits: [{ name, countries[], limit }]

  ).
• 응답에 대한 새로운 명시적 유형의 차별 요소:

  campaignLimitType

  (

  unlimited

  /

  total

  ),

  dailyLimitType

  (

  daily

  /

  countryDaily

  /

  unlimited

  ).

필드 매핑(budget → PatchBudgetCapDto)

total

total

"0"

daily

daily

dailyPerCountry

countryGroupDailyLimits[]

{country: amount}

{ name, countries:[country], limit: amount×1e6 }

name

dailySpent

spent

차단 G — 타게팅

변경한 사항

• GET …/targeting

  is gone →

  GET campaign

  에서 타게팅 필드를 읽습니다.

• PATCH …/targeting

  가 남았지만 바디가 재구성되었습니다 대부분의 레거시 기기 필드는 내려갔습니다 (그들은 이미 레거시 사양의

  deprecated

  이었습니다).

필드 매핑(targetingOptions → UpdateCampaignPublicTargetingDto)

appTargeting.allowList

blockList

allowlistSources[]

blocklistSources[]

categoryTargeting.allowList

blockList

apptopiaSourceCategoriesAllowlist/Blocklist[]

sensorTower…

deviceTargeting

blockedDevices

osMin

appleDevice.deviceBlocklist[]

appleDevice.osMinVersion

deviceTargeting

osMin

androidDevice.{manufacturerAllowlist,manufacturerBlocklist,modelBlocklist,osMinVersion}

regionalTargeting

allowlistCountrySubdivisions[] {country, subdivisions[]}

limitedAdTracking

connectionType

screenSize

screenDensity

allowedDevices

osMax

차단 H — 할당된 소재 팩(현재 목록 기반)

변경한 사항

• 레거시 할당/할당되지 않은 요청당 한 팩(

  POST

  /

  DELETE …/assigned-creative-packs

  ).
• 새 API는 다음과 같은 리스트에서 작동합니다.

  • { creativePackIds: [...] }

    가 있는

    PATCH …/campaigns/{campaignId}/assign-creative-pack

    — 는 할당된 세트를 제공된 ID로 대체합니다.

  • { creativePackIds: [...] }

    가 있는

    DELETE …/campaigns/{campaignId}/unassign-creative-pack

    — 는 나열된 ID를 제거합니다.
• 현재 할당된 팩 목록:

  GET campaign?includeFields=creativePacks

  (

  creativePackIds[]

  ).

마이그레이션 방식

PATCH assign-creative-pack

POST

creativePackIds

차단 I — Audience Pinpointer → 캠페인 관리

변경한 사항

GET …/audience-pinpointer/sdk-event-names

GET …/applications/{id}/sdk-event-names

GET …/audience-pinpointer/event-optimization-info

GET …/applications/{id}/eligibility

GET …/audience-pinpointer/roas-info

GET …/audience-pinpointer/retention-info

sdk-event-names

{ total, results[]{ eventOptimizationType, sdkEventNames[] } }

eligibility

{ total, results[]{ eventOptimizationType, countries[] } }

차단 J — Attribution (relocated)

변경한 사항

appAttributionClickUrl

StartUrl

attributionLinks

• GET …/applications/{applicationId}/attribution

  →

  { id, startUrl, clickUrl, viewUrl?, partner, type?, createdAt, updatedAt }

  .

• PATCH …/applications/{applicationId}/attribution

  with

  { startUrl?, clickUrl?, viewUrl? }

  .

partner

other

adjust

airbridge

appsflyer

branch

bytebrew

kochava

mailru

singular

tenjin

yandex

type

userLevel

nonUserLevel

mixed

마이그레이션 방식

1. 앱 레벨 이동

   appAttributionClickUrl

   /

   appAttributionStartUrl

   →

   PATCH …/attribution

   (

   clickUrl

   /

   startUrl

   ).
2. 캠페인 만들기 이동

   attributionClickUrl

   /

   attributionStartUrl

   → 캠페인의

   PATCH

   (

   attributionLinks.{clickUrl,startUrl,viewUrl}

   ) 캠페인을 생성한 후.

3. viewUrl

   는 새로운(선택 사항).

   {ifa}

   및 기타 URL 매크로: 확인 규칙은 공유 레거시 API와 신규 API 모두에서 사용되는 어트리뷰션 검증 라이브러리(확인됨), 따라서 매크로 동작 변경되지 않으며 레거시 URL을 그대로 유지합니다.

권장 마이그레이션 알고리즘(에이전트 결정적 순서)

1. 설정: 호스트를

   …/ads/advertiser

   로 바꾸고 경로 접두사

   /advertise/v1

   →

   /public/v1

   및

   apps

   세그먼트 →

   applications

   . 기본 인증을 유지합니다.
2. 앱(차단 A): 각 레거시 앱에 대해

   POST …/applications

   (리맵

   store

   →

   {store, platform}

   ).

   legacy campaignSetId → new applicationId

   지속。 어트리뷰션 ** 보내지 않음** URL은 여기에 있습니다.
3. 속성(차단 J): 예전 앱 레벨 URL을

   PATCH …/applications/{id}/attribution

   합니다.
4. 크리에이티브(차단 B): 다시 업로드/다시 매핑하여

   type

   열거형을 변환합니다. 지속 ID가 새로 고정되면

   legacy creativeId → new creativeId

   (ID가 보존되는지 확인).
5. 머티리얼 팩(차단 C): 새로운 소재 ID를 참조하는 팩을 생성합니다.
6. 캠페인 관리(차단 I): 청중-피인포인터 룩업을 재지정 —

   …/audience-pinpointer/sdk-event-names

   →

   …/applications/{id}/sdk-event-names

   및

   …/audience-pinpointer/event-optimization-info

   →

   …/applications/{id}/eligibility

   . 읽기 전용; 결과를 사용하여 캠페인

   appEventType

   /

   sdkEventNames

   및 자격이 있는 국가를 알립니다. ROAS-info 게이트 로직은 삭제할 수 있습니다(자격 요건이 더 이상 필요하지 않음). 리텐션 사용 중단 예정 리텐션 제품이 사용 중단 예정입니다(단계 13 참조).
7. 캠페인(차단 D):

   optimizationType

   로 제작(+

   isCreativeTesting

   /

   appEventType

   /

   roasType

   ),

   start

   만 해당. 그런 다음

   PATCH

   는

   end

   ,

   attributionLinks

   ,

   autoStart

   ,

   paused

   를 설정합니다.
8. 입찰가(차단 E): 달러 → 마이크로 달러 전환(ROAS 목표: 백분율 → 소수점 비율, ÷100); 단가 유형별로 원하는 완전한 세트가 있는

   PATCH …/bids

   하나를 보내야 합니다(패치 대체, 병합하지 않음,

   []

   제거). 리텐션 단가는 지원 사용 중단 예정 예정이며 마이그레이션하지 마십시오. 표면 사용.
9. 메모리 할당량 (차단 F): 마이크로 달러 단위의

   PATCH …/budget-cap

   ; 전환

   dailyPerCountry

   맵 →

   countryGroupDailyLimits[]

   .
10. 타게팅(차단 G):

    appleDevice

    /

    androidDevice

    /source+category 목록으로 재구성 분리된 기기 필드(표면).
11. 할당(차단 H): 캠페인당 하나의 목록 기반

    PATCH assign-creative-pack

    .
12. 읽기: 모든

    GET …/{bids,budget,targeting,assigned-creative-packs}

    를

    GET campaign?includeFields=…

    .
13. 제거된 기능(표면에서 사람):

    DELETE app

    (USF 소유의 앱 라이프사이클, 삭제 사용 중단 예정 리텐션 제품(입찰 + 자격), ROAS 자격 게이트(더 이상 필요하지 않음 — 삭제), 레거시 사용 중단 예정 타겟 필드,

    adomain

    ,

    squareVideo

    소재

확인 체크리스트(마이그레이션 후 실행)

• 요청 경로에는

  /advertise/v1

  ,

  /apps/

  ,

  /cpi-bids

  ,

  /source-bids

  ,

  /roas-bids

  ,

  /retention-bids

  ,

  /event-optimization-bids

  ,

  /audience-pinpointer

  ,

  /assigned-creative-packs

  또는

  …/budget

  (현재

  budget-cap

  ).
• 모든 앱 경로는 새로운 UUID

  applicationId

  를 사용하고 24자리 16진수

  campaignSetId

  는 사용하지 않습니다.
• 모든 화폐 값은 마이크로 달러(정수)이며,

  "2500.20"

  처럼 달러 소수점이 아닙니다.
• 입찰은 단일

  PATCH …/bids

  로 이동하고 읽기에는

  GET campaign?includeFields=bids

  가 사용됩니다.
• 모든 단가

  PATCH

  는 단가 유형에 대한 완전한 세트를 전송합니다(대체 시맨틱 - 부분 는 누락된 입찰을 내립니다.) 레거시 병합 스타일 업데이트는 읽기-수정-쓰기로 전환되었습니다.
• ROAS 타겟은 백분율 문자열에서 소수점 비율(

  "12.34"

  →

  0.1234

  )으로 전환되었습니다.
• 메모리 할당량은

  budget-cap

  +

  countryGroupDailyLimits[]

  (

  dailyPerCountry

  맵 없음)를 사용합니다.
• 캠페인

  goal

  가

  optimizationType

  (+

  isCreativeTesting

  )로 다시 매핑되고 어트리뷰션 URL은 캠페인 생성이 아닌

  attributionLinks

  /

  …/attribution

  를 통해 설정됩니다.
• 소재

  type

  는 새로운 snake_case 값(

  end_card_square

  ,

  video_portrait

  , ...)을 사용합니다.
• 레거시

  enabled

  의 모든 읽음은 반전된 의미로

  paused

  로 다시 매핑되었습니다 (

  enabled:true

  ⇒

  paused:false

  ) — 리스트, 수신 및 업데이트 응답 모두.
• 아무것도 캠페인

  PATCH

  응답에서 전체 캠페인 필드를 파싱하지 않습니다. details 오브젝트); 전체 상태는

  GET campaign?includeFields=…

  를 통해 다시 페치됩니다.
• 애플리케이션 리스트 파싱은 베어 배열(

  {total, results}

  엔벨로프 없음)을 예상하고 더 이상 전송

  offset

  /

  limit

  /

  filter[store]

  /

  filter[storeId]

  .
• 할당 캠페인당 하나의 리스트 기반 호출 사용하며, N개의 단일 할당이 사용되지 않습니다.

• DELETE app

  , 사용 중단 예정 리텐션 사용(입찰/적격),

  squareVideo

  소재 및 제거된 타게팅 필드가 휴먼에게 공백으로 표시되었습니다(클라이언트 사용한 경우). ROAS 자격 게이트가 삭제되었습니다.

빠른 레퍼런스: 제거됨 / 동등하지 않음(모두 마이그레이션하거나 생성하지 않음 - 모두 API 소유자에 의해 확인됨)

• DELETE app

  — 삭제 애플리케이션 엔드포인트가 없습니다. 앱 라이프사이클은 USF가 소유하고 삭제는 현재 플랫폼 전체에서 비활성화되어 있습니다.
• ROAS-info — 제거됨, ROAS 캠페인에는 더 이상 자격이 필요하지 않습니다. 게이트 로직을 삭제합니다.
• 리텐션(전체 제품 영역) — 사용 중단 예정:

  retention-info

  및 리텐션 입찰 단가가 없음 successor。 표면 활성 리텐션 캠페인/입찰 단가
• GET 입찰 / 메모리 할당량 / 타게팅 / 할당된 팩 —

  GET campaign?includeFields=…

  로 대체.
• 레거시 중단 예정 타게팅 필드(

  limitedAdTracking

  ,

  connectionType

  ,

  screenSize

  ,

  screenDensity

  ,

  allowedDevices

  ,

  osMax

  ) 및 앱

  adomain

  — 에서 구성할 수 없음 통합; 클라이언트 코드를 삭제합니다.

• squareVideo

  소재 유형 — 지원되지 않음,

  video_portrait

  /

  video_landscape

  만 지원