- طلب HTTP
- مَعلمات المسار
- نص الطلب
- نص الاستجابة
- نطاقات التفويض
- CustomerSkAdNetworkConversionValueSchemaOperation
- CustomerSkAdNetworkConversionValueSchema
- SkAdNetworkConversionValueSchema
- FineGrainedConversionValueMappings
- ConversionValueMapping
- الحدث
- RevenueRange
- EventOccurrenceRange
- MutateCustomerSkAdNetworkConversionValueSchemaResult
- جرِّبه الآن
تنشئ CustomerSkAdNetworkconversionValueSchema أو يعدّلها.
قائمة الأخطاء التي تظهر: AuthenticationError AuthorizationError FieldError InternalError MutateError
طلب HTTP
POST https://googleads.googleapis.com/v15/customers/{customerId}/customerSkAdNetworkConversionValueSchemas:mutate
يستخدِم عنوان URL بنية تحويل ترميز gRPC.
مَعلمات المسار
المَعلمات | |
---|---|
customerId |
رقم تعريف العميل الذي يتم تعديل مجموعاته المشتركة. |
نص الطلب
يحتوي نص الطلب على بيانات بالبنية التالية:
تمثيل JSON |
---|
{
"operation": {
object ( |
الحقول | |
---|---|
operation |
العملية المطلوب تنفيذها |
validateOnly |
إذا كانت القيمة true، يتم التحقق من صحة الطلب ولكن لا يتم تنفيذه. يتم عرض الأخطاء فقط وليس النتائج. |
نص الاستجابة
رسالة الاستجابة لـ customerSkAdNetwork ConversionValueSchemas.mutate.
إذا كانت الاستجابة ناجحة، سيحتوي نص الاستجابة على بيانات بالبنية التالية:
تمثيل JSON |
---|
{
"result": {
object ( |
الحقول | |
---|---|
result |
جميع النتائج المتعلقة بالمتغير. |
نطاقات التفويض
يجب توفير نطاق OAuth التالي:
https://www.googleapis.com/auth/adwords
لمزيد من المعلومات، راجِع نظرة عامة على بروتوكول OAuth 2.0.
CustomerSkAdNetworkConversionValueSchemaOperation
عملية تحديث واحدة لـ CustomerSkAdNetwork ConversionValueSchema.
تمثيل JSON |
---|
{
"update": {
object ( |
الحقول | |
---|---|
update |
عملية التحديث: من المتوقع أن يحتوي المخطط على اسم مورد صالح. |
CustomerSkAdNetworkConversionValueSchema
نموذج CustomerSkAdNetwork ConversionValueSchema.
تمثيل JSON |
---|
{
"resourceName": string,
"schema": {
object ( |
الحقول | |
---|---|
resourceName |
النتائج فقط. اسم مورد المخطط. تحتوي أسماء موارد CustomerSkAdNetworkconversionValueSchema على الشكل التالي: customers/{customerId}/customerSkAdNetworkValueSchemas/{accountLinkId} |
schema |
النتائج فقط. المخطط للمورد المحدّد. |
SkAdNetworkConversionValueSchema
SkAdNetwork ConversionValueSchema الخاص بـ CustomerLink.
تمثيل JSON |
---|
{
"appId": string,
"measurementWindowHours": integer,
"fineGrainedConversionValueMappings": [
{
object ( |
الحقول | |
---|---|
appId |
مطلوبة. النتائج فقط. رقم تعريف تطبيق Apple App Store. |
measurementWindowHours |
النتائج فقط. فترة زمنية (يتم قياسها بالساعات) بعد التثبيت، ويتوقف بعدها شريك إحالة التطبيق أو المعلن عن استدعاء updateConversionValue. |
fineGrainedConversionValueMappings[] |
النتائج فقط. تعيينات قيم الإحالات الناجحة الدقيقة. |
FineGrainedConversionValueMappings
تعيينات لقيمة الإحالة الناجحة الدقيقة.
تمثيل JSON |
---|
{
"fineGrainedConversionValue": integer,
"conversionValueMapping": {
object ( |
الحقول | |
---|---|
fineGrainedConversionValue |
النتائج فقط. قيمة الإحالة الناجحة الدقيقة. القيم الصالحة في النطاق الشامل [0,63]. |
conversionValueMapping |
النتائج فقط. أحداث الإحالات الناجحة التي ترتبط بها قيمة الإحالة الناجحة الدقيقة. |
ConversionValueMapping
يمثِّل الربط من قيمة إحالة ناجحة واحدة بحدث إحالة ناجحة واحد أو أكثر.
تمثيل JSON |
---|
{
"minTimePostInstallHours": string,
"maxTimePostInstallHours": string,
"mappedEvents": [
{
object ( |
الحقول | |
---|---|
minTimePostInstallHours |
النتائج فقط. الحدّ الأدنى للنطاق الزمني الذي كان آخر نشاط للمستخدم فيه خلال فترة القياس. |
maxTimePostInstallHours |
النتائج فقط. الحدّ الأقصى للنطاق الزمني الذي كان آخر نشاط للمستخدم فيه خلال فترة القياس. |
mappedEvents[] |
النتائج فقط. يمكن ربط قيمة الإحالة الناجحة لأحداث متعددة بسمات مختلفة. |
حدث
تُحدِّد حدث إحالة ناجحة على Google يتم ربط قيمة الإحالة الناجحة به.
تمثيل JSON |
---|
{ "mappedEventName": string, "currencyCode": string, // Union field |
الحقول | |
---|---|
mappedEventName |
النتائج فقط. اسم حدث Google الذي تمثله قيمة الإحالة الناجحة هذه. |
currencyCode |
النتائج فقط. العملة الواردة في التقرير لـ event_revenue رمز العملة المكوَّن من ثلاثة أحرف وفقًا لمعيار ISO 4217، مثل USD |
حقل الاتحاد revenue_rate إما نطاق أو قيمة معيّنة لأرباح الحدث يمكن أن تكون السمة "revenue_rate " واحدة فقط مما يلي: |
|
eventRevenueRange |
النتائج فقط. نطاق أرباح الفعالية. |
eventRevenueValue |
النتائج فقط. قيمة أرباح الحدث المحدّدة. |
حقل الاتحاد event_rate نطاق أو قيمة معيّنة لعدّاد الأحداث يمكن أن تكون السمة "event_rate " واحدة فقط مما يلي: |
|
eventOccurrenceRange |
النتائج فقط. نطاق عدّاد الأحداث |
eventCounter |
النتائج فقط. لقيم عدّاد الأحداث المحدّدة |
RevenueRange
تحدّد نطاقًا لقيم الأرباح.
تمثيل JSON |
---|
{ "minEventRevenue": number, "maxEventRevenue": number } |
الحقول | |
---|---|
minEventRevenue |
النتائج فقط. بالنسبة إلى نطاقات الأرباح، الحد الأدنى للقيمة في |
maxEventRevenue |
النتائج فقط. بالنسبة إلى نطاقات الأرباح، القيمة القصوى في |
EventOccurrenceRange
تحدِّد هذه السمة نطاقًا لقيم عدّاد الأحداث.
تمثيل JSON |
---|
{ "minEventCount": string, "maxEventCount": string } |
الحقول | |
---|---|
minEventCount |
النتائج فقط. الحد الأدنى للنطاق المحدّد بالنسبة إلى نطاقات عدّاد الأحداث سيتم التعامل مع القيمة 0 على أنها بدون ضبط. |
maxEventCount |
النتائج فقط. الحد الأقصى للنطاق المحدّد بالنسبة إلى نطاقات عدّاد الأحداث سيتم التعامل مع القيمة 0 على أنها بدون ضبط. |
MutateCustomerSkAdNetworkConversionValueSchemaResult
نتيجة التغيير في CustomerSkAdNetworkconversionValueSchema.
تمثيل JSON |
---|
{ "resourceName": string, "appId": string } |
الحقول | |
---|---|
resourceName |
اسم المورد للعميل الذي تم تعديله |
appId |
تم تعديل رقم تعريف التطبيق لقيمة Skan ConversionValue. |