ApplyOfflineConversionAdjustments 操作を使用してオフライン コンバージョンを撤回または再宣言するオブジェクトを定義します。
ApplyOfflineConversions 操作を使用して、以前に適用したオフライン変換の変換時間と値を調整できます。
構文
<xs:complexType name="OfflineConversionAdjustment" xmlns:xs="http://www.w3.org/2001/XMLSchema">
<xs:sequence>
<xs:element minOccurs="0" name="AdjustmentCurrencyCode" nillable="true" type="xs:string" />
<xs:element minOccurs="0" name="AdjustmentTime" type="xs:dateTime" />
<xs:element minOccurs="0" name="AdjustmentType" nillable="true" type="xs:string" />
<xs:element minOccurs="0" name="AdjustmentValue" nillable="true" type="xs:double" />
<xs:element minOccurs="0" name="ConversionName" nillable="true" type="xs:string" />
<xs:element minOccurs="0" name="ConversionTime" type="xs:dateTime" />
<xs:element minOccurs="0" name="HashedEmailAddress" nillable="true" type="xs:string">
<xs:annotation>
<xs:appinfo>
<DefaultValue EmitDefaultValue="false" xmlns="http://schemas.microsoft.com/2003/10/Serialization/" />
</xs:appinfo>
</xs:annotation>
</xs:element>
<xs:element minOccurs="0" name="HashedPhoneNumber" nillable="true" type="xs:string">
<xs:annotation>
<xs:appinfo>
<DefaultValue EmitDefaultValue="false" xmlns="http://schemas.microsoft.com/2003/10/Serialization/" />
</xs:appinfo>
</xs:annotation>
</xs:element>
<xs:element minOccurs="0" name="MicrosoftClickId" nillable="true" type="xs:string" />
</xs:sequence>
</xs:complexType>
要素
OfflineConversionAdjustment オブジェクトには、AdjustmentCurrencyCode、AdjustmentTime、AdjustmentType、AdjustmentValue、ConversionName、ConversionTime、HashedEmailAddress、HashedPhoneNumber、MicrosoftClickId という要素があります。
要素 | 説明 | データ型 |
---|---|---|
AdjustmentCurrencyCode | 保存されたオフライン換算の通貨コード。 詳細については、「 通貨」を参照してください。 申し込む:AdjustmentType が "Restate" に設定され、それ以外の場合、このフィールドは無視されます。 修正を使用して調整通貨コードを指定しない場合は、目標の ConversionGoalRevenue の CurrencyCode 要素が使用されます。 |
string |
AdjustmentTime | 調整が行われた日時。 調整時間を元のオフライン 変換日時より早くすることはできません。 大事な: 値は協定世界時 (UTC) である必要があります。 これは、Microsoft Advertising Web アプリケーションでオフライン コンバージョンをアップロードするときのタイム ゾーン オプションとは異なります。 日付と時刻の形式については、「 プリミティブ XML データ型」の dateTime エントリを参照してください。 申し込む: 必須 |
dateTime |
AdjustmentType | オフライン変換を取り消すか、リレートするかを決定します。 この値が "Restate" の場合、指定した MicrosoftClickId に以前に属性が設定されていたオフライン変換は、新しい AdjustCurrencyCode、 AdjustTime、および AdjustValue に従って調整されます。 この値が "取り消し" の場合、指定した MicrosoftClickId に以前に属性が設定されていたオフライン変換は取り消されるか削除されます。 申し込む: 必須 |
string |
AdjustmentValue | 調整されたオフライン変換値。 申し込む:AdjustmentType が "Restate" に設定されている場合は必須です。それ以外の場合は、このフィールドを設定しないでください。 |
複 |
ConversionName | 変換目標名。 この名前は既存のコンバージョン目標名と一致する必要があります。それ以外の場合、オフラインコンバージョン目標データは適用されません。 申し込む: 必須 |
string |
ConversionTime | 元のオフライン変換が発生した日時。 日付と時刻は過去 90 日以内である必要があります。それ以外の場合、Microsoft Advertising にオフライン変換データを送信しようとすると、操作は失敗します。 アップロードが成功した後にオフラインコンバージョンとして 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 日) に含まれていないためカウントされません。 大事な: 値は協定世界時 (UTC) である必要があります。 これは、Microsoft Advertising Web アプリケーションでオフライン コンバージョンをアップロードするときのタイム ゾーン オプションとは異なります。 日付と時刻の形式については、「 プリミティブ XML データ型」の dateTime エントリを参照してください。 申し込む: 必須 |
dateTime |
HashedEmailAddress | 拡張変換で使用する SHA-256 アルゴリズムを使用したハッシュされた電子メール アドレス。 | string |
HashedPhoneNumber | 拡張変換で使用する E.164 標準に従ったハッシュ電話番号。 | string |
MicrosoftClickId | オフライン変換の MSCLKID。 Microsoft のクリック ID 追跡で自動タグ付けが有効になっていることを確認するには、 GetAccountProperties 操作と SetAccountProperties 操作を 使用します。 申し込む: 随意 注: 拡張変換用にハッシュされたメール アドレスまたは電話番号を指定する場合、MSCLKID は省略可能です。 |
string |
要件
サービス: CampaignManagementService.svc v13
Namespace: https://bingads.microsoft.com/CampaignManagement/v13