オフライン変換レコード - 一括

一括ファイルにアップロードできるオフライン変換を定義します。

注:

一括ダウンロードはサポートされていません。

オフライン コンバージョンを追加、修正 (更新)、または restract (削除) できます。

• オフライン変換をアップロードするには、[ 換算通貨コード]、[ 換算名]、[ 変換時間]、[ 換算値]、[ Microsoft Click Id] の各フィールドを設定します。
• 以前にアップロードしたオフラインコンバージョンを必要に応じて修正するには、[ 調整の種類 ] フィールドを "Restate" に設定し、元の [コンバージョン名]、[ 変換時間]、および [Microsoft Click Id] フィールドを 設定します。 調整値、調整時間、調整通貨コードなど、同じレコードに調整を含めます。
• 以前にアップロードしたオフラインコンバージョンを必要に応じて取り消すか削除するには、[ 調整の種類 ] フィールドを [取り消し] に設定し、元の [コンバージョン名]、[ 変換時間]、および [Microsoft Click Id] フィールドを 設定します。

オフラインコンバージョントラッキングを設定するには、 OfflineConversionGoal を作成します。 OfflineConversionGoal の CountType を [すべて] に設定すると、変換時間が異なる同じ MicrosoftClickId のすべてのオフライン変換が累積的に追加されます。 OfflineConversionGoal の CountType を [一意] に設定した場合、広告のクリック後に発生した最初のコンバージョンのみがカウントされます。 同じ MicrosoftClickId と ConversionTime を使用したオフライン変換の重複は無視されます。 つまり、特定の MicrosoftClickId と ConversionTime の最初のオフライン変換のみがカウントされます。

重要

OfflineConversionGoal が設定されたら、2 時間待ってから、ApplyOfflineConversions 操作を介して Microsoft Advertising の OfflineConversion データを送信します。 Microsoft Advertising レポートでコンバージョン データを表示するには、最大 5 時間かかることがあります。

IsExternallyAttributed プロパティを設定するには、Campaign Management API を使用して OfflineConversionGoal を作成する必要があります。

広告のクリック後のベスト プラクティスとして、オフライン コンバージョンをアップロードする前に 1 時間待つ必要があります。

注:

機能テストのためにサンドボックスにオフライン変換をアップロードすることはできますが、オフライン変換データはサンドボックスのパフォーマンス レポート データには含まれません。

次の一括 CSV の例では、新しいオフライン変換を追加します。

Type,Status,Id,Parent Id,Client Id,Name,Conversion Currency Code,Conversion Name,Conversion Time,Conversion Value,Microsoft Click Id
Format Version,,,,,6.0,,,,,
Offline Conversion,,,,ClientIdGoesHere,,USD,My Goal Name,4/1/2020 6:50:54 PM,10,f894f652ea334e739002f7167ab8f8e3

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

var uploadEntities = new List<BulkEntity>();

// Map properties in the Bulk file to the BulkOfflineConversion
var bulkOfflineConversion = new BulkOfflineConversion
{
    // 'Client Id' column header in the Bulk file
    ClientId = "ClientIdGoesHere",

    // Map properties in the Bulk file to the 
    // Label object of the Campaign Management service.
    OfflineConversion = new OfflineConversion
    {
        // 'Conversion Currency Code' column header in the Bulk file
        ConversionCurrencyCode = "USD",
        // 'Conversion Name' column header in the Bulk file
        ConversionName = "My Goal Name",
        // 'Conversion Time' column header in the Bulk file
        ConversionTime = DateTime.UtcNow,
        // 'Conversion Value' column header in the Bulk file
        ConversionValue = 10,
        // 'Microsoft Click Id' column header in the Bulk file
        MicrosoftClickId = "f894f652ea334e739002f7167ab8f8e3"
    },

    // 'Adjustment Currency Code' column header in the Bulk file
    AdjustmentCurrencyCode = null,

    // 'Adjustment Time' column header in the Bulk file
    AdjustmentTime = null,

    // 'Adjustment Type' column header in the Bulk file
    AdjustmentType = null,

    // 'Adjustment Value' column header in the Bulk file
    AdjustmentValue = null,

    // 'External Attribution Credit' column header in the Bulk file
    ExternalAttributionCredit = null,

    // 'External Attribution Model' column header in the Bulk file
    ExternalAttributionModel = null,

    // 'Hashed Email Address' column header in the Bulk file
    HashedEmailAddress = null,

    // 'Hashed Phone Number' column header in the Bulk file
    HashedPhoneNumber = null
};

uploadEntities.Add(bulkOfflineConversion);

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

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

オフライン変換レコードの場合は、一括ファイル スキーマで次の属性フィールドを使用できます。

• 調整通貨コード
• 調整時間
• 調整の種類
• 調整値
• クライアント ID
• 換算通貨コード
• 変換名
• 変換時間
• 変換値
• 外部属性クレジット
• 外部属性モデル
• ハッシュされたEmail アドレス
• ハッシュ電話番号
• Microsoft Click Id

調整通貨コード

保存されたオフライン換算の通貨コード。

詳細については、「 通貨」を参照してください。

追加： 該当なし
言い換える： 必須。 修正を使用して調整通貨コードを指定しない場合は、目標の ConversionGoalRevenue の CurrencyCode 要素が使用されます。
撤回： 該当なし

調整時間

調整が行われた日時。

調整時間を元のオフライン 変換日時より早くすることはできません。

重要

値は協定世界時 (UTC) である必要があります。 これは、Microsoft Advertising Web アプリケーションでオフライン コンバージョンをアップロードするときのタイム ゾーン オプションとは異なります。 日付と時刻の形式については、「 プリミティブ XML データ型」の dateTime エントリを参照してください。

追加： 該当なし
言い換える： 必須
撤回： 必須

調整の種類

オフライン変換を取り消すか、リレートするかを決定します。

この値が "Restate" の場合、指定した Microsoft Click Id に以前に属性が設定されていたオフライン変換は、新しい 調整通貨コード、 調整時間、および 調整値に従って調整されます。

この値が "取り消し" の場合、指定した Microsoft Click Id に以前に属性が設定されていたオフライン変換は取り消されるか削除されます。

追加： 該当なし
言い換える： 必須。 このフィールドは "Restate" に設定する必要があります。
撤回： 必須。 このフィールドは "取り消し" に設定する必要があります。

調整値

調整されたオフライン変換値。

追加： 該当なし
言い換える： 必須
撤回： 該当なし

クライアント ID

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

追加： オプション
言い換える： オプション
撤回： オプション

換算通貨コード

オフライン変換の通貨コード。

詳細については、「 通貨」を参照してください。

追加： オプション。 オフライン換算通貨コードを指定しない場合は、目標の ConversionGoalRevenue の CurrencyCode 要素が使用されます。
言い換える： 該当なし
撤回： 該当なし

変換名

変換目標名。

この名前は既存のコンバージョン目標名と一致する必要があります。それ以外の場合、オフラインコンバージョン目標データは適用されません。

追加： 必須
言い換える： 必須
撤回： 必須

変換時間

オフライン変換が発生した日時。

日付と時刻は過去 90 日以内である必要があります。それ以外の場合、Microsoft Advertising にオフライン変換データを送信しようとすると、操作は失敗します。

重要

値は協定世界時 (UTC) である必要があります。 これは、Microsoft Advertising Web アプリケーションでオフライン コンバージョンをアップロードするときのタイム ゾーン オプションとは異なります。 日付と時刻の形式については、「 プリミティブ XML データ型」の dateTime エントリを参照してください。

アップロードが成功した後にオフラインコンバージョンとして Microsoft Advertising によってカウントされるには、次の追加要件を満たす必要があります。

• 変換の日時は、記録されたクリックの日時より後に設定する必要があります。
• 日付と時刻は、変換ウィンドウ内にある必要があります。 OfflineConversionGoal の ConversionWindowInMinutes プロパティは、コンバージョンが追跡されるクリック後の最大時間 (分) を決定します。

たとえば、4 月 30 日に 3 回のクリックが記録された場合、OfflineConversionGoal の ConversionWindowInMinutes が 30 日 (43200 分) に等しく、7 月 31 日に Microsoft Advertising に次のオフラインコンバージョンを送信した場合、Microsoft Advertising は MicrosoftClickId=2 をオフラインコンバージョンとしてカウントします。

• MicrosoftClickId=1;ConversionTime=2020-04-30T17:02:35.6853793Z
• MicrosoftClickId=2;ConversionTime=2020-05-15T17:02:35.6853793Z
• MicrosoftClickId=3;ConversionTime=2020-06-15T17:02:35.6853793Z

MicrosoftClickId=1 のオフライン変換データは、変換日時が 90 日以上前であるためアップロードされません。また、MicrosoftClickId=3 のオフライン変換データは、変換ウィンドウ (4 月 30 日から 5 月 29 日) に含まれていないためカウントされません。

追加： 必須
言い換える： 必須
撤回： 必須

変換値

オフライン変換値。

追加： オプション。 オフライン変換値を指定しない場合は、目標の ConversionGoalRevenue の Value 要素が使用されます。
言い換える： 該当なし
撤回： 該当なし

外部属性クレジット

このフィールドは、外部属性を使用するコンバージョン アクションにのみ設定できます。 これは、各クリックに起因する変換の割合を表します。 値は 0 より大きく、1 以下である必要があります。

このフィールドが外部属性以外の変換アクションで使用されている場合、GoalNotEligibleForExternalAttribution エラーが返されます。

適用： オプション

外部属性モデル

このフィールドは、外部属性を使用するコンバージョン アクションにのみ設定できます。 属性モデル名を指定します。

このフィールドが外部属性以外の変換アクションで使用されている場合、GoalNotEligibleForExternalAttribution エラーが返されます。

適用： オプション

ハッシュされたEmail アドレス

拡張変換で使用する SHA-256 アルゴリズムを使用したハッシュされた電子メール アドレス。

追加： 拡張変換に必要です。
言い換える： 拡張変換に必要です。
撤回： 拡張変換に必要です。

ハッシュ電話番号

拡張変換で使用する E.164 標準に従ったハッシュ電話番号。

追加： 拡張変換に必要です。
言い換える： 拡張変換に必要です。
撤回： 拡張変換に必要です。

Microsoft Click Id

オフライン変換の MSCLKID。

Microsoft のクリック ID 追跡で自動タグ付けが有効になっていることを確認するには、アカウント レコードの MSCLKID 自動タグ付け有効フィールドを使用します。

追加： 必須
言い換える： 必須
撤回： 必須