- リソース: InsertionOrder
- InsertionOrderType
- InsertionOrderBudget
- InsertionOrderAutomationType
- InsertionOrderBudgetSegment
- BillableOutcome
- メソッド
リソース: InsertionOrder
1 つの広告掲載オーダー。
JSON 表現 |
---|
{ "name": string, "advertiserId": string, "campaignId": string, "insertionOrderId": string, "displayName": string, "insertionOrderType": enum ( |
フィールド | |
---|---|
name |
出力のみ。広告掲載オーダーのリソース名。 |
advertiserId |
出力のみ。広告掲載オーダーが属する広告主の一意の ID。 |
campaignId |
必須。変更不可。広告掲載オーダーが属するキャンペーンの一意の ID。 |
insertionOrderId |
出力のみ。広告掲載オーダーの一意の ID。システムによって割り当てられます。 |
displayName |
必須。広告掲載オーダーの表示名。 UTF-8 でエンコードし、最大サイズが 240 バイトである必要があります。 |
insertionOrderType |
広告掲載オーダーのタイプ。 作成時にこのフィールドが指定されていない場合、値はデフォルトで |
entityStatus |
必須。広告掲載オーダーで予算を支出して広告枠に入札できるかどうかを制御します。
|
updateTime |
出力のみ。広告掲載オーダーが最後に更新されたときのタイムスタンプ。システムによって割り当てられます。 RFC3339 UTC「Zulu」形式のタイムスタンプ。精度はナノ秒まで、小数点以下は最大 9 桁。例: |
partnerCosts[] |
広告掲載オーダーに関連付けられたパートナー費用。
|
pacing |
必須。広告掲載オーダーの予算消化速度の設定。 |
frequencyCap |
必須。広告掲載オーダーのフリークエンシー キャップ設定。 |
integrationDetails |
広告掲載オーダーのその他の統合の詳細。 |
performanceGoal |
必須。広告掲載オーダーのパフォーマンス目標。 |
budget |
必須。広告掲載オーダーの予算割り当て設定。 |
bidStrategy |
広告掲載オーダーの入札戦略。デフォルトでは |
reservationType |
出力のみ。広告掲載オーダーの予約タイプ。 |
billableOutcome |
変更不可。広告掲載オーダーの請求対象の結果。 成果ベースの購入はサポート終了となりました。有効な値は |
InsertionOrderType
広告掲載オーダーの使用可能なタイプ。
使用できる設定やオプション(広告のフォーマットやターゲティング オプションなど)は、広告掲載オーダーのタイプによって決まります。
列挙型 | |
---|---|
INSERTION_ORDER_TYPE_UNSPECIFIED |
広告掲載オーダーのタイプが指定されていないか、不明です。 |
RTB |
リアルタイム ビッダー。 |
OVER_THE_TOP |
オーバー ザ トップ。 |
InsertionOrderBudget
広告掲載オーダーの予算の割り当て方法を管理する設定です。
JSON 表現 |
---|
{ "budgetUnit": enum ( |
フィールド | |
---|---|
budgetUnit |
必須。変更不可。予算単位では、予算が通貨ベースかインプレッション ベースかを指定します。 |
automationType |
広告掲載オーダーの入札単価と予算の管理に使用する自動化のタイプ。 作成時にこのフィールドが指定されていない場合、値はデフォルトで |
budgetSegments[] |
必須。予算セグメントのリスト。予算セグメントを使用すると、広告掲載オーダーの実施期間に対する特定の予算を指定できます。 |
InsertionOrderAutomationType
広告掲載オーダーの入札単価と予算を自動化するための設定。
列挙型 | |
---|---|
INSERTION_ORDER_AUTOMATION_TYPE_UNSPECIFIED |
このバージョンでは広告掲載オーダーの自動化オプションが指定されていないか、不明です。 |
INSERTION_ORDER_AUTOMATION_TYPE_BUDGET |
予算の自動割り当てperformanceGoal で定義した掲載結果を最適化するために、システムで予算が自分の広告申込情報に自動的に移行されるようにします。入札単価設定は自動化されていません。 |
INSERTION_ORDER_AUTOMATION_TYPE_NONE |
広告掲載オーダー単位で入札単価や予算が自動化されない。入札単価と予算は、広告申込情報レベルで手動で設定する必要があります。 |
INSERTION_ORDER_AUTOMATION_TYPE_BID_BUDGET |
「performanceGoal 」で定義されたパフォーマンスを最適化するために、システムで入札単価を自動的に調整して、その広告申込情報に予算をシフトすることを許可します。 |
InsertionOrderBudgetSegment
1 つの予算セグメントの予算を管理する設定です。
JSON 表現 |
---|
{
"budgetAmountMicros": string,
"description": string,
"dateRange": {
object ( |
フィールド | |
---|---|
budgetAmountMicros |
必須。指定した |
description |
予算セグメントの説明。これを使用して、各予算セグメントの注文書情報を入力し、その情報を請求書に印刷できます。 UTF-8 でエンコードする必要があります。 |
dateRange |
必須。予算セグメントの開始日と終了日の設定。親広告主のタイムゾーンが基準となります。
|
campaignBudgetId |
この広告掲載オーダー予算セグメントが属しているキャンペーン予算の |
BillableOutcome
広告掲載オーダーで考えられる請求対象の結果。
列挙型 | |
---|---|
BILLABLE_OUTCOME_UNSPECIFIED |
請求対象の結果が指定されていません。 |
BILLABLE_OUTCOME_PAY_PER_IMPRESSION |
インプレッション単価。 |
BILLABLE_OUTCOME_PAY_PER_CLICK |
クリック課金型。 |
BILLABLE_OUTCOME_PAY_PER_VIEWABLE_IMPRESSION |
アクティブ ビュー単価制。 |
Methods |
|
---|---|
|
さまざまなターゲティング タイプで広告掲載オーダーに割り当てられたターゲティング オプションを一覧表示します。 |
|
新しい広告掲載オーダーを作成します。 |
|
広告掲載オーダーを削除します。 |
|
広告掲載オーダーを取得します。 |
|
広告主の広告掲載オーダーを一覧表示します。 |
|
既存の広告掲載オーダーを更新します。 |