次の方法で共有

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 という要素があります。

要素 説明 データ型
AppPlatform アプリケーション プラットフォーム。

使用可能な値には 、iOS と Android が含まれます。

追加： 必須
更新： オプション		 string
AppStoreId アプリ ストアによって提供されるアプリケーション識別子。

アプリケーションが新しい場合は、広告の配信資格が得られるまで 4 日から 7 日お待ちください。

追加： 必須
更新： オプション		 string
テキスト 広告のコピー。 コピーには、少なくとも 1 つの単語が含まれている必要があります。 広告のコピーとタイトルの組み合わせには、少なくとも 3 つの単語を合計する必要があります。

広告コピーに {キーワード (keyword)} などの動的テキスト文字列を含めることはできません。

コピーの最大入力長は 71 文字です。 繁体字中国語を使用する広告グループの場合、テキストは 38 文字に制限されることに注意してください。

広告コピーに改行 (\n) 文字を含めることはできません。

追加： 必須
更新： オプション		 string
Title 広告のタイトル。 タイトルには、少なくとも 1 つの単語が含まれている必要があります。 広告のコピーとタイトルの組み合わせには、少なくとも 3 つの単語を合計する必要があります。

{キーワード (keyword)} などの動的テキスト文字列をタイトルに含めることはできません。

タイトルの最大入力長は 25 文字です。 繁体字中国語を使用する広告グループの場合、タイトルは 15 文字に制限されることに注意してください。

タイトルに改行 (\n) 文字を含めることはできません。

追加： 必須
更新： オプション		 string

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 配列
Id 広告の一意の 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