نوع التقرير: زيارة

بيانات الأحداث الأولية حول الزيارات. تحدث الزيارة في كل مرة ينقر فيها المستهلك على إعلان وتتم إعادة توجيهه إلى صفحة مقصودة.

لا يمكن عرض هذا التقرير إلا من خلال طلب غير متزامن (أي من خلال طريقة Reports.request()).

بما أنّ الأحداث تقع في تواريخ محدّدة، يجب أن يحدّد طلب هذا التقرير timeRange. يمكنك تحديد أي مما يلي:

طلب مقتطف

أرسِل نص طلب 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 نعم