بيانات الأحداث الأولية حول الزيارات. تحدث الزيارة في كل مرة ينقر فيها المستهلك على إعلان وتتم إعادة توجيهه إلى صفحة مقصودة.
لا يمكن عرض هذا التقرير إلا من خلال طلب غير متزامن (أي من خلال طريقة Reports.request()).
بما أنّ الأحداث تقع في تواريخ محدّدة، يجب أن يحدّد طلب هذا التقرير timeRange. يمكنك تحديد أي مما يلي:
- startDate وendDate.
- changedMetricsSinceTimestamp (changedAttributesSinceTimestamp غير صالحة للأحداث).
طلب مقتطف
أرسِل نص طلب Reports.request() عاديًا، ولكن حدِّد "reportType": "visit"
.
{ ... "reportType": "visit", "columns": [ { "columnName": string, "headerText": string, "startDate": string, "endDate": string } ], "filters": [ { "column": { "columnName": string, }, ... }, ... ], ... }
لكل عمود تريد عرضه أو تصفيته في التقرير، حدِّد columnName
المُدرَج في الجدول أدناه.
ويمكنك أيضًا اختياريًا تحديد
headerText
وstartDate
وendDate.
تجدر الإشارة إلى أنه لا يمكن تصفية بعض الأعمدة؛ راجع "قابل للتصفية" في الجدول أدناه.
columnName | الوصف | السلوك | النوع | قابل للفلترة |
---|---|---|---|---|
status |
حالة الزيارة. الزيارات غير قابلة للتغيير، ولذلك يكون هذا دائمًا Active . |
سمة | Status |
نعم |
deviceSegment |
شريحة الجهاز التي تُنسب إليها الزيارة: Desktop أو Mobile أو Tablet أو Other . |
سمة | Device segment |
نعم |
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 |
رقم تعريف مجموعة المنتجات المرتبط بهذه الزيارة. فقط الزيارات الواردة من حملات Shopping لها أرقام تعريف مجموعات منتجات. يجب عدم استخدام أرقام تعريف مجموعات المنتجات في الانضمام. | سمة | 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) التي تمّ تعيينها لخلاصة Merchant Center التي تحتوي على بيانات حول المنتج. | سمة | String |
نعم |
productStoreId |
المتجر في إعلان المستودع المحلي الذي تم النقر عليه. ويجب أن يتطابق هذا المعرّف مع معرّفات المتاجر المستخدَمة في خلاصة المنتجات في المتاجر المحلّية. | سمة | String |
نعم |
productChannel |
قناة البيع للمنتج الذي تم النقر عليه: Online أو Local . |
سمة | Product channel |
نعم |
visitId |
رقم تعريف زيارة DS. | سمة | ID |
نعم |
visitSearchQuery |
طلب البحث الذي أدى إلى إنشاء هذه الزيارة. | سمة | String |
نعم |
visitDate |
التاريخ، حسب المنطقة الزمنية لحساب المحرك، وقت حدوث الزيارة. يتم استخدام هذا التاريخ لتجميع الزيارات. على سبيل المثال، عندما تُجمِّع DS الزيارات في 1 أيار (مايو)، تحتسب جميع الزيارات التي يكون visitDate فيها 1 أيار (مايو). |
سمة | Date |
نعم |
visitTimestamp |
الطابع الزمني للتوقيت العالمي المتفق عليه عند حدوث الزيارة. | سمة | Timestamp |
نعم |
visitNetworkType |
شبكة الإعلانات التي أدت إلى إنشاء هذه الزيارة: Content ، أو Search ، أو Other . |
سمة | Network type |
نعم |
visitReferrer |
عنوان URL المُحيل للزيارة. | سمة | String |
نعم |
visitExternalClickId |
سلسلة فريدة لكل زيارة يتم تمريرها إلى الصفحة المقصودة كمعلمة عنوان URL لـ gclid. هذه الميزة مفعَّلة فقط للمعلنين الذين لديهم دمج واجهة برمجة التطبيقات للإحالات الناجحة أو دمج "إحصاءات Google". | سمة | String |
نعم |
feedItemId |
رقم تعريف صف عنصر الخلاصة المرتبط بهذه الزيارة. | سمة | ID |
نعم |
feedId |
رقم تعريف جدول الخلاصة المرتبط بهذه الزيارة. | سمة | ID |
نعم |
feedType |
نوع الخلاصة المرتبطة بهذه الزيارة. | سمة | Feed type |
نعم |