REST Resource: properties.dataStreams.sKAdNetworkConversionValueSchema

منبع: SKAdNetworkConversionValueSchema

طرحواره ارزش تبدیل SKAdNetwork از یک جریان iOS.

نمایش JSON 
{
  "name": string,
  "postbackWindowOne": {
    object (PostbackWindow)
  },
  "postbackWindowTwo": {
    object (PostbackWindow)
  },
  "postbackWindowThree": {
    object (PostbackWindow)
  },
  "applyConversionValues": boolean
}
فیلدها
name

string

شناسه. نام منبع طرحواره. این فقط فرزند یک جریان iOS خواهد بود و حداکثر می‌تواند یک فرزند از این نوع تحت یک جریان iOS وجود داشته باشد. قالب: properties/{property}/dataStreams/{dataStream}/sKAdNetworkConversionValueSchema

postbackWindowOne

object ( PostbackWindow )

الزامی. تنظیمات مقدار تبدیل برای اولین پنجره‌ی پست‌بک. این تنظیمات با مقادیر پنجره‌های پست‌بک دو و سه متفاوت است، زیرا حاوی یک مقدار تبدیل دانه‌بندی‌شده‌ی «دقیق» (یک مقدار عددی) هستند.

مقادیر تبدیل برای این پنجره‌ی postback باید تنظیم شوند. پنجره‌های دیگر اختیاری هستند و در صورت تنظیم نشدن یا غیرفعال بودن، ممکن است تنظیمات این پنجره را به ارث ببرند.

postbackWindowTwo

object ( PostbackWindow )

تنظیمات مقدار تبدیل برای پنجره‌ی پست‌بک دوم.

این فیلد فقط در صورتی باید پیکربندی شود که نیاز به تعریف مقادیر تبدیل مختلف برای این پنجره‌ی پست‌بک باشد.

اگر enable_postback_window_settings برای این پنجره‌ی پست‌بک روی false تنظیم شده باشد، از مقادیر postbackWindowOne استفاده خواهد شد.

postbackWindowThree

object ( PostbackWindow )

تنظیمات مقدار تبدیل برای پنجره‌ی سومِ ارسالِ اطلاعات.

این فیلد فقط در صورتی باید تنظیم شود که کاربر تصمیم به تعریف مقادیر تبدیل مختلف برای این پنجره postback داشته باشد. پیکربندی پنجره ۳ بدون تنظیم پنجره ۲ مجاز است. در صورتی که تنظیمات پنجره ۱ و ۲ تنظیم شده باشند و enable_postback_window_settings برای این پنجره postback روی false تنظیم شده باشد، طرحواره تنظیمات را از postbackWindowTwo به ارث می‌برد.

applyConversionValues

boolean

در صورت فعال بودن، GA SDK مقادیر تبدیل را با استفاده از این تعریف طرحواره تنظیم می‌کند و طرحواره به هر حساب Google Ads مرتبط با این ویژگی صادر می‌شود. در صورت غیرفعال بودن، GA SDK به طور خودکار مقادیر تبدیل را تعیین نمی‌کند و همچنین طرحواره به Ads صادر نمی‌شود.

پنجره پس‌پست

تنظیمات مربوط به پنجره‌ی پست‌بک تبدیل SKAdNetwork.

نمایش JSON 
{
  "conversionValues": [
    {
      object (ConversionValues)
    }
  ],
  "postbackWindowSettingsEnabled": boolean
}
فیلدها
conversionValues[]

object ( ConversionValues )

ترتیب فیلد تکرار شده برای اولویت‌بندی تنظیمات مقدار تبدیل استفاده می‌شود. ورودی‌های با شاخص پایین‌تر، اولویت بالاتری دارند. اولین تنظیم مقدار تبدیل که مقدار آن درست باشد انتخاب خواهد شد. اگر enable_postback_window_settings روی درست تنظیم شده باشد، باید حداقل یک ورودی داشته باشد. حداکثر می‌تواند ۱۲۸ ورودی داشته باشد.

postbackWindowSettingsEnabled

boolean

اگر enable_postback_window_settings درست باشد، conversionValues ​​باید پر شوند و برای تعیین زمان و نحوه تنظیم Conversion Value روی دستگاه کلاینت و خروجی گرفتن از schema به حساب‌های تبلیغات لینک‌شده استفاده می‌شوند. اگر نادرست باشد، تنظیمات استفاده نمی‌شوند، اما در صورتی که در آینده مورد استفاده قرار گیرند، حفظ می‌شوند. این همیشه باید برای postbackWindowOne درست باشد.

مقادیر تبدیل

تنظیمات مقدار تبدیل برای پنجره‌ی پست‌بک برای طرحواره‌ی مقدار تبدیل SKAdNetwork.

نمایش JSON 
{
  "displayName": string,
  "coarseValue": enum (CoarseValue),
  "eventMappings": [
    {
      object (EventMapping)
    }
  ],
  "lockEnabled": boolean,
  "fineValue": integer
}
فیلدها
displayName

string

نام نمایشی مقدار تبدیل SKAdNetwork. حداکثر طول مجاز نام نمایشی ۵۰ واحد کد UTF-16 است.

coarseValue

enum ( CoarseValue )

الزامی. مقدار تبدیل دانه درشت.

تضمین نمی‌شود که این مقدار منحصر به فرد باشد.

eventMappings[]

object ( EventMapping )

شرایط رویدادی که باید برای دستیابی به این مقدار تبدیل رعایت شوند. شرایط موجود در این لیست با هم AND می‌شوند. در صورت فعال بودن پنجره postback، باید حداقل ۱ ورودی و حداکثر ۳ ورودی داشته باشد.

lockEnabled

boolean

اگر درست باشد، SDK باید برای پنجره‌ی postback فعلی به این مقدار تبدیل قفل شود.

fineValue

integer

مقدار تبدیل دقیق. این مقدار فقط برای اولین پنجره postback قابل استفاده است. مقادیر معتبر آن [0،63] هستند، که شامل هر دو می‌شود. باید برای پنجره postback 1 تنظیم شود و نباید برای پنجره postback 2 و 3 تنظیم شود. تضمین نمی‌شود که این مقدار منحصر به فرد باشد.

اگر پیکربندی اولین پنجره‌ی پست‌بک برای پنجره‌های پست‌بک دوم یا سوم دوباره استفاده شود، این فیلد هیچ تاثیری نخواهد داشت.

مقدار درشت

مقدار تبدیل تقریبی که در فراخوانی SDK مربوط به updatePostbackConversionValue تنظیم می‌شود، زمانی که شرایط ConversionValues.event_mappings برقرار باشد. برای اطلاعات بیشتر، به SKAdNetwork.CoarseConversionValue مراجعه کنید.

انوم‌ها
COARSE_VALUE_UNSPECIFIED مقدار درشت مشخص نشده است.
COARSE_VALUE_LOW مقدار کم یا زیاد.
COARSE_VALUE_MEDIUM مقدار درشت یا متوسط.
COARSE_VALUE_HIGH مقدار درشتِ زیاد.

نقشه‌برداری رویداد

شرایط تنظیم رویداد برای مطابقت با یک رویداد.

نمایش JSON 
{
  "eventName": string,
  "minEventCount": string,
  "maxEventCount": string,
  "minEventValue": number,
  "maxEventValue": number
}
فیلدها
eventName

string

الزامی. نام رویداد گوگل آنالیتیکس. همیشه باید تنظیم شود. حداکثر طول مجاز نام نمایشی ۴۰ واحد کد UTF-16 است.

minEventCount

string ( int64 format)

حداقل یکی از چهار مقدار حداقل/حداکثر زیر باید تنظیم شود. مقادیر تنظیم شده با هم AND می‌شوند تا یک رویداد را تعیین کنند. حداقل تعداد دفعاتی که رویداد رخ داده است. در صورت عدم تنظیم، حداقل تعداد رویداد بررسی نخواهد شد.

maxEventCount

string ( int64 format)

حداکثر تعداد دفعاتی که رویداد رخ داده است. اگر تنظیم نشود، حداکثر تعداد رویداد بررسی نخواهد شد.

minEventValue

number

حداقل درآمد حاصل از رویداد. واحد پول درآمد در سطح ویژگی تعریف می‌شود. در صورت عدم تنظیم، حداقل مقدار رویداد بررسی نخواهد شد.

maxEventValue

number

حداکثر درآمد حاصل از رویداد. واحد پول درآمد در سطح ویژگی تعریف می‌شود. در صورت عدم تنظیم، حداکثر مقدار رویداد بررسی نخواهد شد.

روش‌ها

create

 یک SKAdNetworkConversionValueSchema ایجاد می‌کند.

delete

 طرحواره‌ی SKAdNetworkConversionValueSchema هدف را حذف می‌کند.

get

 یک SKAdNetworkConversionValueSchema واحد را جستجو می‌کند.

list

 SKAdNetworkConversionValueSchema را در یک جریان لیست می‌کند.

patch

 یک SKAdNetworkConversionValueSchema را به‌روزرسانی می‌کند.