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 وجود داشته باشد. قالب: خواص/{property}/dataStreams/{dataStream}/sKAdNetworkConversionValueSchema

postbackWindowOne

object ( PostbackWindow )

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

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

postbackWindowTwo

object ( PostbackWindow )

تنظیمات ارزش تبدیل برای دومین پنجره پس‌بازگشت.

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

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

postbackWindowThree

object ( PostbackWindow )

تنظیمات ارزش تبدیل برای سومین پنجره بازپس‌گیری.

این فیلد فقط در صورتی باید تنظیم شود که کاربر بخواهد مقادیر تبدیل متفاوتی را برای این پنجره بازپس‌گیری تعریف کند. پیکربندی پنجره 3 بدون تنظیم پنجره 2 مجاز است. در صورتی که تنظیمات پنجره 1 و 2 تنظیم شده باشد و 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 روی true تنظیم شده باشد، باید حداقل یک ورودی داشته باشد. حداکثر می تواند 128 ورودی داشته باشد.

postbackWindowSettingsEnabled

boolean

اگر enable_postback_window_settings درست باشد، conversionValues ​​باید پر شود و برای تعیین زمان و نحوه تنظیم مقدار تبدیل در دستگاه مشتری و صدور طرح به حساب‌های Ads مرتبط استفاده می‌شود. اگر نادرست باشد، تنظیمات استفاده نمی شود، اما در صورت استفاده از آنها در آینده حفظ می شوند. این باید همیشه برای postbackWindowOne صادق باشد.

ConversionValues

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

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

string

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

coarseValue

enum ( CoarseValue )

ضروری. یک مقدار تبدیل دانه درشت.

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

eventMappings[]

object ( EventMapping )

شرایط رویدادی که برای دستیابی به این مقدار تبدیل باید رعایت شود. شرایط در این لیست با هم AND شده اند. در صورت فعال بودن پنجره بازگردانی، باید حداقل 1 ورودی و حداکثر 3 ورودی داشته باشد.

lockEnabled

boolean

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

fineValue

integer

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

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

مقدار درشت

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

Enums
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

ضروری. نام رویداد GA4. همیشه باید تنظیم شود. حداکثر طول نام نمایشی مجاز 40 واحد کد 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 را به روز می کند.
،

منبع: SKAdNetworkConversionValueSchema

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

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

string

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

postbackWindowOne

object ( PostbackWindow )

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

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

postbackWindowTwo

object ( PostbackWindow )

تنظیمات ارزش تبدیل برای دومین پنجره پس‌بازگشت.

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

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

postbackWindowThree

object ( PostbackWindow )

تنظیمات ارزش تبدیل برای سومین پنجره بازپس‌گیری.

این فیلد فقط در صورتی باید تنظیم شود که کاربر بخواهد مقادیر تبدیل متفاوتی را برای این پنجره بازپس‌گیری تعریف کند. پیکربندی پنجره 3 بدون تنظیم پنجره 2 مجاز است. در صورتی که تنظیمات پنجره 1 و 2 تنظیم شده باشد و 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 روی true تنظیم شده باشد، باید حداقل یک ورودی داشته باشد. حداکثر می تواند 128 ورودی داشته باشد.

postbackWindowSettingsEnabled

boolean

اگر enable_postback_window_settings درست باشد، conversionValues ​​باید پر شود و برای تعیین زمان و نحوه تنظیم مقدار تبدیل در دستگاه مشتری و صدور طرح به حساب‌های Ads مرتبط استفاده می‌شود. اگر نادرست باشد، تنظیمات استفاده نمی شود، اما در صورت استفاده از آنها در آینده حفظ می شوند. این باید همیشه برای postbackWindowOne صادق باشد.

ConversionValues

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

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

string

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

coarseValue

enum ( CoarseValue )

ضروری. یک مقدار تبدیل دانه درشت.

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

eventMappings[]

object ( EventMapping )

شرایط رویدادی که برای دستیابی به این مقدار تبدیل باید رعایت شود. شرایط در این لیست با هم AND شده اند. در صورت فعال بودن پنجره بازگردانی، باید حداقل 1 ورودی و حداکثر 3 ورودی داشته باشد.

lockEnabled

boolean

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

fineValue

integer

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

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

مقدار درشت

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

Enums
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

ضروری. نام رویداد GA4. همیشه باید تنظیم شود. حداکثر طول نام نمایشی مجاز 40 واحد کد 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 را به روز می کند.