AssetGroup データ オブジェクト - キャンペーン管理

広告キャンペーンの資産グループを定義します。

構文

<xs:complexType name="AssetGroup" xmlns:xs="http://www.w3.org/2001/XMLSchema">
  <xs:sequence>
    <xs:element minOccurs="0" name="BusinessName" nillable="true" type="xs:string" />
    <xs:element minOccurs="0" name="CallToAction" nillable="true" type="tns:CallToAction" />
    <xs:element minOccurs="0" name="Descriptions" nillable="true" type="tns:ArrayOfAssetLink" />
    <xs:element minOccurs="0" name="EditorialStatus" nillable="true" type="tns:AssetGroupEditorialStatus" />
    <xs:element minOccurs="0" name="EndDate" nillable="true" type="tns:Date" />
    <xs:element xmlns:q114="http://schemas.microsoft.com/2003/10/Serialization/Arrays" minOccurs="0" name="FinalMobileUrls" nillable="true" type="q114:ArrayOfstring" />
    <xs:element xmlns:q115="http://schemas.microsoft.com/2003/10/Serialization/Arrays" minOccurs="0" name="FinalUrls" nillable="true" type="q115:ArrayOfstring" />
    <xs:element xmlns:q116="http://schemas.datacontract.org/2004/07/System.Collections.Generic" minOccurs="0" name="ForwardCompatibilityMap" nillable="true" type="q116:ArrayOfKeyValuePairOfstringstring" />
    <xs:element minOccurs="0" name="Headlines" nillable="true" type="tns:ArrayOfAssetLink" />
    <xs:element minOccurs="0" name="Id" nillable="true" type="xs:long" />
    <xs:element minOccurs="0" name="Images" nillable="true" type="tns:ArrayOfAssetLink" />
    <xs:element minOccurs="0" name="LongHeadlines" nillable="true" type="tns:ArrayOfAssetLink" />
    <xs:element minOccurs="0" name="Name" nillable="true" type="xs:string" />
    <xs:element minOccurs="0" name="Path1" nillable="true" type="xs:string" />
    <xs:element minOccurs="0" name="Path2" nillable="true" type="xs:string" />
    <xs:element minOccurs="0" name="StartDate" nillable="true" type="tns:Date" />
    <xs:element minOccurs="0" name="Status" nillable="true" type="tns:AssetGroupStatus" />
  </xs:sequence>
</xs:complexType>

要素

AssetGroup オブジェクトには、BusinessName、CallToAction、Descriptions、EditorialStatus、EndDate、FinalMobileUrls、FinalUrls、ForwardCompatibilityMap、Headlines、Id、Images、LongHeadlines、Name、Path1、Path2、StartDate、Status という要素があります。

要素	説明	データ型
BusinessName	ビジネスの名前。 広告の配置によっては、ビジネス名が広告に表示される場合があります。 文字列の長さは 25 文字に制限されています。 追加： 必須。 指定されておらず、親キャンペーンがストアに関連付けられている場合、ストア名がビジネス名として使用されます。 更新： オプション。 更新プログラムに値が設定されていない場合、この設定は変更されません。	string
CallToAction	顧客が今すぐ広告をクリックする簡単でパンチの効く理由。 これは、アクションの呼び出しボタンに表示されます。 追加： 必須。 指定されておらず、親キャンペーンがストアに関連付けられている場合、既定では LearnMore になります。 更新： オプション。 更新プログラムに値が設定されていない場合、この設定は変更されません。	CallToAction
説明	広告のパスの下に表示される説明。 2 から 5 の説明を設定する必要があります。 各説明の Text には、少なくとも 1 つの単語が含まれている必要があります。 Text には改行 (\n) 文字を含めることはできません。 親キャンペーンがストアに関連付け、説明を指定する場合は、見出し、LongHeadlines、および画像も指定する必要があります。 追加: 親キャンペーンがストアに関連付ける場合は省略可能。親キャンペーンがストアに関連付けられない場合は必須です。 更新: 省略可能。 既存のすべてのアセット リンクを保持するには、この要素を nil のままにします。 この要素の値を設定すると、以前にこの資産グループにリンクされていた説明が置き換えられます。 親キャンペーンがストアに関連付け、この要素を空のリストに設定すると、前の設定が削除されます。	AssetLink 配列
EditorialStatus	資産グループの編集レビューの状態。資産グループがレビュー待ちであるか、承認されているか、または承認されていないかを示します。 追加: 読み取り専用 更新: 読み取り専用	AssetGroupEditorialStatus
EndDate	資産グループの有効期限が切れる日付。 終了日を指定しない場合、資産グループの有効期限は切れなくなります。 終了日を延長して、資産グループの有効期限が切れた後でも、資産グループを配信の対象にすることができます。 終了日は包括的です。 たとえば、EndDate を 2020 年 12 月 31 日に設定した場合、広告グループの広告は 2020 年 12 月 31 日午後 11 時 59 分に期限切れになります。 時間は、キャンペーン レベルで指定したタイム ゾーンに基づいています。 追加: 省略可能。 資産グループを追加するときに終了日を設定しない場合は、この要素を null に設定します。 更新: 省略可能。 更新プログラムに値が設定されていない場合、この設定は変更されません。 既存の終了日設定を削除し、資産グループを更新するときに終了日を効果的に設定しない場合は、終了日を 2050 年 1 月 2 日以降に設定します。 次回アセット グループを取得すると、この要素は nil になります。つまり、2050 年 1 月 2 日には設定されません。	Date
FinalMobileUrls	モバイル ランディング ページの URL。 次の検証規則は、最終 URL と最終モバイル URL に適用されます。 - URL の長さは 2,048 文字に制限されています。 HTTP または HTTPS プロトコル文字列は、2,048 文字の制限にカウントされます。 - FinalUrls と FinalMobileUrls の両方に対して最大 10 個の項目を指定できます。ただし、各一覧の最初の項目のみが配信に使用されます。 このサービスでは、前方互換性の可能性がある最大 10 個を許可します。 - '{' と '}' の使用は、{lpurl} などのタグのみを示すために許可されます。 - 最終的な URL はそれぞれ、http:// または https:// で始まる整形式の URL である必要があります。 - FinalMobileUrls を指定する場合は、FinalUrls も指定する必要があります。 追加: 省略可能 更新: 省略可能	string 配列
FinalUrls	ランディング ページの URL。 パス 1 およびパス 2 の文字列と組み合わせた URL のドメイン部分は、67 文字を超えることはできません。 次の検証規則は、最終 URL と最終モバイル URL に適用されます。 - URL の長さは 2,048 文字に制限されています。 HTTP または HTTPS プロトコル文字列は、2,048 文字の制限にカウントされます。 - FinalUrls と FinalMobileUrls の両方に最大 10 個の項目を指定できます。ただし、各一覧の最初の項目のみが配信に使用されます。 このサービスでは、前方互換性の可能性がある最大 10 個を許可します。 - '{' と '}' の使用は、{lpurl} などのタグのみを示すために許可されます。 - 最終的な URL はそれぞれ、http:// または https:// で始まる整形式の URL である必要があります。 - FinalMobileUrls を指定する場合は、FinalUrls も指定する必要があります。 リテール キャンペーンの場合、最終的な URL は、キャンペーンに関連付けられているストアのドメインと一致する必要があります。 追加: 必須。 指定されず、親キャンペーンがストアに関連付けられている場合、ストア URL が最終的な URL として使用されます。 更新: 省略可能	string 配列
ForwardCompatibilityMap	現在の API バージョンで新しい要素が追加されたときに変更が中断されないように、前方互換性のためのキー文字列と値文字列の一覧。 今後のリリースでは、今後の互換性の変更に関するページを参照してください。 現在、このオブジェクトの前方互換性の変更はありません。	KeyValuePairOfstring 配列
見出し	見出しは広告に表示される最も目立つテキストであるため、使用可能な文字を最大限に活用する必要があります。 広告がさまざまなパブリッシャーやプレースメントに柔軟に表示できるように、複数の見出しが必要です。 データ モデルの観点から見ると、説明と見出しはそれぞれテキストアセット (AssetLink ごとに 1 つの TextAsset) として格納されます。 同じアセットを複数の広告で使用できます。 たとえば、"シームレスインテグレーション" がテキストアセットの場合、同じ Microsoft Advertising アカウント内のすべての広告で同じアセット識別子が設定されます。 見出しは 3 から 15 の間で設定する必要があります。 各見出しのテキストには、少なくとも 1 つの単語が含まれている必要があります。 Text には改行 (\n) 文字を含めることはできません。 親キャンペーンがストアに関連付け、見出しを指定する場合は、LongHeadlines、説明、および画像も指定する必要があります。 追加: 親キャンペーンがストアに関連付ける場合は省略可能。親キャンペーンがストアに関連付けられない場合は必須です。 更新: 省略可能。 既存のすべてのアセット リンクを保持するには、この要素を nil のままにします。 この要素の値を設定すると、以前にこの資産グループにリンクされていた見出しが置き換えられます。 親キャンペーンがストアに関連付け、この要素を空のリストに設定すると、前の設定が削除されます。	AssetLink 配列
Id	システムによって生成された資産グループ ID。 追加: 読み取り専用 更新: 読み取り専用	long
Images	さまざまなサイズと縦横比を持つ画像アセットを使用して、さまざまな発行元や配置に対して柔軟に表示できるようにします。 それぞれ SubType とトリミング設定を持つ ImageAsset を含む 1 つ以上の AssetLink オブジェクトを含め、目的の縦横比に一致します。 ImageAsset には、CropHeight、CropWidth、CropX、CropY、SubType の各フィールドが含まれています。 可能なサブタイプの値には、LandscapeImageMedia、SquareImageMedia、LandscapeLogoMedia、SquareLogoMedia、ImageMedia15X10、ImageMedia133X100、ImageMedia178X100、ImageMedia1X2、ImageMedia4X1 などがあります。 少なくとも 1 つの LandscapeImageMedia と 1 つの SquareImageMedia を指定する必要があります。 最大 20 個の画像と最大 5 つのロゴの合計を保存できます。 親キャンペーンがストアに関連付け、画像を指定する場合は、見出し、LongHeadlines、およびディスクリプションも指定する必要があります。 追加: 親キャンペーンがストアに関連付ける場合は省略可能。親キャンペーンがストアに関連付けられない場合は必須です。 更新: 省略可能。 更新プログラムに値が設定されていない場合、この設定は変更されません。 更新中にイメージを含める場合、以前に設定したイメージはすべて置き換えられます。 親キャンペーンがストアに関連付け、この要素を空のリストに設定すると、前の設定が削除されます。	AssetLink 配列
LongHeadlines	長い見出しを 1 ~ 5 個設定する必要があります。 各見出しのテキストには、少なくとも 1 つの単語が含まれている必要があります。 Text には改行 (\n) 文字を含めることはできません。 親キャンペーンがストアに関連付け、LongHeadlines を指定する場合は、見出し、説明、および画像も指定する必要があります。 追加: 親キャンペーンがストアに関連付ける場合は省略可能。親キャンペーンがストアに関連付けられない場合は必須です。 更新: 省略可能。 既存のすべてのアセット リンクを保持するには、この要素を nil のままにします。 この要素の値を設定すると、以前にこの資産グループにリンクされていた見出しが置き換えられます。 親キャンペーンがストアに関連付け、この要素を空のリストに設定すると、前の設定が削除されます。	AssetLink 配列
名前	資産グループの名前。 名前はキャンペーンで一意であり、大文字と小文字が区別されます。 長さは 256 文字以内です。 追加: 必須 更新: 省略可能	string
Path1	表示 URL のドメイン部分に追加される省略可能なパスの最初の部分。 たとえば、表示 URL のドメイン部分は、Final URL (FinalUrls 要素) のドメインから生成されます。 https://www.contoso.com Path1 の値を指定した場合は、表示 URL に追加されます。 Path2 の値も指定している場合は、Path1 の後の表示 URL にも追加されます。 たとえば、FinalUrls に が含まれている https://www.contoso.com場合、Path1 がサブディレクトリ 1 に設定され、Path2 がサブディレクトリ 2 に設定されている場合、表示される URL は になります https://www.contoso.com/subdirectory1/subdirectory2。 入力できる文字数は 15 文字以下です。 最終的な URL ドメインの長さと組み合わせたパスが 67 文字を超える場合、広告は表示に失敗します。 二重幅文字を持つ言語の場合 (繁体字中国語など)、最後の 7 文字以内で入力できます。 最終的な URL ドメインの長さと組み合わされたパスが 33 文字を超える場合、広告の表示に失敗します。 二重幅文字は、キャンペーン言語設定の文字セットの代わりに使用する文字によって決まります。 二重幅の文字には、韓国語、日本語、中国語の文字と絵文字が含まれます。 パスにスラッシュ (/) 文字または改行 (\n) 文字を含めることはできません。 パスにスペースが含まれている場合、広告が表示されるときにアンダースコア (_) に置き換えられます。 追加: 省略可能 更新: 省略可能	string
Path2	表示 URL のドメイン部分に追加される省略可能なパスの 2 番目の部分。 たとえば、表示 URL のドメイン部分は、Final URL (FinalUrls 要素) のドメインから生成されます。 https://www.contoso.com Path1 の値を指定した場合は、表示 URL に追加されます。 Path2 の値も指定している場合は、Path1 の後の表示 URL にも追加されます。 たとえば、FinalUrls に が含まれている https://www.contoso.com場合、Path1 がサブディレクトリ 1 に設定され、Path2 がサブディレクトリ 2 に設定されている場合、表示される URL は になります https://www.contoso.com/subdirectory1/subdirectory2。 Path1 も設定されている場合にのみ Path2 を指定できます。 入力できる文字数は 15 文字以下です。 最終的な URL ドメインの長さと組み合わせたパスが 67 文字を超える場合、広告は表示に失敗します。 二重幅文字を持つ言語の場合 (繁体字中国語など)、最後の 7 文字以内で入力できます。 最終的な URL ドメインの長さと組み合わされたパスが 33 文字を超える場合、広告の表示に失敗します。 二重幅文字は、キャンペーン言語設定の文字セットの代わりに使用する文字によって決まります。 二重幅の文字には、韓国語、日本語、中国語の文字と絵文字が含まれます。 パスにスラッシュ (/) 文字または改行 (\n) 文字を含めることはできません。 パスにスペースが含まれている場合、広告が表示されるときにアンダースコア (_) に置き換えられます。 追加: 省略可能 更新: 省略可能	string
StartDate	資産グループが提供を開始できる日付。それ以外の場合、サービスはアセット グループがアクティブになった日に広告の配信を開始できます。 開始日は包括的です。 たとえば、開始日を 2021 年 5 月 5 日に設定した場合、アセット グループから作成された広告は、2021 年 5 月 5 日の午前 12 時に開始されます。 時間は、キャンペーン レベルで指定したタイム ゾーンに基づいています。 追加: 省略可能。 開始日を設定しない場合、既定値は今日の日付になり、アセット グループの状態がアクティブになるとすぐにサービスで広告の配信を開始できます。 更新: 省略可能。 更新プログラムに値が設定されていない場合、この設定は変更されません。 開始日は、資産グループが送信された後、つまり開始日が到着した後は更新できません。	Date
Status	資産グループの状態。 使用可能な値は 、アクティブ、 期限切れ 、 一時停止です。 期限切れの状態は読み取り専用です。 追加: 省略可能。 既定値は [一時停止] です。 更新: 省略可能	AssetGroupStatus

要件

サービス: CampaignManagementService.svc v13
Namespace: https://bingads.microsoft.com/CampaignManagement/v13

使用ページ

AddAssetGroups
GetAssetGroupsByCampaignId
GetAssetGroupsByIds
UpdateAssetGroups