アプリのインストールの広告レコード - 一括

[アーティクル]
10/04/2023

一括ファイルでダウンロードおよびアップロードできるアプリインストール広告を定義します。

アプリのインストール広告はテキスト広告に似ていますが、ボタンを使用してアプリへの直接リンクを提供し、該当するストアに顧客を直接送信してアプリケーションをダウンロードします。これは、ウェブサイトのトラフィックではなく、アプリのダウンロードを管理して推進したい広告主にとって理想的なソリューションです。

アプリのインストール広告は、顧客のモバイルデバイスとオペレーティングシステムを自動的に検出し、対応する Apple App Storeまたは Google Play に送信します。 App Extensions と同じコンバージョントラッキングパートナーを使用してコンバージョンを追跡することもできます。AppsFlyer、Kochava、Tune、Singular、Adjust、Branch。

注:

アプリインストール広告は、オーストラリア、ブラジル、カナダ、フランス、ドイツ、インド、英国、iOS と Android の米国でのみ利用できます。現在、Apple App Store および Google Play ストアの米国で利用できるアプリのみがサポートされています。 Windows はサポートされません。

誰もがこの機能をまだ持っているわけではありません。そうでない場合は、心配しないでください。近日公開予定です。

注:

アプリのインストール広告は、広告グループの種類が "SearchStandard" に設定されている検索キャンペーンでのみ作成できます。 [広告グループの種類] が [SearchDynamic] に設定されている場合、広告グループはアプリのインストール広告をサポートしません。

AppInstallAds の DownloadEntity 値を DownloadCampaignsByAccountIds または DownloadCampaignsByCampaignIds サービス要求に含めることで、アカウント内のすべての App Install Ad レコードをダウンロードできます。さらに、ダウンロード要求には EntityData スコープを含める必要があります。ベストプラクティスを含む一括サービスの詳細については、「一括ダウンロードとアップロード」を参照してください。

次の一括 CSV の例では、有効な親 ID 値が指定されている場合に新しいアプリインストール広告を追加します。

Type,Status,Id,Parent Id,Campaign,Ad Group,Client Id,Modified Time,Title,Text,Display Url,Destination Url,Promotion,Device Preference,Name,App Platform,App Id,Final Url,Mobile Final Url,Tracking Template,Final Url Suffix,Custom Parameter
Format Version,,,,,,,,,,,,,,6.0,,,,,,,
App Install Ad,Active,,-1111,ParentCampaignNameGoesHere,AdGroupNameGoesHere,ClientIdGoesHere,,Contoso Quick Setup,Find New Customers & Increase Sales!,,,,All,,Android,AppStoreIdGoesHere,FinalUrlGoesHere,,,,{_promoCode}=PROMO1; {_season}=summer

.NET、Java、または Python 用の Bing Ads SDK を使用している場合は、 BulkServiceManager を使用して BulkAppInstallAd オブジェクトをアップロードしてダウンロードする時間を節約できます。サービス操作を直接呼び出し、カスタムコードを記述して一括ファイル内の各フィールドを解析する代わりにします。

var uploadEntities = new List<BulkEntity>();

// Map properties in the Bulk file to the BulkAppInstallAd
var bulkAppInstallAd = new BulkAppInstallAd
{
    // 'Parent Id' column header in the Bulk file
    AdGroupId = adGroupIdKey,
    // 'Ad Group' column header in the Bulk file
    AdGroupName = "AdGroupNameGoesHere",
    // 'Campaign' column header in the Bulk file
    CampaignName = "ParentCampaignNameGoesHere",
    // 'Client Id' column header in the Bulk file
    ClientId = "ClientIdGoesHere",
                
    // Map properties in the Bulk file to the 
    // AppInstallAd object of the Campaign Management service.
    AppInstallAd = new AppInstallAd
    {
        // 'App Platform' column header in the Bulk file
        AppPlatform = "Android",
        // 'App Id' column header in the Bulk file
        AppStoreId = "AppStoreIdGoesHere",
        // 'Device Preference' column header in the Bulk file
        DevicePreference = 0,
        // 'Final Url' column header in the Bulk file
        FinalUrls = new[] {
            // Each Url is delimited by a semicolon (;) in the Bulk file
            "FinalUrlGoesHere"
        },
        // 'Id' column header in the Bulk file
        Id = null,
        // 'Status' column header in the Bulk file
        Status = AdStatus.Active,
        // 'Text' column header in the Bulk file
        Text = "Find New Customers & Increase Sales!",
        // 'Title' column header in the Bulk file
        Title = "Contoso Quick Setup",
        // 'Tracking Template' column header in the Bulk file
        TrackingUrlTemplate = null,
        // 'Custom Parameter' column header in the Bulk file
        UrlCustomParameters = new CustomParameters
        {
            // Each custom parameter is delimited by a semicolon (;) in the Bulk file
            Parameters = new[] {
                new CustomParameter(){
                    Key = "promoCode",
                    Value = "PROMO1"
                },
                new CustomParameter(){
                    Key = "season",
                    Value = "summer"
                },
            }
        },
    },
};

uploadEntities.Add(bulkAppInstallAd);

var entityUploadParameters = new EntityUploadParameters
{
    Entities = uploadEntities,
    ResponseMode = ResponseMode.ErrorsAndResults,
    ResultFileDirectory = FileDirectory,
    ResultFileName = DownloadFileName,
    OverwriteResultFile = true,
};

var uploadResultEntities = (await BulkServiceManager.UploadEntitiesAsync(entityUploadParameters)).ToList();

App Install Ad レコードの場合、一括ファイルスキーマでは次の属性フィールドを使用できます。 [アプリ ID]、[アプリプラットフォーム]、[テキスト]、[タイトル] フィールドの組み合わせにより、アプリのインストール広告が一意になります。

広告グループ
アプリ ID
アプリプラットフォーム
Campaign
クライアント ID
カスタムパラメーター
デバイスの基本設定
編集上の申し立てステータス
編集場所
編集理由コード
編集状態
編集用語
最終 URL
最終 URL サフィックス
Id
変更時刻
Parent Id
発行元の国
状態
テキスト
Title
追跡テンプレート

広告グループ

広告を含む広告グループの名前。

追加： 読み取り専用と必須
更新： 読み取り専用と必須
削除： 読み取り専用と必須

注:

追加、更新、削除を行うには、[ 親 ID ] フィールドまたは [ 広告グループ ] フィールドを指定する必要があります。

アプリ ID

アプリストアによって提供されるアプリケーション識別子。

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

追加： 必須
更新： オプション。更新プログラムに値が設定されていない場合、この設定は変更されません。
削除： 読み取り専用

アプリプラットフォーム

アプリケーションプラットフォーム。

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

追加： 必須
更新： オプション。更新プログラムに値が設定されていない場合、この設定は変更されません。
削除： 読み取り専用

キャンペーン

広告グループと広告を含むキャンペーンの名前。

追加： 読み取り専用
更新： 読み取り専用
削除： 読み取り専用

クライアント ID

一括アップロードファイル内のレコードを結果ファイル内のレコードに関連付けるために使用されます。このフィールドの値は、サーバーによって使用または格納されません。アップロードされたレコードから対応する結果レコードにコピーされます。最大 100 の長さの任意の有効な文字列を指定できます。

追加： オプション
更新： オプション
削除： 読み取り専用

カスタムパラメーター

URL 追跡用のキーパラメーターと値パラメーターのカスタムコレクション。

一括ファイルでは、カスタムパラメーターの一覧は次のように書式設定されます。

各カスタムパラメーターペアを Key=Value (例: {_promoCode}=PROMO1) として書式設定します。
Microsoft Advertising は、含める最初の 8 つのカスタムパラメーターキーと値のペアを受け入れ、8 つ以上のカスタムパラメーターを含める場合はエラーが返されます。各キーと値のペアは、セミコロンとスペース ("; ") で区切られます (例: {_promoCode}=PROMO1;{_season}=summer.
Key にはセミコロンを含めることはできません。 Value にセミコロンが含まれている場合は、'\;' としてエスケープする必要があります。さらに、Value に円記号が含まれている場合は、'\' としてもエスケープする必要があります。
キーは 16 UTF-8 バイトを超えることはできません。値は 250 UTF-8 バイトを超えることはできません。キーは必須であり、値は省略可能です。 Key の最大サイズには、中かっことアンダースコア ('{'、'_'、'}' は含まれません。

注:

Bulk サービスでは、Key は周囲の中かっこと先頭のアンダースコアで書式設定する必要があります。たとえば、Key が promoCode の場合は、{_promoCode} として書式設定する必要があります。キャンペーン管理サービスでは、周囲の中かっことアンダースコアを指定できません。

追加： オプション
更新： オプション。更新プログラムに値が設定されていない場合、この設定は変更されません。すべてのカスタムパラメーターを削除するには、このフィールドを delete_value に設定します。 delete_value キーワード (keyword)では、前の設定が削除されます。カスタムパラメーターのサブセットを削除するには、保持するカスタムパラメーターを指定し、保持しないパラメーターを省略します。カスタムパラメーターの新しいセットは、以前のカスタムパラメーターセットに置き換えられます。
削除： 読み取り専用

デバイスの基本設定

このフィールドは、アプリのインストール広告をモバイルおよびタブレットデバイスに表示するか、モバイルデバイスにのみ表示するかを決定します。 (現在、デスクトップコンピューターではアプリのインストール広告はサポートされていません。

使用できる値は All (モバイルおよびタブレットデバイス) と Mobile (タブレットを除く) です。これは、キャンペーン管理サービスで使用される値とは異なります。

既定値は All です。

一括ダウンロードとアップロードの結果ファイルでは、このフィールドが空になることはありません。デバイスの基本設定を指定しなかった場合は、 既定値の All が返されます。

追加： オプション
更新： オプション。更新プログラムに値が設定されていない場合、この設定は変更されません。このフィールドを delete_value 文字列に設定すると、前の設定は削除されます。このフィールドを delete_value に設定すると、実質的に既定値の All にリセットされます。
削除： 読み取り専用

編集上の申し立てステータス

編集レビューで見つかった問題に異議を申し立てることができるかどうかを判断します。

使用可能な値については、次の表を参照してください。

値	説明
上訴可能	編集上の問題は申し立て可能です。
異議申し立て中	編集上の問題は控訴可能であり、控訴が提出されました。
NotAppealable	編集上の問題は不服として申し立てられない。

追加： 読み取り専用
更新： 読み取り専用
削除： 読み取り専用

編集場所

編集レビューに失敗した広告のコンポーネントまたはプロパティ。

追加： 読み取り専用
更新： 読み取り専用
削除： 読み取り専用

編集理由コード

エラーの理由を識別するコード。考えられる理由コードの一覧については、「編集理由コード」を参照してください。

追加： 読み取り専用
更新： 読み取り専用
削除： 読み取り専用

編集状態

広告の編集状態。

使用可能な値については、次の表を参照してください。

値	説明
アクティブ	広告は編集レビューに合格しました。
ActiveLimited	広告は 1 つ以上の市場で編集レビューに合格し、広告の 1 つ以上の要素が別の市場で編集レビューを受けています。たとえば、広告はカナダの編集レビューに合格し、米国のレビューがまだ保留中です。
不承認	広告の編集レビューに失敗しました。
非アクティブ	広告の 1 つ以上の要素が編集レビュー中です。

追加： 読み取り専用
更新： 読み取り専用
削除： 読み取り専用

編集用語

編集レビューに失敗した用語。

用語の組み合わせによってエラーが発生した場合、またはポリシー違反に基づいて失敗した場合、このフィールドは設定されません。

追加： 読み取り専用
更新： 読み取り専用
削除： 読み取り専用

最終 URL

検索ユーザーがアクセスし、アプリのインストールを選択できる URL。

アプリインストール広告の 最終 URL には 、次の検証規則が適用されます。

URL の長さは 2,048 文字に制限されています。 HTTP または HTTPS プロトコル文字列は、2,048 文字の制限にカウントされます。
このフィールドに指定できる URL は 1 つだけです。
'{' と '}' の使用は、"{lpurl}" などのタグのみを示すために許可されます。
各 URL は、http:// または https:// で始まる整形式の URL である必要があります。

追加： 必須
更新： オプション。更新プログラムに値が設定されていない場合、この設定は変更されません。
削除： 読み取り専用

最終 URL サフィックス

最後の URL サフィックスには、ランディングページ URL の末尾に追加される追跡パラメーターを含めることができます。顧客が常にランディングページに送信されるように、ランディングページで必要な追跡パラメーターを最終的な URL サフィックスに配置することをお勧めします。詳細と検証規則については、テクニカルガイドの「最終 URL サフィックス」を参照してください。

追加： オプション
更新： オプション。更新プログラムに値が設定されていない場合、この設定は変更されません。このフィールドを delete_value 文字列に設定すると、前の設定は削除されます。
削除： 読み取り専用

Id

広告のシステム生成識別子。

追加： オプション。このフィールドは空のままにするか、負の識別子を指定する必要があります。その後、広告の負の識別子セットは、アプリのインストール広告ラベルなどの依存レコードの種類の [親 ID] フィールドで参照できます。これは、同じ Bulk ファイルに新しい広告と新しい依存レコードを追加する場合に推奨されます。詳細については、「一括ファイルスキーマ参照キー」を参照してください。
更新： 読み取り専用と必須
削除： 読み取り専用と必須

変更時刻

エンティティが最後に更新された日付と時刻。値は、世界協定時刻 (UTC) です。

注:

日付と時刻の値は、クライアントではなく、サーバーでの日付と時刻を反映します。日付と時刻の形式については、「プリミティブ XML データ型」の dateTime エントリを参照してください。

追加： 読み取り専用
更新： 読み取り専用
削除： 読み取り専用

Parent Id

広告を含む広告グループのシステム生成識別子。

この一括フィールドは、広告グループレコードの Id フィールドにマップされます。

追加： 読み取り専用と必須。既存の広告グループ識別子を指定するか、親広告グループレコードの Id フィールドと等しい負の識別子を指定する必要があります。これは、同じ Bulk ファイル内の新しい広告グループに新しい広告を追加する場合に推奨されます。詳細については、「一括ファイルスキーマ参照キー」を参照してください。
更新： 読み取り専用
削除： 読み取り専用

注:

追加、更新、削除を行うには、[ 親 ID ] フィールドまたは [ 広告グループ ] フィールドを指定する必要があります。

発行元の国

編集ガイドラインで指定した用語が許可されていない発行元の国または地域の一覧。

一括ファイルでは、発行元の国またはリージョンの一覧はセミコロン (;)で区切られます。

追加： 読み取り専用
更新： 読み取り専用
削除： 読み取り専用

状態

広告の状態。

使用可能な値は、 アクティブ、 一時停止、または 削除です。

追加： オプション。既定値は [アクティブ] です。
更新： オプション。更新プログラムに値が設定されていない場合、この設定は変更されません。
削除： 必須。 [状態] を [削除済み] に設定する必要があります。

テキスト

広告のコピー。コピーには、少なくとも 1 つの単語が含まれている必要があります。広告のコピーとタイトルの組み合わせには、少なくとも 3 つの単語を合計する必要があります。

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

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

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

追加： 必須
更新： オプション。更新プログラムに値が設定されていない場合、この設定は変更されません。
削除： 読み取り専用

タイトル

広告のタイトル。タイトルには、少なくとも 1 つの単語が含まれている必要があります。広告のコピーとタイトルの組み合わせには、少なくとも 3 つの単語を合計する必要があります。

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

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

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

追加： 必須
更新： オプション。更新プログラムに値が設定されていない場合、この設定は変更されません。
削除： 読み取り専用

追跡テンプレート

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 は同じになります。

次の方法で共有

アプリのインストールの広告レコード - 一括

広告グループ

アプリ ID

アプリプラットフォーム

キャンペーン

クライアント ID

カスタムパラメーター

デバイスの基本設定

編集上の申し立てステータス

編集場所

編集理由コード

編集状態

編集用語

最終 URL

最終 URL サフィックス

Id

変更時刻

Parent Id

発行元の国

状態

テキスト

タイトル

追跡テンプレート

その他のリソース

次の方法で共有

アプリのインストールの広告レコード - 一括

広告グループ

アプリ ID

アプリ プラットフォーム

キャンペーン

クライアント ID

カスタム パラメーター

デバイスの基本設定

編集上の申し立てステータス

編集場所

編集理由コード

編集状態

編集用語

最終 URL

最終 URL サフィックス

Id

変更時刻

Parent Id

発行元の国

状態

テキスト

タイトル

追跡テンプレート

その他のリソース

アプリプラットフォーム

カスタムパラメーター