تحميل مجمع

تتيح لك النصوص البرمجية في "إعلانات Google" إجراء تغييرات مجمّعة على حسابك عن طريق تحميل البيانات بتنسيق CSV. يمكنك تحميل البيانات من ملف CSV من Google Drive أو أحد جداول بيانات Google أو جدول بيانات Microsoft Excel أو إنشاء طلب تحميل مُجمَّع في النص البرمجي في وقت التشغيل. يشرح هذا الدليل كيفية استخدام هذه الميزة في نصوصك البرمجية.

الاستخدام

باستخدام عمليات التحميل المجمّعة، يمكنك إجراء أنواع معيّنة من التغييرات التي قد تكون غير مدعومة مباشرةً في نصوص "إعلانات Google" البرمجية، مثل إدارة الحملات أو تحميل الإحالات الناجحة بلا إنترنت.

إنشاء تحميل مجمّع من Google Drive

إنّ أبسط طريقة لاستخدام ميزة التحميل المجمّع هي تحميل ملف CSV إلى Google Drive، وتحميل هذا الملف إلى "إعلانات Google" باستخدام نصوص "إعلانات Google" البرمجية:

const file = DriveApp.getFilesByName("BulkCampaignUpload.csv")
    .next();
const upload = AdsApp.bulkUploads().newFileUpload(file);
upload.forCampaignManagement();
upload.preview();

يؤدّي هذا إلى إنشاء إدخال معاينة للتحميل المجمّع في حسابك ضمن الأدوات والإعدادات > الإجراءات المجمّعة > عمليات التحميل.

انقر على الرابط معاينة لعرض التغييرات.

لتطبيق التغييرات على حسابك، انقر على زر تطبيق التغييرات في صفحة التفاصيل. إذا كان الملف الذي تم تحميله يحتوي على أخطاء، أو إذا كنت لا تريد إجراء التغييرات، انقر على الزر تجاهل المعاينة لتجاهل التغييرات.

بعد التأكّد من عمل النص البرمجي بشكلٍ صحيح، يمكنك تخطي مرحلة المعاينة وتطبيق التغييرات مباشرةً من النص البرمجي. ويمكن إجراء ذلك من خلال استدعاء طريقة apply() لمثيل التحميل المجمّع بدلاً من طريقة preview().

إنشاء عملية تحميل مجمّعة من البداية

يمكنك إنشاء مهمة تحميل مجمّع من البداية على النحو التالي:

// The best way to find column names is to consult a template
// as described in the last section of this guide.
const columns = [
   "Campaign", "Budget", "Bid Strategy type", "Campaign type"
];

const upload = AdsApp.bulkUploads().newCsvUpload(columns);

// Call append once for each row you'd like to upload
upload.append({
   "Campaign": "Test Campaign 1",
   "Budget": 2.34,
   "Bid Strategy type": "cpc",
   "Campaign type": "Search Only"
});
upload.forCampaignManagement();
upload.preview();

ضبط الوحدة النقدية

بشكل تلقائي، يتم تفسير المبالغ المالية في عمليات التحميل المجمَّعة على أنّها المبلغ الفعلي للعملة. إذا كنت تفضّل استخدام وحدات ميكرو، يمكنك ضبط خيار moneyInMicros على true عند إنشاء وظيفة التحميل (على سبيل المثال، سيتم إدخال 2.34 يورو على النحو التالي 2340000).

const upload = AdsApp.bulkUploads().newCsvUpload(columns,
    {moneyInMicros: true});

ضبط لغة الملف

يتم تفسير محتوى ملف CSV افتراضيًا باللغة الإنجليزية (en_US). بإمكانك تحديد لغة مختلفة باستخدام الخيار fileLocale كما هو موضّح أدناه:

const upload = AdsApp.bulkUploads().newCsvUpload(columns,
    {fileLocale: "fr_FR"});

عند تحديد لغة، يمكنك توفير عناوين الأعمدة إما باللغة en_US أو باللغة التي تحدّدها في السمة fileLocale.

اختيار المنطقة الزمنية

بشكل افتراضي، يتم تفسير إدخالات الوقت في الملف في America/Los_Angeles. يمكنك تحديد منطقة زمنية مختلفة باستخدام خيار timeZone. حدِّد المنطقة الزمنية بتنسيق قاعدة بيانات TZ.

const upload = AdsApp.bulkUploads().newCsvUpload(columns,
    {timeZone: "America/New_York"});

يمكن أن يكون تحديد منطقة زمنية مفيدًا عند تحميل الإحالات الناجحة بلا إنترنت.

نماذج جداول بيانات للتحميل المجمّع

أسهل طريقة للحصول على نموذج جدول بيانات للتحميل المجمّع هي من خلال واجهة مستخدم "إعلانات Google".

• سجِّل الدخول إلى حسابك على "إعلانات Google".
• انتقِل إلى الأدوات والإعدادات > الإجراءات المجمّعة > عمليات التحميل.
• انقر على الزر + لبدء عملية تحميل جديدة.
• يظهر بعد ذلك قسم يحتوي على مجموعة متنوعة من النماذج للاختيار من بينها.

يمكنك أيضًا تنزيل العديد من النماذج المختلفة من مركز المساعدة.