فید نمایه

معناشناسی خوراک پروفایل

همانطور که در تعاریف دسته فید ذکر شد، معنایی یک فید فوری اقدامات زیر است:

  • برای هر ارائه‌دهنده‌ای در فید عکس فوری، اگر ارائه‌دهنده در حال حاضر در پایگاه داده ارائه‌دهنده LSA وجود نداشته باشد، یک نمایه جدید ایجاد می‌شود.
  • برای هر ارائه‌دهنده‌ای در فید عکس فوری، اگر ارائه‌دهنده در حال حاضر در پایگاه داده ارائه‌دهنده LSA وجود داشته باشد، اطلاعات نمایه به‌روزرسانی می‌شود.
  • برای هر ارائه‌دهنده‌ای که در فید عکس فوری نیست، اگر ارائه‌دهنده در حال حاضر در پایگاه داده ارائه‌دهنده LSA وجود داشته باشد، نمایه حذف خواهد شد.

معناشناسی یک خوراک افزایشی منجر به اقدامات زیر می شود:

  • برای هر ارائه‌دهنده‌ای در یک فید افزایشی، اگر ارائه‌دهنده در حال حاضر در پایگاه داده ارائه‌دهنده LSA وجود نداشته باشد، بدون عملیات است.
  • برای هر ارائه‌دهنده‌ای در فید افزایشی، اگر ارائه‌دهنده در حال حاضر در پایگاه داده ارائه‌دهنده LSA وجود داشته باشد، اطلاعات نمایه به‌روزرسانی می‌شود.
  • برای هر ارائه‌دهنده‌ای که در فید افزایشی نیست، این یک غیرفعال است.

رسیدگی به خطا در نمایه ها

اگر یک مورد فید نمایه فردی نامعتبر باشد، آن مورد فید را در پایگاه داده LSA به‌روزرسانی نمی‌کنیم، و در عین حال این مورد را موقتاً متوقف می‌کنیم تا از ارائه داده‌های قدیمی جلوگیری کنیم.

اگر فید نمایه نامعتبر باشد (مثلاً با طرح مطابقت ندارد)، پردازش کل فید را متوقف خواهیم کرد. ما گزارشی را به اشتراک می گذاریم که شامل خلاصه ای از نتیجه پردازش فیدها است (به عنوان مثال خطاها، وضعیت پردازش برای هر مورد و غیره).

پروتکل و محدودیت ها

  1. محدودیت ها هر کسب و کار (مورد فید) در یک فید باید یک شناسه منحصر به فرد داشته باشد.

  2. محدودیت ها LSA محدودیت‌های اندازه را بر روی فیلدهای داده فردی اعمال می‌کند که در جدول زیر مشخص شده است.

  3. محدودیت در نام کسب و کار

    1. حداکثر طول: 100 کاراکتر، با احتساب فاصله
    2. حداقل به یک عدد یا حرف نیاز دارد
    3. رمزگذاری نامه های پشتیبانی شده UTF-8، UTF-16 و UTF-32 هستند (UTF-8 توصیه شده)
    4. کاراکترهای ویژه مجاز:
      1. خط تیره - , آمپرسند & , دوره . , کاما , , آپستروف ' , پرانتز ( )
    5. غیر مجاز ALL CAPS
    6. کلمات توهین آمیز را ممنوع کنید
    7. اموجی را مجاز نکنید

فیلدهای نمایه

در زیر فیلدهای تنظیم شده برای یک ارائه دهنده معین را شرح می دهد. فیلدهایی که اختیاری هستند به این صورت علامت گذاری می شوند.

نام فیلد توضیحات نوع فیلد مثال مورد نیاز محدودیت ها
serviceProviderId شناسه منحصر به فرد فهرست کسب و کار (ارائه دهنده خدمات) شماره 12345 بله این یک شناسه منحصر به فرد برای هر ارائه دهنده خدمات است. این به int64 تبدیل می شود. هنگام به‌روزرسانی ارائه‌دهنده، شناسه را یکسان نگه دارید
serviceProviderName نام تجاری رشته "King David Garage Doors, Inc." بله حداکثر 100 کاراکتر مشروط به خط مشی محدودیت های نام.
serviceProviderWebsiteUrl آدرس وب سایت کسب و کار رشته https://abc.xyz خیر با http یا https شروع کنید
آدرس آدرس کسب و کار شی "addressLine1": "847 Oliver Avenue"، "city": "Valley Stream"، "region":"NY"، "postalCode":"11581"، "country": "US" بله addressLine1 در صورت موجود بودن باید با آدرس خیابان پر شود. پس از راه اندازی کسب و کار اولیه نمی توان کد کشور را تغییر داد.
aggregatorProfileUrl نشانی اینترنتی نمایه که به صفحه نمایه در سایت شریک پیوند دارد. رشته http://aggregator.com/joes-plumbing/ خیر با http یا https شروع کنید
yearBusinessStarted سال تاسیس کسب و کار عدد صحیح 2015 خیر فرمت YYYY
ساعات کاری ساعاتی که کسب و کار باز است آرایه از شی به "مثال فید نمایه" مراجعه کنید. بله برای محدودیت ها به تعریف شی مراجعه کنید
شماره تلفن کسب و کار شماره تلفن کسب و کار انفرادی در قالب e164، به جای شماره مرکز تماس یا شماره پیگیری اختصاص داده شده توسط شریک، باید خالی باشد یا متعلق به کسب و کار باشد. رشته “+16501112222” بله شماره تلفن باید با فرمت E.164 باشد
تماس بگیرید اطلاعات تماس مورد استفاده برای روش های مختلف تماس آرایه شی "{ "type": "PHONE", "address": "+16501112222" }" بله نوع ممکن است شامل «PHONE» یا «MESSAGE» باشد. برای نوع «PHONE»، آدرس باید دارای یک شماره تلفن با فرمت E.164 باشد. برای "MESSAGE" آدرس نباید پر شود. عنصر با نوع PHONE مورد نیاز است، اما عنصر با نوع MESSAGE اختیاری است.
targetingLanguages فهرستی از زبان‌هایی که آگهی به آن‌ها ارائه می‌شود. زبان‌ها در کد زبان ISO 639-1 (کوچک، 2 حرفی) تعریف شده‌اند. آرایه رشته "en"، "fr" بله اگر ارائه نشده باشد، پیش‌فرض روی «en» است.
geoCovered خدمات جغرافیایی توسط کسب و کار. شی خیر
geoCovered ->criteriaIds فهرستی از شناسه‌های معیار که با مناطق (منطقه، شهرستان، شهر، کد پستی) مورد استفاده قرار می‌گیرد. آرایه اعداد صحیح خیر شناسه معیار جغرافیایی باید در فهرست اهداف جغرافیایی Google Ads معتبر باشد.
دسته بندی ها فهرستی از دسته‌های ارائه‌شده توسط کسب‌وکار. آرایه شی به "مثال فید نمایه" مراجعه کنید. بله برای انتخاب از گوگل لیست دسته بندی ها ارائه شده است. این باید دقیقاً شامل یک دسته باشد.
دسته ها -> وظایف فهرستی از وظایفی که در یک دسته بندی انجام شده است. آرایه شی بله برای انتخاب از گوگل لیستی از وظایف ارائه شده است
tasks ->geoCovered Geo توسط این وظیفه خدمت کرده است شی بله
tasks ->geoCovered->postalCodeCriteriaIds فهرستی از شناسه‌های معیاری که با کدهای پستی ارائه شده مطابقت دارند.. آرایه رشته شناسه معیار جغرافیایی فهرستی از کدهای پستی ارائه شده، شناسه معیار باید در فهرست اهداف جغرافیایی Google Ads با نوع هدف، Code Postal Code معتبر باشد.
tasks ->geoCovered->cityCriteriaIds فهرستی از شناسه‌های معیار که با شهرهای مورد استفاده مطابقت دارد. آرایه رشته شناسه معیار جغرافیایی لیستی از شهرهای ارائه شده، شناسه معیار باید در فهرست اهداف جغرافیایی Google Ads با نوع شهر هدف معتبر باشد)
فعال پرچم را نشان می دهد که آیا این کسب و کار باید فعال باشد یا موقتاً متوقف شود بولی درست / نادرست بله
بودجه ماهانه بودجه ماهانه این ارائه دهنده در ماهانهBudgetCurrency عدد صحیح 100 بله باید بزرگتر یا مساوی حداکثر قیمت پیشنهادی یا ذخیره سرنخ باشد.
ماهانه بودجه بودجه ارز بودجه ماهانه و پیشنهادات. کدهای ارز را ببینید. رشته “USD” بله پس از راه اندازی کسب و کار اولیه قابل تغییر نیست.
فراخوانی ها آرایه ای از فراخوان برای هر دسته آرایه شی بله برای انتخاب از Google فهرستی از فراخوان ها ارائه شده است
استراتژی مناقصه استراتژی مناقصه برای این تجارت برای حراج. بر قیمت هر سرب تأثیر می گذارد. رشته «MANUAL_CPA» / «MAX_CONVERSION» خیر برای انتخاب از لیست ارائه شده توسط گوگل اگر تنظیم نشود، این استراتژی به طور پیش‌فرض روی MANUAL_CPA خواهد بود.
biddingConfiguration فهرستی از تنظیمات مناقصه در هر دسته. فقط برای استراتژی پیشنهاد قیمت MANUAL_CPA قابل اجرا است. آرایه شی نمونه خوراک نمایه را ببینید ن اگر هیچ پیکربندی ارائه نشده است و استراتژی مناقصه MANUAL_CPA است، به‌طور پیش‌فرض هر دسته‌بندی حداقل پیشنهاد را دارد.
biddingConfiguration->categoryId شناسه دسته در طبقه بندی LSA. این دسته بندی ها باید با دسته های ذکر شده در بالا مطابقت داشته باشند. در صورت اعلام پیکربندی مناقصه الزامی است. رشته خیر برای انتخاب از لیست ارائه شده توسط گوگل
biddingConfiguration->manualCostPerLead هزینه دستی هر پیکربندی سرب. اگر استراتژی مناقصه "MANUAL_CPA" باشد، باید ارائه شود. شی خیر
manualCostPerLead->bid هزینه دستی هر پیشنهاد سرب قیمت سرب هرگز از ارزش این پیشنهاد تجاوز نخواهد کرد. اگر manualCostPerLead اعلام شده باشد، الزامی است. شماره خیر باید بزرگتر یا مساوی با قیمت رزرو باشد.