LLM コーディングエージェントの広告主向け公開 API 移行リファレンス

オーディエンス：このファイルは、LLM コーディングエージェント (クロードコードまたは Unityの古い機能である「Advertise API」からクライアントのインテグレーションを移行するタスク (

/advertise/v1/...

、

mz-advertiser-public-api

サービス) を新しい Unity Ads に送信 Advertiser Public API (

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

)。自己完結型に分割されます。 エンティティブロック。各ブロックには_、変更内容_と_具体的な対応_が示されます。を読む まず、概念モデル変更とグローバル変更のセクションがあります。これらはすべてのブロックに適用されます。

このファイルの使用方法(エージェントの手順)

1. この散文ではなく、2 つの契約を真実のソースとして扱います。古い機能 =

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

   .新規 =

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

   .このガイドでは、 古い機能 v1 のみ。クライアントが

   /advertise/v2alpha1/...

   を呼び出す場合は、そのスペシフィケーションの差分 (

   advertise-v2-alpha.yml

   ) を別に作成し、v2 のみの使用をユーザーに提示します。
2. 指定した順序でエンティティブロックを1つずつ移行します(「Apps(アプリケーション)」、「Attribution(アトリビューション)」、「Creatives(クリエイティブ)」、「 クリエイティブパック → キャンペーン管理 → キャンペーン → 入札 → バジェット → ターゲティング → 割り当て)。実行 依存するブロックがコンパイル/パスされるまでブロックを開始しない。アプリケーションファースト: すべてが 新しい

   applicationId

   。アトリビューションは即座に続き（アプリケーションレベル）、キャンペーンは 管理検索(

   sdk-event-names

   /

   eligibility

   )はキャンペーンの前に来ます。なぜなら、キャンペーンがフィードされるためです。 キャンペーン設定。
3. レガシー機能が 🚫 No equivalent (同等の機能 なし) の下にリストされている場合、 エンドポイント。停止し、オープンな質問としてユーザーに提示します。最も重要な例は以下のとおりです。

   DELETE app

   (アプリケーション ライフサイクルは現在 USF が所有しています)と非推奨のリテンション product area (リテンション入札/適格性) — ブロックを参照してください。
4. 各ブロックの後に、フィールドテーブルごとにフィールド名を再マップする。フィールドは持ち越されないと仮定する テーブルに "unchanged" と表示されていない限り変更されません。
5. 両替単位 (ドル → マイクロドル) とアプリケーション ID の変更の種類 (24 文字の hex → UUID)。この 2 つの Transform はほとんどすべてのブロックに触れます。最初に正しく

概念モデルの変更 (最初にお読みください)

Application

古い機能モデル

組織└── アプリケーション (campaignSetId、24 文字の 16 進数) ← パス内の "apps"    ├──クリエイティブ    ├── クリエイティブパック    └── Campaign  (goal: installs|retention|roas|creativeTesting|eventOptimization)        ├── cpi-bids | source-bids | roas-bids | retention-bids | event-optimization-bids        │ （5 つの異なるサブリソース、各 GET/PUT/パッチ、ドル文字列）        ├── ターゲット設定 (GET + パッチ)        ├── バジェット (GET + パッチ、ドル、日または日ごとの国別マップ)        └─── 割り当て済みクリエイティブパック (POST/DELETE を 1 つずつ)

新しいモデル

組織└── アプリケーション (applicationId、UUID) ← パス内の "applications"    ├── クリエイティブ (パッチ + 削除も可)    ├── クリエイティブパック    ├── アトリビューション（GET + パッチ、アプリケーションレベル） ← アトリビューションの新しい配置    └── キャンペーン（optimizationType：cpi|legacyRetention|roas|appEventConversion、isCreativeTesting）        ├── 入札（1パッチ.../入札、roas|manual|manualSource|appEvent）        ├── ターゲット設定 (パッチのみ)        ├── バジェットキャップ(パッチのみ、マイクロドル、countryGroupDailyLimits)        ├── assign-creative-pack / unassign-creative-pack (リストベースのパッチ/削除)        └── (入札/バジェット/ターゲティング/パックの読み取りは 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

グローバル変更（すべてのエンドポイントに適用）

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"

"2500200000"

^[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

  （16 進数で 24 文字） →

  applicationId

  (UUID)。これは最もリスクの高い再マップします。キャンペーン/クリエイティブ/パック呼び出しはすべてネストされます。 その下に移行中に

  legacy campaignSetId → new applicationId

  マップをビルドおよび維持します。

• platform

  は、作成時に必須の明示的なフィールドになりました (

  store

  によって暗示されました)。
• アプリケーションレベルのトラッキング URL (

  appAttributionClickUrl

  /

  appAttributionStartUrl

  ) は 専用アトリビューションエンドポイント — ブロック J を参照してください。

• DELETE app

  に同等の機能はありません (意図的なものと確認済み)。アプリケーションライフサイクルの移行 Unity Services Foundation (USF) に対する広告主の範囲であり、アプリケーション削除は現在 プラットフォーム全体で無効。新しいアプリケーションリソースはリスト/作成/取得/更新のみを公開します。もし クライアントは API を介してアプリケーションを削除し、停止して表示します。
• リストの形状が変更され、ページ処理/フィルタが失われました。古い機能

  GET …/apps

  が返されました

  offset

  /

  limit

  と

  filter[store]

  /

  filter[storeId]

  の

  { total, offset, limit, results[] }

  クエリ params。New

  GET …/applications

  は、すべての組織のベア JSON 配列を返します。 アプリケーション — エンベロープ、ページ処理、フィルタなし。params とフィルター/ページ処理のドロップ client-side.

フィールドマッピング — 作成 (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を再マップすることは最もリスクの高いステップです。**Persist

legacy campaignSetId → new {applicationId}

campaignSetId

を使用したすべてのダウンストリーム パスを書き換えます。

ブロック B — クリエイティブ

変更内容

• apps/{campaignSetId}

  の代わりに

  applications/{applicationId}

  の下にネストされています。
• それでも

  multipart/form-data

  、最初に JSON を

  creativeInfo

  してからバイナリファイルフィールド。
• 新しい操作:

  PATCH …/creatives/{creativeId}

  (名前の変更) と

  DELETE …/creatives/{creativeId}

  。

• type

  enum 値が変更されました（snake＿case）。再マップ。
• 画像アップロード制限が 20 MB (5 MB) に増加。プレイアブルは 10 MB。
• ビデオアップロード (

  videoFile

  ) は古い機能 (API 所有者の確認が必要) とまったく同じように機能します。OpenAPI 2026 年 7 月下旬に上陸した動画作成バリアントを文書化したスキーマ。 spec にはビデオ

  oneOf

  バリアントがありません。ビデオがサポートされていないと仮定するのではなく、spec を更新してください。

type enum 再マップする

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 enum

uploaded

processing

processingFailed

pendingModeration

approved

rejected

multipart フィールド名

creativeInfo

squareEndCardFile

portraitEndCardFile

landscapeEndCardFile

playableFile

creativeInfo

fileName

orientation

landscape

portrait

both

CreativePublicResponseDto

id

name

language

type

status

files[]{name,url}

createdAt

updatedAt

Block C — クリエイティブパック

変更内容

• applications/{applicationId}

  の下にネストされています。CRUD 動詞は同じです（GET/POST/GET/パッチ/削除）。

• type

  は

  banner

  値

  video

  、

  playable

  、

  video+playable

  、

  banner

  を取得します。
• リストエンベロープは古い機能

  { total, offset, limit, results[] }

  です (キャンペーンやクリエイティブとは異なります)。
• 反応はより豊富です。

  applicationId

  、

  moderationStatus

  (

  pending

  /

  approved

  /

  rejected

  、 nullable）、

  ageRating

  （nullable）、

  assignedCampaignIds[]

  、

  createdAt

  /

  updatedAt

  。

フィールドマッピング — 作成 (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 …/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

installs

optimizationType: cpi

retention

optimizationType: legacyRetention

roas

optimizationType: roas

roasType

eventOptimization

optimizationType: appEventConversion

appEventType

creativeTesting

isCreativeTesting: true

optimizationType: cpi

cpiType: manual

フィールドマッピング — 作成 (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

)。キャンペーン全体ではありませ ん 。 クライアントがパッチ反応から他のキャンペーンフィールドを読み取る場合は、

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}

Transform(重要)

"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

  がなくなりました →

  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 — 割り当てられたクリエイティブパック (現在はリスト)

変更内容

• 古い機能割り当て済み/未割り当てのリクエストあたり1パック(

  POST

  /

  DELETE …/assigned-creative-packs

  )。
• 新しい API はリストに対して動作します。

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

    with

    { creativePackIds: [...] }

    — 指定された ID で割り当てられた集合を置き換えます。

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

    with

    { creativePackIds: [...] }

    — リストされた ID を削除します。
• 現在割り当てられているパックのリスト：

  GET campaign?includeFields=creativePacks

  （

  creativePackIds[]

  ）。

移行アプローチ

PATCH assign-creative-pack

POST

creativePackIds

ブロック I — オーディエンス Pinpointer → Campaign Management (キャンペーン管理)

変更内容

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 — アトリビューション（再配置）

変更内容

appAttributionClickUrl

StartUrl

attributionLinks

• GET …/applications/{applicationId}/attribution

  →

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

  .

• { startUrl?, clickUrl?, viewUrl? }

  との

  PATCH …/applications/{applicationId}/attribution

  。

partner

other

adjust

airbridge

appsflyer

branch

bytebrew

kochava

mailru

singular

tenjin

yandex

type

userLevel

nonUserLevel

mixed

移行アプローチ

1. アプリケーションレベルの移動

   appAttributionClickUrl

   /

   appAttributionStartUrl

   →

   PATCH …/attribution

   (

   clickUrl

   /

   startUrl

   ).
2. campaign-create

   attributionClickUrl

   /

   attributionStartUrl

   → キャンペーンの

   PATCH

   の移動 (

   attributionLinks.{clickUrl,startUrl,viewUrl}

   )。キャンペーンの作成後に実行されます。

3. viewUrl

   は新規 (任意)。

   {ifa}

   およびその他の URL マクロ: 検証規則は、共有の 古い機能と新しい API の両方で使用されるトラッキング検証ライブラリ（確認済み）。そのため、マクロ 動作は変更されません。古い機能 URL をそのまま使用します。

推奨される移行アルゴリズム (エージェントの決定的な順序)

1. 構成: ホストを

   …/ads/advertiser

   にスワップ、パスプレフィックス

   /advertise/v1

   →

   /public/v1

   、

   apps

   セグメント →

   applications

   。Basic 認証を維持します。
2. アプリケーション(ブロックA):古い機能アプリケーションごとに、

   POST …/applications

   します(

   store

   を再マップする →

   {store, platform}

   )。持続

   legacy campaignSetId → new applicationId

   。トラッキングを送信しない ここに URL
3. アトリビューション（ブロック J）： 古いアプリケーションレベルの URL で

   PATCH …/applications/{id}/attribution

   します。
4. クリエイティブ (Block B): 再アップロード/再マップ、

   type

   enum の変換。持続 ID が再度生成されるかどうかを

   legacy creativeId → new creativeId

   します (ID が保持されているかどうかを確認します)。
5. **クリエイティブパック (**Block 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 情報ゲームロジックは単純に削除できます (資格は不要)。リテンション情報は 非推奨のリテンション製品と一緒に使用されました(ステップ13を参照)。
7. キャンペーン (ブロック D):

   optimizationType

   で作成 (+

   isCreativeTesting

   /

   appEventType

   /

   roasType

   )。

   start``PATCH

   して、

   end

   、

   attributionLinks

   、

   autoStart

   、

   paused

   を設定します。
8. 入札(ブロックE): ドル→マイクロドルに変換します(ROAS目標: パーセント→小数割合、 ÷100)。入札タイプごとに完全な希望セットを含む

   PATCH …/bids

   を1つ送信します(パッチ Replaces、Never Merge、

   []

   Clears)。リテンション入札は非推奨です。移行しないでください。 どのような使用法でも表面化します。
9. **バジェット(**ブロックF):マイクロドルで

   PATCH …/budget-cap

   。

   dailyPerCountry

   マップの変換 →

   countryGroupDailyLimits[]

   .
10. ターゲティング(ブロックG):

    appleDevice

    /

    androidDevice

    /ソース+カテゴリリストに再構築 削除されたデバイス フィールドをドロップします（表面化）。
11. 割り当て(ブロックH):キャンペーンごとに1つのリストベースの

    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

  )。
• すべてのアプリケーション パスで、24 文字の 16 進数

  campaignSetId

  ではなく、新しい UUID

  applicationId

  が使用されます。
• すべての貨幣値はマイクロドル (整数) であり、

  "2500.20"

  のような小数ではありません。
• 入札は単一の

  PATCH …/bids

  に送信され、読み取りは

  GET campaign?includeFields=bids

  を使用します。
• すべての入札

  PATCH

  は、その入札タイプの完全なセットを送信します(置換セマンティクス — 部分的 送信では省略された入札がドロップされます）。古い機能マージ形式の更新は読み取り/変更/書き込みに変換されました。
• ROAS 目標はパーセント文字列から小数比率に変換されました (

  "12.34"

  →

  0.1234

  )。
• バジェットは

  budget-cap

  +

  countryGroupDailyLimits[]

  を使用します（

  dailyPerCountry

  マップなし）。
• キャンペーン

  goal

  が

  optimizationType

  （+

  isCreativeTesting

  ）に再マッピングされ、アトリビューションが URLはキャンペーン作成ではなく、

  attributionLinks

  /

  …/attribution

  で設定します。
• Creative

  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 回の割り当てではなく、キャンペーンごとに 1 つのリストの呼び出しを使用します。

• DELETE app

  、非推奨のリテンション使用（入札/適格性）、

  squareVideo

  クリエイティブ、 削除されたターゲティングフィールドは、(クライアントがそれらを使用した場合) ギャップとしてユーザーに提示されます。ROAS 適格性審査が削除されました。

クイック リファレンス:🚫削除済み/同等の機能なし(移行または製造しない。すべてAPI所有者によって確認済み)

• DELETE app

  :削除アプリケーション エンドポイントなし。アプリケーション ライフサイクルはUSFが所有し、削除は 現在プラットフォーム全体で無効になっています。
• ROAS-info：削除。ROAS キャンペーンに適格性は必要なくなりました。ゲーティングロジックを削除します。
• リテンション(全製品領域):非推奨:

  retention-info

  とリテンションの入札には successor。アクティブなリテンションキャンペーン/入札を表示します。
• GET bids / バジェット / targeting / assigned-packs —

  GET campaign?includeFields=…

  に置き換えられました。
• 古い機能ターゲティングフィールド（

  limitedAdTracking

  、

  connectionType

  、

  screenSize

  、

  screenDensity

  、

  allowedDevices

  、

  osMax

  )およびアプリケーション

  adomain

  : では設定できません。 統一。クライアントコードを削除します。

• squareVideo

  クリエイティブ タイプ — サポートされていません。

  video_portrait

  /

  video_landscape

  のみです。