بيانات الأحداث الأولية عن الإحالات الناجحة
لا يمكن عرض هذا التقرير إلا باستخدام طلب غير متزامن (أي عبر 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 OrderId استنادًا إلى تعليمات 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 |
نعم |