Method: customers.customerSkAdNetworkConversionValueSchemas.mutate

تنشئ CustomerSkAdNetworkconversionValueSchema أو يعدّلها.

قائمة الأخطاء التي تظهر: AuthenticationError AuthorizationError FieldError InternalError MutateError

طلب HTTP

POST https://googleads.googleapis.com/v14/customers/{customerId}/customerSkAdNetworkConversionValueSchemas:mutate

يستخدِم عنوان URL بنية تحويل ترميز gRPC.

مَعلمات المسار

المَعلمات
customerId

string

رقم تعريف العميل الذي يتم تعديل مجموعاته المشتركة.

نص الطلب

يحتوي نص الطلب على بيانات بالبنية التالية:

تمثيل JSON 
{
  "operation": {
    object (CustomerSkAdNetworkConversionValueSchemaOperation)
  },
  "validateOnly": boolean
}
الحقول
operation

object (CustomerSkAdNetworkConversionValueSchemaOperation)

العملية المطلوب تنفيذها
validateOnly

boolean

إذا كانت القيمة true، يتم التحقق من صحة الطلب ولكن لا يتم تنفيذه. يتم عرض الأخطاء فقط وليس النتائج.

نص الاستجابة

رسالة الاستجابة لـ customerSkAdNetwork ConversionValueSchemas.mutate.

إذا كانت الاستجابة ناجحة، سيحتوي نص الاستجابة على بيانات بالبنية التالية:

تمثيل JSON 
{
  "result": {
    object (MutateCustomerSkAdNetworkConversionValueSchemaResult)
  }
}
الحقول
result

object (MutateCustomerSkAdNetworkConversionValueSchemaResult)

جميع النتائج المتعلقة بالمتغير.

نطاقات التفويض

يجب توفير نطاق OAuth التالي:

  • https://www.googleapis.com/auth/adwords

لمزيد من المعلومات، راجِع نظرة عامة على بروتوكول OAuth 2.0.

CustomerSkAdNetworkConversionValueSchemaOperation

عملية تحديث واحدة لـ CustomerSkAdNetwork ConversionValueSchema.

تمثيل JSON 
{
  "update": {
    object (CustomerSkAdNetworkConversionValueSchema)
  }
}
الحقول
update

object (CustomerSkAdNetworkConversionValueSchema)

عملية التحديث: من المتوقع أن يحتوي المخطط على اسم مورد صالح.

CustomerSkAdNetworkConversionValueSchema

نموذج CustomerSkAdNetwork ConversionValueSchema.

تمثيل JSON 
{
  "resourceName": string,
  "schema": {
    object (SkAdNetworkConversionValueSchema)
  }
}
الحقول
resourceName

string

النتائج فقط. اسم مورد المخطط. تحتوي أسماء موارد CustomerSkAdNetworkconversionValueSchema على الشكل التالي: customers/{customerId}/customerSkAdNetworkValueSchemas/{accountLinkId}
schema

object (SkAdNetworkConversionValueSchema)

النتائج فقط. المخطط للمورد المحدّد.

SkAdNetworkConversionValueSchema

SkAdNetwork ConversionValueSchema الخاص بـ CustomerLink.

تمثيل JSON 
{
  "appId": string,
  "measurementWindowHours": integer,
  "fineGrainedConversionValueMappings": [
    {
      object (FineGrainedConversionValueMappings)
    }
  ]
}
الحقول
appId

string

مطلوبة. النتائج فقط. رقم تعريف تطبيق Apple App Store.
measurementWindowHours

integer

النتائج فقط. فترة زمنية (يتم قياسها بالساعات) بعد التثبيت، ويتوقف بعدها شريك إحالة التطبيق أو المعلن عن استدعاء updateConversionValue.
fineGrainedConversionValueMappings[]

object (FineGrainedConversionValueMappings)

النتائج فقط. تعيينات قيم الإحالات الناجحة الدقيقة.

FineGrainedConversionValueMappings

تعيينات لقيمة الإحالة الناجحة الدقيقة.

تمثيل JSON 
{
  "fineGrainedConversionValue": integer,
  "conversionValueMapping": {
    object (ConversionValueMapping)
  }
}
الحقول
fineGrainedConversionValue

integer

النتائج فقط. قيمة الإحالة الناجحة الدقيقة. القيم الصالحة في النطاق الشامل [0,63].
conversionValueMapping

object (ConversionValueMapping)

النتائج فقط. أحداث الإحالات الناجحة التي ترتبط بها قيمة الإحالة الناجحة الدقيقة.

ConversionValueMapping

يمثِّل الربط من قيمة إحالة ناجحة واحدة بحدث إحالة ناجحة واحد أو أكثر.

تمثيل JSON 
{
  "minTimePostInstallHours": string,
  "maxTimePostInstallHours": string,
  "mappedEvents": [
    {
      object (Event)
    }
  ]
}
الحقول
minTimePostInstallHours

string (int64 format)

النتائج فقط. الحدّ الأدنى للنطاق الزمني الذي كان آخر نشاط للمستخدم فيه خلال فترة القياس.
maxTimePostInstallHours

string (int64 format)

النتائج فقط. الحدّ الأقصى للنطاق الزمني الذي كان آخر نشاط للمستخدم فيه خلال فترة القياس.
mappedEvents[]

object (Event)

النتائج فقط. يمكن ربط قيمة الإحالة الناجحة لأحداث متعددة بسمات مختلفة.

حدث

تُحدِّد حدث إحالة ناجحة على Google يتم ربط قيمة الإحالة الناجحة به.

تمثيل JSON 
{
  "mappedEventName": string,
  "currencyCode": string,

  // Union field revenue_rate can be only one of the following:
  "eventRevenueRange": {
    object (RevenueRange)
  },
  "eventRevenueValue": number
  // End of list of possible types for union field revenue_rate.

  // Union field event_rate can be only one of the following:
  "eventOccurrenceRange": {
    object (EventOccurrenceRange)
  },
  "eventCounter": string
  // End of list of possible types for union field event_rate.
}
الحقول
mappedEventName

string

النتائج فقط. اسم حدث Google الذي تمثله قيمة الإحالة الناجحة هذه.
currencyCode

string

النتائج فقط. العملة الواردة في التقرير لـ event_revenue رمز العملة المكوَّن من ثلاثة أحرف وفقًا لمعيار ISO 4217، مثل USD
حقل الاتحاد revenue_rate إما نطاق أو قيمة معيّنة لأرباح الحدث يمكن أن تكون السمة "revenue_rate" واحدة فقط مما يلي:
eventRevenueRange

object (RevenueRange)

النتائج فقط. نطاق أرباح الفعالية.
eventRevenueValue

number

النتائج فقط. قيمة أرباح الحدث المحدّدة.
حقل الاتحاد event_rate نطاق أو قيمة معيّنة لعدّاد الأحداث يمكن أن تكون السمة "event_rate" واحدة فقط مما يلي:
eventOccurrenceRange

object (EventOccurrenceRange)

النتائج فقط. نطاق عدّاد الأحداث
eventCounter

string (int64 format)

النتائج فقط. لقيم عدّاد الأحداث المحدّدة

RevenueRange

تحدّد نطاقًا لقيم الأرباح.

تمثيل JSON 
{
  "minEventRevenue": number,
  "maxEventRevenue": number
}
الحقول
minEventRevenue

number

النتائج فقط. بالنسبة إلى نطاقات الأرباح، الحد الأدنى للقيمة في currencyCode التي سيتم تعديل قيمة الإحالة الناجحة هذه لها. سيتم التعامل مع القيمة 0 على أنها بدون ضبط.
maxEventRevenue

number

النتائج فقط. بالنسبة إلى نطاقات الأرباح، القيمة القصوى في currencyCode التي سيتم تعديل قيمة الإحالة الناجحة هذه لها. سيتم التعامل مع القيمة 0 على أنها بدون ضبط.

EventOccurrenceRange

تحدِّد هذه السمة نطاقًا لقيم عدّاد الأحداث.

تمثيل JSON 
{
  "minEventCount": string,
  "maxEventCount": string
}
الحقول
minEventCount

string (int64 format)

النتائج فقط. الحد الأدنى للنطاق المحدّد بالنسبة إلى نطاقات عدّاد الأحداث سيتم التعامل مع القيمة 0 على أنها بدون ضبط.
maxEventCount

string (int64 format)

النتائج فقط. الحد الأقصى للنطاق المحدّد بالنسبة إلى نطاقات عدّاد الأحداث سيتم التعامل مع القيمة 0 على أنها بدون ضبط.

MutateCustomerSkAdNetworkConversionValueSchemaResult

نتيجة التغيير في CustomerSkAdNetworkconversionValueSchema.

تمثيل JSON 
{
  "resourceName": string,
  "appId": string
}
الحقول
resourceName

string

اسم المورد للعميل الذي تم تعديله
appId

string

تم تعديل رقم تعريف التطبيق لقيمة Skan ConversionValue.