نقشه برداری های میدانی

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

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

UploadClickConversionRequest (API تبلیغات گوگل)	IngestEventsRequest (رابط برنامه‌نویسی کاربردی مدیریت داده)	یادداشت‌ها
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 با شکست مواجه شود، رابط برنامه‌نویسی کاربردی مدیریت داده (Data Manager API) کل درخواست را رد می‌کند.
validate_only	validate_only
conversions	events	فهرست تبدیل‌ها یا رویدادها. برای جزئیات بیشتر به بخش فیلدهای تبدیل مراجعه کنید.

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

API گوگل ادز به هدر درخواست developer-token نیاز دارد و شما هدرهای درخواست login-customer-id و linked-customer-id را برای سناریوهای مختلف احراز هویت تنظیم می‌کنید.

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

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

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

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

ClickConversion (API تبلیغات گوگل)	Event (رابط برنامه‌نویسی کاربردی مدیریت داده)	یادداشت‌ها
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 تنظیم کنید که کمی با فرمت تاریخ و زمان API تبلیغات گوگل متفاوت باشد. اگر از بافرهای پروتکل استفاده می‌کنید، از یک Timestamp استفاده کنید و فیلدهای seconds و (اختیاری) nanoseconds را تنظیم کنید. برای جزئیات بیشتر به قالب مهر زمانی مراجعه کنید.
conversion_environment	معادلی وجود ندارد
conversion_value	conversion_value	روی مقدار ارز تنظیم کنید، نه مقدار بر حسب میکرو. برای مثال، برای مقدار تبدیل ۵.۲۳ دلار، از مقدار 5.23 استفاده کنید.
currency_code	currency
custom_variables	custom_variables	برای جزئیات بیشتر به فیلدهای متغیر سفارشی مراجعه کنید.
customer_type
معادلی وجود ندارد	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 (رابط برنامه‌نویسی کاربردی تبلیغات گوگل)	CartData (رابط برنامه‌نویسی کاربردی مدیریت داده)	یادداشت‌ها
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 (API تبلیغات گوگل)	Item (API مدیریت داده)	یادداشت‌ها
product_id	merchant_product_id
quantity	quantity
unit_price	unit_price
معادلی وجود ندارد	item_id
معادلی وجود ندارد	additional_item_parameters

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

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

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

نکته: در رابط برنامه‌نویسی کاربردی مدیریت داده (Data Manager API)، شناسه‌های کاربر را به یک شیء UserData اضافه کنید، سپس فیلد user_data مربوط به Event را تنظیم کنید. در رابط برنامه‌نویسی کاربردی گوگل ادز (Google Ads API)، شناسه‌های کاربر مستقیماً به ClickConversion در فیلد user_identifiers اضافه می‌شوند.

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

فیلدهای پاسخ

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