نگاشت‌های فیلد

از نگاشت‌های موجود در جدول‌ها برای نگاشتن UploadClickConversionRequest در Google Ads API به معادل آن در IngestEventsRequest Data Manager API استفاده کنید.

اصالت‌سنجی

‫Data Manager API به اعتبارنامه‌هایی با دامنه‌ای متفاوت از Google Ads API نیاز دارد. مراحل مندرج در راه‌اندازی دسترسی به API را دنبال کنید تا اطلاعات اعتباری جدیدی که شامل حوزه «میانای برنامه‌سازی کاربردی مدیر داده‌ها» است تولید کنید.

فیلدهای درخواست

UploadClickConversionRequest (Google Ads API)	IngestEventsRequest (Data Manager API)	یادداشت‌ها
customer_id سرایند درخواست developer-token سرایند درخواست login-customer_id سرایند درخواست linked-customer-id conversion_action	destinations	فیلدهای کنش تبدیل و مشتری را ببینید.
معادل ندارد	consent	تنظیمات اختیاری موافقت پیش‌فرض برای رویدادهای موجود در درخواست. با تنظیم فیلد consent در Event می‌توانید این مقدار را برای رویداد تکی ملغی کنید.
معادل ندارد	encoding	الزامی: روی Encoding استفاده‌شده برای مقادیر UserIdentifier تنظیم شود.
معادل ندارد	encryption_info	اگر درخواست حاوی مقادیر رمزگذاری‌شده است، تنظیم کنید. برای جزئیات، رمزگذاری را ببینید.
job_id	معادل ندارد	از request_id برگشتی در پاسخ برای بازیابی تشخیص خرابی استفاده کنید.
partial_failure	معادل ندارد	‫Data Manager API از مدل خطای سریع‌شکست استفاده می‌کند. اگر هریک از فیلدهای IngestEventsRequest درستی‌سنجی نشود، «میانای برنامه‌سازی کاربردی مدیر داده» کل درخواست را رد می‌کند.
validate_only	validate_only
conversions	events	فهرست تبدیل‌ها یا رویدادها. برای جزئیات، بخش فیلدهای تبدیل را ببینید.

فیلدهای کنش تبدیل و مشتری

«میانای برنامه‌سازی کاربردی Google Ads» به سرایند درخواست developer-token نیاز دارد و شما login-customer-id و linked-customer-id سرایندهای درخواست را برای سناریوهای اصالت‌سنجی مختلف تنظیم می‌کنید.

‫Data Manager API به کد توسعه‌دهنده نیاز ندارد و اطلاعات ورود به سیستم و مشتری پیوندی را بااستفاده از فیلدهای Destination به‌جای سرایندهای درخواست مشخص می‌کنید. برای اطلاعات بیشتر درباره مقصدها، پیکربندی مقصدها را بررسی کنید.

در اینجا نحوه نگاشت فیلدهای «میانای برنامه‌سازی کاربردی Google Ads» برای یک conversion_action به فیلدهای معادل در Destination آورده شده است:

Google Ads API	Destination (Data Manager API)	یادداشت‌ها
‫customer_id درخواست	operating_account	account_id را روی شناسه مشتری حساب تبدیل Google Ads تنظیم کنید. این ممکن است با customer_id در درخواست Google Ads API شما متفاوت باشد. ‫account_type operating_account را روی GOOGLE_ADS تنظیم کن.
سرایند درخواست developer-token	معادل ندارد	برای «میانای برنامه‌سازی کاربردی مدیر داده»، کد توسعه‌دهنده لازم نیست.
سرایند درخواست login-customer-id	login_account	‫account_id را روی شناسه مشتری حساب ورود به سیستم تنظیم کنید. اگر حساب ورود به سیستم حساب Google Ads است، account_type را روی GOOGLE_ADS تنظیم کنید، یا اگر حساب ورود به سیستم حساب شریک داده است، DATA_PARTNER را تنظیم کنید.
سرایند درخواست linked-customer-id	linked_account	اگر بااستفاده از پیوند شریک به operating_account دسترسی پیدا می‌کنید، account_id را روی شناسه مشتری حساب پیوندشده تنظیم کنید و account_type را روی DATA_PARTNER تنظیم کنید. درغیراین‌صورت، فیلد linked_account را تنظیم نکنید.
‫conversion_action از ClickConversion	product_destination_id	روی شناسه عددی کنش تبدیل تنظیم کنید. از نام منبع ConversionAction استفاده نکنید.
معادل ندارد	reference	شناسه تعریف‌شده توسط کاربر برای Destination. اگر تبدیل‌ها را برای چندین کنش تبدیل در یک درخواست ارسال می‌کنید، این فیلد را تنظیم کنید.

فیلدهای تبدیل

ClickConversion (Google Ads API)	Event (Data Manager API)	یادداشت‌ها
cart_data	cart_data	برای جزئیات، فیلدهای داده سبد خرید را ببینید.
consent	consent	هر دو API از شیء Consent مشابهی (ad_user_data، ad_personalization) استفاده می‌کنند. برای Data Manager API، می‌توانید با تنظیم فیلد consent سطح درخواست، موافقت را برای همه رویدادهای درخواست نیز تنظیم کنید.
conversion_action	destination_references	اگر تبدیل‌ها را برای چندین کنش تبدیل در یک درخواست ارسال می‌کنید، این فیلد را روی reference مربوط به مقصد تنظیم کنید.
conversion_date_time	event_timestamp	اگر از قالب JSON استفاده می‌کنید، آن را روی مقداری در قالب RFC 3339 تنظیم کنید که کمی با قالب تاریخ و زمان Google Ads API متفاوت است. اگر از بافرهای پروتکل استفاده می‌کنید، از Timestamp استفاده کنید و فیلدهای seconds و (درصورت تمایل) nanoseconds را تنظیم کنید. برای جزئیات بیشتر، قالب مُهر زمان را ببینید.
conversion_environment	معادل ندارد
conversion_value	conversion_value	روی مقدار واحد پول تنظیم کنید، نه مقدار در میکرو. برای مثال، برای مقدار تبدیل ۵٫۲۳ دلار، از مقدار 5.23 استفاده کنید.
currency_code	currency
custom_variables	custom_variables	برای جزئیات، به فیلدهای متغیر سفارشی مراجعه کنید.
customer_type	user_properties.customer_type	روی مقداری در CustomerType enum تنظیم کنید.
معادل ندارد	event_source
معادل ندارد	event_device_info
external_attribution_data	معادل ندارد
gbraid	ad_identifiers.gbraid
gclid	ad_identifiers.gclid
معادل ندارد	last_updated_timestamp
order_id	transaction_id
session_attributes_encoded	ad_identifiers.session_attributes	برای جزئیات بیشتر، به افزودن مشخصه‌های جلسه مراجعه کنید.
session_attributes_key_value_pairs	experimental_fields	برای جزئیات بیشتر، به افزودن مشخصه‌های جلسه مراجعه کنید.
user_identifiers	user_data.user_identifiers	برای جزئیات، فیلدهای شناسه کاربر را ببینید.
user_ip_address	landing_page_device_info.ip_address
wbraid	ad_identifiers.wbraid

فیلدهای داده‌های سبد خرید

CartData (Google Ads API)	CartData (Data Manager API)	یادداشت‌ها
feed_country_code	merchant_feed_label	روی برچسب فید تنظیم کنید.
feed_language_code	merchant_feed_language_code
items	items
local_transaction_cost	transaction_discount
merchant_id	merchant_id

فیلدهای مورد برای داده‌های سبد خرید

Item (Google Ads API)	Item (Data Manager API)	یادداشت‌ها
product_id	merchant_product_id
quantity	quantity
unit_price	unit_price
معادل ندارد	item_id
معادل ندارد	additional_item_parameters

فیلدهای متغیر سفارشی

CustomVariable (Google Ads API)	CustomVariable (Data Manager API)	یادداشت‌ها
معادل ندارد	destination_references	«میانای برنامه‌سازی کاربردی Google Ads» برای هر کنش تبدیل به درخواست‌های جداگانه نیاز دارد. «میانای برنامه‌سازی کاربردی مدیر داده‌ها» از ارسال تبدیل‌ها برای چندین کنش تبدیل در یک درخواست واحد پشتیبانی می‌کند، و همچنین از این فیلد destination_references برای نشان دادن اینکه کدام مقصدها باید متغیر سفارشی خاصی را دریافت کنند پشتیبانی می‌کند.
conversion_custom_variable	variable	به‌جای نام منبع، روی نام متغیر تنظیم کنید.
value	value

فیلدهای شناسه کاربر

UserIdentifier (Google Ads API)	UserIdentifier (Data Manager API)
address_info	address	دستورالعمل‌های قالب‌بندی و درهم‌سازی را دنبال کنید. همچنین می‌توانید مشخصه‌های درهم‌سازی‌شده نشانی را رمزگذاری کنید.
hashed_email	email_address	روی نشانی ایمیل قالب‌بندی‌شده و درهم‌سازی‌شده تنظیم کنید. همچنین می‌توانید نشانی ایمیل درهم‌سازی‌شده را رمزگذاری کنید.
hashed_phone_number	phone_number	روی شماره تلفن قالب‌بندی‌شده و درهم‌سازی‌شده تنظیم کنید. همچنین می‌توانید شماره تلفن درهم‌سازی‌شده را رمزگذاری کنید.
فیلدهای دیگر: mobile_id third_party_user_id user_identifier_source	نامربوط	هیچ‌یک از این «میاناهای برنامه‌سازی کاربردی» از این شناسه‌ها برای تبدیل‌های آفلاین یا تبدیل‌های به‌سازی‌شده برای مشتریان بالقوه پشتیبانی نمی‌کنند، و «میانای برنامه‌سازی کاربردی مدیر داده‌ها» هنگام ارسال رویدادهای تبدیل به‌عنوان منبع داده اضافی از این شناسه‌ها پشتیبانی نمی‌کند.

فیلدهای پاسخ

UploadClickConversionResponse (Google Ads API)	IngestEventsResponse (Data Manager API)	یادداشت‌ها
job_id	معادل ندارد	از request_id برگشتی در پاسخ برای بازیابی تشخیص خرابی استفاده کنید.
partial_failure_error	معادل ندارد	‫Data Manager API از مدل خطای سریع‌شکست استفاده می‌کند. اگر هریک از فیلدهای IngestEventsRequest درستی‌سنجی نشود، «میانای برنامه‌سازی کاربردی مدیر داده» کل درخواست را رد می‌کند.
request-id سرایند پاسخ	request_id	شناسه درخواست به‌جای سرصفحه پاسخ، به‌عنوان فیلد پاسخ در Data Manager API برگردانده می‌شود.
results	معادل ندارد	‫Data Manager API رویدادها را به‌صورت ناهمزمان پردازش می‌کند. نتایج پردازش را بااستفاده از تشخیص خرابی بررسی کنید.