アプリのインストールの目標レコード - 一括
アプリ インストールのコンバージョン目標を定義します。 この種類の目標を使用して、一括ファイルでダウンロードおよびアップロードできる conversion.list としてアプリをインストールするたびに追跡します。
AppInstallGoals の DownloadCampaignsByAccountIds または DownloadCampaignsByCampaignIds サービス要求に DownloadEntity 値を含めることで、アカウント内のすべての App Install Goal レコードをダウンロードできます。 さらに、ダウンロード要求には EntityData スコープを含める必要があります。 ベスト プラクティスを含む一括サービスの詳細については、「 一括ダウンロードとアップロード」を参照してください。
次の一括 CSV の例では、新しいアプリのインストール目標を追加します。
Type,Id,Attribution Model Type,Count Type,Exclude From Bidding,Goal Category,Is Enhanced Conversions Enabled,Name,Conversion Currency Code,Revenue Value,Revenue Type,Scope,UET Tag Id,Status,View Through Conversion Window In Minutes,Conversion Window In Minutes,Category Expression,Category Operator,Action Expression,Action Operator,Label Expression,Label Operator,Event Value,Event Value Operator,URL Expression,URL Operator,Minimum Duration In Second,App Platform,App Id,Minimum Pages Viewed
Format Version,,,,,,,6.0,,,,,,,,,,,,,,,,,,,,,,
AppInstall Goal,,,,False,Download,False,GoalE,USD,1,FixedValue,Account,,Active,150,367,,,,,,,,,,,,Android,qazwsx,
App Install Goal レコードの場合、一括ファイル スキーマでは次の属性フィールドを使用できます。
アプリ プラットフォーム
アプリケーション プラットフォーム。
使用できる値は 、Android、 iOS、 Windows 、 WindowsPhone です。
追加: 必須
更新: 省略可能
App Store ID
アプリ ストアによって提供されるアプリケーション識別子。
追加: 必須
更新: 省略可能
変換ウィンドウ (分単位)
変換ウィンドウは、コンバージョンを追跡するクリック後の時間 (分) です。 この値を 43200 分 (30 日) に設定した場合、クリックが追跡されてから 30 日以内に発生するコンバージョン。 過去のコンバージョンは影響を受けません。 サポートされる最小値は 1 分ですが、コンバージョン期間が短いほどアカウント レコードのコンバージョン数が減ります。 サポートされる最大値は 129600 分 (90 日) です。
追加: 省略可能
更新: 省略可能
カウントの種類
この変換目標に関連するデータをパフォーマンス レポート列のサブセットから除外するかどうかを指定します。
この要素は、[コンバージョンに含める] 機能が有効になっているお客様にのみ使用できます (GetCustomerPilotFeatures は 574 を返します)。
この要素が true に設定されている場合、それ以外の場合、この変換目標に関連するデータは、、、、RevenuePerConversion、およびRevenueレポート列からConversions除外されます。 ReturnOnAdSpendCostPerConversionConversionRate また、自動入札戦略を使用する場合、このプロパティを true に設定すると、目標のコンバージョンが自動入札計算に考慮されなくなります。 このプロパティを "true" に設定することは、実質的に Microsoft Advertising Web アプリケーションで [コンバージョンに含める] をオフにした場合と同じです。
この要素の値に関係なく、、AllConversionRate、AllConversionsAllCostPerConversion、AllReturnOnAdSpend、AllRevenuePerConversion、およびAllRevenueレポート列には、すべての変換目標のデータが含まれます。 既定では、この要素は false であり、この変換目標に関連するデータはすべてのレポート列に含まれます。
詳細については、「 レポート属性とパフォーマンス統計」と ヘルプ記事 「コンバージョンの目標: "コンバージョン" と "すべてのコンバージョン"」を参照してください。
追加: 省略可能
更新: 省略可能
目標カテゴリ
変換目標をセグメント化するために使用されるカテゴリ。
ただし、コンバージョン目標を分類することは、ビジネスにとって意味があります。 目標カテゴリはパフォーマンスに影響しません。目標とそのパフォーマンス メトリックをセグメント化するのに役立ちます。
サポートされているカテゴリ値は、コンバージョン目標の種類によって異なります。 アプリのインストールの目標は 、[ダウンロード ] カテゴリのみをサポートします。
追加: 省略可能。 この要素を nil または空のままにすると、既定のカテゴリが [ダウンロード] に設定されます。
更新: 省略可能。 更新プログラムに値が設定されていない場合、この設定は変更されません。
Id
変換目標の一意の Microsoft Advertising 識別子。
追加： 読み 取り 専用
更新： 読み取り専用と必須
拡張変換が有効になっています
コンバージョン目標に対して拡張コンバージョンを有効にするかどうかを決定します。
注: 拡張変換目標を作成して設定 isEnhancedConversionsEnabled=trueするには、Microsoft Advertising UI を使用してアカウントのコンバージョン目標を作成し、拡張変換設定を選択し、関連付けられているチェック ボックスをオンにする必要があります。
追加: 省略可能
更新: 省略可能
名前
変換目標名。
名前の最大長は 100 で、名前は同じ顧客に属するすべてのコンバージョン目標の中で一意である必要があります。
追加: 必須
更新: 省略可能
収益の種類
各コンバージョンがビジネスにどの程度価値を持っているかを決定します。
コンバージョン目標を更新するときに、Revenue 要素が nil または空の場合、入れ子になったプロパティは更新されません。 ただし、この要素が nil または空でない場合は、既存の収益プロパティを効果的に置き換えます。
VariableValue オプションは、アプリのインストールコンバージョン目標には使用できません。
追加: 省略可能
更新: 省略可能
範囲
目標がすべてのアカウントに適用されるか、必要な CustomerAccountId ヘッダー要素で指定されたアカウントにのみ適用されるかを決定します。 複数の Microsoft Advertising アカウントがある場合は、それらのすべてのアカウントでコンバージョンを追跡できます。 目標を 1 つのアカウントに関連付けた場合、コンバージョンはそのアカウントに対してのみ追跡されます。
アプリのインストールの目標の場合、アカウント レベルのスコープはサポートされていません。 この要素は Customer に設定することも、そのままにすることもできます。 指定しない場合、スコープは既定で Customer に設定されます。
追加: 省略可能
更新: 省略可能
状態
コンバージョン目標の可能なユーザーが決定する状態の値を定義します。 これらは、ユーザーが設定できる状態の値です。たとえば、その目標のコンバージョンを追跡する必要がなくなった場合は、目標を [一時停止 ] に設定できます。
システムによって設定できる状態値については、 TrackingStatus 要素を参照してください。
追加: 省略可能
更新: 省略可能
確認状況
コンバージョン目標の可能なシステムが決定する状態の値を定義します。 これらは、システムによって設定できるステータス値です。たとえば、過去 7 日以内にコンバージョンが記録されている場合、システムは状態を RecordingConversions に設定します。
アプリのインストール変換の目標には、 NoRecentConversions と RecordingConversions の状態のみが適用されます。
ユーザーが設定できる状態値については、たとえば、その目標のコンバージョンを追跡する必要がなくなった場合に状態を [一時停止 ] に設定する場合は、Status 要素を参照してください。
追加: 読み取り専用
更新: 読み取り専用
種類
変換目標の種類。 この値は、アプリのインストールの目標を取得するときに AppInstall です。 変換目標の種類の詳細については、「 ConversionGoal Data Object 解説」を参照してください。
追加: 読み取り専用
更新: 読み取り専用