Method: customers.customerSkAdNetworkConversionValueSchemas.mutate

تنشئ CustomerSkAdNetworkConversionValueSchema أو تحدّثه.

قائمة بالأخطاء الشائعة: AuthenticationError AuthorizationError FieldError InternalError MutateError

طلب HTTP

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

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

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

المَعلمات
customerId

string

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

نص الطلب

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

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

object (CustomerSkAdNetworkConversionValueSchemaOperation)

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

boolean

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

boolean

اختياريّ. في حال اختيار القيمة "صحيح"، سيتم تفعيل عرض التحذيرات. تعرض التحذيرات رسائل خطأ ورموز خطأ بدون حظر تنفيذ عملية التبديل.

نص الاستجابة

رسالة رد لـ customerSkAdNetworkConversionValueSchemas.mutate.

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

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

object (MutateCustomerSkAdNetworkConversionValueSchemaResult)

جميع النتائج للمتغير.
warning

object (Status)

أخطاء لا تؤدي إلى الحظر وتقدم تفاصيل تعذُّر التحقّق من صحة المخطط لا يُعرَض إلا عندما تكون هذه الإعدادات هي "فعَّلة معيّنة" = "صحيح".

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

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

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

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

CustomerSkAdNetworkConversionValueSchemaOperation

عملية تعديل واحدة لـ CustomerSkAdNetworkConversionValueSchema

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

object (CustomerSkAdNetworkConversionValueSchema)

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

CustomerSkAdNetworkConversionValueSchema

نموذج CustomerSkAdNetworkConversionValueSchema

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

string

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

object (SkAdNetworkConversionValueSchema)

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

SkAdNetworkConversionValueSchema

SkAdNetworkConversionValueSchema الخاص بـ CustomerLink.

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

string

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

integer

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

object (FineGrainedConversionValueMappings)

النتائج فقط. تحديد قيم الإحالات الناجحة الدقيقة بالنسبة إلى إصدارات SkAdNetwork >= 4.0 التي تتوافق مع فترات إحالات ناجحة متعدّدة، لا تنطبق تعيينات قيم الإحالات الناجحة الدقيقة إلّا على أوّل عملية تسجيل إحالات ناجحة.
postbackMappings[]

object (PostbackMapping)

النتائج فقط. عمليات ربط قيم الإحالات الناجحة حسب الإبلاغ عن الإحالات الناجحة لعمليات تسجيل الإحالات الناجحة في فترات إحالات ناجحة متعدّدة ينطبق فقط على إصدارات SkAdNetwork >= 4.0.

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 على أنّها بدون ضبط.

PostbackMapping

عمليات ربط كل عملية تسجيل إحالات ناجحة في فترات إحالات ناجحة متعدّدة.

تمثيل JSON 
{
  "postbackSequenceIndex": integer,
  "coarseGrainedConversionValueMappings": {
    object (CoarseGrainedConversionValueMappings)
  },

  // Union field lock_window_trigger can be only one of the following:
  "lockWindowCoarseConversionValue": enum (SkAdNetworkCoarseConversionValue),
  "lockWindowFineConversionValue": integer,
  "lockWindowEvent": string
  // End of list of possible types for union field lock_window_trigger.
}
الحقول
postbackSequenceIndex

integer

النتائج فقط. فهرس مستند إلى 0 يشير إلى ترتيب عمليات تسجيل الإحالات الناجحة. القيم الصالحة في النطاق الشامل [0,2].
coarseGrainedConversionValueMappings

object (CoarseGrainedConversionValueMappings)

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

enum (SkAdNetworkCoarseConversionValue)

النتائج فقط. قيمة الإحالة الناجحة الدقيقة التقريبية التي تؤدي إلى قفل فترة الإحالة الناجحة
lockWindowFineConversionValue

integer

النتائج فقط. قيمة الإحالة الناجحة الدقيقة التي تؤدي إلى قفل فترة الإحالة الناجحة
lockWindowEvent

string

النتائج فقط. اسم الحدث الذي يؤدي إلى قفل فترة الإحالة الناجحة.

CoarseGrainedConversionValueMappings

تعيينات قيم الإحالات الناجحة التقريبية

تمثيل JSON 
{
  "lowConversionValueMapping": {
    object (ConversionValueMapping)
  },
  "mediumConversionValueMapping": {
    object (ConversionValueMapping)
  },
  "highConversionValueMapping": {
    object (ConversionValueMapping)
  }
}
الحقول
lowConversionValueMapping

object (ConversionValueMapping)

النتائج فقط. تعيين قيمة الإحالة الناجحة التقريبية "المنخفضة".
mediumConversionValueMapping

object (ConversionValueMapping)

النتائج فقط. تعيين قيمة الإحالة الناجحة التقريبية "متوسطة".
highConversionValueMapping

object (ConversionValueMapping)

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

MutateCustomerSkAdNetworkConversionValueSchemaResult

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

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

string

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

string

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