بيانات الأحداث الأولية عن الإحالات الناجحة.
لا يمكن عرض هذا التقرير إلا من خلال طلب غير متزامن (أي من خلال طريقة Reports.request()).
بما أنّ الأحداث تقع في تواريخ محدّدة، يجب أن يحدّد طلب هذا التقرير timeRange. يمكنك تحديد أي مما يلي:
- startDate وendDate.
- changedMetricsSinceTimestamp (changedAttributesSinceTimestamp غير صالحة للأحداث).
طلب مقتطف
أرسِل نص طلب Reports.request() عاديًا، ولكن حدِّد "reportType": "conversion"
.
{ ... "reportType": "conversion", "columns": [ { "columnName": string, "headerText": string, "startDate": string, "endDate": string } ], "filters": [ { "column": { "columnName": string, }, ... }, ... ], ... }
لكل عمود تريد عرضه أو تصفيته في التقرير، حدِّد columnName
المُدرَج في الجدول أدناه.
ويمكنك أيضًا اختياريًا تحديد
headerText
وstartDate
وendDate.
تجدر الإشارة إلى أنه لا يمكن تصفية بعض الأعمدة؛ راجع "قابل للتصفية" في الجدول أدناه.
columnName | الوصف | السلوك | النوع | قابل للفلترة |
---|---|---|---|---|
status |
حالة الإحالة الناجحة: Active أو Removed . |
سمة | Status |
نعم |
deviceSegment |
شريحة الجهاز التي تُنسب الإحالة الناجحة إليها: Desktop أو Mobile أو Tablet أو Other . |
سمة | Device segment |
نعم |
floodlightGroup |
اسم مجموعة Floodlight. | سمة | String |
نعم |
floodlightGroupConversionType |
نوع الإحالات الناجحة الناتجة عن أنشطة Floodlight في هذه المجموعة: Action أو Transaction . |
سمة | Conversion type |
نعم |
floodlightGroupId |
رقم تعريف مجموعة Floodlight في DS | سمة | ID |
نعم |
floodlightGroupTag |
علامة مجموعة Floodlight. | سمة | String |
نعم |
floodlightActivity |
اسم نشاط Floodlight. | سمة | String |
نعم |
floodlightActivityId |
رقم تعريف نشاط Floodlight في DS. | سمة | ID |
نعم |
floodlightActivityTag |
علامة نشاط Floodlight. | سمة | String |
نعم |
agency |
اسم الوكالة. | سمة | String |
نعم |
agencyId |
رقم تعريف وكالة DS. | سمة | ID |
نعم |
advertiser |
اسم المعلن. | سمة | String |
نعم |
advertiserId |
الرقم التعريفي لمعلن DS. | سمة | ID |
نعم |
account |
اسم حساب المحرِّك. | سمة | String |
نعم |
accountId |
رقم تعريف حساب محرك DS. | سمة | ID |
نعم |
accountEngineId |
رقم تعريف الحساب في حساب المحرك الخارجي. | سمة | String |
نعم |
accountType |
نوع حساب المحرك: Google AdWords أو Bing Ads أو Yahoo Japan Listing Ads أو Yahoo Search Marketing أو Yahoo Gemini أو Baidu أو Comparison Shopping . |
سمة | Engine type |
نعم |
campaign |
اسم الحملة. | سمة | String |
نعم |
campaignId |
رقم تعريف حملة DS. | سمة | ID |
نعم |
campaignStatus |
حالة الحملة التي تحتوي على هذا العنصر. | سمة | Status |
نعم |
adGroup |
اسم المجموعة الإعلانية. | سمة | String |
نعم |
adGroupId |
رقم تعريف المجموعة الإعلانية في DS. | سمة | ID |
نعم |
adGroupStatus |
حالة المجموعة الإعلانية التي تحتوي على هذا العنصر. | سمة | Status |
نعم |
keywordId |
رقم تعريف الكلمة الرئيسية في DS. وتشير القيمة 0 إلى أن الكلمة الرئيسية غير منسوبة. | سمة | ID |
نعم |
keywordMatchType |
نوع مطابقة الكلمة الرئيسية: Broad أو Exact أو Phrase أو Content . |
سمة | Match type |
نعم |
keywordText |
نص الكلمة الرئيسية. | سمة | String |
نعم |
productTargetId |
رقم تعريف استهداف المنتج في DS. | سمة | ID |
نعم |
productGroupId |
رقم تعريف مجموعة المنتجات المرتبط بهذه الإحالة الناجحة. الإحالات الناجحة من حملات التسوّق هي فقط التي تحتوي على أرقام تعريف مجموعات المنتجات. يجب عدم استخدام أرقام تعريف مجموعات المنتجات في الانضمام. | سمة | ID |
نعم |
ad |
اسم الإعلان. | سمة | String |
نعم |
adId |
رقم تعريف الإعلان في DS. وتشير القيمة 0 إلى عدم إسناد الإعلان. | سمة | ID |
نعم |
isUnattributedAd |
يشير إلى ما إذا كانت المقاييس في هذا الصف غير قابلة للإحالة إلى إعلان محدّد. على سبيل المثال، يمكن أن يمنع إعلان ذو تنسيق غير متوافق أو عنوان URL غير صحيح لخادم النقر DS من إحالة المقاييس إلى إعلان. | سمة | Boolean |
نعم |
inventoryAccountId |
رقم تعريف حساب مستودع DS الذي يحتوي على المنتج المرتبط بالإحالة الناجحة. تنشئ DS هذا المعرّف عند ربط حساب مستودع في DS. | سمة | ID |
نعم |
productId |
رقم تعريف المنتج المرتبط بهذه الإحالة الناجحة. | سمة | String |
نعم |
productCountry |
البلد (بتنسيق ISO 3166) المسجّل لخلاصة المستودع التي تحتوي على المنتج المرتبط بهذه الإحالة الناجحة. | سمة | String |
نعم |
productLanguage |
لغة المنتج (ISO 639-1) المرتبطة بهذا التحويل. | سمة | String |
نعم |
productStoreId |
المتجر في إعلان المستودع المحلي المرتبط بالإحالة الناجحة. ويجب أن يتطابق هذا المعرّف مع معرّفات المتاجر المستخدَمة في خلاصة المنتجات في المتاجر المحلّية. | سمة | String |
نعم |
productChannel |
قناة بيع المنتج المرتبط بالإحالة الناجحة: Online أو Local . |
سمة | Product channel |
نعم |
conversionId |
رقم التعريف الذي تُنشئه "إعلانات شبكة البحث 360" لكل إحالة ناجحة. | سمة | ID |
نعم |
advertiserConversionId |
وبالنسبة إلى الإحالات الناجحة خارج إطار الإنترنت، يكون هذا الرقم التعريفي مقدّمًا من المعلِنين. وفي حال لم يحدّد أحد المعلِنين هذا المعرّف، تُنشئ "إعلانات شبكة البحث 360" معرّفًا. بالنسبة إلى الإحالات الناجحة على الإنترنت، يساوي هذا العمود عمود "رقم تعريف الإحالة الناجحة" أو عمود "رقم تعريف طلب Floodlight" وفقًا لتعليمات Floodlight المتعلّقة بالمعلن. | سمة | String |
نعم |
conversionType |
نوع الإحالة الناجحة: Action أو Transaction . |
سمة | Conversion type |
نعم |
conversionRevenue |
المبلغ الإجمالي بالدولار من الإحالة الناجحة. | سمة | Money |
نعم |
conversionQuantity |
كمية السلع التي سجّلتها الإحالة الناجحة على النحو الذي تحدّده المعلّمة qty. ويكون المعلن مسؤولاً عن تعبئة المعلّمة ديناميكيًا (مثل عدد العناصر التي تم بيعها في الإحالة الناجحة)، وإلا سيتم إعداده تلقائيًا على 1. | سمة | Number |
نعم |
conversionDate |
التاريخ، في المنطقة الزمنية للشبكة في "مدير الحملة"، وقت حدوث الإحالة الناجحة. يُستخدَم هذا التاريخ لتجميع مقاييس الإحالات الناجحة. على سبيل المثال، عندما يُجمِّع DS الإجراءات ليوم 1 أيار (مايو)، يتم احتساب جميع الإحالات الناجحة للإجراءات التي يكون conversionDate فيها 1 أيار (مايو). |
سمة | Date |
نعم |
conversionTimestamp |
الطابع الزمني للتوقيت العالمي المتفق عليه عند حدوث الإحالة الناجحة. | سمة | Timestamp |
نعم |
conversionLastModifiedTimestamp |
الطابع الزمني للتوقيت العالمي المنسق لآخر تعديل تم إجراؤه على الإحالة الناجحة. | سمة | Timestamp |
نعم |
conversionAttributionType |
السبب في الإحالة الناجحة: Visit أو Keyword+Ad . |
سمة | Conversion attribution type |
نعم |
conversionVisitId |
رقم تعريف زيارة DS التي تُنسب الإحالة الناجحة إليها. | سمة | ID |
نعم |
conversionVisitTimestamp |
الطابع الزمني للتوقيت العالمي المنسق للزيارة التي تُنسب الإحالة الناجحة إليها. | سمة | Timestamp |
نعم |
conversionVisitExternalClickId |
سلسلة فريدة للزيارة التي تُنسب الإحالة الناجحة، يتم تمريرها إلى الصفحة المقصودة كمعلمة عنوان URL لـ gclid. هذه الميزة مفعَّلة فقط للمعلنين الذين لديهم دمج واجهة برمجة التطبيقات للإحالات الناجحة أو دمج "إحصاءات Google". | سمة | String |
نعم |
conversionSearchTerm |
عبارة البحث التي أدت إلى التحويل. | سمة | String |
نعم |
floodlightOriginalRevenue |
الأرباح الأصلية التي لم تتغيّر والمقترنة بحدث Floodlight (بعملة التقرير الحالي) قبل إجراء تعديلات على تعليمات Floodlight | سمة | Money |
نعم |
floodlightEventRequestString |
سلسلة طلب Floodlight للإحالة الناجحة. | سمة | String |
نعم |
floodlightReferrer |
الموقع الإلكتروني للإحالة الناجحة في Floodlight. | سمة | String |
نعم |
floodlightOrderId |
رقم تعريف طلب Floodlight الذي يقدّمه المعلن لإجراء الإحالة الناجحة. | سمة | String |
نعم |
feedItemId |
رقم تعريف صف عنصر الخلاصة المرتبط بهذه الإحالة الناجحة. | سمة | ID |
نعم |
feedId |
رقم تعريف جدول الخلاصة المرتبط بهذه الإحالة الناجحة. | سمة | ID |
نعم |
feedType |
نوع الخلاصة المرتبطة بهذه الإحالة الناجحة. | سمة | Feed type |
نعم |