Прежде чем начать
Редактирование типа массива данных
Вы можете редактировать данные на Affise с помощью многих методов API, однако некоторые из них требуют специальных знаний для корректной работы с данными. Одним из таких случаев является редактирование данных типа массив.
Особенности типа массива таковы:
в запросе на редактирование необходимо сохранить (повторить) настройки всего массива, которые вы хотите сохранить
при необходимости добавить новые настройки в соответствующий массив с учетом предыдущего пункта.
необходимо удалить настройки всего массива, которые вы не хотите сохранять, в запросе на редактирование. В случае с другими типами данных (строка или целое число) данные не будут удалены, если вы не повторите их в API-запросе на редактирование.
В этой статье вы увидите несколько примеров редактирования данных типа массив.
Редактирование группы таргетинга
Допустим, у вас есть три группы таргетинга в предложении со следующими настройками:
Общая группа таргетинга:
Страны: Франция, Испания, Нидерланды.
Включена защита от мошенничества на уровне кликов.
Устройства: мобильные.
Общая целевая группа.
Страны: Франция.
Защита от мошенничества на уровне кликов включена.
Допустимые значения sub1: 123,323.
Персональная группа таргетинга для партнера №2.
Страны: Испания, Италия.
Включена защита от мошенничества на уровне кликов.
Параметры для этих настроек следующие:
🔎 Каждая группа таргетинга - это отдельный массив данных.
Допустим, вы хотите изменить страны во всех общих группах таргетинга, добавить разрешенные аккаунты sub1 в первую общую группу таргетинга и удалить персональную группу таргетинга. Остальные настройки должны остаться.
Параметры для запроса API следующие:
Запрос cURL для примера выглядит следующим образом:
curl --request POST \ --url https://api-rocketcompany.affise.com/3.0/admin/offer/1441540 \ --header 'api-key: 4sdf87fsdfd8723lkjhrn324' \ --header 'content-type: application/x-www-form-urlencoded' \ --cookie PHPSESSID=7u7eu0hds2parivvhl6nbicgj9 \ --data 'targeting[0][country][allow][0]=DE' \ --...данные 'targeting[0][country][allow][1]=BE' \ -данные 'targeting[0][country][allow][2]=AT' \ -данные 'targeting[0][device_type][0]=mobile' \ --data 'targeting[0][block_proxy]=1' \ --data 'targeting[0][sub][allow][1][0]=123' \ --data 'targeting[0][sub][allow][1][1]=321' \ --данные 'targeting[1][country][allow][0]=DE' \ --data 'targeting[1][block_proxy]=1' \ --data 'targeting[1][sub][allow][1][0]=123' \ --data 'targeting[1][sub][allow][1][1]=321'
Запрос изменяет следующее:
Отсутствует персональная группа таргетинга (она удалена).
Страны в обеих общих группах отличаются от исходных.
В первую общую группу таргетинга добавлены разрешенные значения sub1.
Все настройки, которые мы хотели сохранить, сохраняются в предложении.
Редактирование выплаты
Предположим, что у вас есть две выплаты в предложении со следующими настройками:
Общая выплата.
Страны: Норвегия, Швеция и Дания исключены.
Тип выплаты: фиксированная.
Валюта: EUR.
Доход: 10.
Выплата: 5.
Стоимость цели: inst.
Общая выплата.
Страны: Польша.
Sub1: 456, Sub2: 678.
Тип выплаты: процент.
Валюта: EUR.
Доход: 10.
Выплата: 5.
Значение цели: покупки.
Параметрами для этих настроек являются:
🔎 Каждая выплата - это отдельный массив данных.
Допустим, вы хотите включить страны в первую выплату, добавить туда значения sub1 и sub2, изменить валюту, доход и платежи во второй выплате и удалить там значения sub1 и sub2.
Параметры для запроса API следующие:
Запрос cURL для данного примера выглядит следующим образом:
curl --request POST \ --url https://api-rocketcompany.affise.com/3.0/admin/offer/1441540 \ --header 'api-key: 4sdf87fsdfd8723lkjhrn324' \ --header 'content-type: application/x-www-form-urlencoded' \ --cookie PHPSESSID=7u7eu0hds2parivvhl6nbicgj9 \ --data 'payments[0][countries][0]=DK' \ --data 'payments[0][countries][1]=NO' \ --data 'payments[0][countries][2]=SE' \ -...-данные 'payments[0][country_exclude]=0' \ -данные 'payments[0][type]=fixed' \ -данные 'payments[0][currency]=EUR' \ -данные 'payments[0][total]=10' \ -данные 'payments[0][revenue]=5' \ -...-data 'payments[0][goal]=inst' \ --data 'payments[0][sub1]=456' \ --data 'payments[0][sub2]=678' \ --data 'payments[1][countries][0]=PL' \ --data 'payments[1][type]=percent' \ --данные 'payments[1][currency]=USD' \ -данные 'payments[1][total]=8' \ -данные 'payments[1][revenue]=4' \ -данные 'payments[1][goal]=purch' \ -данные 'payments[1][sub1]=0' \ -данные 'payments[1][sub2]=0'
Запрос изменяет следующее:
включены страны в первых выплатах.
Значения sub1 и sub2 были добавлены в первую выплату и удалены из второй выплаты.
Валюта, доход и платежи были изменены во второй выплате.
Редактирование конверсии
Используйте этот метод для редактирования статуса конверсии, дохода, выплат и валюты. Здесь вы можете найти подробный пример.
🔎 При редактировании конверсии не следует сохранять/повторять определенные данные в API-запросе.
Метод: POST /3.0/admin/conversion/edit
Редактирование постбэка партнера
С помощью этого метода вы можете отредактировать ссылку постбэка партнера: URL, параметры, макросы.
🔎 В запросе API необходимо использовать ID постбэка. Вы можете найти его на странице редактирования партнера в админпанели или через список методов API для постбэков партнеров.
Метод: POST /3.0/partner/postback/{ID}
Запрос cURL для изменения одной ссылки постбэка:
curl --request POST \ --url https://api-rocketcompany.affise.com/3.0/partner/postback/1496 \ --header 'api-key: 4sdf87fsdfd8723lkjhrn324' \ --header 'content-type: application/x-www-form-urlencoded' \ --cookie PHPSESSID=7u7eu0hds2parivvhl6nbicgj9 \ --data 'url=https://new.postback.com?sub1={sub1}' \ --data status=confirmed \ --data integration_method=allРедактирование партнера
Используйте этот метод для редактирования профиля партнера на Affise. В этом методе нет постбеков или пикселей, он касается информации о профиле, платежных системах и других данных, не связанных с интеграцией.
Метод: POST /3.0/admin/partner/{ID}
Запрос cURL для изменения информации о профиле, а также добавления тегов, реферального процента и одной платежной системы.
curl --request POST \ --url https://api-rocketcompany.affise.com/3.0/admin/partner/2 \ --header 'api-key: 4sdf87fsdfd8723lkjhrn324' \ --header 'content-type: application/x-www-form-urlencoded' \ --cookie PHPSESSID=7u7eu0hds2parivvhl6nbicgj9 \ --data country=ES \ --data 'contact_person=John Snow' \ --data 'tags[0]=new_aff' \ --...данные 'tags[1]=gambling' \ -данные ref_percent=10 \ -данные 'payment_systems[0][system_id]=35' \ -данные 'payment_systems[0][currency]=USD' \ -данные 'payment_systems[0][fields][1]=12333321'
Здесь отредактированные данные не принадлежат к типу массива. Однако добавленные данные относятся к типу массива (теги, платежная система).
По всем возникшим вопросам обращайтесь в службу поддержки клиентов Affise по электронной почте: [email protected].