- リソース: 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 |
|
---|---|
|
新しい広告掲載オーダーを作成します。 |
|
広告掲載オーダーを削除します。 |
|
広告掲載オーダーを取得します。 |
|
広告主の広告掲載オーダーを一覧表示します。 |
|
さまざまなターゲティング タイプで広告掲載オーダーに割り当てられているターゲティング オプションを一覧表示します。 |
|
既存の広告掲載オーダーを更新します。 |