AppInstallAd データ オブジェクト - キャンペーン管理
アプリ インストール広告を定義します。
アプリのインストール広告はテキスト広告に似ていますが、ボタンを使用してアプリへの直接リンクを提供し、該当するストアに顧客を直接送信してアプリケーションをダウンロードします。 これは、ウェブサイトのトラフィックではなく、アプリのダウンロードを管理して推進したい広告主にとって理想的なソリューションです。
アプリのインストール広告は、顧客のモバイル デバイスとオペレーティング システムを自動的に検出し、対応する Apple App Storeまたは Google Play に送信します。 App Extensions と同じコンバージョン トラッキング パートナーを使用してコンバージョンを追跡することもできます。AppsFlyer、Kochava、Tune、Singular、Adjust、Branch。
注:
アプリインストール広告は、オーストラリア、ブラジル、カナダ、フランス、ドイツ、インド、英国、iOS と Android の米国でのみ利用できます。 現在、Apple App Store および Google Play ストアの米国で利用できるアプリのみがサポートされています。 Windows はサポートされません。
誰もがこの機能をまだ持っているわけではありません。 そうでない場合は、心配しないでください。 近日公開予定です。
注:
アプリのインストール広告は、 AdGroupType が "SearchStandard" に設定されている検索キャンペーンでのみ作成できます。 AdGroupType が "SearchDynamic" に設定されている場合、広告グループはアプリのインストール広告をサポートしません。
AppPlatform、AppStoreId、Text、および Title 要素の組み合わせにより、アプリのインストール広告が一意になります。
構文
<xs:complexType name="AppInstallAd" xmlns:xs="http://www.w3.org/2001/XMLSchema">
<xs:complexContent mixed="false">
<xs:extension base="tns:Ad">
<xs:sequence>
<xs:element minOccurs="0" name="AppPlatform" nillable="true" type="xs:string" />
<xs:element minOccurs="0" name="AppStoreId" nillable="true" type="xs:string" />
<xs:element minOccurs="0" name="Text" nillable="true" type="xs:string" />
<xs:element minOccurs="0" name="Title" nillable="true" type="xs:string" />
</xs:sequence>
</xs:extension>
</xs:complexContent>
</xs:complexType>
要素
AppInstallAd オブジェクトには、AppPlatform、AppStoreId、Text、Title という要素があります。
AppInstallAd オブジェクトには継承された要素があります。
継承された要素
Ad から継承された要素
AppInstallAd オブジェクトは Ad オブジェクトから派生し、AdFormatPreference、DevicePreference、EditorialStatus、FinalAppUrls、FinalMobileUrls、FinalUrls、FinalUrlSuffix、ForwardCompatibilityMap、Id、Status、TrackingUrlTemplate、Type、UrlCustomParameters の各要素を継承します。 以下の説明は AppInstallAd に固有であり、 Ad オブジェクトから同じ要素を継承する他のオブジェクトには適用されない場合があります。
要素 | 説明 | データ型 |
---|---|---|
AdFormatPreference | この広告タイプではサポートされていません。 | string |
DevicePreference | この要素は、アプリのインストール広告をモバイルおよびタブレット デバイスに表示するか、モバイル デバイスにのみ表示するかを決定します。 (現在、デスクトップ コンピューターではアプリのインストール広告はサポートされていません。 モバイル デバイスのみの設定 (タブレットを除く) を指定するには、この要素を 30001 に設定します。 モバイル デバイスとタブレット デバイスの両方の基本設定を指定するには、この要素を 0 (ゼロ) に設定するか、要素 nil のままにします。 既定では、この要素は nil になります。 足す: 随意 更新: 随意 |
long |
EditorialStatus | 広告の編集レビューの状態。これは、広告がレビュー待ちであるか、承認されているか、不承認であるかを示します。 足す: 読み取り専用 更新: 読み取り専用 |
AdEditorialStatus |
FinalAppUrls | アプリのインストール広告ではサポートされていません。 | AppUrl 配列 |
FinalMobileUrls | アプリのインストール広告ではサポートされていません。 | string 配列 |
FinalUrls | 検索ユーザーがアクセスし、アプリのインストールを選択できる URL。 足す: 必須 更新: 随意 |
string 配列 |
FinalUrlSuffix | 最後の URL サフィックスには、ランディング ページ URL の末尾に追加される追跡パラメーターを含めることができます。 顧客が常にランディング ページに送信されるように、ランディング ページで必要な追跡パラメーターを最終的な URL サフィックスに配置することをお勧めします。 詳細と検証規則については、テクニカル ガイドの 「最終 URL サフィックス」を 参照してください。 足す: 随意 更新: 随意。 更新プログラムに値が設定されていない場合、この設定は変更されません。 この要素を空の文字列 ("") に設定すると、前の設定が削除されます。 |
string |
ForwardCompatibilityMap | 現在の API バージョンで新しい要素が追加されたときに変更が中断されないように、前方互換性のためのキー文字列と値文字列の一覧。 現在、このオブジェクトに適用できる ForwardCompatibilityMap キーと値のペアはありません。 |
KeyValuePairOfstring 配列 |
身分証明書 | 広告の一意の Microsoft Advertising 識別子。 足す: 読み取り専用 更新: 必須と読み取り専用 |
long |
Status | 広告の状態。 広告の状態を [アクティブ] または [一時停止] に設定できます。 足す: 随意 更新: 随意 |
AdStatus |
TrackingUrlTemplate |
FinalUrls で指定された URL の既定として使用する追跡テンプレート。 追跡テンプレートには、次の検証規則が適用されます。 サポートされているテンプレートとパラメーターの詳細については、Microsoft Advertising のヘルプ記事「 どのような追跡または URL パラメーターを使用できますか?」を参照してください。 - 低レベルのエンティティに対して定義された追跡テンプレート (広告など) は、キャンペーンなど、上位レベルのエンティティに対して設定されたものをオーバーライドします。 詳細については、「 エンティティの制限」を参照してください。 - 追跡テンプレートの長さは 2,048 文字に制限されています。 HTTP または HTTPS プロトコル文字列は、2,048 文字の制限にカウントされます。 - 追跡テンプレートは、 http://、 https://、 {lpurl}、または {unescapedlpurl} のいずれかで始まる整形式の URL である必要があります。 - Microsoft Advertising では、カスタム パラメーターが存在するかどうかを検証しません。 追跡テンプレートでカスタム パラメーターを使用し、それらが存在しない場合、ランディング ページ URL には、代替なしでカスタム パラメーターのキーと値のプレースホルダーが含まれます。 たとえば、トラッキング テンプレートが https://tracker.example.com/?season={_season}&promocode={_promocode}&u={lpurl} で、キャンペーン、広告グループ、条件、キーワード (keyword)、または広告レベルで {_season} または {_promocode} が定義されていない場合、ランディング ページの URL は同じになります。足す: 随意 更新: 随意。 更新プログラムに値が設定されていない場合、この設定は変更されません。 この要素を空の文字列 ("") に設定すると、前の設定が削除されます。 |
string |
種類 | 広告の種類。 この値は、アプリ インストール広告を取得するときに AppInstall です。 広告の種類の詳細については、「 Ad Data Object 解説」を参照してください。 足す: 読み取り専用 更新: 読み取り専用 |
AdType |
UrlCustomParameters | URL 追跡用のキーパラメーターと値パラメーターのカスタム コレクション。 Microsoft Advertising では、 CustomParameters オブジェクトに含める最初の 8 個の CustomParameter オブジェクトを受け入れ、8 つ以上のカスタム パラメーターを含める場合はエラーが返されます。 各 CustomParameter には、Key 要素と Value 要素が含まれています。 足す: 随意 更新: 随意。 更新プログラムに値が設定されていない場合、この設定は変更されません。 既存のカスタム パラメーターを保持するには、 UrlCustomParameters 要素を null または空に設定します。 すべてのカスタム パラメーターを削除するには、CustomParameters オブジェクトの Parameters 要素を null または空に設定します。 カスタム パラメーターのサブセットを削除するには、CustomParameters オブジェクトの Parameters 要素に保持するカスタム パラメーターを指定します。 |
CustomParameters |
要件
サービス: CampaignManagementService.svc v13
Namespace: https://bingads.microsoft.com/CampaignManagement/v13