広告データ オブジェクト - キャンペーン管理
広告のベース オブジェクトを定義します。
広告をインスタンス化しないでください。 次のオブジェクトから派生する 1 つ以上のオブジェクトを作成できます。
- AppInstallAd
- DynamicSearchAd
- ExpandedTextAd
- HotelAd
- TextAd
- ProductAd
- ResponsiveAd
- ResponsiveSearchAd
構文
<xs:complexType name="Ad" xmlns:xs="http://www.w3.org/2001/XMLSchema">
<xs:sequence>
<xs:element minOccurs="0" name="AdFormatPreference" nillable="true" type="xs:string" />
<xs:element minOccurs="0" name="DevicePreference" nillable="true" type="xs:long" />
<xs:element minOccurs="0" name="EditorialStatus" nillable="true" type="tns:AdEditorialStatus" />
<xs:element minOccurs="0" name="FinalAppUrls" nillable="true" type="tns:ArrayOfAppUrl" />
<xs:element xmlns:q1="http://schemas.microsoft.com/2003/10/Serialization/Arrays" minOccurs="0" name="FinalMobileUrls" nillable="true" type="q1:ArrayOfstring" />
<xs:element minOccurs="0" name="FinalUrlSuffix" nillable="true" type="xs:string" />
<xs:element xmlns:q2="http://schemas.microsoft.com/2003/10/Serialization/Arrays" minOccurs="0" name="FinalUrls" nillable="true" type="q2:ArrayOfstring" />
<xs:element xmlns:q3="http://schemas.datacontract.org/2004/07/System.Collections.Generic" minOccurs="0" name="ForwardCompatibilityMap" nillable="true" type="q3:ArrayOfKeyValuePairOfstringstring" />
<xs:element minOccurs="0" name="Id" nillable="true" type="xs:long" />
<xs:element minOccurs="0" name="Status" nillable="true" type="tns:AdStatus" />
<xs:element minOccurs="0" name="TrackingUrlTemplate" nillable="true" type="xs:string" />
<xs:element minOccurs="0" name="Type" nillable="true" type="tns:AdType" />
<xs:element minOccurs="0" name="UrlCustomParameters" nillable="true" type="tns:CustomParameters" />
</xs:sequence>
</xs:complexType>
要素
Ad オブジェクトには、AdFormatPreference、DevicePreference、EditorialStatus、FinalAppUrls、FinalMobileUrls、FinalUrls、FinalUrlSuffix、ForwardCompatibilityMap、Id、Status、TrackingUrlTemplate、Type、UrlCustomParameters の各要素があります。
| 要素 | 説明 | データ型 |
|---|---|---|
| AdFormatPreference | [広告フォーマットの設定] は、広告コピーを検索広告または対象ユーザー広告としてユーザーに表示するかどうかを示すために使用されます。 検索広告は行動喚起として書き込まれる傾向があるのに対し、オーディエンス広告は、より多くの情報スタイルで記述する必要があります。 オーディエンス広告として検索広告を使用することもできますが、広告を対象ユーザー広告の優先形式として指定すると、ネイティブ配信用にメッセージングを最適化できます。 可能な値は AudienceAd と All です。 [すべて] に設定すると、広告は検索広告と対象ユーザーの両方の広告形式の対象になります。 AudienceAd に設定されている場合、広告は対象ユーザーの広告形式にのみ適用されます。 広告フォーマット設定は、 ExpandedTextAd オブジェクトと TextAd オブジェクトでのみサポートされます。 |
string |
| DevicePreference | 広告を表示するデバイスの設定を決定します。 デバイスの基本設定は、 AppInstallAd オブジェクトと TextAd オブジェクトでのみサポートされます。 |
long |
| EditorialStatus | 広告の編集レビューの状態。これは、広告がレビュー待ちであるか、承認されているか、不承認であるかを示します。 | AdEditorialStatus |
| FinalAppUrls | 将来の使用のために。 | AppUrl 配列 |
| FinalMobileUrls | モバイル ランディング ページの URL。 この要素は、 ExpandedTextAd、 ResponsiveAd、 ResponsiveSearchAd、 および TextAd オブジェクトでのみサポートされます。 AppInstallAd、DynamicSearchAd、ProductAd オブジェクトではサポートされていません。 |
string 配列 |
| FinalUrls | 最終 URL パスへのクリックにリダイレクトが含まれているかどうかに関係なく、ユーザーが最終的に取得される最後または最後の URL。 この要素は、 AppInstallAd、 ExpandedTextAd、 ResponsiveAd、 ResponsiveSearchAd、 および TextAd オブジェクトでのみサポートされます。 DynamicSearchAd オブジェクトと ProductAd オブジェクトではサポートされていません。 |
string 配列 |
| FinalUrlSuffix | 最後の URL サフィックスには、ランディング ページ URL の末尾に追加される追跡パラメーターを含めることができます。 顧客が常にランディング ページに送信されるように、ランディング ページで必要な追跡パラメーターを最終的な URL サフィックスに配置することをお勧めします。 詳細と検証規則については、テクニカル ガイドの 「最終 URL サフィックス」を 参照してください。 この要素は、 AppInstallAd、 DynamicSearchAd、 ExpandedTextAd、 ResponsiveAd、 および ResponsiveSearchAd オブジェクトでのみサポートされます。 ProductAd オブジェクトと TextAd オブジェクトではサポートされていません。 |
string |
| ForwardCompatibilityMap | 現在の API バージョンで新しい要素が追加されたときに変更が中断されないように、前方互換性のためのキー文字列と値文字列の一覧。 今後のリリースでは、今後の互換性の変更に関するページを参照してください。 現在、このオブジェクトの前方互換性の変更はありません。 |
KeyValuePairOfstring 配列 |
| 身分証明書 | 広告の一意の Microsoft Advertising 識別子。 | long |
| Status | 広告の状態。 広告の状態を [アクティブ] または [一時停止] に設定できます。 |
AdStatus |
| TrackingUrlTemplate | すべてのランディング ページ URL の既定として使用する追跡テンプレート。 この要素は、 AppInstallAd、 DynamicSearchAd、 ExpandedTextAd、 ResponsiveAd、 ResponsiveSearchAd、 および TextAd オブジェクトでのみサポートされます。 ProductAd オブジェクトではサポートされていません。 |
string |
| 型 | 広告の種類。 広告の種類の詳細については、「 備考」を参照してください。 |
AdType |
| UrlCustomParameters | URL 追跡用のキーパラメーターと値パラメーターのカスタム コレクション。 この要素は、 AppInstallAd、 DynamicSearchAd、 ExpandedTextAd、 ResponsiveAd、 ResponsiveSearchAd、 および TextAd オブジェクトでのみサポートされます。 ProductAd オブジェクトではサポートされていません。 |
CustomParameters |
解説
Java および .NET 言語の場合は、展開されたテキスト広告をインスタンス化するか別の広告の種類によって値が決定されるため、 Type 要素を設定しないでください。
SOAP を手動で生成する場合は、(次の例に示すように) ノードの <Ad>type 属性を使用して広告の種類を指定します。
<Ads xmlns:i="http://www.w3.org/2001/XMLSchema-instance">
<Ad i:type="ExpandedTextAd">
<DevicePreference i:nil="true" />
<EditorialStatus i:nil="true" />
<ForwardCompatibilityMap i:nil="true" />
<Id i:nil="true" />
<Status i:nil="true" />
<FinalUrls xmlns:a="http://schemas.microsoft.com/2003/10/Serialization/Arrays">
<a:string>https://www.contoso.com/womenshoesale</a:string>
</FinalUrls>
<Path1>seattle</Path1>
<Path2>shoe sale</Path2>
<Text>Find New Customers & Increase Sales!</Text>
<TextPart2>Start Advertising on Contoso Today.</TextPart2>
<TitlePart1>Contoso</TitlePart1>
<TitlePart2>Fast & Easy Setup</TitlePart2>
<TitlePart3>Top Rated</TitlePart3>
</Ad>
</Ads>
要件
サービス: CampaignManagementService.svc v13
Namespace: https://bingads.microsoft.com/CampaignManagement/v13
使用ページ
AddAds
GetAdsByAdGroupId
GetAdsByEditorialStatus
GetAdsByIds
UpdateAds